扩展:感谢

MediaWiki的扩展的手冊

Thanks 發佈狀態： 穩定版本
实现	用户界面
描述	使用户对个别编辑或其他操作发送感谢
作者	Ryan Kaldari Benjamin Chen Wctaiwan
最新版本	1.2.0 (正在持续的更新)
兼容性政策	快照跟随MediaWiki发布。 master分支不向後兼容。
MediaWiki	1.31+
PHP	5.4+
许可协议	MIT授權條款
下載	下載扩展 Git [?]: 下载Git master 浏览存储库 (Phabricator · GitHub) 提交历史 repository contributors (GitHub) 代码复核
參數 $wgThanksAllowedLogTypes $wgThanksConfirmationRequired $wgThanksLogging $wgThanksSendToBots
使用的钩子 ApiMain::moduleManager BeforeCreateEchoEvent BeforePageDisplay BeforeSpecialMobileDiffDisplay DiffTools DifferenceEngineViewHeader EchoGetBundleRules GetAllBlockActions GetLogTypesOnUser HistoryTools LocalUserCreated LogEventsListLineEnding PageHistoryBeforeList
季度下載量	78 (Ranked 104th)
公開的wiki使用	2,442 (Ranked 193rd)
翻譯Thanks的扩展，若在translatewiki.net可用
Vagrant角色	echo
問題	尚未完成的工作 · 报告錯誤

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

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

A 'thank' link is added in the following places:

• next to the 'undo' link in history and diff views;

• on some log entries on Special:Log (see #Configuration, below); and

• to Flow board comments if Flow is installed.

It also provides an API for sending thanks.

Note that if you do not want to be thanked, you can easily disable this notification in your preferences, as described below.

Once you have had a chance to try it out, we welcome your feedback about this feature on the talk page.

We hope that the Thanks notification will make it easier to show appreciation for each other's work – and it should be particularly helpful for encouraging new users during their first critical steps on a wiki. We have intentionally kept this notification as simple as possible, so we can evaluate it and improve it together. Enjoy…

下載

此扩展可直接从Git检索到 ^[?]:

• 浏览代码
• 部分扩展有稳定版本标签。
  • 浏览标签
  • 选择标签
  • 点击“快照”
• 每个分支与过去的MediaWiki发布版本相关联。 这里也有一个“主线”分支，包含最新alpha版本（可能需要MediaWiki的alpha版本）。
  • 浏览分支
  • 选择一个分支名称
  • 点击“继续”

提取快照，并将它放置在您的MediaWiki安装副本的extensions/Thanks/目录中。

如果您对git熟悉，并且拥有您服务器的shell访问权，您也可以通过以下方法获得扩展：

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

安裝

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

• 下载文件，并将其放置在您extensions/文件夹中的Thanks目录内。
• 将下列代码放置在您的LocalSettings.php 的底部：

  wfLoadExtension( 'Thanks' );
  

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

配置

對機器人編輯啟用感謝介面（預設停用）

$wgThanksSendToBots = false;

記錄感謝操作到「Special:Log」（預設啟用）

$wgThanksLogging = true;

是否需要對發送感謝進行確認（預設啟用）

$wgThanksConfirmationRequired = true;

在Special:Log中可以被感謝的日誌項目類型：

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

用法

To thank another user, go to the History tab of any page. Next to each revision will be a 'thank' link. Click the link to send thanks to that user. This link is also available in the diff view, on some entries in Special:Log, and below comments on Flow boards if Flow is installed.

When the thank link is clicked, the recipient will receive a notification with your thanks via the Echo extension (unless they have opted out of receiving thanks notifications). A record of the action is also recorded as a log entry at Special:Log/thanks.

If the wiki is using memcached, a rate limit is imposed of no more than 10 thanks per minute per user. The limit can be configured with $wgRateLimits ['thanks-notification'].

避免感谢

To stop getting thanks notifications, you can opt out from them in your notification preferences. Go to the Notifications tab of your preferences. This only prevents you from getting notified, it does not prevent users from thanking you.

API帮助文档

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

The Thanks extension includes an API for sending thanks. In order to call the API, use the parameter action=thank.

参数：

• rev - The revision ID you would like to thank someone for (either this or log is required)
• log - The log ID you would like to thank someone for (either this or rev is required)
• source - Source of the thank event. This is a short string that identifies where the thanks was sent from. For example, if the thanks was sent from Huggle, the value could be 'huggle'. (optional)
• token - 编辑令牌（又称为csrf令牌）。 您可以通过API令牌获得其中之一。 （需要）

例子：

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

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

Flow感谢

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

There is a separate API for sending Thanks for comments on Flow boards. To call the API, use action=flowthank.

参数：

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

例如：

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

错误与警告

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

SQL帮助文档

要从日志中了解谁感谢了谁，就需要对各列有一定的了解。 Within the logging table, the log_title represents the receiver, and the log_user_text represents the sender.

The following SQL which finds all the thanks a receiver received within a time period illustrates this:

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

Notice also that the logging table is not selected from directly, but on Wikimedia servers we take advantage of the logging_logindex table. 为了快速搜索所有用户“发送”的感谢，logging_userindex提供了正确的索引。

參見

• w:Wikipedia:Notifications/Thanks - Information about the usage of this extension on English Wikipedia
• Echo (Notifications)/Feature requirements#Thank_you_notification - Initial feature proposal (for the Echo extension)
• 扩展:WikiLove - 传递感谢的另一个扩展
• 扩展:Echo - 提供通知系统