Extension:LiquidThreads

Příručka k rozšířením MediaWiki

LiquidThreads Stav rozšíření: neudržované
Implementace	Akce stránky , Speciální stránka , API
Popis	Implementuje strukturovaný diskusní systém
Autoři	David McCabe, Andrew Garrett
Nejnovější verze	2.2-alpha (2014-03-28)
MediaWiki	1.29+
PHP	5.4+
Změny v databázi	Ano
Tabulky	thread thread_history thread_pending_relationship thread_reaction historical_thread user_message_state
Licence	GNU General Public License 2.0 nebo novější
Stáhnout	Stáhněte si rozšíření Git [?]: Procházení úložiště (GitHub) Kontrola kódu Gerrit Zobrazení historie Git Stáhněte si zdrojový soubor tarball README
Parametry $egLqtNamespaceNumbers
Přidaná práva Sloučení vláken (lqt-merge) Odpovědět na vlákna (lqt-react) Rozdělení vlákna (lqt-split)
Použité háčky (hooks) 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
Poskytované háčky (hooks) LiquidThreadsIsLqtPage LiquidThreadsDoInlineEditForm LiquidThreadsShowNewThreadForm LiquidThreadsAfterShowNewThreadForm LiquidThreadsSaveNewThread LiquidThreadsShowReplyForm LiquidThreadsSaveReply LiquidThreadsEditFormContent LiquidThreadsAfterReplyMetadataUpdates LiquidThreadsAfterNewPostMetadataUpdates LiquidThreadsThreadCommands LiquidThreadsThreadMajorCommands LiquidThreadsTopLevelCommands LiquidThreadsShowThreadBody LiquidThreadsShowPostContent LiquidThreadsShowPostThreadBody LiquidThreadsThreadSignature LiquidThreadsThreadInfoPanel LiquidThreadsShowThreadHeading
Přeložte rozšíření LiquidThreads, používá-li lokalizaci z translatewiki.net
Problémy	Otevřené úkoly · Nahlásit chybu

Rozšíření LiquidThreads (LQT) implementuje systém diskusních stránek s vlákny, který byl prekurzorem.

Varování:

This extension is currently incompatible with temporary accounts. Temporary accounts can be disabled with $wgAutoCreateTempUser['enabled'] = false; in your LocalSettings.php.

Historie

Původní kód vyvinul David McCabe pod záštitou Google Summer of Code 2006, Commonwealth of Learning a Wikia .

Původní kód LiquidThreads byl od května 2009 podstatně vylepšen a rozšířen Andrewem Garrettem z Wikimedia Foundation. To vedlo k vydání LQT 2.0 v září 2009.

V lednu 2011 začala práce na projektu LiquidThreads 3.0 v Wikimedia Foundation. Andrew Garrett byl hlavním vývojářem. Vývoj Nadací byl však brzy poté zastaven ve prospěch rozšíření Flow (v roce 2017 přejmenovaného na StructuredDiscussions a později také opuštěno). Poslední závazky k oddělení LQT3 (lqt-updates) byly provedeny v září 2011.

Dokumentace pro uživatele

Hlavní stránky: Help:Extension:LiquidThreads a Extension:LiquidThreads/FAQ

Chcete-li aktivovat LiquidThreads na konkrétní stránce wiki, kde je LiquidThreads přihlášen, přidejte do zdrojového kódu stránky následující kód:

{{#useliquidthreads:1}}

Chcete-li deaktivovat LiquidThreads na konkrétní stránce wiki, kde je LiquidThreads odhlášen, přidejte do zdrojového kódu stránky následující kód:

{{#useliquidthreads:0}}

Zdůvodnění

Diskusní stránky wiki mají oproti webovým fórům a fórům uživatelů určité výhody:

• Umožňují použití celé syntaxe wiki, od obrázků přes odkazy až po transkluze.
• Je možné refaktorovat celé diskusní stránky.

Webová fóra však nabízejí oproti modelu diskusních stránek MediaWiki mnohem více výhod:

• Vlákna lze zobrazit v různých zobrazeních: ploché, vnořené, seřazené podle data, předmětu atd.
• Uživatel stačí kliknout na tlačítko nebo odkaz "Reply" (odpovědět), aby mohl reagovat na komentář. Ruční odsazení není nutné. Citace ze zdrojového komentáře lze vkládat automaticky.
• Komentáře jsou automaticky podepsány a datovány.
• Avatary jsou možné (ale zatím nebyly vytvořeny).
• Uživatel si může prohlížet jednotlivá vlákna nebo být upozorněn na odpovědi ve vláknech.
• Komentáře a vlákna lze zobrazit jednotlivě, bez okolní stránky.
• Staré komentáře jsou archivovány automaticky a neviditelně, s trvalými odkazy, které jsou snadno dostupné.
• Je možné vyhledávat podle autora, předmětu, data atd.
• Jednotlivá vlákna mohou mít kategorie.
• Správa souvisejících diskusí v tematicky zaměřeném fóru je relativně snadná, zatímco diskusní stránky MediaWiki se vždy řídí modelem "jedna diskusní stránka na stránku tématu".
• Mohou existovat omezení, která by uživatelům umožnila upravovat příspěvky jiných uživatelů.

LiquidThreads si klade za cíl sjednotit výhody obou typů fór a navíc přidat některé unikátní funkce pro diskusi.

Instalace

Předpoklady: LiquidThreads aktuálně vyžaduje, aby bylo již nainstalováno rozšíření Extension:WikiEditor . Viz T40654.

• Stáhněte soubor/y a vložte je do adresáře pojmenovaného LiquidThreads ve vaší složce extensions/.
  Vývojáři a přispěvatelé kódu by si místo toho měli nainstalovat rozšíření from Git pomocí:

  cd extensions/
  git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/LiquidThreads
  

• Na konec vašeho souboru LocalSettings.php přidejte následující kód:

  wfLoadExtension( 'LiquidThreads' );
  

• Spusťte aktualizační skript, který automaticky provede všechny nezbytné databázové změny, jaké rozšíření vyžaduje.
• Dokončeno – Přejděte na stránku Special:Version vaší wiki a zkontrolujte, zda bylo rozšíření úspěšně nainstalováno.

Nastavení

Toto je výchozí konfigurace rozšíření. Tyto hodnoty můžete přepsat v souboru 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

Hlavní stránka: Extension:LiquidThreads/API

Související odkazy

• v:THREADNAV – vývoj Wikiverzity na strukturovaných a vláknových diskusích s využitím wiki-syntaxe pro struktury. Poslední aktivita proběhla v roce 2007.
• User:Inquisitor Ehrenstein/LQTavatar – šablony LQT ve stylu fóra pro zahrnutí avatarů a plných podpisů ve stylu fóra.
• Strukturované diskuse – snaha WMF pro diskuse ve stylu fóra. Také zastaralá.
• Extension:DiscussionThreading – udržované a nenáročné řešení, které i nadále umožní upravovat diskusní stránku jako wiki stránku.
• Rozšíření:DiscussionTools – větší úsilí WMF o integraci s běžnými diskusními stránkami wikitextu.
• Extension:DiscussionTools/Comparison – srovnání LQT a 3 dalších nástrojů pro diskusní stránky.

Externí odkazy

• Weby používající toto rozšíření
• Phabricator task for LiquidThreads deployment
• w:Wikipedia:LiquidThreads
• Obrázky LiquidThreads na Commons