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

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.

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.

The user will initially be presented with a short set of easy-to-understand instructions and a list of available award categories.

Upon selecting an award type, the user is presented with a section in which they can add details to the award (such as a short message).

Note that some award categories (e.g., "cookie") will not have a secondary award creation step and will go directly to "Preview".

The user then clicks the "preview" button, which will load a preview of the award so that they may see how it will look on the user's talk page.

Once the user is satisfied, they may click the "Send WikiLove" button. At this time, AJAX calls to the server API will be fired, adding the template to the user's talk page.

Notification par courriel
Since most new users are unlikely to be aware that they even have talk pages, they may not be aware that they have received the WikiLove in question.

Accordingly, the server will email the recipient (if they have provided an email address) informing them of the WikiLove as well as short instructions on how to access their talk page.

Configuration du site
Initially, the awards that can be given are to be defined in the gadget itself. If this system is elevated to an extension, then the names of the awards and the templates should be defined in the site's LocalSettings.php.

Alternatively, such information can be stored in the database. An administration console would be required to add or subtract available awards and award categories.

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
In the future, it should be possible to create a page, Special:WikiLoveStatistics, that could be used to see how often the system is used as well as providing insight into who gives the most love, what awards are most popular, and who receives the most awards.

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