Extension:Thanks/fr

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



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…

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

Journaliser les actions Remercier dans « Spécial&#58;Journal » (activé par défaut).

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

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

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.



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.

Paramètres :


 * - ID de révision pour laquelle vous souhaitez remercier une personne (utilisez obligatoirement ceci ou bien )
 * - ID de connexion pour lequel vous souhaitez remercier la personne (utilisez obligatoirement ceci ou bien )
 * - 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)
 * - 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, 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,  représente le destinataire , et   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 :

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. Pour chercher rapidement tous les remerciements envoyés par un utilisateur,  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.

Paramètres :
 * - UUID du commentaire pour lequel vous souhaitez envoyer vos remerciements (obligatoire)
 * - 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


Voir aussi

 * w:Wikipedia:Notifications/Thanks - Information about the usage of this extension on English Wikipedia
 * - proposition initiale de la fonctionnalité (pour l'extension Echo)
 * - une autre extension pour exprimer votre gratitude
 * - fournit le système de notification