Extension:WikiLove/es

WikiLove is an extension designed to promote the spread of WikiLove within Wikipedia and possibly other wikis. Specifically, it makes adding awards, gifts, and invitations to user talk pages as simple as clicking a few buttons.

Instalación

 * 1) Download the latest snapshot and extract it to your extensions directory.
 * 2) Add this to LocalSettings.php:
 * 1) Run the update script which will automatically create the necessary database tables that this extension needs.
 * 2) If you want to use the built-in awards, you must have InstantCommons enabled. To do this, add this to LocalSettings.php:
 * 1) La extensión debe ahora estar activo. Ir a la pestaña de edición en sus preferencias para activar la interfaz.
 * 2) Necesitas También pueden utilizar estas opciones de configuración en su LocalSettings.php:
 * 3) * - enable the extension for all users, removing the user preference (default: false)
 * 4) ** Nota: también puede activar la configuración por defecto, pero aún dar a los usuarios la opción de apagarlo ("opt-out") mediante el uso de:


 * 1) * - use an icon for skins that support them (i.e. Vector) (default: true)
 * 2) * - enable logging of giving of WikiLove (default: false); this automatically creates a database table   which you can use for statistical queries

Uso
Para activar su cuenta para utilizar WikiLove, vaya a la pestaña de edición en sus preferencias y encienda WikiLove bajo características Labs.

Para utilizar WikiLove, vaya a la página de discusión de un usuario y haga clic en el icono del corazón. Siga las instrucciones de allí.

Configuración personalizada
To learn how to customize WikiLove for an individual editor (rather than an entire wiki), see the user documentation.

You can customize the options for your own wiki by editing the page MediaWiki:WikiLove.js. In here, you can change the configuration the same way as is done with the built-in options:. Here are some examples of custom WikiLove configurations: Malayalam Wikipedia, English Wikipedia, Wikimedia Commons, English Sturmkrieg.

The options at the top of are some default settings for your convenience. If you omit certain properties from types or subtypes, these defaults will be used. Then there is the list of types. Each type can have the properties  (required) and   (optional). Furthermore, a type can have a list of subtypes, or not, in which case the additional properties will be assigned to the type itself.

If the type has subtypes, they are listed in an object list. Optionally, the type can also have the property, which specifies the label above the dropdown menu. Each subtype can have the following properties:


 * - name in the dropdown menu
 * - Descripción al seleccionar el subtipo
 * - Encabezado del mensaje que se va a agregar, es decir, la parte que estará entre
 * - Título del cuadro de mensaje
 * - Texto del cuadro de mensaje (ver detalles más abajo)
 * - Imagen del cuadro de mensaje

Cuando no se utilice subtipos, estas opciones (excepto para los dos primeros) necesitan ser añadido al tipo en sí.
 * - Galería de selección de una imagen (ver detalles más abajo)
 * - Arsenal de los campos que el usuario puede editar; puede contener estos valores:
 * - Tamaño de la imagen (por ejemplo )
 * - Background color (any CSS valid color, e.g.  or  )
 * - Color del borde (misma)

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

Para que sea más fácil para el usuario para seleccionar las imágenes, puede crear una galería con imágenes predefinidas. Para ello, cree una, que tiene las siguientes propiedades:

You can use images from Wikimedia Commons, as the default awards do. Like mentioned before, you have to enable InstantCommons for this.
 * - Una serie de nombres de imágenes
 * - Anchura máxima de las imágenes en la galería (en píxeles); durante 3 imágenes  se recomienda
 * - La altura máxima de las imágenes en la galería (en píxeles)
 * - Número de imágenes aleatorias para mostrar (opcional); si se omite se muestran todas las imágenes

La eliminación de elementos
If you just want to remove some of the default WikiLove items, you can delete them from the $.wikiLoveOptions object. Here are some examples that you could use in your wiki's MediaWiki:Wikilove.js page: // Delete the Random Acts of Kindness Barnstar from the barnstars list delete $.wikiLoveOptions.types.barnstar.subtypes.kindness; // Delete the cheeseburger from the food and drink list delete $.wikiLoveOptions.types.food.subtypes.cheeseburger; // Delete the kittens interface entirely delete $.wikiLoveOptions.types.kitten

Glitches y problemas
Si la página de discusión que está intentando editar contiene una palabra que se ha añadido posteriormente a Especial:SpamRegex, los intentos de utilizar la interfaz para añadir un barnstar u otro premio fallarán. Esto es porque la página no se puede editar, ya que contiene una palabra prohibida. Extracción de la palabra desde la página o desde el filtro se solucionará el problema.

Documentación de API
Para llamar a la API, usa el parámetro ' '.

Parámetros:

Example: api.php?action=wikilove&title=User:Dummy&text=Love&subject=Hi&token=%2B\
 * - Título de la página de usuario o de discusión de usuario para enviar a WikiLove (requerido)
 * - Wikitext Raw para agregar en la nueva sección (requerido)
 * - Actual message the user has entered, for logging purposes
 * - Edit token. You can get one of these through prop=info (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)
 * - Content of the optional e-mail message to send to the user

Diseñado para la versión 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.

Justificación
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.

Since Wikipedia is in need of positive reinforcement, especially for new users, a system designed specifically and only towards positive feedback is desired.

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

This style may be abandoned based on user feedback.

Nota sobre la nomenclatura
Some template types, such as welcome templates, are not technically "awards".

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.

Dialog Behavior
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.

The WikiLove system requires 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.

Notificación por correo electrónico
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.

Configuración del sitio
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.

Almacenamiento de datos
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

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.

This will help to provide a global overview of community health. The more awards given, the healthier the community.

Future Thinking
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.

Véase también

 * WikiLove - Original design document
 * Extension:Thanks - lighter-weight thanking for edits using Echo
 * GiveCredit on MeatBall Wiki