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. |
MediaWiki | 1.31+ |
PHP | 5.4+ |
Licence | Licence MIT |
Téléchargement | |
|
|
Téléchargements trimestriels | 77 (Ranked 106th) |
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…
Téléchargement
Cette extension peut être récupérée directement depuis Git [?]:
- Naviguer dans le code
- Certaines extensions étiquettent les versions stables.
- Naviguer dans les Étiquettes
- Sélectionner l'étiquette
- Cliquer sur snapshot (instantané)
- 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)
- Naviguer dans les branches
- Sélectionnez le nom d'une branche
- Cliquez sur « Continuer »
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
- Téléchargez et placez le(s) fichier(s) dans un répertoire appelé
Thanks
dans votre dossierextensions/
. - 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 :
$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
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 - Information about the usage of this extension on English Wikipedia
- 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 paquets et / ou les fermes de wikis suivants : Cette liste ne fait pas autorité. Certaine fermes de wikis ou d'hébergeurs peuvent contenir ce extension même s'ils ne figurent pas ici. Vérifiez toujours cela dans votre environement avant de confirmer. |