Help:扩展:群发消息

From mediawiki.org
This page is a translated version of the page Help:Extension:MassMessage and the translation is 53% complete.
Outdated translations are marked like this.

这是扩展:大量信息 的帮助页面,如果想要安装此扩展,请访问扩展的自述页面。

建立分发列表

有几种方法可以为群发消息功能创建交付列表:

生成交货清单的特殊页面(MediaWiki 1.24或更高版本)

请注意,创建传递列表要求用户具有“editcontentmodel”用户权限,默认情况下,当前版本的MediaWiki中不会向任何人(包括管理员)提供该权限(请参阅phab:T92795)。 在维基媒体项目中,只有管理员具有editcontentmodel权限。

MassMessage包含一个用于管理交货清单的特殊页面。 要创建新的交付列表,请转到Special:CreateMassMessageList。 您可以选择创建新列表,也可以从现有交货清单(任何格式)导入页面。 可以在查看传递列表时一次一个地直接添加或删除页面,编辑选项卡提供用于修改说明以及批量添加或删除页面的界面。

在批量编辑界面中,如果您的wiki是wiki系列的一部分,则其他wiki上的目标页面将以“title@site”格式指定(例如“Project:Noticeboard@en.wikipedia.org”)。 本地维基上的标题中带有“@”的页面也以这种方式指定以避免歧义(例如“Foo@bar @mediawiki.org”)。

Signpost订阅页面上查看一个真实示例。

生成交货清单的特殊页面(MediaWiki 1.23或更高版本)

MassMessage可以将消息传递到给定类别中允许的命名空间中的所有页面。 在发送消息时,只需指定分类(例如Category:Foo)作为交付列表。

解析器函数传递列表

您可以创建包含自定义格式的收件人列表的专用页面。每个用户名,项目等的格式如下:

{{#target:Project:Noticeboard}}

在这种情况下,页面名称为“Project:Noticeboard”。如果您使用维基农场设置并希望发布到另一个wiki上的页面,您将使用:

{{#target:Project:Noticeboard|en.wikipedia.org}}

此示例将发布到en.wikipedia.org上的“Project:Noticeboard”。

技术新闻订阅页面中查看一个真实示例。

维基数据MassMessage工具

对于维基媒体基金会wiki,您可以使用维基数据MassMessage工具生成基于维基数据项目的wikipages列表,准备好并格式化为MassMessage的交付列表。

发送消息

前往您维基的“Special:MassMessage”。

  1. The first input box is for the delivery list. Type in the full page name of the list you created in the previous step.
  2. 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.
  1. 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
  1. 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.
  2. 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.
  1. Hit Preview. This will load a preview of how your message will look on an example page.
  2. 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.
  3. You can visit "Special:Statistics" on your wiki to view how many messages are still queued in the job queue.

Note that the default 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". Also, note that if you sign the message with a normal signature (~~~~), 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: [[User:Example|]] ([[User talk:Example|talk]]) ~~~~~.

Sending a translated message

See Newsletters/Translation#Regular process for instructions on how to send a message that has been translated into many languages.

Sending a translated page as message

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. Select the source page as the message page, preview and then hit send. The source page is the base page under which all the translation pages reside as subpages. 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 to pt-br, then the pt 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.
The Translate extension need not be installed on the wiki where the target page is present.

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.

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.

自定义

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.

输入检查

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).

投递的可选项

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.

监视

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).

参阅