Extension:LiquidThreads

shortcut: LQT

MediaWiki extensions manual - list

LiquidThreads Release status: experimental
Implementation	Page action, Special page, API
Description	LiquidThreads extension implements a structured discussion system for MediaWiki.
Author(s)	David McCabe, Andrew Garrett
Last version	2.1-alpha[1]
MediaWiki	1.19
PHP	5.3.0+
Database changes	yes
License	GPL v2
Download	Download snapshot (Git master) Git [?]: repo summary tree code changes README
Parameters $egLqtNamespaceNumbers
Hooks used BeforeWatchlist ChangesListInsertArticleLink MediaWikiPerformAction PageHistoryBeforeList SkinTemplateTabAction SkinTemplateTabs SkinTemplateOutputPageBeforeExec SpecialMovepageAfterMove PageContentLanguage
Bugs: list open list all report

LiquidThreads (LQT) is an extension for MediaWiki that implements a threaded discussion page system.

History

The original code was developed by David McCabe under sponsorship from the Google Summer of Code 2006, the Commonwealth of Learning, and Wikia. However, David McCabe is no longer involved with this project.

The original LiquidThreads code was substantially improved and augmented by Andrew Garrett at the Wikimedia Foundation since May 2009. The latest stable release of the LiquidThreads extension is LQT 2.0, described on this page. LQT 2.0 is the version currently being used on several Wikimedia wikis, and was used in the strategic planning process.

In January 2011, work on LiquidThreads 3.0 was begun at the Wikimedia Foundation. LQT 3.0 was being developed, with Andrew Garrett as the lead developer, but is now suspended. Development of LQT3 can be tracked in this branch; the last commits to LQT3 (lqt-updates) branch were in September 2011. Development by the Foundation has been discontinued.

User documentation

To activate LiquidThreads on a specific page on a wiki where LiquidThreads is opt-in, add

{{#useliquidthreads:1}} 

to the page's source code. To deactivate LiquidThreads on a specific page on a wiki where LiquidThreads is opt-out add

{{#useliquidthreads:0}} 

to the page's source code.

• FAQ and
• Extension help page.

Comprehensive user documentation will be developed when LiquidThreads has a finalised (or remotely stable) interface.

Rationale

Wiki discussion pages have some advantages over web and Usenet forums. They allow use of the entire wiki syntax - from images to wiki links to transclusion. It is possible to refactor entire discussion pages.

Web forums offer a number of advantages over the MediaWiki talk page model:

• Threads can be displayed in different views: flat, nested, sorted by date, subject, etc.
• The user only needs to click a "Reply" button or link in order to respond to a comment. Manual indentation is not required. Quotations from the source comment can be inserted automatically.
• Comments are automatically signed and dated.
• Avatars are possible. (but not yet created)
• The user can watch individual threads or be notified about responses in threads.
• Comments and threads can be displayed individually, without the surrounding page.
• Old comments are archived automatically and invisibly, with permanent links easily available.
• Search for author, subject, date, etc. is possible
• Individual threads can have categories.
• It is relatively easy to manage related discussions in a subject-specific forum, whereas MediaWiki talk pages always follow the "one discussion page per subject page" model.

LiquidThreads aims to unite the advantages of both forum types, and to add some unique discussion features to boot.

Installation

• Download and extract the files in a directory called "LiquidThreads" in your extensions/ folder.
• Add the following code to your LocalSettings.php (at the bottom)

require_once( "$IP/extensions/LiquidThreads/LiquidThreads.php" );

• Run the update script which will automatically create the necessary database tables that this extension needs.
• Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.

Installing without command prompt access

Some individuals may not have command prompt access. However, if you have access through phpMyAdmin, substitute these steps for step #4 above:

1. Download lqt.sql.
2. In phpMyAdmin, click the database you're using for mediawiki along the left side
3. On the next screen, click the "SQL" tab at the top.
4. At "Location of the text file", choose one of the files, select compression "None", and click the bottom "Go" button.

   If your phpMyAdmin screen has only a text field and no text file chooser, click the "SQL" button in the left-side column, under the phpMyAdmin logo, and click the "import files" tab in the new window that opens.

API

API documentation

Notes

Warning:

The status of the version in trunk is experimental, not beta, because several parts of the "drag to new location" user-interface are broken and throw javascript errors, for example when you drag a reply to become a new thread, and you did not enter the required subject.

This extension does not work in case your LocalSettings.php contains the following two parameter settings: $wgEnableAPI = false; and $wgEnableWriteAPI = false;

Example

• Test Page for playing around with the Liquid Threads interface.

See also

• Flow
• v:THREADNAV - Wikiversity development on structured and threaded discussions using wiki-syntax for structures and NavFrames JavaScript for display. Last activity was 2007.
• Extension:AWC's Forum - allows the display of a standalone forum within MediaWiki.
• Extension:Reflect - implements a novel augmentation of threaded comments.
• User:Inquisitor_Ehrenstein/LQTavatar – Forum style LQT templates for including avatars and full forum style signatures.

External links

Sites that use LiquidThreads

• see here for sites that use this extension

Other links

• Bugzilla ticket for LiquidThreads deployment
• English Wikipedia LiquidThreads article
• Wikimedia Commons LiquidThreads pictures