Справка:Расширение:MassMessage
Это справочная страница для использования расширения MassMessage. Для инструкций по установке, пожалуйста, посетите страницу документации расширения.
Создание списков рассылки
Есть несколько способов создания списков рассылки для MassMessage:
Специальная страница для создания списков рассылки (MediaWiki 1.24 или более поздний)
Имейте в виде, что создание списков рассылки требует от пользователя наличия прав "editcontentmodel" (см. phab:T92795). На большинстве проектов Викимедиа только администраторы имеют права editcontentmodel.
MassMessage включает специальную страницу для управления списками рассылки. Чтобы создать новый список рассылки, перейдите в "Special:CreateMassMessageList" на своей вики. Вы можете выбрать создание нового списка или импортировать страницы из существующего списка рассылки (в любом формате). Страницы могут быть добавлены или удалены по одной при просмотре списков рассылки, а в вкладке "Править" предоставляется интерфейс для изменения описания и для добавления или удаления страниц в большом количестве.
В интерфейсе массового редактирования, если ваша вики является частью семьи вики, целевые страницы на других вики определяются в формате "title@site" (например, "Project:Noticeboard@en.wikipedia.org"). Страницы на локальной вики с "@" в названиях также указаны таким образом, чтобы избежать двусмысленности (например, "Foo@bar@mediawiki.org").
См. реальный пример на странице подписки Signpost.
Категории списков рассылки (MediaWiki 1.23 или более поздний)
MassMessage может доставлять сообщения на все страницы в разрешенных пространствах имен в данной категории. Просто укажите категорию (например, Category:Foo) в качестве списка доставки при отправке сообщения.
Списки рассылки по функции парсера
Вы можете создать специальную страницу, содержащую список пользователей-получателей. Формат каждого имени пользователя, проекта и т.д. следующий:
{{#target:Project:Noticeboard}}
В этом случае название страницы — "Project:Noticeboard". Если вы находитесь на настройке wikifarm и хотите разместить сообщение на странице на другой вики, вы можете использовать:
{{#target:Project:Noticeboard|en.wikipedia.org}}
Этот пример будет размещен в "Project:Noticeboard" на en.wikipedia.org.
См. реальный пример на странице подписки Tech News.
Инструмент MassMessage Викиданных
Для вики Викимедиа вы можете использовать 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:Foo", то сообщение будет опубликовано на "User talk:Foo".
Также обратите внимание, что если вы подпишите сообщение обычной подписью (~~~~), будет отображаться имя пользователя бота (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 theptversion 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:Page name]], показанные в превью).
Отключение
Любая рассылка MassMessage требует вводного списка, поэтому удаление себя из любого вводного листа, который был использован, является самым простым способом отказаться от конкретной подписки. Обычно сообщение, которое будет доставлено, будет включать ссылку "отменить подписку" или "неправильная страница?".
Если вы хотите исключить страницу из любых и всех списков рассылки MassMessage, вы можете добавить страницу на Category:Opted-out of message delivery.
Эта строка локализована (через MediaWiki:Massmessage-optout-category) и может быть настроена на вашей вики, так что проверьте содержимое страницы "MediaWiki:massmessage-optout-category" для конкретного исключения категории, используемой локально.
Если вы хотите освободить всю Вики от любых и всех рассылок MassMessage, вы можете заблокировать учетную запись, используемую для доставки сообщений (на вики Викимедиа эта учетная запись называется "MediaWiki message delivery"). Блокирование рассылки MassMessage скорее всего будет воспринято как серёзное нарушение. Будьте осторожны. Рассылки, которые были отменены из-за блокировки (или любого другого ограничения, такого как защита страниц), будут записываться на Special:Log/massmessage.
Наблюдение
Для наблюдения за инструментом вы можете использовать Special:Log/massmessage. Также вы можете посетить Special:Statistics чтобы узнать сколько в очереди сообщений (если таковые вообще есть).