Extension:DiscussionTools

From Linux Web Expert

<translate> This {{<tvar name=1>#if:|{{{type}}}</tvar>|extension}} [[<tvar name=mwversion>Special:MyLanguage/MediaWiki 1.40#Bundled extensions</tvar>|comes with MediaWiki <tvar name=mwversion2>1.40</tvar>]] and above.</translate> <translate> Thus you do not have to download it again.</translate> <translate> However, you still need to follow the other instructions provided.</translate>
MediaWiki extensions manual
DiscussionTools
Release status: stable
File:DiscussionTools reply widget example 2020-04-02.png
Implementation User interface
Description Tools to enhance discussion pages
Author(s) Wikimedia Editing team
Latest version continuous updates
Compatibility policy Snapshots releases along with MediaWiki. Master is not backward compatible.
MediaWiki >= 1.42.0
Database changes Yes
Tables discussiontools_items
discussiontools_item_ids
discussiontools_item_pages
discussiontools_item_revisions
discussiontools_subscription
License MIT License
Download
Help Help:DiscussionTools
  • $wgDiscussionToolsReplyIndentation
  • $wgDiscussionToolsABTest
  • $wgDiscussionToolsBeta
  • $wgDiscussionTools_visualenhancements
  • $wgDiscussionToolsEnablePermalinksBackend
  • $wgDiscussionToolsAutoTopicSubEditor
  • $wgDiscussionToolsTimestampFormatSwitchTime
  • $wgDiscussionToolsShowFeedbackLinks
  • $wgDiscussionTools_visualenhancements_pageframe
  • $wgDiscussionToolsTalkPageParserCacheExpiry
  • $wgDiscussionToolsConflictingGadgetName
  • $wgDiscussionTools_visualenhancements_reply
  • $wgDiscussionToolsEnablePermalinksFrontend
  • $wgDiscussionTools_visualenhancements_reply_icon_languages
Quarterly downloads Lua error in Module:Extension at line 172: bad argument #1 to 'inNamespace' (unrecognized namespace name 'skin').
Public wikis using Lua error in Module:Extension at line 172: bad argument #1 to 'inNamespace' (unrecognized namespace name 'skin').
Translate the DiscussionTools extension
Issues Open tasks · Report a bug

The Discussion Tools extension is a set of tools to enhance discussion pages. <translate> {{<tvar name=1>#if: </tvar>|as of|As of}} <tvar name=2>2024</tvar></translate>, it is being built by the Editing team as part of the talk pages project .

User documentation is at Help:DiscussionTools .

Some features can be disabled on individual pages and sections as described at Help:DiscussionTools/Magic words and markup .

Features

Dependencies

Installation

  • Install the dependencies.
  • <translate> [[<tvar name=2>Special:ExtensionDistributor/DiscussionTools</tvar>|Download]] and move the extracted <tvar name=name>DiscussionTools</tvar> folder to your <tvar name=ext>extensions/</tvar> directory.</translate>
    <translate> Developers and code contributors should install the extension [[<tvar name=git>Special:MyLanguage/Download from Git</tvar>|from Git]] instead, using:</translate>cd extensions/
    git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/DiscussionTools
  • <translate> Add the following code at the bottom of your <tvar name=1>LocalSettings.php </tvar> file:</translate>
    wfLoadExtension( 'DiscussionTools' );
    
  • <translate> Run the [[<tvar name=update>Special:MyLanguage/Manual:Update.php</tvar>|update script]] which will automatically create the necessary database tables that this extension needs.</translate>
  • Also in LocalSettings.php, ensure that you have a timezone set and $wgFragmentMode set in html5.
  • Configure as required.
  • File:OOjs UI icon check-constructive.svg <translate> Done</translate> – <translate> Navigate to <tvar name=special>Special:Version</tvar> on your wiki to verify that the extension is successfully installed.</translate>

Configuration

Setting name Default value Description
$wgDiscussionToolsEnable true Enable DiscussionTools on talk pages.
$wgDiscussionToolsBeta false Make DiscussionTools a beta feature .
$wgDiscussionToolsEnable2017Wikitext false Enable the 2017 wikitext editor for wikitext replies (not yet supported).
$wgDiscussionToolsEnablePermalinksBackend true Enable the permalinks backend (Special:GoToComment). See Extension:DiscussionTools/How it works#Permanent links.
$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 "⧼discussiontools-replywidget-feedback⧽" links in the footer of reply tool and new topic tool.
$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.

API

Editing

Action Human readable Description Internal?
discussiontoolscompare compare Get information about comment changes between two page revisions. internal
discussiontoolsedit edit Post a message on a discussion page.
discussiontoolsfindcomment find comment Find a comment by its ID or name.
discussiontoolspageinfo page info Returns metadata required to initialize the discussion tools. internal
discussiontoolspreview preview Preview a message on a discussion page. internal

Subscriptions

Action Human readable Description Internal?
discussiontoolsgetsubscriptions get subscriptions Get the subscription statuses of given topics.
discussiontoolssubscribe subscribe Subscribe (or unsubscribe) to receive notifications about a topic.

Special pages


Integration with other extensions

DiscussionTools can integrate with PlaceNewSection to put the location of where added new topics will begin to be placed.

See also

This message box is using an invalid "type=interface" parameter and needs fixing.