Extensión:WikiLove

From MediaWiki.org
Jump to navigation Jump to search
This page is a translated version of the page Extension:WikiLove and the translation is 90% complete.

Outdated translations are marked like this.
Other languages:
Afrikaans • ‎Cymraeg • ‎Deutsch • ‎English • ‎Nederlands • ‎Türkçe • ‎azərbaycanca • ‎dansk • ‎español • ‎français • ‎magyar • ‎română • ‎русский • ‎ייִדיש • ‎עברית • ‎اردو • ‎العربية • ‎فارسی • ‎বাংলা • ‎සිංහල • ‎中文 • ‎日本語 • ‎한국어
MediaWiki extensions manual
OOjs UI icon advanced.svg
WikiLove
Release status: estable
WikiLove-screenshot-2014.png
Implementación User interface
Descripción Facilita agregar comentarios positivos a las páginas de discusión de usuarios
Autor(es) Ryan Kaldari, Jan Paul Posma, Brandon Harris (diseño)
Última versión 1.2
MediaWiki 1.27+ - WikiLove master should only be used with core's master; otherwise, use matching branches (e.g. WikiLove REL1_27 with core REL1_27, or matching WMF release branches).
Cambios de la base de datos
Licencia MIT License
Descarga
Parámetros
$wgWikiLoveGlobal
$wgWikiLoveTabIcon
$wgWikiLoveLogging
Hooks que usa
GetPreferences
SkinTemplateNavigation
BeforePageDisplay
LoadExtensionSchemaUpdates
MakeGlobalVariablesScript
ListDefinedTags
ChangeTagsListActive
Translate the WikiLove extension if it is available at translatewiki.net
Verificar uso y versión de la matriz.
Asuntos Tareas abiertas · Reportar un bug

WikiLove Es una extensión diseñada para promover la difusión de WikiLove dentro de Wikipedia y posiblemente otros wikis. Específicamente, añade premios, regalos, e invitaciones a páginas de charla del usuario tan sencillo como clickear unos cuantos botones.

Specifically, it makes adding awards, gifts, and invitations to user talk pages as simple as clicking a few buttons.

Descarga

The extension can be retrieved directly from Git [?]:

  • Browse code
  • Some extensions have tags for stable releases.
  • Each branch is associated with a past MediaWiki release. There is also a "master" branch containing the latest alpha version (might require an alpha version of MediaWiki).

Extract the snapshot and place it in the extensions/WikiLove/ directory of your MediaWiki installation.

If you are familiar with git and have shell access to your server, you can also obtain the extension as follows:

cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/WikiLove.git

Instalación

  • Descarga y extrae los archivos en el directorio «WikiLove» dentro del directorio extensions/ existente.
  • Añade el siguiente código a tu LocalSettings.php (preferiblemente al final):
    wfLoadExtension( 'WikiLove' );
    
  • Ejecuta el script de actualización, que creará automáticamente las tablas que necesita esta extensión en la base de datos.
  • Yes Listo – Navega a Special:Version en tu wiki para verificar que la apariencia se haya instalado correctamente.

Si quieres utilizar los premios incorporados, debes tener InstantCommons habilitado. Para hacerlo, añade esto a LocalSettings.php:

$wgUseInstantCommons = true;
  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:

También puedes utilizar estas opciones de configuración en tu LocalSettings.php:

  • $wgWikiLoveGlobal - Habilita la extensión para todos los usuarios, removiendo la preferencia de usuario (default: falso)
    • 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:
$wgDefaultUserOptions['wikilove-enabled'] = 1;
  • $wgWikiLoveTabIcon - Uso un icono para máscaras que las soporte (i.e. Vector) (default: true)
  • $wgWikiLoveLogging - enable logging of giving of WikiLove (default: false); this automatically creates a database table wikilove_log which you can use for statistical queries
WikiLove 1.0 supported MW 1.17+

Uso

Para habilitar su cuenta para utilizar WikiLove, vaya a la pestaña de edición en sus preferencias y active WikiLove bajo "características de Laboratorios" (o, en algunas versiones, bajo "opciones Generales").

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

Para aprender cómo personalizar WikiLove para un editor individual (más que un wiki completo), ver el documentación de usuario.

Puedes personalizar las opciones de tu propia wiki editando la pàgina MediaWiki:WikiLove.js. Aqui, puedes cambiar la configuraciòn de la misma manera como se hace en las opciones "built-in"": defaultOptions.js. Aquì hay algunos ejemplos de configuraciones personalizadas: Malayalam Wikipedia. English Wikipedia. Wikimedia Commons. English Sturmkrieg.

opciones en la parte superior de defaultOptions.js es algunos default encuadres para vuestra comodidad. Si omites propiedades seguras de tipos o subtipos, estos defaults será utilizado (defaultText, defaultBackgroundColor, defaultBorderColor, defaultImageSize, defaultImage). Entonces hay la lista de tipos. Cada tipo puede tener el nombre de propiedades (requerido) e icono (opcional). Además, un tipo puede tener una lista de subtipos, o no, en qué caso las propiedades adicionales serán asignadas al tipo él. If you omit certain properties from types or subtypes, these defaults will be used (defaultText, defaultBackgroundColor, defaultBorderColor, defaultImageSize, defaultImage). Then there is the list of types. Each type can have the properties name (required) and icon (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.

Si el tipo contiene subtipos, están enlistados en un objeto lista subtipos. Opcionalmente, el tipo también puede tener la propiedad selecciona, que especifica la etiqueta encima del menú desplegable. Cada subtipo puede tener las siguientes propiedades:

Optionally, the type can also have the property select, which specifies the label above the dropdown menu. Each subtype can have the following properties:

  • option - Nombre en este menú desplegable
  • descr - Descripción al seleccionar el subtipo
  • header - Encabezado del mensaje que se va a agregar, es decir, la parte que estará entre == ... ==
  • title - Título del cuadro de mensaje
  • text - Texto del cuadro de mensaje (ver detalles más abajo)
  • image - Imagen del cuadro de mensaje
  • gallery - Galería de selección de una imagen (ver detalles más abajo)
  • fields - Arsenal de los campos que el usuario puede editar; puede contener estos valores: header, title, image, message
  • imageSize - Tamaño de la imagen (por ejemplo 100px)
  • backgroundColor - Color de fondo (cualquier CSS color válido, p. ej. #fdffe7 o amarillo)
  • borderColor - Color del borde (misma)

Cuando no se utilice subtipos, estas opciones (excepto para los dos primeros) necesitan ser añadido al tipo en sí.

En el texto y en los campos email (así como en texto por defecto, antes mencionado), puedes usar unos cuantos códigos que serán sustituidos automáticamente:

  • $1 - Mensaje de usuario
  • $2 - Título
  • $3 - Nombre de imagen
  • $4 - Tamaño de imagen
  • $5 - Color de fondo
  • $6 - Color de borde
  • $7 - Nombre de usuario del receptor

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 gallery, que tiene las siguientes propiedades:

  • imageList - Una serie de nombres de imágenes
  • width - Anchura máxima de las imágenes en la galería (en píxeles); durante 3 imágenes 145 se recomienda
  • height - La altura máxima de las imágenes en la galería (en píxeles)
  • number - Número de imágenes aleatorias para mostrar (opcional); si se omite se muestran todas las imágenes

Puedes utilizar imágenes de Wikimedia Commons, como los premios por defecto lo hacen. Como se mencionó antes, debes habilitar InstantCommons para esto.

Eliminar elementos =

Si sólo quieres eliminar algunos de los elementos por defecto de WikiLove, puedes borrarlos desde $.wikiLoveOptions object. Aquí hay algunos ejemplos que puedes usar en tus páginas de wikis MediaWiki:WikiLove.js:

// Elimina los Actos Aleatorios de Bondad Barnstar (decorativos) desde la lista de barnstars.
delete $.wikiLoveOptions.types.barnstar.subtypes.kindness;
// Elimina la hamburguesa desde la lista de comida y bebida
delete $.wikiLoveOptions.types.food.subtypes.cheeseburger;
// Elimina la interfaz de gatitos completamente
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

WikiLove usa una API wikilove especial para postear mensajes en las páginas de discusión de los usuarios. El API es básicamente un delgado envoltorio alrededor algunos APIs existentes. Si la página de discusión de usuarios es una página de Wikitext, utiliza la API edit . Si es una página de Flujo , utiliza el $flujo API. Y si es una página LiquidThreads, utiliza la API threadaction .

Para llamar a la API, usa el parámetro action=wikilove.

Parámetros:

  • title - Título de la página de usuario o de discusión de usuario para enviar a WikiLove (requerido)
  • text - Wikitext Raw para agregar en la nueva sección (requerido)
  • message - Mensaje real que el usuario ha introducido, con fines de explotación forestal (No incluye imagen ni formato HTML)
  • token - Edita token. Puedes conseguir uno de estos a través de prop=info (requerido)
  • subject - Asunto cabecera de la nueva sección de la página (requerido)
  • type - Tipos de WikiLove (para estadísticas); esto corresponde con un tipo seleccionado en el menú izquierdo y opcionalmente un subtipo después de ese. (ej. "barnstar - normal" o "gatito") (opcional)
  • email - Contenido del mensaje de correo electrónico opcional para enviar al usuario

Ejemplo

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

Diseñado para la versión 1.0

El diálogo WikiLove en primera carga
El diálogo WikiLove al seleccionar una categoría de premio
El diálogo WikiLove al llenar los detalles para un premio
El diálogo WikiLove en modo de vista previa
El estado estacionario para el panel de selección de premios

Este documento describe el diseño y comportamiento del sistema de "WikiLove" de observaciones positivas para Wikipedia. Esta herramienta está diseñada para promover la difusión de WikiLove dentro de Wikipedia. Específicamente, hace que el añadir premios y regalos a los usuarios de páginas de discusión sea tan simple como clickear algunos botones.

Justificación

Wikipedia, como comunidad, tiene varios mecanismos para indicar descontento o para proporcionar retroalimentación "negativa" a sus usuarios. Algunos aparatos, como Twinkle, están fuertemente diseñados hacia la alerta, el bloqueo, y revertir.

Desde Wikipedia está en la necesidad de un refuerzo positivo, especialmente para los nuevos usuarios, un sistema diseñado específicamente y sólo hacia se desea retroalimentación positiva.

El uso de Estilo caprichosa

El sistema tiene una pesada estilo de "banal" a su diseño. Esto es intencional y está destinado a alinear más de cerca a las expectativas de los usuarios de los sitios web modernos. Además, todo el principio de "premios" es en sí mismo (por ejemplo, caprichoso, galletas y gatitos).

Este estilo puede ser abandonada en base a comentarios de los usuarios.

Nota sobre la nomenclatura

Algunos tipos de plantilla, como plantillas de bienvenida, no son técnicamente "premios".

En este documento se utiliza el término "premio" como sinónimo de "plantilla". Dado que el sistema es, y no destinadas directamente para los usuarios avanzados centrado en el usuario, la nomenclatura de cara al usuario ha sido utilizado.

Proceso

El diálogo WikiLove es modal. Inicio de ella (desde cualquier lugar) causará que aparezca en el texto de la página. Puede ser despedido con un simple clic.

El sistema WikiLove requiere Javascript.

El usuario se presentará inicialmente con una breve serie de instrucciones fáciles de entender y una lista de los disponibles "categorías de premios".

Al seleccionar un tipo de premio, el usuario se presenta con una sección en la que se pueden añadir detalles a la concesión (por ejemplo, un mensaje corto).

Nótese que algunas categorías (ej. "galleta") no tendrán un segundo paso de creación de premios e irá directamente a "Vista Previa".

El usuario luego clickea el botón "Vista Previa" ("Preview") que cargará una vista previa del premio para poder visualizar como se verá en la página de discusión del usuario.

Una vez que el usuario está satisfecho, puede clickear el botón "Enviar WikiLove". En ese momento las llamadas de AJAX al servidor API serán efectuadas, añadiendo la plantilla a la página de chat del usuario.

Notificación por correo electrónico

Como la mayoría de los nuevos usuarios son poco probable que sea consciente de que incluso tienen páginas de discusión, puede que no sean conscientes de que han recibido la WikiLove en cuestión.

En consecuencia, el servidor enviará por correo electrónico al destinatario (si han facilitado una dirección de correo electrónico) para informarles de la WikiLove así como instrucciones breves sobre cómo acceder a su página de discusión.

Configuración del sitio

Inicialmente, los premios que se pueden dar son que se definirá en el propio gadget. Si este sistema se eleva a una extensión, a continuación, los nombres de los premios y las plantillas deben ser definidos en LocalSettings.php del sitio.

Alternativamente, dicha información se puede almacenar en la base de datos. Una consola de administración estaría obligado a sumar o restar premios y categorías de los premios disponibles.

Almacenamiento de datos

Para las estadísticas de fines recolección, cada vez que se da un premio, los datos se realiza un seguimiento y se almacena en la base de datos. Una mesa simple, escrita a través de la API, es exigirse todo lo necesario:

  • Del Usuario - El nombre de usuario de la persona que está dando el premio
  • Al Usuario - El nombre de usuario de la persona que recibe el premio
  • Plantilla - el nombre de la plantilla otorgada
  • Fecha de Estampa - Cuándo el premio fue dado
  • Texto de premio - Opcional; esto sería el texto del premio

Especial:EstadísticasDeWikiLove

En el futuro, será posible crear una página, "Especial:EstadísticasWikiLove, que podría ser usada para ver cuán a menudo se utiliza el sistema, así como también proporcionar una visión sobre quién da más amor, qué premios son los más populares, y quién recibe más premios.

Esto ayudará a proporcionar una visión global de la salud de la comunidad. Los más premios dados, el más sano de la comunidad.

Pensamiento a futuro

Fase dos de este proyecto podría resultar en que los enlaces "Enviar WikiLove" sean dinámicamente añadidos a las firmas en páginas de charla. Esto le permitiría a WikiLove ser enviado de una manera más fácil, directamente desde otras páginas de charla.

Véase también