Extension:LiquidThreads

From MediaWiki.org

Jump to: navigation, search

               

Manual on MediaWiki Extensions
List of MediaWiki Extensions
Crystal Clear action run.png
LiquidThreads

Release status: beta
Implementation  Page action, Special page
Description LiquidThreads is a new structured discussion system for MediaWiki, implemented as an extension.
Author(s)  David McCabe, Andrew Garrett
Last Version  2.0
MediaWiki  1.16
License GPL v2
Download Download snapshot

Subversion [Help]
Browse source code

README
Example  LiquidThreads beta testing at labs.mediawiki.org

check usage (experimental)

Liquid Threads is an extension that implements a new discussion page system. The original code was developed under sponsorship from the Google Summer of Code 2006, the Commonwealth of Learning, and Wikia. It is close to completion, and being worked on by Andrew Garrett under contract with the Wikimedia Foundation. It may eventually be deployed on some or all Wikimedia sites.

Contents

[edit] Demonstrations at Wikimania

start=26:33
(seek to 26:33)
start=20:30
(seek to 20:30)

[edit] Installation

  1. Download the files from SVN and place them under $IP/extensions/LiquidThreads
  2. Add the required tables to the database: php maintenance/sql.php extensions/LiquidThreads/lqt.sql
  3. Add
    require_once("$IP/extensions/LiquidThreads/LiquidThreads.php");
    into your wiki's LocalSettings.php
  4. Installation can be verified through Special:Version

[edit] 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.
  • 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 content page" model.

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

[edit] Addressing

Each thread has a unique and permanent wiki title, so they can be linked to: e.g., [[Thread:Talk:Main_Page/Thread 1]].

[edit] API

LiquidThreads adds a 'threads' list module to retrieve thread details.


Parameters

  • thstartid: The thread id to start enumerating from
  • thendid: The thread id to stop enumerating at
  • thdir: The direction in which to enumerate (older, newer)
  • thshowdeleted: ???
  • thlimit: The maximum number of threads to list
  • thprop: Which properties to get
  • thpage: Limit results to threads on a particular page(s)
  • thauthor: Limit results to threads by a particular author(s)
  • throot: Limit results to threads with the given root(s)
  • thsummary: Limit results to threads corresponding to the given summary page(s)
  • thid: Get threads with the given ID(s)
  • thrender: ???
  • threnderlevel: ???
  • threnderthreadpos: ???
  • threnderthreadcount: ???
  • threndermaxthreadcount: ???
  • threndermaxdepth: ???
  • threnderstartrepliesat: ???

Example Get details of all threads on "Talk:Main Page"

api.php ? action=query & list=threads & thpage=Talk:Main_Page
<api>
  <query>
    <threads>
      <thread id="1" subject="test" pagens="1" pagetitle="Talk:Main Page" parent="">
        <author id="0" name="127.0.0.1" />
      </thread>
      <thread id="2" subject="foo" pagens="1" pagetitle="Talk:Main Page" parent="">
        <author id="0" name="127.0.0.1" />
      </thread>
      <thread id="3" subject="foo" pagens="1" pagetitle="Talk:Main Page" parent="2">
        <author id="0" name="127.0.0.1" />
      </thread>
    </threads>
  </query>
</api>

[edit] See also

  • v:THREADNAV - an alternative project on Wikiversity on structured and threaded discussions, which uses wiki-syntax for structures and the NavFrames JavaScript for display
  • Extension:AWC's Forum - allows the display of a standalone forum within MediaWiki.

[edit] External links

[edit] Comments/feedback

I assume this section is where I can write my feedback?

  1. Old talk pages are not migrated into the new system.

That sucks, but it's not an easy problem to solve.

  1. Does 'you have new messages' still work?

Yes.

  1. if enotif is installed, can user be notified by email whenever a new topic or comment is added on a discussion page of a page included in his watch list and/or answers a comment of his ?
  1. What about moderation? There doesn't seem to be any way to delete abusive, obscene, off-topic or spam comments. Will that function be available to admins and bureaucrats?
  1. What is the purpose of letting posts be editable by other users? No other forum software does anything like that and I fail to see its utility. It's a recipe for edit wars. Yes, the edit history is available, but users should not have to go through histories in order to see if words attributed to a user were in fact inserted by someone else. If a post is signed by a user, which is automatically done in LiquidThreads, it should be editable only by that user.

[edit] Search of WikiEducator Google Group discussions

[edit] User comments

  • LQT (James Neill, WikiEducator)

[edit] Sites that use LiquidThreads

Retrieved from "http://www.mediawiki.org/wiki/Extension:LiquidThreads"