Extension:InlineComments

Manuel des extensions MediaWiki

InlineComments État de la version : stable
Implémentation	ContentHandler
Description	Permet d'ajouter des commentaires en ligne aux pages
Auteur(s)	WikiTeq Brian Wolff Yaron Koren Jayanth Vikash S
Dernière version	1.1
Politique de compatibilité	Pour chaque version de MediaWiki qui est une version avec support à long terme (LTS - Long Term Support) il existe une branche correspondante dans l'extension.
MediaWiki	1.40
Paramètres $wgInlineCommentsAutoDeleteComments $wgInlineCommentsNamespaces
Droits ajoutés inlinecomments-add inlinecomments-edit-all inlinecomments-view
Accroches utilisées BeforeCreateEchoEvent BeforePageDisplay ChangeTagsListActive ListDefinedTags MediaWikiServices MultiContentSave UserGetReservedNames
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 InlineComments sur translatewiki.net si elle y est disponible
Problèmes	Tâches ouvertes · Signaler un bogue

L'extension InlineComments ajoute la possibilité pour les lecteurs d'ajouter des commentaires en ligne à une page, similaire aux commentaires en ligne dans Confluence ou aux annotations dans les outils tels que Google Docs.

Utilisation

Pour attachez un commentaire à un texte spécifique, mettez d'abord en évidence le texte auquel vous souhaitez joindre le commentaire. Une icône + va apparaître ensuite. Si vous cliquez dessus ou utilisez le raccourci clavier Ctrl+Alt+M, un formulaire de saisie du commentaire apparaîtra sur le côté. Remplissez la zone de texte et appuyez sur Enregistrer pour enregistrer votre commentaire.

Une fois le commentaire fait, chacun peut y répondre en appuyant sur le bouton Répondre et en ajoutant plus de texte. Un fil de discussion dans InlineComments peut atteindre n'importe quelle longueur.

Les commentaires peuvent être modifiés par l'auteur ou l'administrateur en appuyant sur l'icône du crayon sur le côté droit du commentaire.

Vous pouvez également supprimer un sujet (qui peut inclure un ou plusieurs commentaires) en appuyant sur le bouton Fermer la discussion. Cela supprimera tout ce texte à partir de la position de InlineComments dans la page. Comme cette suppression apparaît dans l'historique de la page, vous pouvez l'annuler à tout moment, et restaurer le fil, simplement en annulant cette modification.

Les utilisateurs peuvent être mentionnés dans les commentaires en utilisant l'annotation @.

Si l'Extension:Echo est installée.

• La mention d'un utilisateur dans un commentaire en ligne déclenchera une notification en écho à cet utilisateur.
• Le créateur de fil de commentaires sera également informé de chaque réponse ou de la fermeture du fil.

Tous les commentaires en ligne reçoivent la balise inlinecomments pour les filtrer facilement sur les balises, dans Special:RecentChanges et Special:Watchlist.

Voir aussi les captures d'écran ci-dessous.

Téléchargement

Vous pouvez télécharger le code de InlineComments dans le format .zip

Vous pouvez également télécharger le code directement via Git depuis le dépôt de code source MediaWiki. À partir d'une ligne de commande, appelez ceci :

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

Pour voir le code en ligne, y compris l'historique de version de chaque fichier, allez sur : voir le code InlineComments

Installation

• Téléchargez et placez le(s) fichier(s) dans un répertoire appelé InlineComments 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/InlineComments
  

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

  wfLoadExtension( 'InlineComments' );
  

• Configurer si nécessaire.
• Fait – Accédez à Special:Version sur votre wiki pour vérifier que l'extension a bien été installée.

Configuration

Les paramètres suivants peuvent être ajoutés à LocalSettings.php :

$wgInlineCommentsAutoDeleteComments

indique s'il faut supprimer automatiquement les commentaires quand le texte auquel ils sont attachés est supprimé (par défaut à true)

$wgInlineCommentsNamespaces

espaces de noms où InlineComments doit être uniquement activé. Par défaut la valeur est $wgContentNamespaces. Quand initialisé explicitement avec un tableau d'espaces de noms, $wgContentNamespaces ne sera pas inclus à moins que l'utilisateur ne l'ajoute dans LocalSettings.php

InlineComments définit les droits utilisateurs suivants :

inlinecomments-add

indique si vous pouvez ajouter ou supprimer des commentaires sur une page. Par défaut, cette possibilité est donnée à tous les utilisateurs connectés.

inlinecomments-view

indique si les commentaires en ligne vous sont affichés. Veuillez noter que ceci contrôle l'interface par défaut mais les utilisateurs peuvent encore voir les commentaires existants par d'autres moyens s'ils ont les droits d'accès en lecture sur le wiki, comme pour l'historique de la page ou par l'API.

inlinecomments-edit-all

indique si vous pouvez modifier tous les commentaires en ligne sur une page. Par défaut, attribué aux utilisateurs qui sont des opérateurs système.

Captures d'écran

• 
  Cliquez sur la fenêtre contextuelle ou utilisez le raccourci clavier Ctrl+Alt+M pour ajouter un nouveau commentaire au texte mis en évidence.
• 
  Entrez votre commentaire dans le formulaire contextuel et enregistrez les modifications.
• 
  Une fois qu'un commentaire est fait, vous pouvez le voir sur le côté et lorsque vous survolez le texte avec la souris.
• 
  Tout fil de commentaire peut être répondu, fermé, ou effacé. En cliquant sur Fermer la discussion vous supprimez le fil du commentaire; il reste disponible dans l'historique de la page.
• 
  Chaque action de commentaire est enregistrée dans l'historique de la page, de où elle peut être aussi annulée.

Historique des versions

• 0.1 – 29 avril 2023 – version initiale
• 0.2 – 27 février 2024 – améliorations de l'apparence, correction de plusieurs bogues
• 0.3 – 11 avril 2024 – paramètre $wgInlineCommentsAutoResolveComments renommé en $wgInlineCommentsAutoDeleteComments; renommage de Marquer résolu en Fermer la discussion; ajout du droit inlinecomments-view; ajout de l'affichage de l'horodatage à la création du commentaire
• 1.0 – 21 août 2024 – Ajout des mentions utilisateur en même temps que l'autocomplétion; ajout de la fonctionnalité de modification aux commentaires; ajout du paramètre $wgInlineCommentsNamespaces; remplace le diff JSON par un diff personnalisé pour les modifications des commentaires; rendre la barre latérale indépendante de l'habillage; ajout de la balise inlinecomments pour toutes les modifications des commentaires; correction des problèmes de droits pour l'affichage et la modification des droits des utilisateurs non connectés, des utilisateurs bloqués et des utilisateurs masqués; ajout de la notification par Echo pour l'initiateur du commentaire lors de la réponse ou de la clôture; ajout de la notification par Echo pour l'utilisateur mentionné
• 1.0.1 – 15 janvier 2025 – amélioration de la gestion avec MW 1.42+; code simplifié de l'utilisation de l’Éditeur visuel
• 1.1 – 22 avril 2025 – suppression de la gestion des versions antérieures à celles de MW 1.40 ; gestion améliorée pour MW 1.44+; amélioration du code

Voir aussi

• Extension:SmartComments