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 (completely replaces all WikiLove configuration)
 * pt:MediaWiki:WikiLove.js (completely replaces all WikiLove configuration)
 * 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)

When not using subtypes, these options (except for the first two) should be added to the type itself.

In the  and   fields (as well as in , mentioned earlier), you can use a few codes that will be substituted automatically:
 * $1 - User message
 * $2 - Title
 * $3 - Image name
 * $4 - Image size
 * $5 - Background color
 * $6 - Border color
 * $7 - Username of the recipient

To make it easy for the user to select images, you can create a gallery with predefined images. For this, create a  property, which has the following properties:


 * - 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
If you just want to remove some of the default WikiLove types, you can delete them from the $.wikiLoveOptions object. Here are some examples that you could use in your wiki's MediaWiki:WikiLove.js page:

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

Here's an example of adding a new hedgehog type with a gallery of images to choose from:

Here's an example of adding a new falafel subtype under the existing food type:

Glitches and problems
If the talk page you are attempting to edit contains a word that has been subsequently added to Special:SpamRegex, attempts to use the interface to add a barnstar or other award will fail. This is because the page cannot be edited, as it contains a forbidden word. Removing the word from the page or from the filter will fix the problem.

Documentation API
WikiLove uses a special wikilove API to post messages to users' talk pages. The API is basically just a thin wrapper around some existing APIs. If the user's talk page is a Wikitext page, it uses the API. If it's a Flow page, it uses the API. And if it's a LiquidThreads page, it uses the API.

In order to call the API, use the parameter.

Paramètres :


 * Title of the user or user talk page to send WikiLove to (required)
 * Title of the user or user talk page to send WikiLove to (required)


 * Raw wikitext to add in the new section (required)
 * Raw wikitext to add in the new section (required)


 * Actual message the user has entered, for logging purposes (doesn't include the image and HTML formatting)
 * Actual message the user has entered, for logging purposes (doesn't include the image and HTML formatting)


 * Edit token. You can get one of these through prop=info (required)
 * Edit token. You can get one of these through prop=info (required)


 * Subject header of the new page section (required)
 * Subject header of the new page section (required)


 * Type of WikiLove (for statistics); this corresponds with a type selected in the left menu, and optionally a subtype after that (e.g. "barnstar-normal" or "kitten") (optional)
 * Type of WikiLove (for statistics); this corresponds with a type selected in the left menu, and optionally a subtype after that (e.g. "barnstar-normal" or "kitten") (optional)


 * Content of the optional email message to send to the user
 * Content of the optional email message to send to the user

Exemple :

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

Architecture de la version 1.0


This document describes the design and behavior of the WikiLove system of positive feedback for Wikipedia. This tool is designed to promote the spread of WikiLove within Wikipedia. Specifically, it makes adding awards and gifts to user talk pages as simple as clicking a few buttons.

Rationale
Wikipedia, as a community, has several mechanisms for indicating displeasure or to provide negative feedback to its users. Certain gadgets, such as Twinkle, are heavily engineered towards warning, blocking, and reverting.

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.

Use of whimsical style
The system has a heavy style of "whimsy" to its design. This is intentional and is intended to align closer to the expectations of users of modern websites. Further, the entire principle of "awards" is in and of itself whimsical (e.g., cookies and kittens).

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.

This document uses the term award interchangeably with template. Since the system is user-focused, and not intended directly for power-users, user-facing nomenclature has been used.

Comportement du dialogue
The WikiLove dialog is modal. Initiating it (from anywhere) will cause it to appear over the text of the page. It can be dismissed with a simple click.

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
For statistics gathering purposes, every time an award is given, data is tracked and stored in the database. A simple table, written to via the API, is all that need be required:


 * From User - The username of the person who is giving the award
 * To User - The username of the person receiving the award
 * Template - the name of the template awarded
 * Timestamp - when the award was given
 * Award Text - Optional; this would be the text of the award

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
Phase two of this project could result in "Send WikiLove" links being dynamically added to signatures on talk pages. This would allow for WikiLove to be sent in a much easier manner, directly from other talk pages.

Voir aussi

 * - Document d'architecture initial
 * - lighter-weight thanking for edits using Echo
 * GiveCredit - Wiki MeatBall