Extension:DiscussionTools（讨论工具）

**MediaWiki扩展手册**
DiscussionTools; 发行状态：稳定版
实现	用户界面
描述	用于增强讨论页的工具
作者	维基媒体编辑团队
最新版本	持续更新
兼容性政策	快照跟随MediaWiki发布。 master分支不向后兼容。
数据库更改	是
表	discussiontools_items; discussiontools_item_ids; discussiontools_item_pages; discussiontools_item_revisions; discussiontools_subscription
许可协议	MIT授權條款
下載	下載扩展 ; Git [?]: 浏览存储库 (Phabricator · GitHub); Gerrit代码复核; Git提交日誌; 下載原始碼（tarball壓縮）;
帮助	帮助:讨论工具
	参数 $wgDiscussionToolsTimestampFormatSwitchTime; $wgDiscussionToolsBeta; $wgDiscussionTools_visualenhancements; $wgDiscussionToolsTalkPageParserCacheExpiry; $wgDiscussionToolsReplyIndentation; $wgDiscussionToolsConflictingGadgetName; $wgDiscussionToolsAutoTopicSubEditor; $wgDiscussionToolsShowFeedbackLinks; $wgDiscussionTools_visualenhancements_reply_icon_languages;
	使用的函数钩 APIAfterExecute; APIGetAllowedParams; ApiMain::moduleManager; BeforeCreateEchoEvent; BeforeDisplayNoArticleText; BeforePageDisplay; ChangeTagsListActive; DiscussionToolsAddOverflowMenuItems; EchoGetBundleRules; EchoGetEventsForRevision; GetActionName; GetBetaFeaturePreferences; GetDoubleUnderscoreIDs; GetPreferences; ListDefinedTags; LoadExtensionSchemaUpdates; OutputPageBeforeHTML; OutputPageParserOutput; ParserAfterTidy; ParserOutputPostCacheTransform; RecentChange_save; ResourceLoaderGetConfigVars; RevisionDataUpdates; SidebarBeforeOutput; SkinTemplateNavigation::Universal;
	提供的函数钩 DiscussionToolsAddOverflowMenuItems; DiscussionToolsTermsOfUseMessages;
	翻译DiscussionTools扩展
問題	开启的任务 · 报告错误

This page is a translated version of the page Extension:DiscussionTools and the translation is 82% complete.

Discussion Tools扩展是用于增强讨论页面的工具集。截至2024年，它作为讨论页计划的一部份，由编辑团队构建。

用户文档位于帮助:讨论工具。

部份功能可在个别页面或章节中禁用，详见Help:DiscussionTools/Magic words and markup 。

功能

依赖

Optional dependencies

Extension:Echo - 啟用主題訂閱及使用者通知功能。
Extension:Thanks（感谢） - Enables comment thanking.
Extension:MobileFrontend（移动版前端） - Enables mobile support.

安裝

此扩展随附于MediaWiki 1.40及更新版本，因此您無需下載它。但其余的配置的指示仍须依循執行。

安装所需的依赖组件.
下载文件，并解压DiscussionTools文件夹到extensions/目录中。
开发者和代码贡献人员应改从Git安装此扩展，输入：
```
cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/DiscussionTools
```
請新增下列代码到您的LocalSettings.php 文件的底部：
```
wfLoadExtension( 'DiscussionTools' );
```
請运行更新脚本，它将自动创建此扩展所必须的数据库表。
同時在LocalSettings.php中，确保设置了时区，并將$wgFragmentMode 設定成html5。
按需求配置。
完成 – 請导航至您的wiki上的Special:Version，以验证此扩展已成功安装。

配置

设置名称	默认值	描述
`$wgDiscussionToolsBeta`	`false`	使讨论工具成为一个测试功能。
`$wgDiscussionTools_visualenhancements`	`'default'`	覆盖讨论工具视觉增强的可用性。 Possible values: `'default'`, `'available'`, `'unavailable'`
`$wgDiscussionTools_visualenhancements_reply_icon_languages`	[ 'ar' => true, 'zh' => true, 'yue' => true, 'ja' => true, 'nod' => true, ]	一个语言代码字典，其中的语言由于翻译非常简短，将在其增强的回复按钮处理中显示图标。 (T323537) 除非明确将语言设置为 `false`，否则将检查语言回滚。 (T352289) 标准化的语言代码为小写。
`$wgDiscussionToolsAutoTopicSubEditor`	`'any'`	Editor which triggers automatic topic subscriptions. Either `'discussiontoolsapi'` for edits made using DiscussionTools’ API (e.g. reply and new topic tools), or `'any'` for any editor.
`$wgDiscussionToolsTalkPageParserCacheExpiry`	`0`	Override `$wgParserCacheExpireTime` for discussion pages, regardless of DiscussionTools enablement.
`$wgDiscussionToolsReplyIndentation`	`'invisible'`	选择一个回复缩进：`'invisible'`（使用`<dl><dd>`标签以在wikitext中输出`:`）或`'bullet'`（使用`<ul><li>`标签以在wikitext中输出`*`）
`$wgDiscussionToolsShowFeedbackLinks`	`false`	MW 1.40+ 在回复工具和新话题工具的后边显示“分享有关此功能的意见反馈”链接。
`$wgDiscussionToolsTimestampFormatSwitchTime`	`'2022-07-12'`	Date on which the internal timestamp format has changed (T304595), in ISO 8601 format.
`$wgDiscussionToolsConflictingGadgetName`	`'convenientDiscussions'`	设置Convenient Discussions小工具的内部名称，因为先前的配置会与回复工具相冲突。当这个小工具被启用时，回复工具将不可用。

API

编辑


操作	说明	是否为内部性质
discussiontoolscompare	获取两个页面修订间留言更改的有关信息。
discussiontoolsedit	在讨论页面上发布留言。	N
discussiontoolsfindcomment	按ID或名称查找留言。	N
discussiontoolspageinfo	返回初始化讨论工具所需的元数据。
discussiontoolspreview	预览讨论页面上的留言。

話題訂閱

操作	说明	是否为内部性质
discussiontoolsgetsubscriptions	获取给定话题的订阅状态。	N
discussiontoolssubscribe	订阅（或取消订阅）来接收有关话题的通知。	N

特殊页面

整合其他扩展

DiscussionTools可以跟PlaceNewSection 整合在一起，以放置用于添加新主题的位置。

It can also integrate with AutoModerator to enable community-configured reversion of Machine Language-scored bad edits.

參見

Extension:DiscussionTools/How it works – 技术信息
Convenient Discussions – another tool for discussions, incompatible with DiscussionTools

此扩展用于一个或多个维基媒体项目。这可能意味着扩展足够稳定、运作足够良好，可以用在这样的高流量的网站上。请在维基媒体的CommonSettings.php和InitialiseSettings.php配置文件中查找此扩展的名称以查看哪些网站安装了该扩展。特定wiki上的已安装的扩展的完整列表位于Special:Version页面。

此扩展在以下wiki农场/托管网站和/或软件包中提供：