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」に移動してください。
- 最初の入力欄には配信先のリストを入れます。前のステップで作ったリストの完全なページ名を入力してください。
- 次はメッセージの題名です。これは要約欄に入ります。このため、240バイトまでに制限されています。
- 最後はメッセージ本文です。ここでは妥当なウィキテキストであればすべて使用できますが、誤りがある場合は警告が表示されることがあります。#入力内容の確認をご覧ください。
- 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. - プレビューを押します。表示例のページでメッセージがどう表示されるかのプレビューが読み込まれます。
- メッセージを変更して再びプレビューを表示できます。メッセージが完成したら、送信を押します。メッセージは配送のキュー (待ち列) に並びます。
- 自分のウィキの「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 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.
メッセージまたは件名として(翻訳可能な)ページのセクションを選択する
メッセージとして (翻訳可能な) ページのセクションを送信したり、配送リストに記載されているページに送信することも可能です。
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.
カスタマイズ
メッセージを送信する側の各ウィキでは、「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 で確認することもできます (ある場合)。