Extension:Thanks

From mediawiki.org
This page is a translated version of the page Extension:Thanks and the translation is 100% complete.
Cette extension est fournie avec MediaWiki 1.40 et supérieur. Ainsi vous n'avez pas besoin de la télécharger à nouveau. Néanmoins, vous devez encore suivre les autres instructions fournies.
Manuel des extensions MediaWiki
Thanks
État de la version : stable
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.42
Licence Licence MIT
Téléchargement
  • $wgThanksAllowedLogTypes
  • $wgThanksConfirmationRequired
  • $wgThanksLogging
  • $wgThanksSendToBots
Téléchargements trimestriels 52 (Ranked 99th)
Utilisé par les wikis publics 2,442 (Ranked 193rd)
Traduire l’extension Thanks sur translatewiki.net si elle y est disponible
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…

Installation

Thanks a besoin, en prérequis, que l’extension Echo soit installée.
  • Téléchargez et placez le(s) fichier(s) dans un répertoire appelé Thanks 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/Thanks
  • Ajoutez le code suivant à la fin de votre fichier LocalSettings.php  :
    wfLoadExtension( 'Thanks' );
    
  • Si nécessaire, faites les réglages à votre convenance.
  • Allez sur l’action Historique d’une page pour voir la nouvelle interface « Remercier ».
  • Yes Fait – Accédez à Special:Version sur votre wiki pour vérifier que l'extension a bien été installée.

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 la 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.

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.

Documentation SQL

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.


Voir aussi