Extension:SectionDisqus

From MediaWiki.org
Jump to: navigation, search
MediaWiki extensions manualManual:Extensions
Crystal Clear action run.png
SectionDisqus

Release status:Extension status beta

SectionDisqus.jpg
ImplementationTemplate:Extension#type Hook, Skin
DescriptionTemplate:Extension#description Adds a "Discuss" button next to the "Edit" button of every section, that when clicked, opens a Disqus thread for that section.
Author(s)Template:Extension#username Felipe Schenonetalk
Latest versionTemplate:Extension#version 1.0 (2013-08-16)
MediaWikiTemplate:Extension#mediawiki 1.22+
PHPTemplate:Extension#php 5.3+
Database changesTemplate:Extension#needs-updatephp No
LicenseTemplate:Extension#license GNU General Public License 2.0 or later
Download
Hooks usedTemplate:Extension#hook
BeforePageDisplayManual:Hooks/BeforePageDisplay
DoEditSectionLinkManual:Hooks/DoEditSectionLink
SkinAfterContentManual:Hooks/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 be lost, or more precisely, get unlinked. This is due to the way Disqus works. 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 me 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:
    require_once "$IP/extensions/SectionDisqus/SectionDisqus.php";
    $wgSectionDisqusShortname = 'your-disqus-shortname';
    
  • YesY Done - Navigate to Special:Version on your wiki to verify that the extension is successfully installed.

See also[edit]