Extension:LiquidThreads

Manuel des extensions MediaWiki

LiquidThreads État de la version : non-maintenu
Implémentation	Action de page , Page spéciale , API
Description	Implémente un système de discussions structurées
Auteur(s)	David McCabe, Andrew Garrett
Dernière version	2.2-alpha (2014-03-28)
MediaWiki	1.29+
PHP	5.4+
Modifie la base de données	Oui
Tables thread thread_history thread_pending_relationship thread_reaction historical_thread user_message_state
Paramètres $egLqtNamespaceNumbers
Droits ajoutés Fusionner des fils de discussion (lqt-merge) Répondre aux fils de discussion (lqt-react) Séparer des fils de discussion (lqt-split)
Accroches utilisées 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
Accroches fournies LiquidThreadsIsLqtPage LiquidThreadsDoInlineEditForm LiquidThreadsShowNewThreadForm LiquidThreadsAfterShowNewThreadForm LiquidThreadsSaveNewThread LiquidThreadsShowReplyForm LiquidThreadsSaveReply LiquidThreadsEditFormContent LiquidThreadsAfterReplyMetadataUpdates LiquidThreadsAfterNewPostMetadataUpdates LiquidThreadsThreadCommands LiquidThreadsThreadMajorCommands LiquidThreadsTopLevelCommands LiquidThreadsShowThreadBody LiquidThreadsShowPostContent LiquidThreadsShowPostThreadBody LiquidThreadsThreadSignature LiquidThreadsThreadInfoPanel LiquidThreadsShowThreadHeading
Licence	Licence publique générale GNU v2.0 ou ultérieur
Téléchargement	Télécharger l'extension Git [?]: parcourir le dépôt (GitHub) relecture Gerrit du code historique Git des validations (commits) Télécharger le tarball source README
Traduire l’extension LiquidThreads sur translatewiki.net si elle y est disponible
Problèmes	Tâches ouvertes · Signaler un bogue

L'extension LiquidThreads (LQT) implémente un système de pages de discussion utilisant des fils de discussion.

Avertissement :

Cette extension n'est pas compatible actuellement avec les comptes temporaires. Les comptes temporaires peuvent être désactivés avec $wgAutoCreateTempUser['enabled'] = false; dans LocalSettings.php .

Historique

LiquidThreads a été développé initialement par David McCabe dans le cadre du Google Summer of Code 2006, puis sous le sponsoring du Commonwealth of Learning et de Wikia .

Le code original de LiquidThreads a été légèrement amélioré et augmenté par Andrew Garrett à la Fondation Wikimedia en mai 2009. Ce qui a donné la version LQT 2.0 en septembre 2009.

En janvier 2011, les travaux sur LiquidThreads 3.0 ont commencé à la Fondation Wikimedia. Andrew Garrett fut le développeur en chef. Cependant, le développement par la Fondation a été arrêté peu de temps après, en faveur de l'extension de Flow (renommée en 2017 StructuredDiscussions, qui fut aussi abandonnée plus tard). Les derniers commit dans la branche LQT3 (lqt-updates) datent de septembre 2011.

Documentation utilisateur

Pages principales : Help:Extension:LiquidThreads et Extension:LiquidThreads/FAQ

Pour activer LiquidThreads sur une page donnée d'un wiki où il est utilisé, ajouter ceci au code source de la page :

{{#useliquidthreads:1}}

Pour désactiver LiquidThreads sur une page donnée d'un wiki où il n'est pas utilisé, ajouter ceci au code source de la page :

{{#useliquidthreads:0}}

Principe

Les pages de discussion du wiki ont certains avantages sur le web et les forums Usenet :

• Ils permettent d'utiliser toute la syntaxe du wiki, allant des images aux liens et aux transclusions.
• Il est possible de restructurer entièrement des pages de discussion.

Mais les forums du web offrent beaucoup plus d'avantages que le modèle de page de discussion MediaWiki :

• Les fils de discussion peuvent être affichés de différentes manières : à plat, indentés, triés par date, par sujet, etc.
• L'utilisateur n'a besoin que de cliquer sur un bouton Répondre ou un lien pour répondre à un commentaire. L'indentation manuelle n'est pas demandée. Les citations du commentaire source peuvent être insérées automatiquement.
• Les commentaires sont automatiquement signés et datés.
• Les avatars sont possibles (mais pas encore créés).
• L'utilisateur peut suivre des threads individuels ou être notifié des réponses dans les threads.
• Les commentaires et les threads peuvent être affichés individuellement, sans la page environnante.
• Les anciens commentaires sont archivés de manière automatique et invisible, avec des liens permanents facilement accessibles.
• La recherche de l'auteur, du sujet, de la date, etc. est possible.
• Les threads individuels peuvent avoir des catégories.
• Il est relativement facile de gérer les discussions connexes dans un forum spécifique à un sujet, alors que les pages de discussion MediaWiki suivent toujours le modèle une page de discussion par page de sujet.
• Il peut y avoir des restrictions sur les utilisateurs pouvant modifier les messages d'autres utilisateurs.

LiquidThreads vise à unir les avantages des deux types de forums et à ajouter des fonctionnalités de discussion uniques au démarrage.

Installation

Prérequis : LiquidThreads exige actuellement que l'extension Extension:WikiEditor soit déjà installée. Voir T40654.

• Téléchargez et placez le(s) fichier(s) dans un répertoire appelé LiquidThreads dans votre dossier extensions/.
  Les développeurs et les contributeurs au code doivent à la place installer l'extension à partir de Git en utilisant:

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

• Ajoutez le code suivant à la fin de votre fichier LocalSettings.php  :

  wfLoadExtension( 'LiquidThreads' );
  

• Exécutez le script de mise à jour qui va créer automatiquement les tables de base de données dont cette extension a besoin.
• Fait – Accédez à Special:Version sur votre wiki pour vérifier que l'extension a bien été installée.

Configuration

C'est la configuration par défaut de l'extension. Vous pouvez redéfinir ces valeurs dans LocalSettings.php.

// préférences
$wgDefaultUserOptions['lqtnotifytalk'] = false;
$wgDefaultUserOptions['lqtdisplaydepth'] = 5;
$wgDefaultUserOptions['lqtdisplaycount'] = 25;
$wgDefaultUserOptions['lqtcustomsignatures'] = true;
$wgDefaultUserOptions['lqt-watch-threads'] = true;

// privilèges
$wgGroupPermissions['user']['lqt-split'] = true;
$wgGroupPermissions['user']['lqt-merge'] = true;
$wgGroupPermissions['user']['lqt-react'] = true;

/* activation de LiquidThreads sur des pages individuelles */
$wgLqtPages = array();

/* désactiver LiquidThreads sur les pages de discussion standard
	(destiné aux essais et à la transition) */
$wgLqtTalkPages = true;

/* activer ou non les notifications LiquidThreads par courriel */
$wgLqtEnotif = true;

/* actions des fils de discussion qui ne les propulsent pas en tête */
/* utiliser les nombres car les constantes de type de changement sont définies dans Threads.php, ne souhaite pas les analyser à chaque affichage de la page. */
$wgThreadActionsNoBump = array(
	3 /* résumé modifié */,
	10 /* fusionné à partir de */,
	12 /* segmenté à partir de */,
	2 /* racine modifiée */,
	14 /* clé de tri ajustée */
);

/** activer si vous avez migré d'une version d'avant mai 2009 */
$wgLiquidThreadsMigrate = false;

/** nombre par défaut de fils par page */
$wgLiquidThreadsDefaultPageLimit = 20;

/** permettre ou non aux utilisateurs d'activer / desactiver LiquidThreads par page */
$wgLiquidThreadsAllowUserControl = true;

/** permettre ou pas aux utilisateurs d'activer / désactiver LiquidThreads dans des espaces de noms spécifiques */
	NULL signifie tous ou aucun selon ce qui précède. */
$wgLiquidThreadsAllowUserControlNamespaces = null;

/** Permettre à LiquidThreads d'indenter */
$wgLiquidThreadsAllowEmbedding = true;

/** espaces de nom où LQT est activé */
$wgLqtNamespaces = array();

/** activer / désactiver la case à cocher des conflits. **/
$wgLiquidThreadsShowBumpCheckbox = false;

/** Activer / désactiver le lien 'Nouveaux messages' et la page spéciale (Special:NewMessages) */
$wgLiquidThreadsEnableNewMessages = true;

API

Page principale : Extension:LiquidThreads/API

Voir aussi

• v:THREADNAV – Développement de Wikiversité sur les discussions structurées et par fils en utilisant la syntaxe wiki des structures. La dernière activité a eu lieu en 2007.
• User:Inquisitor Ehrenstein/LQTavatar – Modèles LQT dans le style des forums pour inclure des avatars et des signatures dans le style global du forum.
• Discussions structurées – Efforts de la WMF pour des discussions dans le style des forums; également obsolète.
• Extension:DiscussionThreading – Solution légère et maintenue qui permettra toujours de modifier la page de discussion comme une page de wiki.
• Extension:DiscussionTools – Efforts plus importants de la WMF pour s'intégrer aux wikicode habituel des pages de discussion.
• Extension:DiscussionTools/Comparaison – Comparison entre LQT et 3 autres outils de page de discussion.

Liens externes

• Sites qui utilisent cette extension
• Phabricator task for LiquidThreads deployment
• w:Wikipedia:LiquidThreads
• images LiquidThreads sur Commons