Menyunting Modul:Protection banner/doc

{{High-use| 500 }}
{{Module rating|protected}}
{{Lua|Module:Protection banner/config|Module:No globals|Module:File link|Module:Effective protection level|Module:Effective protection expiry|Module:Yesno|Module:Arguments|Module:Message box|Module:Vandal-m|Module:Submit an edit request|noprotcat=yes}}
Modul ini digunakan untuk membuat tajuk pelindungan dan ikon gembok yang ditempatkan di atas [[Bantuan:Pelindungan|halaman pelindungan]].

== Penggunaan ==

Tidak dapat digunakan secara langsung. Templat pelindungan memerlukan templat {{tl|pp}}, atau menggunakan daftar templat di bawah

{{templat pelindungan}}

=== Dari teks wiki ===

 &#123;{#invoke:Protection banner|main
 | 1        = ''reason''
 | small    = ''yes/no''
 | action   = ''action''
 | date     = ''protection date''
 | user     = ''username''
 | section  = ''talk page section name''
 | category = ''no''
 }&#125;

Sintaksis #invoke digunakan untuk templat yang lebih spesifik daripada {{tl|pp}}. Misalnya, it is possible to create a protection template which always shows a padlock icon by using the code <code><nowiki>{{#invoke:Protection banner|main|small=yes}}</nowiki></code>. Pages which call this template will still be able to use other arguments, like ''action''. However, this only works one level deep; a page calling a template which calls another template containing the above code will not automatically be able to use parameters like ''action''.

'''''Note:''' You should no longer specify the expiry, as it is automatically retrieved in all cases.''

=== Dari lua ===

First, load the module.

<syntaxhighlight lang="lua">
local mProtectionBanner = require('Module:Protection banner')
</syntaxhighlight>

Then you can make protection banners by using the _main function.

<syntaxhighlight lang="lua">
mProtectionBanner._main(args, cfg, titleObj)
</syntaxhighlight>

<var>args</var> is a table of arguments to pass to the module. For possible keys and values for this table, see the [[#Parameters|parameters section]]. The <var>cfg</var> and <var>titleObj</var> variables are intended only for testing; <var>cfg</var> specifies a customised config table to use instead of [[Module:Protection banner/config]], and <var>titleObj</var> specifies a mw.title object to use instead of the current title. <var>args</var>, <var>cfg</var> and <var>titleObj</var> are all optional.

== Parameters ==

All parameters are optional.

* '''1''' – the reason that the page was protected. If set, this must be one of the values listed in the [[#Reasons|reasons table]].
* '''small''' – if set to "yes", "y", "1", or "true", a padlock icon is generated instead of a full protection banner.
* '''action''' – the protection action. Must be one of "edit" (for normal protection), "move" (for move-protection) or "autoreview" (for pending changes). The default value is "edit".
* '''date''' – the protection date. This must be valid input to the second parameter of the [[mw:Help:Extension:ParserFunctions##time|#time parser function]]. This argument has an effect for reasons that use the PROTECTIONDATE parameter in their configuration. As of July 2014, those were the "office" and "reset" reasons.
* '''user''' – the username of the user to generate links for. As of July 2014, this only has an effect when the "usertalk" reason is specified.
* '''section''' – the section name of the protected page's talk page where discussion is taking place. This works for most, but not all, values of ''reason''.
* '''category''' – categories are suppressed if this is set to "no", "n", "0", or "false".

== Reasons ==

The following table contains the available reasons, plus the actions for which they are available.

{{#invoke:Protection banner/documentation|reasonTable}}

== Errors ==

Below is a list of some of the common errors that this module can produce, and how to fix them.

=== Invalid protection date ===

{{error|Error: invalid protection date ("abc")}}

This error is produced if you supply an {{para|date}} parameter value that is not recognised as a valid date by the #time parser function. If in doubt, you can just use a date in the format "dd Month YYYY", e.g. "{{#time:j F Y|+ 1 week}}". To see a full range of valid inputs, see the [[mw:Help:Extension:ParserFunctions##time|#time documentation]] (only the first parameter, the ''format string'', may be specified).

=== Invalid action ===

{{error|Error: invalid action ("abc")}}

This error is produced if you specify an invalid protection action. There are only three valid actions: <code>edit</code> (the default, for normal protection), <code>move</code> (for move-protection), and <code>autoreview</code> (for [[WP:PC|pending changes]]). This should only be possible if you are using a template that supports manually specifying the protection action, such as {{tl|pp}}, or if you are using #invoke directly. If this is not the case, please leave a message on [[Module talk:Protection banner]].

=== Reasons cannot contain the pipe character ===

{{error|Error: reasons cannot contain the pipe character ("&#124;")}}

Galat ini dihasilkan jika Anda memberikan alasan pada parameter {{para|1}} mengandung karakter pipa ("&#124;"). Periksa bahwa Anda tidak memasukkan templat {{tl|!}} ke parameter ini. Karakter ini dilarang karena modul ini menggunakan karakter tersebut secara internal. Alasan yang valid dapat dilihat di bagian [[#Alasan|alasan]].

=== Galat yang lain ===

Jika Anda melihat galat selain hal di atas, kemungkinan itu adalah kekutu atau kesalahan konfigurasi. Kirim pesan mengenai masalah ini di [[Pembicaraan Modul:Protection banner]].

== Detail teknis ==

Modul ini menggunakan konfigurasi [[Module:Protection banner/config]]. Kebanyakan perilaku modul, dikonfigurasi di sana sehingga sangat portabel di antara wiki dalam berbagai bahasa

Kasus uji umum modul ini dapat dilakukan di [[Module:Protection banner/kasus uji|Modul:Protection banner/kasus uji]], dan konfigurasinya dapat dilakukan di [[Modul:Protection banner/config/testcases|Modul:Protection banner/config/kasus uji]].

Masalah kekutu dan fitur baru dapat dibicarakan [[w:en:Module talk:Protection banner|di halaman pembicaraan modul ini]].
<includeonly>{{#ifeq:{{SUBPAGENAME}}|sandbox||
<!-- Categories go here and interwikis go in Wikidata. -->
}}</includeonly>