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>
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 |
|
|
|
|
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
<translate> Main pages:</translate> Talk pages project/Feature summary and Extension:DiscussionTools/Comparison
Dependencies
- Extension:VisualEditor
- Extension:Linter
- Extension:Echo (optional). Only required if you want to use the topic subscriptions feature.
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
- Extension:DiscussionTools/How it works – technical information
File:Wikimedia-logo black.svg | <translate> This {{<tvar name=1>#ifeq:Extension|Extension</tvar>|extension|skin}} is being used on one or more [[<tvar name=2>m:Special:MyLanguage/Wikimedia projects</tvar>|Wikimedia projects]].</translate> <translate> This probably means that the {{<tvar name=1>#ifeq:Extension|Extension</tvar>|extension|skin}} is stable and works well enough to be used by such high-traffic websites.</translate> <translate> Look for this {{<tvar name=1>#ifeq:Extension|Extension</tvar>|extension's|skin's}} name in Wikimedia's <tvar name=2>CommonSettings.php</tvar> and <tvar name=3>InitialiseSettings.php</tvar> configuration files to see where it's installed.</translate> <translate> A full list of the {{<tvar name=1>#ifeq:Extension|Extension</tvar>|extensions|skins}} installed on a particular wiki can be seen on the wiki's <tvar name=ver>Special:Version</tvar> page.</translate> |
DiscussionTools reply widget example 2020-04-02.png |
This message box is using an invalid "type=interface" parameter and needs fixing.
Categories:
- Pages with script errors
- Extensions bundled with MediaWiki 1.40
- Pages with broken file links
- Stable extensions
- User interface extensions
- Extensions with release branches compatibility policy
- MIT licensed extensions
- Extensions in Wikimedia version control
- BeforeCreateEchoEvent extensions
- BeforeDisplayNoArticleText extensions
- BeforePageDisplay extensions
- ChangeTagsListActive extensions
- DiscussionToolsAddOverflowMenuItems extensions
- EchoGetBundleRules extensions
- EchoGetEventsForRevision extensions
- GetActionName extensions
- GetBetaFeaturePreferences extensions
- GetDoubleUnderscoreIDs extensions
- GetPreferences extensions
- ListDefinedTags extensions
- LoadExtensionSchemaUpdates extensions
- LocalUserCreated extensions
- OutputPageBeforeHTML extensions
- OutputPageParserOutput extensions
- ParserAfterTidy extensions
- ParserOutputPostCacheTransform extensions
- RecentChange save extensions
- ResourceLoaderGetConfigVars extensions
- RevisionDataUpdates extensions
- SidebarBeforeOutput extensions
- All extensions
- Pages containing potentially dated statements
- Extensions used on Wikimedia
- Discussion and forum extensions
- Extensions with VisualEditor support
- Talk pages project