Расширение:Thanks
Thanks Статус релиза: стабильно |
|
---|---|
Реализация | Пользовательский интерфейс |
Описание | Позволяет участникам поблагодарить других участников за их правки и действия. |
Автор(ы) |
|
Последняя версия | 1.2.0 (Continuous updates) |
Политика совместимости | Снэпшоты выходят вместе с MediaWiki. Мастер не имеет обратной совместимости. |
Лицензия | MIT License |
Скачать | |
|
|
Ежеквартальные загрузки | 23 (Ranked 107th) |
Использование общедоступными вики | 2,442 (Ranked 193rd) |
Переведите расширение Thanks, если оно доступно на translatewiki.net | |
Роль Vagrant | echo |
Проблемы | Открытые задачи · Сообщить об ошибке |
Расширение Thanks добавляет быстрый способ дать положительный отклик на продуктивные действия на сайтах MediaWiki. Он позволяет пользователям отправлять публичные уведомления "спасибо" (посредством Echo ) другим пользователям за их индивидуальные редактирования и некоторые записанные действия.
Конкретный пересмотр, за который "благодарим", не хранится в публичной таблице регистрации. Только по дате, отправитель и получатель публично подписываются.
Ссылка «поблагодарить» добавляется в следующих местах:
- рядом со ссылкой «отменить» при просмотре истории страницы и диффа;
- у некоторых записей журнала на странице Служебная:Журналы (см. #Конфигурация ниже)
- на досках обсуждений Flow, если соответствующее расширение установлено.
Также добавляется API для отправки благодарностей.
Обратите внимание, что если вы не хотите, чтобы вас благодарили, вы можете легко отключить это уведомление в своих настройках, как описано ниже.
Как только у вас появится возможность опробовать ее, мы будем рады вашим отзывам об этой функции на странице обсуждения.
Мы надеемся, что уведомление "Спасибо" облегчит проявление признательности друг другу за работу - и оно должно быть особенно полезно для поощрения новых пользователей во время их первых критических шагов на вики. Мы намеренно сделали это уведомление максимально простым, чтобы мы могли оценить его и улучшить вместе. Наслаждайтесь...
Установка
- Скачайте и распакуйте файл(ы) в папку с названием
Thanks
в вашей папкеextensions/
.
Вместо этого разработчикам и соавторам кода следует установить расширение из Git, используя:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/Thanks - Добавьте следующий код в конце вашего файла LocalSettings.php :
wfLoadExtension( 'Thanks' );
- Настройте на свой манер при необходимости
- Перейдите к действию "История" страницы, чтобы увидеть новый интерфейс "Спасибо".
- Готово – Перейдите на страницу Special:Version на своей вики, чтобы удостовериться в том, что расширение успешно установлено.
Конфигурация
Включить интерфейс Thank для редактирования ботов (отключен по умолчанию)
$wgThanksSendToBots = false;
Запись Благодарить действия в "Специальный:Запись" (по умолчанию включен)
$wgThanksLogging = true;
Необходимо ли подтверждение для отправки благодарности (по умолчанию включено)
$wgThanksConfirmationRequired = true;
Типы записей в журнале, которые можно поблагодарить из Special:Log:
$wgThanksAllowedLogTypes = [
"contentmodel",
"delete",
"import",
"merge",
"move",
"patrol",
"protect",
"tag",
"managetags",
"rights"
];
Использование
Чтобы поблагодарить другого пользователя, перейдите в раздел История любой страницы. Помимо каждого пересмотра будет указана ссылка "спасибо". Нажмите на ссылку, чтобы поблагодарить пользователя. Эта ссылка также доступна в разном виде, в некоторых записях в специальном:Логе, а также ниже комментариев на пластинках Flow, если Flow установлен.
При нажатии на ссылку "Поблагодарить" получатель получит уведомление с вашей благодарностью через расширение Echo (если только он не отказался от получения уведомлений с благодарностью). Запись о действии также записывается в виде записи в журнале по адресу Специальный:Журнал/спасибо.
Если в вики используется кэшированная память, устанавливается ограничение скорости не более 10 благодарностей в минуту для каждого пользователя. Ограничение можно настроить с помощью $wgRateLimits ['thanks-notification']
igure.
Не желание благодарить
Чтобы не получать уведомления о благодарности, вы можете отказаться от них в своих предпочтениях уведомления. Перейдите на вкладку Уведомления в ваших настройках. Это только мешает вам получать уведомления, но не мешает пользователям думать о вас.
Документация по API
thank | |
---|---|
Этот модуль не может быть использован в качестве генератора. | |
Префикс | |
Необходимые права | нет |
Только POST? | Да |
Генерируемая справка | Текущее |
Расширение "Спасибо" включает API для отправки благодарности. Для вызова API используйте параметр action=thank
.
Параметры:
rev
- Идентификатор пересмотра, за который вы хотите поблагодарить кого-то (у вас требуется это илиlog
)log
- Идентификатор дневного дня, за который вы хотите поблагодарить кого-то (у вас требуется это илиrev
)source
- Источник события thank. Это короткая строка, которая определяет, откуда была отправлена благодарность. Например, если благодарность была отправлена с Huggle Huggle, значением может быть 'huggle'. (опционально)token
- Edit token (a.k.a. CSRF token). Вы можете получить один из них через tokens API. (required)
Пример:
api.php?action=thank&rev=16543&token=%2B\
Чтобы отправить благодарность только OAuth , "Basic" grant permission is required. A python example имеется в наличии.
Большая благодарность
flowthank | |
---|---|
Этот модуль не может быть использован в качестве генератора. | |
Префикс | |
Необходимые права | нет |
Только POST? | Да |
Генерируемая справка | Текущее |
Есть отдельный API для отправки благодарности за комментарии на панелях потока. Чтобы вызвать API, используйте action=flowthank
.
Параметры:
postid
- UUID комментария, за который следует поблагодарить (required)token
- Edit token.Вы можете получить один из них через prop=info. (желательно)
Пример:
api.php?action=flowthank&postid=abc123&token=%2B\
Ошибки и предупреждения
Код | Информация |
---|---|
invalidrecipient | Не найдено корректного получателя Нельзя поблагодарить ботов Вы не можете поблагодарить сами себя |
SQL документация
Чтобы понять, кто поблагодарил кого из журналов, нужно немного понять колонны.
В таблице logging log_title
представляет получателя, а log_user_text
- отправителя.
Следующий SQL, который находит все благодарности, полученные получателем в течение определенного периода времени, иллюстрирует это:
select log_timestamp as thank_timestamp,
replace(log_title, '_', ' ') as receiver,
log_user_text as sender
from logging_logindex
where log_title = :user_name
and log_action = 'thank'
and :start_date <= log_timestamp
and log_timestamp <= :end_date
Обратите внимание, что таблица logging не выбирается из прямого, но на серверах Викимедиа мы используем таблицу logging_logindex
.
Для быстрого поиска всех благодарностей, которые пользователь "отправил", в logging_userindex
указан правильный индекс.
См. также
- w:Wikipedia:Notifications/Thanks - Информация о использовании этого расширения на английской Википедии
- Echo (Notifications)/Feature requirements#Thank_you_notification - Предложение первоначальных особенностей (для расширения Echo)
- Расширение:ВикиСимпатия - Еще одно продление за посылку благодарности
- Расширение:Echo - Создает систему уведомления
Это расширение используется в одном или нескольких проектах Викимедиа. Вероятно, это означает, что расширение стабильно и работает достаточно хорошо, чтобы использоваться такими сайтами с высоким трафиком. Найдите название этого расширения в файлах конфигурации Викимедиа CommonSettings.php и InitialiseSettings.php, чтобы узнать, где оно установлено. Полный список расширений, установленных на конкретной вики, можно увидеть на странице Special:Version wiki. |
Это расширение включено в следующие вики-фермы/хостинги и/или пакеты: Это не исчерпывающий список. Некоторые вики-фермы/хостинги и/или пакеты могут содержать это расширение, даже если они не перечислены здесь. Всегда сверяйтесь со своими вики-фермами/хостингами или комплектами/бандлами для подтверждения. |