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

This page is a translated version of the page Extension:Thanks and the translation is 98% complete.
This extension comes with MediaWiki 1.40 and above. Таким образом, вам не нужно загружать его снова. Тем не менее, вы всё равно должны следовать другим инструкциям.
Справка по расширениям MediaWiki
Thanks
Статус релиза: стабильно
Реализация Пользовательский интерфейс
Описание Позволяет участникам поблагодарить других участников за их правки и действия.
Автор(ы)
Последняя версия 1.2.0 (Continuous updates)
Политика совместимости Снэпшоты выходят вместе с MediaWiki. Мастер не имеет обратной совместимости.
Лицензия MIT License
Скачать
  • $wgThanksAllowedLogTypes
  • $wgThanksConfirmationRequired
  • $wgThanksLogging
  • $wgThanksSendToBots
Ежеквартальные загрузки 23 (Ranked 107th)
Использование общедоступными вики 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:

$wgThanksAllowedLogTypes = [
	"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 указан правильный индекс.


См. также