Help:Extension:MassMessage

このページは、MassMessage 拡張機能の使用法についてのヘルプ ページです。インストール手順については、拡張機能の説明文書を参照してください。

配信先リストの作成

MassMessage の配信リストを作成する方法はいくつかあります:

カテゴリ配信リスト(MediaWiki 1.24 以降)

配信リストを作成するには、利用者が「editcontentmodel」利用者権限を持っている必要があります (phab:T92795 参照)。 ウィキメディアプロジェクトでは、管理者のみが編集権を持っています。

MassMessageでは、配信リストを管理するための専用の特別ページが追加されます。 新しい配信リストの作成は、 お使いのウィキで"Special:CreateMassMessageList" を開きます。 新しいリストを作成するか、既存の配信リストからページをインポートするかを選択できます (任意の形式で)。 配信リストを表示する際には、ページを直接 1 つずつ追加/除去でき、編集タブでは説明の変更や一括でページの追加/除去を行うためのインターフェイスが提供されています。

一括編集インターフェースでは、ウィキがウィキファミリーの一部である場合、他のウィキのターゲットページは「title @ site」の形式で指定されます（例：「Project：Noticeboard@en.wikipedia.org」）。 タイトルに「@」が含まれるローカルウィキのページも、曖昧さを避けるためにこのように指定されます (例: "Foo@bar@mediawiki.org")。

実際の例はSignpost 購読ページで確認できます。

カテゴリ配信リスト(MediaWiki 1.23 以降)

MassMessageは、特定のカテゴリで許可されている名前空間のすべてのページにメッセージを配信できます。 メッセージを送信するときに、配信リストとしてカテゴリ（Category：Fooなど）を指定するだけです。

配信先リストの作成

カスタム フォーマットの受信者リストを含む専用のページを作成することもできます。利用者名、プロジェクトなどの形式は次のようになります:

{{#target:Project:Noticeboard}}

この場合、ページ名は「Project:Noticeboard」です。ウィキファームが有効な状態で、別のウィキのページにメッセージを送信したい場合は、以下の書き方を使用します:

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

この例では en.wikipedia.org の「Project:Noticeboard」にメッセージを送信します。

実際の例は Tech News 購読ページで確認できます。

ウィキデータMassメッセージツール

ウィキメディアの場合は、Wikidata MassMessage tool を使ってウィキデータを元にウィキページのリストを作成し、MassMessage用の配信リストとして整形することができます。

メッセージの送信

自分のウィキの「Special:MassMessage」に移動してください。

1. 最初の入力欄には配信先のリストを入れます。前のステップで作ったリストの完全なページ名を入力してください。
2. 次はメッセージの題名です。これは要約欄に入ります。このため、240バイトまでに制限されています。
3. 最後はメッセージ本文です。ここでは妥当なウィキテキストであればすべて使用できますが、誤りがある場合は警告が表示されることがあります。#入力内容の確認をご覧ください。
4. 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.
5. 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.
6. プレビューを押します。表示例のページでメッセージがどう表示されるかのプレビューが読み込まれます。
7. メッセージを変更して再びプレビューを表示できます。メッセージが完成したら、送信を押します。メッセージは配送のキュー (待ち列) に並びます。
8. 自分のウィキの「Special:Statistics」で、ジョブキュー内に並んでいるメッセージの件数を確認できます。

既定の設定では利用者ページはすべて利用者トークページに変換されることにご注意ください - 例えば配信リストに「User:Example」と登録すると、メッセージは利用者ページ「User talk:Example」に投稿されます。 また、通常の署名(~~~~)でメッセージに署名すると、ボットの利用者名(User:MediaWiki message delivery)が表示されることに注意してください。これを防ぐには、利用者ページにリンクしてタイムスタンプ([[User:Example|]] ([[User talk:Example|talk]]) ~~~~~)を追加し、通常の署名を書いてください。

メッセージの送信

多言語に翻訳されたメッセージを送る方法については、Newsletters/Translation#Regular processをご覧ください。

メッセージの送信

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. メッセージページからソースページを選択し、プレビューしてから送信を押します。 ソースページは、すべての翻訳ページがサブページとして存在するベースページです。 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.

送信リストのターゲットページは

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

メッセージまたは件名として（翻訳可能な）ページのセクションを選択する

メッセージとして (翻訳可能な) ページのセクションを送信したり、配送リストに記載されているページに送信することも可能です。

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.

カスタマイズ

メッセージを送信する側の各ウィキでは、「MediaWiki:Massmessage-message-footer」を編集することで、フッターを追加できます。

メッセージを受信する側の各ウィキでは、「MediaWiki:Massmessage-hidden-comment」を編集することで、同様の機能を使用できます。

入力内容の確認

MassMessageは、不正に閉じられたHTMLタグなどの一般的なエラーをチェックします。現在、以下のチェックが実施されています。

• HTMLタグが不適切に閉じられました。(JavaScriptが必要です。)
• エスケープされていない言語リンク (例えば、[[de:ページ名]]、プレビューに表示されます)。

オプトアウト

MassMessageの配信には入力リストが必要です。ですから、どの入力リストを使ってもそのリストから削除することは、特定のサブスクリプションを削除する最も簡単な方法です。通常、送られるメッセージには"登録解除"または"間違ったページ"のリンクが含まれます。

MassMessageの配信をすべて解除したい場合はCategory:Opted-out of message deliveryにページを追加できます。 この文字列は(MediaWiki:massmessage-optout-categoryによって)ローカライズされ、あなたのwikiでカスタマイズされるかもしれません。ローカルで使用されている正確な除外カテゴリについて "MediaWiki:massmessage-optout-category"ページを確認して下さい。

MassMessageの配信全体を解除したい場合は、メッセージ配信に使用されたアカウントをブロックできます (ウィキメディアの場合、このアカウントは "MediaWiki massage delivery" です。)。 MassMessageをブロックすることは 極めて非建設的と考えられるでしょう。 注意するべきは、ブロック (ページ保護などの他の制限) によって送信されなかった配信は、Special:Log/massmessageに追加されます。

動作の監視

このツールの動作を Special:Log/massmessage で監視できます。キューで待機しているメッセージ数を Special:Statistics で確認することもできます (ある場合)。

関連ページ

• m:一斉メッセージ
• Massmessage送信権限を持つ方へのリスト。