Extension: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. |
| Licence | Licence MIT |
| Téléchargement | |
|
|
| Téléchargements trimestriels | 23 (Ranked 113rd) |
| 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.
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
- Téléchargez et placez le(s) fichier(s) dans un répertoire appelé
Thanksdans votre dossierextensions/.
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 ».
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 :
$wgThanksAllowedLogTypes = [
"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
| thank | |
|---|---|
Ce module ne peut pas être utilisé comme générateur. | |
| Préfixe | |
| Droits exigés | aucun |
| POST seulement ? | Oui |
| Aide générée | Version actuelle |
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 bienlog)log- ID de connexion pour lequel vous souhaitez remercier la personne (utilisez obligatoirement ceci ou bienrev)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
| flowthank | |
|---|---|
Ce module ne peut pas être utilisé comme générateur. | |
| Préfixe | |
| Droits exigés | aucun |
| POST seulement ? | Oui |
| Aide générée | Version actuelle |
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
- w:Wikipedia:Notifications/Thanks - Informations sur l'utilisation de cette extension sur la Wikipedia anglophone
- Echo (Notifications)/Feature requirements#Thank_you_notification - proposition initiale de la fonctionnalité (pour l'extension Echo)
- Extension:WikiLove - une autre extension pour exprimer votre gratitude
- Extension:Echo - fournit le système de notification
| Cette extension est utilisée par au moins un des projets Wikimédia. Cela signifie probablement que l’extension est assez stable et fonctionnelle pour être utilisée sur des sites à fort trafic. Recherchez le nom de cette extension dans le CommonSettings.php de Wikimédia et dans le fichier de configuration InitialiseSettings.php pour situer les endroits où elle est installée. Une liste complète des extensions installées sur un Wiki donné peut être visualisée sur la page Special:Version de ce wiki. |
| Cette extension est incluse dans les fermes de wikis ou les hôtes suivants et / ou les paquets : Cette liste ne fait pas autorité. Certaines fermes de wikis ou hôtes et / ou paquets peuvent contenir cette extension même s'ils ne sont pas listés ici. Vérifiez toujours cela avec votre ferme de wikis ou votre hôte ou votre paquet avant de confirmer. |