Extension:Thanks（感谢）

MediaWiki扩展手册

Thanks [[Special:MyLanguage/Extension status| 发行状态：]] 稳定版
实现	用户界面
描述	可讓用户向其他用户們的个别编辑動作感谢。
作者	Ryan Kaldari Benjamin Chen Wctaiwan
最新版本	1.2.0 (持续更新)
兼容性政策	快照跟随MediaWiki发布。 master分支不向后兼容。
参数 $wgThanksAllowedLogTypes $wgThanksConfirmationRequired $wgThanksLogging $wgThanksSendToBots
使用的函数钩 ApiMain::moduleManager BeforeCreateEchoEvent BeforePageDisplay ChangesListInitRows DiffTools DifferenceEngineViewHeader EchoGetBundleRules GetAllBlockActions GetLogTypesOnUser HistoryTools LocalUserCreated LogEventsListLineEnding PageHistoryBeforeList PageHistoryPager::doBatchLookups
许可证	MIT License
下載	下載扩展 Git [?]: 浏览存储库 (Phabricator · GitHub) Gerrit代码复核 Git提交日誌 下載原始碼（tarball壓縮）
前往translatewiki.net翻譯Thanks扩展
Vagrant角色	echo
問題	开启的任务 · 报告错误

‎Thanks扩展可对那些MediaWiki网站上的建設性贡献，提供了一種快速給予正面回饋的方式。‎ ‎它可讓用户（通过Echo ）发送通知‎給其他用户們，公开"感谢"他們的编辑和某些已记录在案的操作‎。‎

在以下位置中加上了一個“感谢”链接：

• 在历史和差异檢視中的“還原”链接的旁边；
• 某些Special:Log 上的日志条目（請见下方的#配置）；
• 如果有安装StructuredDiscussions 扩展，则包括Flow板的评论。

它还提供了一个API发送感谢。

请注意，如果您不想被感谢，您可以輕易地在首选项中禁用此通知，如下所述。

一旦您有机会试用，我们欢迎您在讨论页面上对此功能提供反馈。

我们希望，感谢通知可以更容易地对彼此的工作表達赞赏，而且它對于鼓励新用户在wiki上迈出关键的第一步应该會特别有用。我们刻意讓這個通知尽可能地简单，以便我们可以共同对其进行評判并改进。請享用…

安装

Thanks扩展需要先安装Echo 扩展。

此扩展随附于MediaWiki 1.40及更新版本，因此您無需下載它。 但其余的配置的指示仍须依循執行。

• 下载文件，并解压Thanks文件夹到extensions/目录中。
  开发者和代码贡献人员应改从Git安装此扩展，输入：

  cd extensions/
  git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/Thanks
  

• 請新增下列代码到您的LocalSettings.php 文件的底部：

  wfLoadExtension( 'Thanks' );
  

• 在您方便的时候配置即可。
• 转到页面的历史记录栏以查看新的“Thanks”界面。
• 完成 – 請导航至您的wiki上的Special:Version，以验证此扩展已成功安装。

配置

启用机器人程序编辑 的Thanks界面（默认情况下禁用）

$wgThanksSendToBots = false;

将Thanks操作记录到Special:Log （默认启用）

$wgThanksLogging = true;

发送感谢是否需要确认（默认启用）

$wgThanksConfirmationRequired = true;

可以从Special:Log中感谢的日志条目类型：

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

用法

要感谢其他用户，请转到任何页面的“历史记录”选项卡。 每个修订旁边都有一個“感谢”链接。 单击链接即可向该用户发送感谢。 这个链接也可以在diff檢视中、在Special:Log的某些条目上找到，以及，如果有安装了Flow，则可以在Flow板的下方评论中找到。

单击感谢链接后，收件人将通过echo扩展收到包含有您的感谢的通知（除非他们选择不接收感谢通知）。 该操作也会被记录为Special:Log/thanks处的日志的一個条目。

如果wiki使用memcached，则每个用户每分钟的感谢次数限制不超过10次。可以使用$wgRateLimits ['thanks-notification']配置限制。

避免感谢

要停止收到感谢通知，您可以在通知首选项中选择退出。 转到您首选项的通知选项卡。这只会阻止您收到通知，不会阻止用户感谢您。

API使用文档

thank
此模块不能用作generator。
前缀
需要的权限	无
仅限Post？	是
产生帮助	当前

感谢扩展包括用于发送感谢的API。 请使用参数action=thank以调用API。

参数：

• rev - 您要感谢某人的修订ID（需要此ID或log）
• log - 您要感谢某人的日志ID（需要此ID或rev）
• source - 感谢活动的来源。这是一个短字符串，用于标识感谢的发送位置。例如，如果感谢是从huggle发送的，则其值可能是“huggle”。（可选）
• token - 编辑令牌（又称为CSRF令牌）。 您可以通过API令牌获得其中之一。 （需要）

例子：

 api.php?action=thank&rev=16543&token=%2B\

要通过OAuth 发送感谢，只需要“基本”的授予许可。 可以在这里找到一个python示例。

跟踪感谢

flowthank
此模块不能用作generator。
前缀
需要的权限	无
仅限Post？	是
产生帮助	当前

有一个独立API用于向Flow板上的评论发送感谢。 请使用action=flowthank调用API。

参数：

• postid - 要发送感谢的评论的UUID（需要）
• token - 编辑令牌。 您可以通过prop=info获得其中之一。（必需）

例如：

 api.php?action=flowthank&postid=abc123&token=%2B\

错误与警告

代码	信息
invalidrecipient	找不到有效的接收者 不能感谢机器人 您不能感谢您自己

SQL使用文档 “感谢”的特定修订不会存储在公共日志记录表中。仅公开记录时间戳、感谢者和被感谢者。 被「感謝」的具體修改、事件、或動作並未儲存於記錄資料庫表中（因此系統限制了可顯示的內容，例如在Special:Log/thanks上的系統）。僅記錄時間戳記、發送者與接收者。 要从日志中了解谁感谢了谁，就需要对各個列有一定的了解。 在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

还要注意，the logging table表不是直接从中选择的，但在Wikimedia服务器上，我们利用了logging_logindex表。 为了快速搜索所有用户“发送”的感谢，logging_userindex提供了正确的索引。

参阅

• w:Help:Notifications/Thanks - 英语维基百科上有关此扩展的用法信息
• Echo (Notifications)/Feature requirements#Thank_you_notification - 初始功能提案（针对Echo扩展）
• Extension:WikiLove - 传递感谢的另一个扩展
• Extension:Echo - 提供通知系统