Extension:LiquidThreads - MediaWiki
Jump to content
From mediawiki.org
Translate this page
Languages:
Türkçe
polski
čeština
中文
This extension is currently not actively maintained!
Although it may still work, any bug reports or feature requests will more than likely be ignored. The Wikimedia Foundation provides no support to Wikimedia wikis using it and requests to install on new Wikimedia projects are
no longer possible
Please see the following alternatives that you may wish to install instead of this extension:
Extension:DiscussionTools
If you are interested in taking on the task of developing and maintaining this extension,
you can request repository ownership
. As a courtesy, you may want to contact the author. You should also remove this template and list yourself as maintaining the extension in the page's {{
Extension
}} infobox.
MediaWiki extensions manual
LiquidThreads
Release status:
unmaintained
Implementation
Page action
Special page
API
Description
Implements a structured discussion system
Author(s)
David McCabe, Andrew Garrett
Latest version
2.2-alpha
(2014-03-28)
MediaWiki
1.29+
PHP
5.4+
Database changes
Yes
Tables
thread
thread_history
thread_pending_relationship
thread_reaction
historical_thread
user_message_state
Parameters
$egLqtNamespaceNumbers
Added rights
Merge threads (
lqt-merge
Reply to threads (
lqt-react
Split threads (
lqt-split
Hooks used
APIQueryAfterExecute
AfterImportPage
ArticleConfirmDelete
ArticleDelete
ArticleDeleteComplete
ArticleEditUpdateNewTalk
ArticleUndelete
CanonicalNamespaces
ChangesListSpecialPageQuery
EditPageGetCheckboxesDefinition
GetNewMessagesAlert
GetPreferences
ImportHandlePageXMLTag
InfoAction
LoadExtensionSchemaUpdates
MediaWikiPerformAction
ModifyExportQuery
MovePageIsValidMove
OldChangesListRecentChangesLine
OutputPageBeforeHTML
OutputPageParserOutput
PageContentLanguage
PageMoveComplete
PageSaveComplete
ParserFirstCallInit
PreferencesGetIcon
RenameUserSQL
RevisionUndeleted
ShowSearchHitTitle
SkinTemplateNavigation::Universal
SpecialPage_initList
SpecialSearchProfiles
TitleGetRestrictionTypes
UserIsBlockedFrom
UserMergeAccountFields
XmlDumpWriterOpenPage
getUserPermissionsErrors
Hooks provided
LiquidThreadsIsLqtPage
LiquidThreadsDoInlineEditForm
LiquidThreadsShowNewThreadForm
LiquidThreadsAfterShowNewThreadForm
LiquidThreadsSaveNewThread
LiquidThreadsShowReplyForm
LiquidThreadsSaveReply
LiquidThreadsEditFormContent
LiquidThreadsAfterReplyMetadataUpdates
LiquidThreadsAfterNewPostMetadataUpdates
LiquidThreadsThreadCommands
LiquidThreadsThreadMajorCommands
LiquidThreadsTopLevelCommands
LiquidThreadsShowThreadBody
LiquidThreadsShowPostContent
LiquidThreadsShowPostThreadBody
LiquidThreadsThreadSignature
LiquidThreadsThreadInfoPanel
LiquidThreadsShowThreadHeading
Licence
GNU General Public License 2.0 or later
Download extension
Git
Browse repository
GitHub
Gerrit code review
Git commit log
Download source tarball
README
Help
Help:Extension:LiquidThreads
Translate the LiquidThreads extension
if it is available at translatewiki.net
Issues
Open tasks
Report a bug
The
LiquidThreads
LQT
) extension implements a precursor threaded discussion page system.
Warning:
This extension is currently incompatible with
temporary accounts
Temporary accounts can be disabled with
$wgAutoCreateTempUser
'enabled'
false
in your LocalSettings.php.
History
LiquidThreads was originally developed by David McCabe as part of the
Google Summer of Code 2006
, then under sponsorship from
the Commonwealth of Learning
and
Wikia
The original LiquidThreads code was substantially improved and augmented by
Andrew Garrett
at the Wikimedia Foundation starting in May 2009.
This resulted in the release of LQT 2.0 in September 2009.
In January 2011, work on
LiquidThreads 3.0
was begun at the Wikimedia Foundation.
Andrew Garrett was the lead developer.
However, development by the Foundation was discontinued soon afterwards, in favor of the
Flow
extension (renamed in 2017 to StructuredDiscussions, and itself later abandoned as well).
The last commits to LQT3's branch (
lqt-updates
) were in September 2011.
User documentation
Main pages:
Help:Extension:LiquidThreads
and
Extension:LiquidThreads/FAQ
To activate LiquidThreads on a specific page on a wiki where LiquidThreads is
opt-in
, add the following to the page's source code:
{{#useliquidthreads:1}}
To deactivate LiquidThreads on a specific page on a wiki where LiquidThreads is
opt-out
add the following to the page's source code:
{{#useliquidthreads:0}}
Rationale
Wiki discussion pages have some advantages over web and Usenet forums:
They allow use of the entire wiki syntax, from images to links to
transclusions
It is possible to refactor entire discussion pages.
But web forums offer many more 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.
There can be restrictions on which users can edit other users' posts.
LiquidThreads aims to unite the advantages of both forum types, and to add some unique discussion features to boot.
Installation
Prerequisites:
LiquidThreads currently requires the
Extension:WikiEditor
extension to be already installed.
See
T40654
and move the extracted
LiquidThreads
folder to your
extensions/
directory.
Developers and code contributors should install the extension
from Git
instead, using:
cd
extensions/
git
clone
Add the following code at the bottom of your
LocalSettings.php
file:
wfLoadExtension
'LiquidThreads'
);
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.
Configuration
This is the default configuration of the extension. You can override such values in LocalSettings.php:
// Preferences
$wgDefaultUserOptions
'lqtnotifytalk'
false
$wgDefaultUserOptions
'lqtdisplaydepth'
$wgDefaultUserOptions
'lqtdisplaycount'
25
$wgDefaultUserOptions
'lqtcustomsignatures'
true
$wgDefaultUserOptions
'lqt-watch-threads'
true
// Permissions
$wgGroupPermissions
'user'
][
'lqt-split'
true
$wgGroupPermissions
'user'
][
'lqt-merge'
true
$wgGroupPermissions
'user'
][
'lqt-react'
true
/* Allows activation of LiquidThreads on individual pages */
$wgLqtPages
array
();
/* Allows switching LiquidThreads off for regular talk pages
(intended for testing and transition) */
$wgLqtTalkPages
true
/* Whether or not to activate LiquidThreads email notifications */
$wgLqtEnotif
true
/* Thread actions which do *not* cause threads to be "bumped" to the top */
/* Using numbers because the change type constants are defined in Threads.php, don't
want to have to parse it on every page view */
$wgThreadActionsNoBump
array
/* Edited summary */
10
/* Merged from */
12
/* Split from */
/* Edited root */
14
/* Adjusted sortkey */
);
/** Switch this on if you've migrated from a version before around May 2009 */
$wgLiquidThreadsMigrate
false
/** The default number of threads per page */
$wgLiquidThreadsDefaultPageLimit
20
/** Whether or not to allow users to activate/deactivate LiquidThreads per-page */
$wgLiquidThreadsAllowUserControl
true
/** Whether or not to allow users to activate/deactivate LiquidThreads
in specific namespaces. NULL means either all or none, depending
on the above. */
$wgLiquidThreadsAllowUserControlNamespaces
null
/** Allow LiquidThreads embedding */
$wgLiquidThreadsAllowEmbedding
true
/** Namespaces in which to enable LQT */
$wgLqtNamespaces
array
();
/** Enable/disable the bump checkbox. **/
$wgLiquidThreadsShowBumpCheckbox
false
/** Enable/Disable 'New messages' link and special page (Special:NewMessages) */
$wgLiquidThreadsEnableNewMessages
true
API
Main page:
Extension:LiquidThreads/API
See also
v:THREADNAV
– Wikiversity development on structured and threaded discussions using wiki-syntax for structures. Last activity was in 2007.
User:Inquisitor Ehrenstein/LQTavatar
– Forum-style LQT templates for including avatars and full forum style signatures.
Structured Discussions
– WMF effort for forum-style discussions; also deprecated.
Extension:DiscussionThreading
– Maintained and light-weight solution that will still allow editing the discussion page like a wiki page.
Extension:DiscussionTools
– Heavier WMF effort to integrate with normal wikitext talk pages.
Extension:DiscussionTools/Comparison
– Comparison between LQT and 3 other talk page tools.
External links
Sites using this extension
Phabricator task for LiquidThreads deployment
w:Wikipedia:LiquidThreads
LiquidThreads pictures on Commons
This extension is being used on one or more
Wikimedia projects
. This probably means that the extension is stable and works well enough to be used by such high-traffic websites. Look for this extension's name in Wikimedia's
CommonSettings.php
and
InitialiseSettings.php
configuration files to see where it's installed. A full list of the extensions installed on a particular wiki can be seen on the wiki's
Special:Version
page.
Retrieved from "
Categories
Unmaintained extensions
Page action extensions
Special page extensions
API extensions
Extensions which add rights
APIQueryAfterExecute extensions
AfterImportPage extensions
ArticleConfirmDelete extensions
ArticleDelete extensions
ArticleDeleteComplete extensions
ArticleEditUpdateNewTalk extensions
ArticleUndelete extensions
CanonicalNamespaces extensions
ChangesListSpecialPageQuery extensions
EditPageGetCheckboxesDefinition extensions
GetNewMessagesAlert extensions
GetPreferences extensions
ImportHandlePageXMLTag extensions
InfoAction extensions
LoadExtensionSchemaUpdates extensions
MediaWikiPerformAction extensions
ModifyExportQuery extensions
MovePageIsValidMove extensions
OldChangesListRecentChangesLine extensions
OutputPageBeforeHTML extensions
OutputPageParserOutput extensions
PageContentLanguage extensions
PageMoveComplete extensions
PageSaveComplete extensions
ParserFirstCallInit extensions
PreferencesGetIcon extensions
RenameUserSQL extensions
RevisionUndeleted extensions
ShowSearchHitTitle extensions
SkinTemplateNavigation::Universal extensions
SpecialPage initList extensions
SpecialSearchProfiles extensions
TitleGetRestrictionTypes extensions
UserIsBlockedFrom extensions
UserMergeAccountFields extensions
XmlDumpWriterOpenPage extensions
GetUserPermissionsErrors extensions
GPL licensed extensions
Extensions in Wikimedia version control
All extensions
Extensions incompatible with temporary accounts
Extensions used on Wikimedia
Discussion and forum extensions
Summer of Code 2006
LiquidThreads
Hidden categories:
Extensions without a compatibility policy
Extensions with manual MediaWiki version
Extension
LiquidThreads
Add topic