Extension:WikiLove/fr

Wikilove est une extension conçue pour promouvoir l'expansion de WikiLove dans Wikipédia ainsi que dans les autres wikis. En particulier, il permet d'ajouter des récompenses, des cadeaux et des invitations sur les pages de discussion des utilisateurs aussi simplement qu'en cliquant sur quelques boutons.

Installation
Si vous souhaitez utiliser les récompenses intégrées, vous devez avoir activé InstantCommons. Pour faire cela, ajoutez ceci à votre fichier LocalSettings.php :

L'extension doit maintenant être active. Allez dans l'onglet d'édition de vos Préférences pour ouvrir l'interface.

Vous pouvez également utiliser ces options de configuration dans votre fichier LocalSettings.php :


 * - activez l'extension pour tous les utilisateurs, en faisant sauter la préférence utilisateur (valeur par défaut: false)




 * - utilisez une icône pour les habillages qui la prennent en charge (par exemple Vector) (valeur par défaut : true)
 * - permet de tracer les attributions de WikiLove (valeur par défaut : false); ceci crée automatiquement une table  dans la base de données, que vous pouvez réutilser à des fins statistiques

Utilisation
Pour autoriser votre compte à utiliser WikiLove, allez dans l'onglet d'édition de vos Préférences et activez WikiLove dans Labs features (ou, dans certaines versions, sous Options Générales). In September 2022 this displays as "Enable showing appreciation for other users with the WikiLove tab".

Pour utiliser WikiLove, allez sur la page de discussion d'un utilisateur et cliquez sur l'icône en forme de coeur. Suivez ensuite les instructions qui vous seront données.



Configuration de base
Pour savoir comment personnaliser WikiLove pour un contributeur individuel (plutôt que pour le wiki entier), voir la documentation utilisateur.

Vous pouvez personnaliser les options pour votre propre wiki en modifiant la page MediaWiki:WikiLove.js. Sur cette page, vous pouvez modifier les paramètres de la même manière que vous le faites avec les options intégrées :. Voici quelques exemples de configurations WikiLove personnalisées :


 * Wikipedia
 * sq:MediaWiki:WikiLove.js (remplace complètement tous les paramètres WikiLove)
 * pt:MediaWiki:WikiLove.js (remplace complètement tous les paramètres WikiLove)
 * ml:MediaWiki:WikiLove.js
 * en:MediaWiki:WikiLove.js
 * Wikimedia Commons

Les options présentes en haut de ne représentent que quelques paramètres par défaut pour votre commodité. Si vous omettez certaines propriétés pour les types ou les sous-types, ces valeurs par défaut seront utilisées. Ensuite vient la liste des types. Chaque type peut avoir les propriétés  (nécessaire) et   (facultatif). De plus, un type peut avoir ou pas, une liste de sous-types auquel cas les propriétés supplémentaires seront attribuées au type lui-même.

Si le type possède des sous-types, ceux-ci sont listés dans un objet liste. Optionnel : le type peut aussi avoir la propriété, qui représente le libellé au-dessus du menu déroulant. Chaque sous-type peut avoir les propriétés suivantes :


 * - nom dans le menu déroulant
 * - Description du sous-type
 * - Entête du message à ajouter, c'est à dire la partie qui sera entre
 * - Titre de la boîte à message
 * - Texte de la boîte à message (voir ci-dessous pour les détails)
 * - Image de la boîte à message


 * - Galerie pour choisir une image (voir ci-dessous pour les détails)
 * - Tableau des champs que l'utilisatuer peut modifier; peut contenir les valeurs suivantes :
 * - Taille de l'image (par exemple )
 * - Couleur du fond (toute couleur CSS valide, par exemple  ou  )
 * - Couleur de la bordure (idem)

Si vous n'utilisez pas les sous-types, ces options (sauf les deux premières) doivent être ajoutées au type lui-même.

Dans les champs  et   (tout comme dans , mentionné ci-dessus), vous pouvez utiliser quelques codes qui seront substitués automatiquement :
 * $1 - Message de l'utilisateur
 * $2 - Titre
 * $3 - Nom de l'image
 * $4 - Taille de l'image
 * $5 - Couleur de fond
 * $6 - Couleur d ela bordure
 * $7 - Nom d'utilisateur du destinataire

Pour que ce soit plus facile à l'utilisateur de sélectionner les images, vous pouvez créer une galerie d'images prédéfinies. Pour cela créez une propriété  avec les propriétés suivantes :


 * - Tableau de noms d'images
 * - Largeur maximale des images de la galerie (en pixels); pour 3 images nous recommandons la valeur de.
 * - Hauteur maximale des images de la galerie (en pixels)
 * - Nombre d'images aléatoires à afficher (optionnel); si absent, toutes les images sont affichées

Vous pouvez utiliser les images de Wikimedia Commons, comme récompense par défaut. Comme mentionné ci-dessus, vous devez activer InstantCommons pour cela.



Supprimer des types WikiLove
Si vous souhaitez simplement supprimer certains types WikiLove par défaut, vous pouvez les supprimer de l'objet $.wikiLoveOptions. Voici quelques exemples que vous pouvez utiliser dans la page MediaWiki:WikiLove.js de votre wiki :



Ajouter de nouveaux types WikiLove
Voici comment ajouter un nouveau type de toutou :

Voici un exemple pour ajouter un nouveau type de hérisson dans une galerie d'images à sélectionner :

Voici un exemple pour ajouter un nouveau sous-type de falafel dans le type de nourriture existant :



Failles et problèmes
Si la page de discussion que vous essayez de modifier contient un mot qui a ensuite été ajouté à Special:SpamRegex, les tentatives d'utilisation de l'interface pour ajouter une étoile ou une autre récompense échoueront. C'est parce que la page ne peut pas être modifiée, car elle contient un mot interdit. Supprimer le mot de la page ou du filtre résoudra le problème.



Documentation API
WikiLove utilise une API wikilove spéciale pour poster les messages sur les pages de discussion des utilisateurs. L'API est une simple sur-couche englobant des API existantes. Si la page de discussion de l'utilisateur est une page Wikitext, c'est l'API qui est utilisée. S'il s'agit d'une page Flow, l'API sera utilisée. Et s'il s'agit d'une page LiquidThreads page, c'est l'API qui est utilisée.

Pour appeler l'API, utilisez le paramètre.

Paramètres :


 * Titre de l'utilisateur ou de sa page de discussion à qui le WikiLove sera envoyé (obligatoire)
 * Titre de l'utilisateur ou de sa page de discussion à qui le WikiLove sera envoyé (obligatoire)


 * Wikicode brut à ajouter à la nouvelle section (obligatoire)
 * Wikicode brut à ajouter à la nouvelle section (obligatoire)


 * Message actuel que l'utilisateur a entré; à des fins de trace (n'inclut pas l'image ni la mise en forme HTML)
 * Message actuel que l'utilisateur a entré; à des fins de trace (n'inclut pas l'image ni la mise en forme HTML)


 * Jeton de modification. Vous pouvez en recevoir un en utilisant prop=info (nécessaire)
 * Jeton de modification. Vous pouvez en recevoir un en utilisant prop=info (nécessaire)


 * Entête du sujet de la section de la nouvelle page (obligatoire)
 * Entête du sujet de la section de la nouvelle page (obligatoire)


 * Type de WikiLove (pour les statistiques); ceci correspond à un type sélectionné dans le menu de gauche, suivi d'un sous-type optionnel (par exemple barnstar-normal ou kitten) (optionnel)
 * Type de WikiLove (pour les statistiques); ceci correspond à un type sélectionné dans le menu de gauche, suivi d'un sous-type optionnel (par exemple barnstar-normal ou kitten) (optionnel)


 * Contenu du message courriel facultatif à envoyer à l'utilisateur
 * Contenu du message courriel facultatif à envoyer à l'utilisateur

Exemple :

api.php?action=wikilove&title=User:Dummy&text=Love&subject=Hi&token=%2B\



Architecture de la version 1.0


Ce document décrit l'architecture et le comportement du système WikiLove d'observations positives pour Wikipédia. Cet outil est conçu pour promouvoir la diffusion de WikiLove dans Wikipédia. Plus précisément, il ne fait que l'ajout de prix et de cadeaux aux pages de discussion des utilisateurs en cliquant simplement sur quelques boutons.

Explications
Wikipédia, en tant que communauté, dispose de plusieurs mécanismes pour indiquer le mécontentement ou pour fournir des commentaires « négatifs » à ses utilisateurs. Certains gadgets, tels que Twinkle, sont fortement conçus pour avertir, bloquer et revenir en arrière.

Parce que Wikipedia a besoin de renforts positifs, particulièrement pour les nouveaux utilisateurs, il est souhaité orienter le système uniquement vers les retours positifs.



Utilisation d'un style fantaisiste
Le système a un style lourd de fantaisie dans sa conception. Ceci est intentionnel et vise à se rapprocher des attentes des utilisateurs des sites Web modernes. De plus, tout le principe des « récompenses » est en soi fantasque (par exemple, des gateaux et des chatons).

Ce style peut être abandonné en fonction des retours qu'en feront les utilisateurs.



Note sur la nomenclature
Certains types de modèles, tels que les modèles de bienvenue, ne sont pas des récompenses du point de vue technique.

Ce document utilise le terme « prix » de manière interchangeable avec « modèle ». Étant donné que le système est axé utilisateurs et n'est pas destiné directement à ceux qui sont expérimentés, une nomenclature orientée vers l'utilisateur a été utilisée.

Processus


Comportement du dialogue
Le dialogue WikiLove est modal. Le lancer (de n'importe où) le fera apparaître au-dessus du texte de la page. Il peut être supprimé d'un simple clic.

Le système WikiLove nécessite JavaScript.

L'utilisateur se verra d'abord présenté une courte série d'instructions faciles à comprendre et une liste des « catégories de prix » disponibles.

Lors de la sélection d'un type de récompense, l'utilisateur se voit présenter une section dans laquelle il peut ajouter des détails à la récompense (tels qu'un court message).

Notez que certaines catégories de récompenses (par exemple, les gateaux) n'auront pas de seconde étape de création de récompense et iront directement à "Aperçu".

L'utilisateur clique ensuite sur le bouton "Aperçu", qui charge un aperçu de le récompense afin qu'il puisse voir à quoi il ressemblera sur la page de discussion de l'utilisateur.

Une fois l'utilisateur satisfait, il peut cliquer sur le bouton Envoyer WikiLove. À ce stade, les appels AJAX à l'API du serveur sont déclenchés, ajoutant le modèle à la page de discussion de l'utilisateur.



Notification par courriel
Comme il est peu probable que la plupart des nouveaux utilisateurs sachent qu'ils ont des pages de discussion, ils peuvent ne pas savoir qu'ils ont reçu le WikiLove en question.

En conséquence, le serveur enverra un courriel au destinataire (s'il a fourni une adresse courriel) l'informant du WikiLove ainsi que de brèves instructions sur la façon d'accéder à sa page de discussion.



Configuration du site
Initialement, les récompenses qui peuvent être attribuées doivent être définies dans le gadget lui-même. Si ce système est élevé au rang d'extension, les noms des récompenses et des modèles doivent être définis dans le fichier LocalSettings.php du site.

Alternativement, ces informations peuvent être stockées dans la base de données. Une console d'administration sera nécessaire pour ajouter ou soustraire les récompenses et les catégories de récompenses disponibles.



Stockage des données
Dans un but statistique, chaque fois qu'une récompense est envoyée, les données sont tracées et placées dans la base de données. Une simple table écrite via l'API est tout ce dont on a besoin :


 * From User - Nom de l'utilisateur qui envoie la récompense
 * To User - Nom de l'utilisateur qui reçoit la récompense
 * Template - Nom du modèle récompensé
 * Timestamp - Date de l'attribution de la récompense
 * Award Text - Facultatif; texte de la récompense

Page Special:WikiLoveStatistics
À l'avenir, il devrait être possible de créer une page, Special:WikiLoveStatistics, qui pourrait être utilisée pour voir à quelle fréquence le système est utilisé ainsi que pour donner un aperçu de qui donne le plus d'amour, quelles récompenses sont les plus populaires, et qui reçoit le plus de récompenses.

Ceci permettra de connaître la santé de la communauté. Plus il y a de récompenses attribuées et meilleure est la santé.



Idées pour l'avenir
La phase deux de ce projet pourrait résulter en la création des liens Send WikiLove ajoutés dynamiquement aux signatures sur toutes les pages. Ceci permettrait d'envoyer plus facilement les WikiLove, directement à partir d'autres pages de discussion.



Voir aussi

 * - Document d'architecture initial
 * - remerciements raccourcis pour les modifications en utilisant Echo
 * GiveCredit - Wiki MeatBall