This page is a translated version of the page Extension:Thanks and the translation is 98% complete.
此扩展随附于MediaWiki 1.40及更高版本。 因此您无需另外下载。 但是,您仍需遵循此页面提供的其他使用说明。
MediaWiki扩展手册
Thanks
发行状态: 稳定版
实现 用户界面
描述 使用户对个别编辑或其他操作发送感谢
作者
最新版本 1.2.0 (正在持续的更新)
兼容性政策 快照跟随MediaWiki发布。 master分支不向后兼容。
MediaWiki >= 1.42
许可协议 MIT授權條款
下載
  • $wgThanksAllowedLogTypes
  • $wgThanksConfirmationRequired
  • $wgThanksLogging
  • $wgThanksSendToBots
季度下載量 49 (Ranked 92nd)
正在使用的公开wiki数 2,442 (Ranked 193rd)
前往translatewiki.net翻譯Thanks扩展
Vagrant角色 echo
問題 开启的任务 · 报告错误

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

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

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

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

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

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

Example of a 'thanks' notification

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

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

安装

感谢扩展依赖于通知扩展
  • 下载文件,并将其放置在您extensions/文件夹中的Thanks目录内。
    开发者和代码贡献人员应从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中感谢的日志条目类型:

$wgThanksLogTypeWhitelist = [
	"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使用文档

感谢扩展包括用于发送感谢的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示例。

跟踪感谢

有一个单独的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提供了正确的索引。


参见