Nápověda:Rozšíření:MassMessage
Toto je stránka nápovědy ohledně použití rozšíření MassMessage . Instrukce, jak tohe rozšíření nainstalovat, naleznete na stránce věnované tomuto rozšíření.
Distribuční seznamy
MassMessage může získat seznam stránek, na které zapíše distribuovanou zprávu tak, že použije:
Distribuční seznam, založený přes speciální stránku (která je dostupná od MediaWiki verze 1.24)
Aby uživatel mohl založit distribuční seznamy, musí disponovat právem "editcontentmodel" (viz phab:T92795). U většiny Wikimedia projektů, mají tohle právo pouze administrátoři – uživatelé ze skupiny 'sysop'.
Rozšíření MassMessage disponuje speciální stránkou, přes kterou lze distribuční seznamy zakládat.
Pro založení nového distribučního seznamu, zavolejte v rámci své wiki stránku "Special:CreateMassMessageList" – u české wiki lze volat i lokalizovanou variantu "Speciální:Vytvořit_distribuční_seznam_pro_hromadné_zprávy", nebo se přes volbu "Speciální stránky" v menu, překliknout na seznam speciálních stránek a tam v sekci "Ostatní" kliknout na odkaz "Vytvořit distribuční seznam pro hromadné zprávy".
Přes zobrazený formulář lze založit nový distribuční seznam, do kterého lze příjemce, resp. stránky do kterých může MassStorage zapisovat, postupně přidávat. Nebo takový seznam do něj rovnou naimportovat z jiného, již existujícího seznamu uživatelů na wiki, u kterého na formátování wikikódu nezáleží, protože si ho rozšíření MassMessage při importu zpracuje podle sebe.
Pokud byste změnili model stránky distribučního seznamu z 'MassMessageListContent' na 'text', viděli byste že jde o JSON formát, který obsahuje položku description
, ve které je obsah stránky, se kterým pracujete při běžné editaci, a targets
, ve které je seznam stránek, do kterých se bude zpráva zapisovat, včetně přísušného jmenného prostoru. V případě uživatelských stránek na jmenném prostoru nezáleží, protože cílovou stránkou bude vždy pouze diskuzní stránka uživatele.
Je-li vaše wiki součástí projektů WMF, lze v distribučním seznamu specifikovat i wiki, ve které se nalézá stránka do které se má zpráva zapsat. A to tak, že se do formuláře uvede název stránky, včetně cílové wiki ve formátu "User:Foo@site", či zcela konkrétně "Project:Noticeboard@en.wikipedia.org", v případě projektové stránky na anglické wikipedii. Pokud by měly být cílem stránky této wiki, které mají v názvu zavináč, vypadalo by to takto: "Foo@bar@mediawiki.org".
Ovšem v distribučním seznamu wiki periodika Signpost takových odběratelů moc nenajdete, protože většina z nich ani netuší, že je to možné.
Kategorii (od MediaWiki verze 1.23)
Rozšíření MassMessage umí hromadně zapsat distribuovanou zprávu i na stránky kategorizované do stejné kategorie, ovšem jen pokud jsou ze jmenného prostoru, do kterého může zapisovat! Pak stačí ve formuláři místo distribučního seznamu uvést pouze název kategorie (např. "Kategorie:Projektové stránky"). Pokud budou ze jmenného prostoru specifikovaného konfigurační proměnnou $wgMetaNamespace (výchozí hodnotou je 'Project'), zapíše do jejich wikikódu kód distribuované zprávy.
Distribuční seznam generovaný s využitím parsovacích funkcí
Jako distribuční seznam může fungovat i obyčejná stránka s wikitextem, pokud obsahuje seznam stránek, na které lze zprávu zapsat. Každá z položek se zapíše takto:
{{#target:Project:Noticeboard}}
V tomto případě je cílem stránka "Project:Noticeboard". Je-li wiki součástí větší farmy, lze zapisovat zprávy i na jiné wiki např.:
{{#target:Project:Noticeboard|en.wikipedia.org}}
Zapíše zprávu na stránku w:en:Project:Noticeboard v anglické jazykové mutaci wikipedie.
Další příklady najdete na distribučním seznamu Tech News. Výhodou takto vytvořeného distribučního seznamu je, že se může sám stát cílovou stránkou, na kterou je možné zprávy zapisovat, pokud se bude nalézat ve jmenném prostoru, kam bude mít MassMessage možnost zapisovat.
Wikidata MassMessage tool
For Wikimedia wikis, you can use Wikidata MassMessage tool to generate a list of wikipages, based on Wikidata items, ready and formatted as a delivery list for MassMessage.
Distribuce zprávy
Máte-li práva k hromadné distribuzi zpráv, naleznete mezi speciálními stránkami vaší wiki odkaz na speciální stránku Special:MassMessage. Používáte-li české rozhraní, bude v sekci „Ostatní” pod názvem „Poslat hromadnou zprávu”. Má-li vaše instance MediaWiki jako výchozí jazyk češtinu, počítejte s tím, že bude lokalizován i název této speciální stránky, takže se vám v URL objeví řetězec „Speciální:Hromadná_zpráva”, který můžete rovněž používat k odkazování na tenhle formulář ve wikikódu vašich stránek.
- Do prvního pole zobrazeného formuláře, se zadává název předem připraveného distribučního seznamu. Těch seznamů může být uvedeno, podle potřeby, i více.
- Další pole je určeno pro text, který se použije na cílové diskuzní stránce pro záhlaví zprávy (též označované jako diskuzní „téma”). Stejný řetězec se objeví i jako shrnutí editace v přehledu změn příslušné diskuzní stránky, proto má omezenou velikost (na 240 bajtů).
- Formulářové pole zprávy může obsahovat libovolný wikitext a také má své náležitosti, takže počítejte s tím, že pokud bude obsahovat nějaké chyby, zobrazí se při náhledu zprávy upozornění. Viz pasáž #Kontrola obsahu formuláře
- Finally, we have the page to be sent as a message. This field accepts the name of the page, whose contents will be sent as a message to the users in the delivery list. If the body of the message is also provided, then the message will be appended at the end of the page content.
- If a page has been selected to be sent as a message, the section of the page control allows you to send a section of the selected page instead of the entire page. This control is a dropdown list that will populate with the list of sections in the selected page, once you hit the Preview button. Sections in the selected page are identified via the
<section begin="hello" /><section end="hello" />
tags. - Po vyplnění formuláře klikněte na tlačítko Náhled a uvidíte náhled zprávy, která se bude zapisovat.
- Stále ji můžete změnit a opakovaně generovat náhled, dokud nebudete spokojeni s výsledkem. Až pak kliněte na Odeslat, čímž předáte zprávu k distribuci. Ta již probíhá na pozadí, jak se postupně vyřizují na straně serveru naplánované úlohy.
- Chcete-li mít přehled o tom, kolik zpráv ještě čeká na doručení, přejděte v rámci vaší wiki na speciální stránku "Special:Statistics", která vám ukáže, kolik jich čeká ve frontě úloh na zpracování.
Pamatujte, že u výchozí konfigurace se bude automaticky u všech uživatelů měnit cílová stránka za jejich stránku diskuzní, takže i když uvedete v distribučním seznamu "User:Foo", bude zpráva zapsaná na stránku "User talk:Foo".
Také pamatujte na to, že pokud zprávu podepíšete jako obvykle čtyřmi tildami (~~~~
), vygeneruje se automaticky podpis bota (User:MediaWiki message delivery), který ji na cílovou stránku zapíše. Pokud tomu chcete zabránit a odkázat na svou vlastní stránku, použijte odkaz na vlastní uživatelskou stránku a přidejte za ni časové razítko: [[User:Example|]] ([[User talk:Example|talk]]) ~~~~~
.
Distribuce překládaných zpráv
Instrukce k tomu jak vytvořit a následně distribuovat zprávu, co může být překládána do jiných jazyků naleznete na stránce ohledně distribuce zpráv určených pro Newsletter na Meta-Wiki.
Distribuce překládané stránky
Using the Page to be sent as a message field (referred to as message page from here on) it is possible to send a page translated via the Translate extension as a message to pages listed in the delivery list. Nejprve vyberte ke vložení stránku ve výchozí jazykové verzi (u Meta-Wiki je obvykle v angličtině) a než dáte zprávu distribuovat, udělejte náhled. Na stránku ve výchozí jazykové verzi se přepnete, když ji zavoláte bez jazykového kódu. Ten mají v URL jen přeložené jazykové verze – její podstránky. For example, if you've marked a page TechBlog for translation, then TechBlog is the source page, and TechBlog/fr is the French translation, TechBlog/es is the Spanish translation and so on.
Each target page on the delivery list will receive the message in,
- The page content language of the target page, if the message page has been translated into that language.
- The fallback language, if the message page has been translated to that language. For example, if the page content language of a target page is
pt-br
, but the message page has not been translated topt-br
, then thept
version of the message page will be posted on the target page. - The source language of the page. This is the language from which the page is translated to other languages.
Choose a section of (translatable) page as a message or subject
It is possible to send sections of a (translatable) page as a message or subject to pages listed in the delivery list.
Sections in a page can be marked by using the <section>
tags. Section markup syntax is the same as with Labeled Section Transclusion. Example:
<!-- Has two sections: subject and body. -->
<!-- This page is marked for translation -->
<section begin="subject" />
<translate>
<!--T:1-->
Subject section
</translate>
<section end="subject" />
<section begin="body" />
<translate>
<!--T:2-->
Message section
<!--T:3-->
This is the body of the message that will be sent to the user.
<!--T:4-->
Can we handle this?
</translate>
<section end="body" />
Once a page is selected to be sent as a message, and the preview button is clicked, these sections will appear in the drop-downs:
- Section of the page to be sent as subject
- Section of the page to be sent as message
Select the appropriate section in each to send that as a subject or message.
When a section of the page is selected to be sent as subject then,
- Any custom subject provided will be ignored.
- Tags and newlines from the subject section will be stripped during the message delivery.
If a translatable page is selected to be sent as a message, this would allow localized subject and message to be delivered to the target page. Read Help:Extension:MassMessage#Sending_a_translated_message to understand how the target delivery language is determined.
Customizing
Each wiki from which messages are sent can require a footer to be added by editing "MediaWiki:Massmessage-message-footer".
Each wiki that receives messages, can edit "MediaWiki:Massmessage-hidden-comment" for similar functionality.
Kontrola obsahu formuláře
MassMessage attempts to check your input for common errors like improperly closed HTML tags. Currently, the following checks are in place:
- improperly closed HTML tags (requires JavaScript, shown immediately); and
- unescaped language links (e.g.,
[[de:Page name]]
, shown on preview).
Opting out
Any MassMessage delivery requires an input list, so removing yourself from whichever input list was used is the most straightforward way to opt out of a particular subscription. Usually the message being delivered will include an "unsubscribe" or "wrong page?" link.
If you want to exempt a page from any and all MassMessage deliveries, you can add the page to Category:Opted-out of message delivery
.
This string is localized (via MediaWiki:Massmessage-optout-category) and may be customized on your wiki, so check what the value of the page "MediaWiki:massmessage-optout-category" for the exact exclusion category being used locally.
If you want to exempt an entire wiki from any and all MassMessage deliveries, you can block the account used to deliver messages (on Wikimedia wikis, this account is "MediaWiki message delivery"). Blocking MassMessage deliveries would likely be considered highly disruptive. Be careful. Deliveries that were aborted due to the block (or any other restriction such as page protection) will be logged at Special:Log/massmessage.
Sledování změn
Jaké byly realizovány změny zjistíte přes Special:Log/massmessage. Také můžete navštívit stránku Special:Statistics, kde uvidíte kolik zpráv ještě čeká ve frontě na doručení (tedy pokud v ní ještě nějaké čekají).
Viz též
- m:MassMessage – stránka k použití rozšíření MassMessage na Meta-Wiki
- Seznam uživatelů na Meta-Wiki co mohou zapisovat globální zprávy