Tingnan ang wikitext ng Module:Message box/doc

<!--{{Used in system}}
{{module rating|p}}-->
{{Lua|Module:Message box/configuration|Module:No globals|Module:Yesno|Module:Arguments|Module:Category handler}}
{{Uses TemplateStyles|Module:Message box/ambox.css|Module:Message box/cmbox.css|Module:Message box/fmbox.css|Module:Message box/imbox.css|Module:Message box/ombox.css|Module:Message box/tmbox.css}}

== Patungkol ==

Isa itong ''meta module'' na gumagawa sa mga padron na kahong pangmensahe (''message box''): {{tl|mbox}}, {{tl|ambox}}, {{tl|cmbox}}, {{tl|fmbox}}, {{tl|imbox}}, {{tl|ombox}}, at {{tl|tmbox}}. Ginawa ito upang gamitin lang sa ibang mga module ng Lua, at hindi para gamitin nang direkta sa mga pahina ng wiki. Kung gusto niyong gamitin ang kakayahan ng module na ito sa isang pahina ng wiki, pakigamkt po ang mga indibidwal na kahong pangmensahe.

=== Paggamit ===

Para magamit ang module na ito sa isang module ng Lua, dapat i-load mo muna ito.

<syntaxhighlight lang="lua">
local messageBox = require('Module:Message box')
</syntaxhighlight>

Para makagawa ng isang kahong pangmensahe, gamitin ang <code>main</code> function. May dalawang parameter ito: ang uri ng kahon (sa string), at ang talahanayan na naglalaman ng mga parameter ng kahong pangmensahe.

<syntaxhighlight lang="lua">
local box = messageBox.main( boxType, {
    param1 = param1,
    param2 = param2,
    -- at iba pang mga parameter...
})
</syntaxhighlight>

May pitong magagamit na uri ng kahon:

{| class="wikitable"
! Uri ng kahon !! Padron !! Gamit
|-
| <code>mbox</code> || {{tl|mbox}} || Para sa mga kahong pangmensaheng gagamitin sa maraming namespace.
|-
| <code>ambox</code> || {{tl|ambox}} || Para sa mga kahong pangmensahe sa mga artikulo.
|-
| <code>cmbox</code> || {{tl|cmbox}} || Para sa mga kahong pangmensahe sa mga kategorya.
|-
| <code>fmbox</code> || {{tl|fmbox}} || Para sa mga kahong pangmensahe sa interface.
|-
| <code>imbox</code> || {{tl|imbox}} || Para sa mga kahong pangmensahe sa file namespace.
|-
| <code>tmbox</code> || {{tl|tmbox}} || Para sa mga kahong pangmensahe sa mga pahina ng usapan.
|-
| <code>ombox</code> || {{tl|ombox}} || Para sa mga kahong pangmensahe sa mga namespace na hindi nabanggit dito.
|}

Tingnan ang dokumentasyon ng mga indibidwal na padron para sa mas detalyadong impormasyon.

=== Paggamit sa <code>#invoke</code> ===

Bukod sa <code>main</code> function, may mga hiwalay na function ang module na ito para sa bawat uri ng kahon. Maa-access sila gamit ang code na <code><nowiki>{{#invoke:Message box|mbox|...}}</nowiki></code>, <code><nowiki>{{#invoke:Message box|ambox|...}}</nowiki></code>, atbp. Gagana sila kapag tinawag sa ibang mga module, pero kaya nilang ma-access ang code na ginamit para iproseso ang mga argumentong pinasa sa <code>#invoke</code>, kaya naman mas mahina ito kesa sa pagtawag sa <code>main</code>.

=== Mga detalyeng teknikal ===

Ginagamit ng module ang parehong basic code para sa bawat padron na nakalista sa taas; makikita at masasaayos sa [[Module:Message box/configuration]] ang kani-kanilang pagkakaiba. Heto ang iba't-ibang mga pagsasaayos  at kung ano-ano ang ibig sabihin nila:

* <code>types</code> – talahanayan na naglalaman ng data na ginagamit ng {{para|type}} parameter ng kahong pangmensahe. Mga value ang mga key ng talahanayan na maipapasa sa {{para|type}}, at talahanayan ang mga value na naglalaman ng <code>class</code> at ang <code>image</code> na ginamit ng uri na yon.
* <code>default</code> – ang uri na na gagamitin kung walang value na pinasa sa {{para|type}}, kung invalid yung binigay na value.
* <code>showInvalidTypeError</code> – kung magpapakita ng error kung invalid ang pinasang value sa {{para|type}} parameter.
* <code>allowBlankParams</code> – madalas, tinatanggal ang mga blangkong value mula sa mga parameter na pinasa sa module. Gayunpaman, pinepreserba ang whitespace para sa mga parameter na sinama sa talahanayan ng <code>allowBlankParams</code>.
* <code>allowSmall</code> – kung gagawa ba ng maliit na bersyon ng kahong pangmensahe ({{para|small|yes}}).
* <code>smallParam</code> – custom na pangalan para sa {{para|small}} parameter. Halimbawa, kung "left" ito, makakagawa ka ng maliit na kahong pangmensahe gamit ang {{para|small|left}}.
* <code>smallClass</code> – ang <code>class</code> na gagamitin para sa mga maliliit na kahong pangmensahe.
* <code>substCheck</code> – kung magsasagawa ng subst check o hindi.
* <code>classes</code> – array ng mga <code>class</code> na gagamitin sa kahong pangmensahe.
* <code>imageEmptyCell</code> – kung gagamit ba ng isang blangkong {{tag|td}} cell kung walang nakatakdang larawan. Gagamitin ito para mapreserba ang espasyo para sa mga kahong pangmensahe na may <code>width</code> na mas maliit para sa 100% ng screen.
* <code>imageEmptyCellStyle</code> – kung lalagyan ba ng istilo ang mga blangkong cell ng larawan.
* <code>imageCheckBlank</code> – kung magreresulta ba ang {{para|image|blank}} sa walang larawang ipapakita.
* <code>imageSmallSize</code> – madalasz nakatakda sa 30×30px ang mga larawang ginagamit sa mga maliliit na kahong pangmensahe. Nagtatakda ito ng isang custom na sukat.
* <code>imageCellDiv</code> – kung ilalagay ba ang larawan sa isang {{tag|div}} na may maximum na sukat ng larawan.
* <code>useCollapsibleTextFields</code> – kung gagamit ba ng mga text field na pwedeng masara, hal. "isyu", "ayos", "usap", atbp. Ginagamit lang ng ambox sa ngayon.
* <code>imageRightNone</code> – kung magreresulta ba ang {{para|imageright|none}} sa walang ipinapakitang larawan sa kanang bahagi ng kahong pangmensahe.
* <code>sectionDefault</code> – ang default na pangalan na gagamitin ng {{para|section}} parameter. Nakadepende sa <code>useCollapsibleTextFields</code>.
* <code>allowMainspaceCategories</code> – nagpapahintulot sa pagkakategorya sa main namespace.
* <code>templateCategory</code> – ang pangalan ng kategoryang ilalagay sa pahina ng padron.
* <code>templateCategoryRequireName</code> – kung gagawin bang required ang {{para|name}} para maipakita ang kategorya ng padron.
* <code>templateErrorCategory</code> – ang pangalan ng kategorya ng error na gagamitin sa pahina ng padron.
* <code>templateErrorParamsToCheck</code> – array ng mga pangalan ng parameter na sisilipin. Kung wala ang alinman sa mga ito, ilalagay ang <code>templateErrorCategory</code> sa pahina ng padron.