View source for Help:Extension:MassMessage/pt-br

<languages />
Esta é uma página de ajuda para a utilização da extensão {{ll|Extension:MassMessage|nsp=0}}. Para instruções de instalação, por favor, consulte a página de documentação da extensão.

<span id="Creating_delivery_lists"></span>
== Criação de listas de entrega ==

Existem várias maneiras de criar listas de entrega para MassMessage:

<span id="Special_page_to_produce_delivery_lists_(MediaWiki_1.24_or_later)"></span>
=== Página especial para criar listas de entrega (MediaWiki 1.24 ou superior) ===

''<span class="mw-translate-fuzzy">Observe que a criação de listas de entrega requer que o usuário tenha o direito de usuário "editcontentmodel", que por padrão não é concedido a ninguém, incluindo administradores de sistemas, nas versões atuais do MediaWiki (veja [[phab:T92795]]).</span> <span lang="en" dir="ltr" class="mw-content-ltr">On most Wikimedia projects, only sysops have editcontentmodel rights.</span>''

<span lang="en" dir="ltr" class="mw-content-ltr">MassMessage includes a special page for managing delivery lists.</span>
<span lang="en" dir="ltr" class="mw-content-ltr">To create a new delivery list, go to "Special:CreateMassMessageList" on your wiki.</span>
<span lang="en" dir="ltr" class="mw-content-ltr">You can choose to create a new list, or to import pages from an existing delivery list (in any format).</span>
<span lang="en" dir="ltr" class="mw-content-ltr">Pages can be directly added or removed one at a time when viewing delivery lists, and the Edit tab provides an interface for modifying the description and for adding or removing pages in bulk.</span>

<span lang="en" dir="ltr" class="mw-content-ltr">In the bulk editing interface, if your wiki is part of a wiki family, target pages on other wikis are specified in the format "title@site" (e.g. "Project:Noticeboard@en.wikipedia.org").</span>
<span lang="en" dir="ltr" class="mw-content-ltr">Pages on the local wiki with "@" in their titles are also specified in this manner to avoid ambiguity (e.g. "Foo@bar@mediawiki.org").</span>

<div lang="en" dir="ltr" class="mw-content-ltr">
See a real example at [//en.wikipedia.org/w/index.php?title=Wikipedia:Wikipedia_Signpost/Subscribe ''Signpost'' subscription page].
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Category delivery lists (MediaWiki 1.23 or later) ===
</div>
<span lang="en" dir="ltr" class="mw-content-ltr">MassMessage can deliver messages to all pages in allowed namespaces in a given category.</span>
<span lang="en" dir="ltr" class="mw-content-ltr">Simply specify the category (e.g. Category:Foo) as the delivery list when sending a message.</span>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Parser function delivery lists ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
You can create a dedicated page containing a custom formatted list of recipients. The format of each username, project, etc. is as follows:
</div>

<pre>
{{#target:Project:Noticeboard}}
</pre>

<div lang="en" dir="ltr" class="mw-content-ltr">
In this case, the page name is "Project:Noticeboard". If you are on a wikifarm setup and wish to post to a page on another wiki, you would use:
</div>

<pre>
{{#target:Project:Noticeboard|en.wikipedia.org}}
</pre>

<div lang="en" dir="ltr" class="mw-content-ltr">
This example would post to "Project:Noticeboard" on en.wikipedia.org.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
See a real example at [[m:Global message delivery/Targets/Tech ambassadors|''Tech News'' subscription page]].
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Wikidata MassMessage tool ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
For Wikimedia wikis, you can use [[m:Wikidata MassMessage tool|Wikidata MassMessage tool]] to generate a list of wikipages, based on Wikidata items, ready and formatted as a delivery list for MassMessage.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
== Sending a message ==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Go to "Special:MassMessage" on your wiki.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
# The first input box is for the delivery list. Type in the full page name of the list you created in the previous step.
# Next is the subject of the message, which will also be used as the edit summary. For this reason, it is limited to 240 bytes.
</div>
<div lang="en" dir="ltr" class="mw-content-ltr">
# Next up, is the body of the message. This field accepts any valid wikitext, but it may warn you if it notices bad input. See [[#Input checking|#Input checking]]
</div>
# 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 <code><nowiki><section begin="hello" /><section end="hello" /></nowiki></code> tags.
<div lang="en" dir="ltr" class="mw-content-ltr">
# Hit Preview. This will load a preview of how your message will look on an example page.
# You can now either modify the message and preview it again, or if you are satisfied with your message, hit send. This will queue your delivery.
# You can visit "Special:Statistics" on your wiki to view how many messages are still queued in the [[Special:MyLanguage/Manual:Job queue|job queue]].
</div>

<span lang="en" dir="ltr" class="mw-content-ltr">Note that the default [[Special:MyLanguage/Extension:MassMessage#Configuration parameters|configuration]] will automatically convert all user pages into user talk pages—if you specify "User:Foo" in a delivery list, the message will be posted to "User talk:Foo".</span>
<span lang="en" dir="ltr" class="mw-content-ltr">Also, note that if you sign the message with a normal signature (<code><nowiki>~~~~</nowiki></code>), the username of the bot (User:MediaWiki message delivery) will appear; to prevent this, mimic a normal signature by linking to your user page and adding a timestamp: <code><nowiki>[[User:Example|]] ([[User talk:Example|talk]]) ~~~~~</nowiki></code>.</span>

<div lang="en" dir="ltr" class="mw-content-ltr">
== Sending a translated message ==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
See [[m:Special:MyLanguage/Newsletters/Translation#Regular process|Newsletters/Translation#Regular process]] for instructions on how to send a message that has been translated into many languages.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
== Sending a translated page as message ==
</div> 
Using the ''Page to be sent as a message'' field (referred to as ''message page'' from here on) it is possible to send a [[Special:MyLanguage/Help:Extension:Translate/Page_translation_example|page translated via the Translate extension]] as a message to pages listed in the delivery list.
<span lang="en" dir="ltr" class="mw-content-ltr">Select the ''source page'' as the message page, preview and then hit send.</span>
<span lang="en" dir="ltr" class="mw-content-ltr">The source page is the base page under which all the translation pages reside as subpages.</span>
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.

<div lang="en" dir="ltr" class="mw-content-ltr">
Each target page on the delivery list will receive the message in,
</div>

* The [[Special:MyLanguage/Manual:Language#Page_content_language|page content language]] of the target page, if the message page has been translated into that language.
* The [[Special:MyLanguage/Manual:Language#Fallback_languages|fallback language]], if the message page has been translated to that language. For example, if the page content language of a target page is <code>pt-br</code>, but the message page has not been translated to <code>pt-br</code>, then the <code>pt</code> 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.

{{note|1=The Translate extension need not be installed on the wiki where the target page is present.}}

<div lang="en" dir="ltr" class="mw-content-ltr">
== Choose a section of (translatable) page as a message or subject ==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
It is possible to send sections of a (translatable) page as a message or subject to pages listed in the delivery list.
</div>

Sections in a page can be marked by using the <code><nowiki><section></nowiki></code> tags. Section markup syntax is the same as with [[Extension:Labeled_Section_Transclusion|Labeled Section Transclusion]]. Example:

{{#tag:syntaxhighlight|
{{^(}}!-- 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" /{{)^}}
|lang=html}}

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. 

[[File:MassMesage Screenshot of section being sent.png|thumb|Sections from a page selected to be sent as message and subject]]

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. 

<div lang="en" dir="ltr" class="mw-content-ltr">
== Customizing ==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Each wiki from which messages are sent can require a footer to be added by editing "MediaWiki:Massmessage-message-footer".
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Each wiki that receives messages, can edit "MediaWiki:Massmessage-hidden-comment" for similar functionality.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
== Input checking ==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
MassMessage attempts to check your input for common errors like improperly closed HTML tags. Currently, the following checks are in place:
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
* improperly closed HTML tags (requires JavaScript, shown immediately); and
</div>
<div lang="en" dir="ltr" class="mw-content-ltr">
* unescaped language links (e.g., <code><nowiki>[[de:Page name]]</nowiki></code>, shown on preview).
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
== Opting out ==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<span lang="en" dir="ltr" class="mw-content-ltr">If you want to exempt a page from any and all MassMessage deliveries, you can add the page to <code>[[:Category:Opted-out of message delivery]]</code>.</span>
<span lang="en" dir="ltr" class="mw-content-ltr">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.</span>

<span lang="en" dir="ltr" class="mw-content-ltr">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").</span>
<span lang="en" dir="ltr" class="mw-content-ltr">Blocking MassMessage deliveries would likely be considered highly disruptive.</span>
<span lang="en" dir="ltr" class="mw-content-ltr">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.</span>

<div lang="en" dir="ltr" class="mw-content-ltr">
== Monitoring ==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
You can use [[Special:Log/massmessage]] to monitor the tool. You can also visit [[Special:Statistics]] to see how many queued messages there are (if any).
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
== See also ==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
* [[m:Special:MyLanguage/MassMessage|m:MassMessage]]
</div>
<div lang="en" dir="ltr" class="mw-content-ltr">
* [[m:Special:ListUsers/massmessage-sender|List of people with MM sending user rights]]
</div>

[[Category:Extension help{{#translation:}}]]