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壓縮);
帮助	帮助:讨论工具
	参数 $wgDiscussionToolsReplyIndentation; $wgDiscussionToolsBeta; $wgDiscussionTools_visualenhancements; $wgDiscussionToolsEnablePermalinksBackend; $wgDiscussionToolsEnableThanks; $wgDiscussionToolsTimestampFormatSwitchTime; $wgDiscussionToolsShowFeedbackLinks; $wgDiscussionToolsTalkPageParserCacheExpiry; $wgDiscussionTools_visualenhancements_pageframe; $wgDiscussionToolsAutoTopicSubEditor; $wgDiscussionToolsConflictingGadgetName; $wgDiscussionTools_visualenhancements_reply; $wgDiscussionToolsEnablePermalinksFrontend; $wgDiscussionTools_visualenhancements_reply_icon_languages;
	使用的函数钩 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 70% 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，以验证此扩展已成功安装。

配置

设置名称	默认值	描述	Possible values
`$wgDiscussionToolsBeta`	`false`	使讨论工具成为一个测试功能。
`$wgDiscussionTools_visualenhancements`	`'default'`	Override availability of DiscussionTools visual enhancements.	`'default'`, `'available'`, `'unavailable'`
`$wgDiscussionTools_visualenhancements_pageframe`	`'default'`	Override availability of DiscussionTools visual enhancements’ page frame sub-feature.	`'default'`, `'available'`, `'unavailable'`
`$wgDiscussionTools_visualenhancements_reply`	`'default'`	Override availability of DiscussionTools visual enhancements’ reply buttons sub-feature.	`'default'`, `'available'`, `'unavailable'`
`$wgDiscussionTools_visualenhancements_reply_icon_languages`	`{ ar: true, zh: true, yue: true, ja: true, nod: true }`	A dictionary of language codes which will receive an icon in their enhanced reply-button treatment, due to translation being very short. (T323537) Language fallbacks will be checked unless a language is explicitly set to `false`. (T352289) Normalized language codes are lower case.
`$wgDiscussionToolsEnablePermalinksBackend`	`true`	启用永久链接后端（Special:GoToComment） Do not enable this unless the database tables exist.
`$wgDiscussionToolsEnablePermalinksFrontend`	`true`	Enable permalinks frontend features: (1) Convert signature timestamps to comment links. (2) Show notification when the target comment is found on another page.
`$wgDiscussionToolsEnableThanks`	`true`	Show a button to thank individual comments. Requires Extension:Thanks（感谢） .
`$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	比较	获取两个页面修订间留言更改的有关信息。	internal
discussiontoolsedit	编辑	在讨论页面上发布留言。
discussiontoolsfindcomment	查找留言	按ID或名称查找留言。
discussiontoolspageinfo	页面信息	返回初始化讨论工具所需的元数据。	internal
discussiontoolspreview	预览	预览讨论页面上的留言。	internal

話題訂閱

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

特殊页面

整合其他扩展

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

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

參見

Extension:DiscussionTools/How it works – 技术信息

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

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

這不是一份權威名單。即使某些wiki农场/托管网站和/或软件包未在这里列出，它们也可能提供此扩展。请检查你的wiki农场/托管网站或软件包以确认提供情况。