扩展:感谢
 发行状态： 稳定版 |
|
|---|---|
 |
|
| 实现 | 用户界面 |
| 描述 | 使用户对个别编辑或其他操作发送感谢 |
| 作者 |
|
| 最新版本 | 1.2.0 (正在持续的更新) |
| 兼容性政策 | 快照跟随MediaWiki发布。 master分支不向后兼容。 |
| MediaWiki | >= 1.43 |
| 许可协议 | MIT授權條款 |
| 下載 | |
|
|
| 季度下載量 | 25 (Ranked 114th) |
| 正在使用的公开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 - 提供通知系统
| 此扩展用于一个或多个维基媒体项目。 这可能意味着扩展足够稳定、运作足够良好，可以用在这样的高流量的网站上。 请在维基媒体的CommonSettings.php和InitialiseSettings.php配置文件中查找此扩展的名称以查看哪些网站安装了该扩展。 特定wiki上的已安装的扩展的完整列表位于Special:Version页面。 |
| 此扩展在以下wiki农场/托管网站和/或软件包中提供： 這不是一份權威名單。 即使某些wiki农场/托管网站和/或软件包未在这里列出，它们也可能提供此扩展。 请检查你的wiki农场/托管网站或软件包以确认提供情况。 |