扩展:LQT

**MediaWiki扩展手册**
LiquidThreads; 发行状态：不再維護
实现	页面操作, 特殊页面, API
描述	Implements a structured discussion system
作者	David McCabe, Andrew Garrett
最新版本	2.2-alpha (2014-03-28)
MediaWiki	1.29+
PHP	5.4+
数据库更改	是
Composer	mediawiki/liquid-threads
表	thread; thread_history; thread_pending_relationship; thread_reaction; historical_thread; user_message_state
许可协议	GNU通用公眾授權條款2.0或更新版本
下載	下載扩展 ; Git [?]: 下载Git master; 浏览存储库 (GitHub); 提交历史; 存储库貢獻者 (GitHub); 代码复核; ; README
	参数 $egLqtNamespaceNumbers;
	添加权限 Merge threads (lqt-merge); Reply to threads (lqt-react); Split threads (lqt-split);
	使用的函数钩 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;
	提供的函数钩 LiquidThreadsIsLqtPage; LiquidThreadsDoInlineEditForm; LiquidThreadsShowNewThreadForm; LiquidThreadsAfterShowNewThreadForm; LiquidThreadsSaveNewThread; LiquidThreadsShowReplyForm; LiquidThreadsSaveReply; LiquidThreadsEditFormContent; LiquidThreadsAfterReplyMetadataUpdates; LiquidThreadsAfterNewPostMetadataUpdates; LiquidThreadsThreadCommands; LiquidThreadsThreadMajorCommands; LiquidThreadsTopLevelCommands; LiquidThreadsShowThreadBody; LiquidThreadsShowPostContent; LiquidThreadsShowPostThreadBody; LiquidThreadsThreadSignature; LiquidThreadsThreadInfoPanel; LiquidThreadsShowThreadHeading;
季度下載量	9 (Ranked 135th)
	前往translatewiki.net翻譯LiquidThreads扩展
問題	开启的任务 · 报告错误

This page is a translated version of the page Extension:LiquidThreads and the translation is 2% complete.

The LiquidThreads (LQT) extension implements a precursor 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. The last commits to LQT3's branch (lqt-updates) 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 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}}

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 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.

下载文件，并将其放置在您extensions/文件夹中的LiquidThreads目录内。
开发者和代码贡献人员应从Git安装扩展，输入：cd extensions/ git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/LiquidThreads
将下列代码放置在您的LocalSettings.php 的底部：
```
wfLoadExtension( 'LiquidThreads' );
```
运行更新脚本，它将自动创建此扩展必须依赖的数据库表。
完成 – 在您的wiki上导航至Special:Version，以验证已成功安装扩展。

Configuration

This is the default configuration of the extension. You can override such values in LocalSettings.php:

// Preferences
$wgDefaultUserOptions['lqtnotifytalk'] = false;
$wgDefaultUserOptions['lqtdisplaydepth'] = 5;
$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(
	3 /* Edited summary */,
	10 /* Merged from */,
	12 /* Split from */,
	2 /* 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

Notes

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

External links

此扩展用于一个或多个维基媒体项目。这可能意味着扩展足够稳定、运作足够良好，可以用在这样的高流量的网站上。请在维基媒体的CommonSettings.php和InitialiseSettings.php配置文件中查找此扩展的名称以查看哪些网站安装了该扩展。特定wiki上的已安装的扩展的完整列表位于Special:Version页面。