說明:擴充功能:MassMessage(群發訊息)
這是大量訊息擴充功能的說明頁面。安裝說明請參閱擴充功能的文件頁面。
建立分發清單
有幾種方法可以為群發訊息功能建立分發清單:
生成分發清單的特殊頁面(MediaWiki 1.24或更高版本)
請注意,建立分發清單會要求使用者必需具有「editcontentmodel」使用者權限(請參閱phab:T92795)。 在大部分維基媒體專案中,只有管理員具有editcontentmodel權限。
群發訊息包含一個用於管理分發清單的特殊頁面。 要新增的分發清單,請前往你的wiki上的「Special:CreateMassMessageList」。 您可以選擇建立一個新的清單,也可以從現有分發清單(任何格式)匯入頁面。 你可以在檢視分發清單時一次一個地直接添加或刪除頁面,編輯索引標籤有提供用於修改說明以及批次添加或刪除頁面的介面。
在批次編輯介面中,如果您的wiki是wiki系列的一部分,則其他wiki上的目標頁面將以「title@site」格式指定(例如「Project:Noticeboard@en.wikipedia.org」)。 本地維基上的標題中帶有「@」的頁面也以這種方式指定以避免歧義(例如「Foo@bar @mediawiki.org」)。
可在Signpost訂閱頁面上檢視一個真實範例。
將分發清單分類(MediaWiki 1.23或更高版本)
群發訊息可將訊息傳遞到指定類別中所允許的命名空間中的所有頁面。 在傳送訊息時,只需指定分類(例如Category:Foo)作為交付列表。
解析器函數的分發清單
您可以建立包含自訂格式的收件人列表的專用頁面。每個使用者名稱,專案等的格式如下:
{{#target:Project:Noticeboard}}
在這種情況下,頁面名稱為「Project:Noticeboard」。如果您在某個維基農場的設定並希望發布到另一個wiki上的頁面,您可以使用:
{{#target:Project:Noticeboard|en.wikipedia.org}}
此範例會發布到en.wikipedia.org上的「Project:Noticeboard」。
可在「技術新聞」的訂閱頁面中檢視一個真實範例。
維基數據的群發訊息工具
對於維基媒體基金會wiki,您可以使用維基數據的MassMessage工具去生成基於維基數據項目的維基頁面列表,準備好並格式化為群發訊息的分發清單。
傳送一則訊息
請前往您維基的「Special:MassMessage」。
- 第一個輸入框用於填寫分發清單。請輸入您在上一步驟所建立的完整頁面名稱的清單。
- 接著是訊息的主旨欄位,此欄位同時會作為編輯摘要使用。鑑於此原因,其輸入長度被限制為240位元組。
- 接下來是訊息的正文。此欄位接受任何有效的維基文字格式,但若偵測到錯誤輸入,可能會發出警告。詳見 #輸入檢查
- 最後,我們獲得了要傳送為訊息的頁面。 此欄位接受頁面的名稱,其內容將作為訊息傳送給分發清單中的使用者。 若同時提供訊息正文,則該訊息將附加於頁面內容末尾。
- 若已選取頁面作為訊息內容,頁面控制區段可讓您傳送選取頁面的一部份,而非整頁內容。 此控制區段為下拉式清單,當您按下預覽按鈕後,將顯示所選頁面中的所有區段清單。 選取頁面中的區段透過
<section begin="hello" /><section end="hello" />標籤進行標識。 - 點擊預覽。這將載入訊息在範例頁面上的顯示效果。
- 您現在可以修改訊息然後再次預覽、若您對內容滿意則點擊傳送。此操作將把訊息加入傳送佇列。
- 您可造訪維基的「特殊頁面:統計」檢視仍有多少訊息佇列於工作佇列中。
請注意,預設的組態會自動將所有使用者頁面轉換為使用者討論頁面——若您在分發清單中指定「User:Foo」,訊息將被張貼至「User talk:Foo」。
此外,請注意若使用普通簽名(~~~~)來簽署訊息,機器人使用者名稱(User:MediaWiki message delivery)將會顯示;欲避免此情況,請透過連結至您的使用者頁面並添加一個時間戳記來類比普通簽名:[[User:Example|]] ([[User talk:Example|talk]]) ~~~~~。
傳送一則翻譯的訊息
請參閱 電子報/翻譯#常規流程 以了解如何傳送已翻譯成多種語言的訊息。
傳送一則翻譯的頁面做為訊息
使用「作為訊息傳送的頁面」欄位(以下簡稱「訊息頁面」),可將一個經由翻譯擴充功能轉換的頁面,以訊息形式傳送至分發清單中所列出的頁面。
選擇「來源頁面」作為訊息頁面,預覽後按下傳送。
來源頁面是所有翻譯頁面作為子頁面所依附的基礎頁面。
例如,若您標記了頁面TechBlog進行翻譯,則TechBlog為原始頁面,TechBlog/fr為法文譯本,TechBlog/es為西班牙文譯本,以此類推。
在分發清單上的每個目標頁面的下列位置,都將收到訊息:
- 目標頁面的頁面內容語言,若訊息頁面已翻譯成該語言。
- 備用語言,若訊息頁面已翻譯成該語言。 例如,若目標頁面的內容語言為
pt-br,但訊息頁面尚未翻譯成pt-br語言版本,則該訊息頁面的pt語言版本將顯示於目標頁面。 - 該頁面的原始語言。 這是將頁面翻譯成其他語言的原始語言。
選擇頁面中(可翻譯的)區段作為訊息或主題
可將(可翻譯)頁面的區段作為訊息或主題,傳送至交付清單中列出的頁面。
頁面中的區段可透過使用<section>標籤來標示。
區段標記語法與 Labeled Section Transclusion 相同。
例如:
<!-- 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" />
一旦頁面被選作為訊息傳送、並點擊預覽按鈕後,以下區塊將出現在下拉選單中:
- 將作為主旨傳送的頁面區段
- 將作為訊息傳送的頁面區段
在每個選項中選擇適當的區段,將其作為主旨或訊息內容傳送。

當頁面的某個區段被選中作為主旨傳送時,
- 任何自訂的主旨欄位都將被忽略。
- 主旨欄位中的標籤與換行字元號將在郵件傳遞過程中被移除。
若選擇將可翻譯頁面作為訊息傳送,此功能將允許將在地化的主旨與內容傳遞至目標頁面。 請閱讀說明:擴充功能:MassMessage(群發訊息)以了解目標分發的語言是如何被確定的。
自訂
每個傳送訊息的維基皆可編輯 MediaWiki:Massmessage-message-footer 來要求添加一個頁尾。
每個接收訊息的維基皆可編輯 MediaWiki:Massmessage-hidden-comment 來實現類似的功能。
輸入檢查
群發訊息會嘗試檢查您的輸入內容是否存在例如未正確關閉的HTML標籤這種常見的錯誤。目前已實施以下的檢查項目:
- 未正確關閉的HTML標籤(需啟用JavaScript,可以立即顯示);以及
- 未轉義的語言連結(例如:
[[de:Page name]],會在預覽時顯示)。
登出
任何群發訊息的傳送都需要一個輸入清單,因此從所使用的輸入清單中移除自己,是登出某個特定的訂閱的最直接方式。通常被傳送的訊息中都會包含一個「取消訂閱」或「頁面錯誤?」的連結。
若你想要在所有群發訊息的配送清單中免除某個頁面,可將該頁面加入到 Category:Opted-out of message delivery 之中。
此字串已透過 MediaWiki:Massmessage-optout-category 進行在地化處理,並可在您的維基上自訂,因此請查閱頁面 MediaWiki:massmessage-optout-category 的值以確認當地實際使用的排除類別。
若您想要在所有群發訊息的傳送中免除整個維基,可封鎖用於傳遞訊息的帳戶(在維基媒體的維基上,此帳戶名為「MediaWiki message delivery」)。 封鎖群發訊息的傳送很可能會被視為高度破壞性的行為。 請注意。因封鎖(或任何其他限制,例如頁面保護)而中止的傳送,會被記錄於 Special:Log/massmessage。
監視
您可以使用 Special:Log/massmessage 來監控此工具。您亦可造訪 Special:Statistics 檢視佇列中的訊息數量(如有的話)。