Extension:SectionDisqus

From MediaWiki.org
Jump to navigation Jump to search
MediaWiki extensions manual
Crystal Clear action run.svg
SectionDisqus
Release status: beta
SectionDisqus.jpg
Implementation Ajax
Description Adds a "Discuss" button next to the "Edit" button of every section, that opens a Disqus thread for that section.
Author(s) Felipe Schenone (Sophivorustalk)
Latest version 3.0 (2018-02-11)
MediaWiki 1.25+
PHP 5.3+
Database changes No
License GNU General Public License 3.0
Download
Parameters
$wgDisqusShortname
Hooks used
BeforePageDisplay
DoEditSectionLink
SkinAfterContent
Translate the SectionDisqus extension if it is available at translatewiki.net
Check usage and version matrix.

The SectionDisqus extension adds a "Discuss" button next to the "Edit" button of every section (including subsections), that when clicked, opens a Disqus thread for that section, inside a jQuery UI dialog (similar to a lightbox). In other words, this extension assigns a different Disqus thread to each section, allowing to discuss each section individually.

Warning! When a user changes the title of a section, the discussion associated with it will get lost, or more precisely, unlinked. This is because Disqus tracks discussions by associating them with a unique identifier, which is usually the URL of the page with the discussion. But because this extension allows for many discussions in the same page, a different identifier needs to be provided for each. The way the extension accomplishes this is by appending the section title to the URL. As a consequence, when the section title changes, the discussion linked to it will change too. If you can think of a solution to this problem, please let the author know, or better yet, fix it yourself. ;-)

Installation[edit]

  • Download and place the file(s) in a directory called SectionDisqus in your extensions/ folder.
  • Add the following code at the bottom of your LocalSettings.php:
    wfLoadExtension( 'SectionDisqus' );
    $wgSectionDisqusShortname = 'your-disqus-shortname';
    
  • Yes Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.
For compatibility with Extension:DisqusTag, if $wgDisqusShortname is set, SectionDisqus will fallback to it if $wgSectionDisqusShortname is not set.

See also[edit]