TheDiscussion Tools extension is a set of tools to enhance discussion pages.As of 2024, it is being built by theEditing team as part of thetalk pages project.
User documentation is atHelp:DiscussionTools.
Some features can be disabled on individual pages and sections as described atHelp:DiscussionTools/Magic words and markup.
DiscussionTools folder to yourextensions/ directory.cdextensions/gitclonehttps://gerrit.wikimedia.org/r/mediawiki/extensions/DiscussionToolswfLoadExtension('DiscussionTools');
html5.
Done – Navigate toSpecial:Version on your wiki to verify that the extension is successfully installed.| Setting name | Default value | Description |
|---|---|---|
$wgDiscussionToolsBeta | false | Make DiscussionTools abeta feature. |
$wgDiscussionTools_visualenhancements | 'default' | Override availability of DiscussionTools visual enhancements. Possible values: '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 tofalse. (T352289) Normalized language codes are lower case. |
$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' | Reply indentation syntax to use:'invisible' (use<dl><dd> tags to output: in wikitext) or'bullet' (use<ul><li> tags to output* in wikitext). |
$wgDiscussionToolsShowFeedbackLinks | false | MW 1.40+ Show "Share feedback about this feature" links in the footer of reply tool and new topic tool. |
$wgDiscussionToolsTimestampFormatSwitchTime | '2022-07-12' | Date on which the internal timestamp format has changed (T304595), inISO 8601 format. |
$wgDiscussionToolsConflictingGadgetName | 'convenientDiscussions' | Internal name of the Convenient Discussions gadget, which conflicts with the reply tool. Reply tool will be unavailable when the user has this gadget enabled. |
| Action | Description | Internal? |
|---|---|---|
| discussiontoolscompare | Get information about comment changes between two page revisions. | |
| discussiontoolsedit | Post a message on a discussion page. |  N |
| discussiontoolsfindcomment | Find a comment by its ID or name. | N |
| discussiontoolspageinfo | Returns metadata required to initialize the discussion tools. | |
| discussiontoolspreview | Preview a message on a discussion page. | |
| Action | Description | Internal? |
|---|---|---|
| discussiontoolsgetsubscriptions | Get the subscription statuses of given topics. | N |
| discussiontoolssubscribe | Subscribe (or unsubscribe) to receive notifications about a topic. | N |
DiscussionTools can integrate withPlaceNewSection to put the location of where added new topics will begin to be placed.
It can also integrate withAutoModerator to enable community-configured reversion of Machine Language-scored bad edits.
 | This extension is being used on one or moreWikimedia projects. This probably means that the extension is stable and works well enough to be used by such high-traffic websites. Look for this extension's name in Wikimedia'sCommonSettings.php andInitialiseSettings.php configuration files to see where it's installed. A full list of the extensions installed on a particular wiki can be seen on the wiki'sSpecial:Version page. |
 | This extension is included in the following wiki farms/hosts and/or packages: |