Extension:Thanks

From mediawiki.org
This page is a translated version of the page Extension:Thanks and the translation is 100% complete.
Manuel des extensions MediaWiki
OOjs UI icon advanced-invert.svg
Thanks
État de la version : stable
History-Thank-Link-Mockup1.png
Implémentation Interface utilisateur
Description Permet aux utilisateurs de remercier d’autres utilisateurs pour leurs modifications, etc.
Auteur(s)
Dernière version 1.2.0 (mises à jour continues)
Politique de compatibilité Versions ponctuelles alignées avec MediaWiki. Le master n'est pas compatible arrière.
MediaWiki 1.31+
PHP 5.4+
Licence Licence MIT
Téléchargement
  • $wgThanksAllowedLogTypes
  • $wgThanksConfirmationRequired
  • $wgThanksLogging
  • $wgThanksSendToBots
Traduire l’extension Thanks sur translatewiki.net si elle y est disponible

Vérifier la matrice des utilisations et des versions.

Rôle Vagrant echo
Problèmes Tâches ouvertes · Signaler un bogue

L’extension Thanks (remerciements) ajoute une manière rapide d’émettre un retour positif pour les contributions constructives aux sites MediaWiki. Elle permet aux utilisateurs d’envoyer des notifications « Merci » publiques (via Echo ) aux autres utilisateurs pour leurs contributions individuelles et certaines actions journalisées.

La révision sur laquelle porte le remerciement n’est pas enregistrée dans la table publique de journalisation. Seuls l’horodatage, l’émetteur et le destinataire sont publiquement journalisés.

Un lien « remercier » est ajouté aux endroits suivants :

  • à côté du lien « annuler » dans l’historique et les vues diff ;
  • sur certaines entrées de journal sur Special:Log (voir ci-après) ; et
  • aux commentaires des tableaux des Discussions structurées, si l’extension Discussions structurée est installée.

Elle fournit aussi une API pour envoyer des remerciements.

Remarquez que si vous ne voulez pas être remercié, vous pouvez facilement désactiver cette notification dans vos préférences, comme décrit plus bas.

Example of a 'thanks' notification

Si vous avez pu la tester, nous accueillerons avec plaisir vos commentaires sur cette fonctionnalité sur la page de discussion.

Nous espérons que les notifications émises par Thanks rendront plus visible l’appréciation par autrui du travail de chacun – et cela devrait être particulièrement utile pour encourager les nouveaux utilisateurs pendant leurs premiers pas critiques sur le wiki. Nous avons intentionnellement gardé cette extension aussi simple que possible, afin de pouvoir l'évaluer et l’améliorer ensemble. Faites-vous plaisir…

Téléchargement

Cette extension peut être récupérée directement depuis Git [?]:

  • Naviguer dans le code
  • Certaines extensions étiquettent les versions stables.
  • Chaque branche correspond à une version antérieure de MediaWiki. Il y a aussi une branche master (maître) qui contient la dernière version alpha (elle peut nécessiter une version alpha de MediaWiki)

Décompressez l'instantané et placez-le dans le répertoire extensions/Thanks/ de votre installation MediaWiki.

Si vous êtes familier de Git et si vous avez un accès au shell de votre serveur, vous pouvez aussi obtenir l'extension de la manière suivante:

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

Installation

Thanks a besoin, en prérequis, que l’extension Echo soit installée.

Pour les utilisateurs de MediaWiki 1.26 ou précédents :

Les instructions ci-dessus décrivent la nouvelle procédure pour installer cette extension en utilisant wfLoadExtension(). Si vous avez besoin d'installer cette extension sur les précédentes versions de MediaWiki (1.26 ou antérieur), à la place de wfLoadExtension( 'Thanks' );, vous devez utiliser :

require_once "$IP/extensions/Thanks/Thanks.php";

Configuration

Activer l’interface Remercier pour les modifications faites par des robots (désactivée par défaut).

$wgThanksSendToBots = false;

Journaliser les actions Remercier dans « Spécial:Journal » (activé par défaut).

$wgThanksLogging = true;

Définit si la confirmation est requise ou non pour envoyer des remerciements (activé par défaut).

$wgThanksConfirmationRequired = true;

Types de remerciements tracés dans le journal à partir de Special:Log :

$wgThanksLogTypeWhitelist = [
	"contentmodel",
	"delete",
	"import",
	"merge",
	"move",
	"patrol",
	"protect",
	"tag",
	"managetags",
	"rights"
];

Utilisation

Pour remercier un autre utilisateur, ouvrez l'onglet Historique de toute page. A côté de chaque révision se trouve un lien de 'remerciement'. En cliquant sur ce lien, vous envoyez vos remerciements à cet utilisateur. Ce lien est également disponible dans la vue diff, pour certaines entrées de Special:Log, et sous les commentaires des tableaux des Discussions Structurées (si ces dernières sont installées).

Lorsque vous cliquez sur le lien de remerciement, le destinataire recevra une notification avec vos remerciements via l'extension Echo (sauf s'il s'est désabonné pour ne plus recevoir les notifications de remerciement). Une trace de l'action est également enregistrée comme entrée du journal dans Special:Log/thanks.

Si le wiki utilise la mémoire cache, un seuil maximal de 10 remerciements par minute est imposé. La limite est paramètrable avec $wgRateLimits ['thanks-notification'].

Ne plus recevoir de remerciement

Pour arrêter la réception des notifications de remerciement, vous pouvez les désabonner dans vos préférences de notification. Allez dans l'onglet Notifications de vos préférences. Ceci vous empêche de recevoir les notifications mais n'empêche pas les autres utilisateurs de vous envoyer leurs remerciements.

Documentation de l'API

L'extension Thanks possède une API pour envoyer des remerciements. Pour l'appeler, utilisez le paramètre action=thank.

Paramètres :

  • rev - ID de révision pour laquelle vous souhaitez remercier une personne (utilisez obligatoirement ceci ou bien log)
  • log - ID de connexion pour lequel vous souhaitez remercier la personne (utilisez obligatoirement ceci ou bien rev)
  • source - Emetteur de l'événement de remerciement. Courte chaîne de caractères identifiant l'origine des remerciements. Par exemple, si les remerciements viennent de Huggle, la valeur peut être 'huggle'. (facultatif)
  • token - Jeton d'édition (a.k.a. jeton CSRF). Vous pouvez en obtenir un via l'API Tokens. (obligatoire)

Exemple :

 api.php?action=thank&rev=16543&token=%2B\

Pour envoyer vos remerciements via OAuth , seules les droits de base sont nécessaires. Un exemple Python se trouve ici.


Documentation de la journalisation

Pour comprendre qui vous a remercié en lisant les traces il faut comprendre la signification des colonnes. Dans la table logging , log_title représente le destinataire , et log_user_text représente l'émetteur.

Pour illustrer cela, le code SQL ci-après recherche tous les remerciements reçus par un utilisateur pendant une période donnée :

select log_timestamp as thank_timestamp, replace(log_title, '_', ' ') as receiver, log_user_text as sender
  from logging_logindex where log_title = :user_name
    and log_action = 'thank'
    and :start_date <= log_timestamp
    and log_timestamp <= :end_date

Notez également que la table logging n'est pas accédée directement, mais que sur les serveurs Wikimedia on utilise plutôt la table logging_logindex. Pour chercher rapidement tous les remerciements envoyés par un utilisateur, logging_userindex donne l'index correct.

Flux de Thanks

Il existe une API spécifique pour envoyer les Thanks pour les commentaires des tableaux des Discussions Structurées. Pour appeler l'API, utilisez action=flowthank.

Paramètres :

  • postid - UUID du commentaire pour lequel vous souhaitez envoyer vos remerciements (obligatoire)
  • token - Jeton d'édition. Vous pouvez en acquérir un via prop=info. (obligatoire)

Exemple :

 api.php?action=flowthank&postid=abc123&token=%2B\

Erreurs et avertissements

Code Informations
invalidrecipient Aucun destinataire valide trouvé
Les robots ne peuvent pas être remerciés
Vous ne pouvez pas vous remercier vous-même.


Voir aussi