扩展:感谢

此扩展随附于MediaWiki 1.40及更高版本。 因此您无需另外下载。 但是，您仍需遵循此页面提供的其他使用说明。

MediaWiki扩展手册

Thanks 发行状态： 稳定版
实现	用户界面
描述	使用户对个别编辑或其他操作发送感谢
作者	Ryan Kaldari Benjamin Chen Wctaiwan
最新版本	1.2.0 (正在持续的更新)
兼容性政策	快照跟随MediaWiki发布。 master分支不向后兼容。
MediaWiki	>= 1.43
许可协议	MIT授權條款
下載	下載扩展 Git [?]: 下载Git master 浏览存储库 (Phabricator · GitHub) 提交历史 存储库貢獻者 (GitHub) 代码复核
参数 $wgThanksAllowedLogTypes $wgThanksConfirmationRequired $wgThanksLogging $wgThanksSendToBots
使用的函数钩 ApiMain::moduleManager BeforeCreateEchoEvent BeforePageDisplay ChangesListInitRows DiffTools DifferenceEngineViewHeader EchoGetBundleRules GetAllBlockActions GetLogTypesOnUser HistoryTools LocalUserCreated LogEventsListLineEnding PageHistoryBeforeList PageHistoryPager::doBatchLookups
季度下載量	25 (Ranked 112nd)
正在使用的公开wiki数	2,442 (Ranked 193rd)
前往translatewiki.net翻譯Thanks扩展
Vagrant角色	echo
問題	开启的任务 · 报告错误

‎Thanks扩展增加了一个快速的方式来提供积极的反馈对MediaWiki网站的高效性贡献。‎ ‎它允许用户发送公开的"谢谢"通知‎（通过Echo ）‎给其他用户进行个人编辑和某些已记录的操作。‎

“感谢”的特定修订不会存储在公共日志记录表中。仅公开记录时间戳、感谢者和被感谢者。

在以下位置添加了“感谢”链接：

• 在历史和差异视图中的“撤消”链接旁边；
• 关于Special:log上的一些日志条目（请参阅下面的#Configuration）；和
• 到Flow板注释（如果安装了Flow）。

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

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

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

我们希望，感谢通知将使人们更容易对彼此的工作表示赞赏，而且它应该特别有助于鼓励新用户在wiki上迈出关键的第一步。我们有意使此通知尽可能简单，以便我们可以对其进行评估并共同改进。享受…

安装

感谢扩展依赖于通知扩展。

• 下载文件，并将解压后的Thanks文件夹移动到extensions/目录中。
  开发者和代码贡献人员应从Git安装扩展，输入：cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/Thanks
• 将下列代码放置在您的LocalSettings.php 的底部：

  wfLoadExtension( 'Thanks' );
  

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

配置

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

$wgThanksSendToBots = false;

将感谢操作记录到“特殊日志”（默认启用）

$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。为了调用API，请使用参数action=thank。

参数：

• 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发送感谢流板上的评论。若要调用API，请使用action=flowthank。

参数：

• postid - 要发送感谢的评论的UUID（需要）
• 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表不是直接从中选择的，但在Wikimedia服务器上，我们利用了logging_logindex表。 为了快速搜索所有用户“发送”的感谢，logging_userindex提供了正确的索引。

参见

• w:Wikipedia:Notifications/Thanks - Information about the usage of this extension on English Wikipedia
• Echo (Notifications)/Feature requirements#Thank_you_notification - 初始功能提案（针对Echo扩展）
• 扩展:WikiLove - 传递感谢的另一个扩展
• Extension:Echo - 提供通知系统