Расширение:Thanks

This page is a translated version of the page Extension:Thanks and the translation is 98% complete.
Это расширение поставляется с MediaWiki 1.40 и выше. Таким образом, вам не нужно загружать его снова. Тем не менее, вы всё равно должны следовать другим инструкциям.
Справка по расширениям MediaWiki
Thanks
Статус релиза: стабильно
Реализация Пользовательский интерфейс
Описание Позволяет участникам поблагодарить других участников за их правки и действия.
Автор(ы)
Последняя версия 1.2.0 (Continuous updates)
Политика совместимости Снэпшоты выходят вместе с MediaWiki. Мастер не имеет обратной совместимости.
MediaWiki >= 1.42
Лицензия MIT License
Скачать
  • $wgThanksAllowedLogTypes
  • $wgThanksConfirmationRequired
  • $wgThanksLogging
  • $wgThanksSendToBots
Ежеквартальные загрузки 45 (Ranked 94th)
Использование общедоступными вики 2,442 (Ranked 193rd)
Переведите расширение Thanks, если оно доступно на translatewiki.net
Роль Vagrant echo
Проблемы Открытые задачи · Сообщить об ошибке

Расширение Thanks добавляет быстрый способ дать положительный отклик на продуктивные действия на сайтах MediaWiki. Он позволяет пользователям отправлять публичные уведомления "спасибо" (посредством Echo ) другим пользователям за их индивидуальные редактирования и некоторые записанные действия.

Конкретный пересмотр, за который "благодарим", не хранится в публичной таблице регистрации. Только по дате, отправитель и получатель публично подписываются.

Ссылка «поблагодарить» добавляется в следующих местах:

  • рядом со ссылкой «отменить» при просмотре истории страницы и диффа;
  • у некоторых записей журнала на странице Служебная:Журналы (см. #Конфигурация ниже)
  • на досках обсуждений Flow, если соответствующее расширение установлено.

Также добавляется API для отправки благодарностей.

Обратите внимание, что если вы не хотите, чтобы вас благодарили, вы можете легко отключить это уведомление в своих настройках, как описано ниже.

Example of a 'thanks' notification

Как только у вас появится возможность опробовать ее, мы будем рады вашим отзывам об этой функции на странице обсуждения.

Мы надеемся, что уведомление "Спасибо" облегчит проявление признательности друг другу за работу - и оно должно быть особенно полезно для поощрения новых пользователей во время их первых критических шагов на вики. Мы намеренно сделали это уведомление максимально простым, чтобы мы могли оценить его и улучшить вместе. Наслаждайтесь...

Установка

Для получения благодарности требуется установка Echo extension в качестве предварительного условия.
  • Скачайте и распакуйте файл(ы) в папку с названием 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:

$wgThanksLogTypeWhitelist = [
	"contentmodel",
	"delete",
	"import",
	"merge",
	"move",
	"patrol",
	"protect",
	"tag",
	"managetags",
	"rights"
];

Использование

Чтобы поблагодарить другого пользователя, перейдите в раздел История любой страницы. Помимо каждого пересмотра будет указана ссылка "спасибо". Нажмите на ссылку, чтобы поблагодарить пользователя. Эта ссылка также доступна в разном виде, в некоторых записях в специальном:Логе, а также ниже комментариев на пластинках Flow, если Flow установлен.

При нажатии на ссылку "Поблагодарить" получатель получит уведомление с вашей благодарностью через расширение Echo (если только он не отказался от получения уведомлений с благодарностью). Запись о действии также записывается в виде записи в журнале по адресу Специальный:Журнал/спасибо.

Если в вики используется кэшированная память, устанавливается ограничение скорости не более 10 благодарностей в минуту для каждого пользователя. Ограничение можно настроить с помощью $wgRateLimits ['thanks-notification']igure.

Не желание благодарить

Чтобы не получать уведомления о благодарности, вы можете отказаться от них в своих предпочтениях уведомления. Перейдите на вкладку Уведомления в ваших настройках. Это только мешает вам получать уведомления, но не мешает пользователям думать о вас.

Документация по API

Расширение "Спасибо" включает 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 имеется в наличии.

Большая благодарность

Есть отдельный 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 указан правильный индекс.


См. также