扩展:感谢
![]() 發佈狀態: 穩定版本 |
|
---|---|
![]() |
|
实现 | 用户界面 |
描述 | 使用户对个别编辑或其他操作发送感谢 |
作者 |
|
最新版本 | 1.2.0 (正在持续的更新) |
兼容性政策 | 快照跟随MediaWiki发布。 master分支不向後兼容。 |
MediaWiki | 1.31+ |
PHP | 5.4+ |
许可协议 | MIT授權條款 |
下載 | |
|
|
季度下載量 | 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 orlog
is required)log
- The log ID you would like to thank someone for (either this orrev
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 - 提供通知系统
此扩展用于一个或多个维基媒体项目。 这可能意味着扩展足够稳定、运作足够良好,可以用在这样的高流量的网站上。 请在维基媒体的CommonSettings.php和InitialiseSettings.php配置文件中查找此扩展的名称以查看哪些网站安装了该扩展。 特定wiki上的已安装的扩展的完整列表位于Special:Version页面。 |
此擴充功能包含在以下包或/和wiki農場: 這不是一份權威名單。即使一些wiki農場/託管者沒有被列在這裡,他們也可能包含這個extension。請以各wiki農場/託管者或包的狀態為準。 |