página de información de wikipedia
Un gadget de Wikipedia es un programa JavaScript y/o un fragmento de CSS que se puede habilitar simplemente marcando una opción en tus preferencias . La función del gadget la proporciona la extensión Gadgets de MediaWiki .
Muchos dispositivos comenzaron como scripts de usuario . Una vez que un script de usuario se aprueba como gadget, se elimina de Wikipedia:User scripts/List .
Criterios generales para gadgets.
Para poder implementarse en la Wikipedia en inglés, los gadgets generalmente deben cumplir las siguientes condiciones:
- Los gadgets deben funcionar si se incluyen sin más configuración. Se pueden configurar a través de common.js personal , pero deben funcionar sin configurar.
- Los gadgets deben ser compatibles con los principales navegadores, es decir, no deben finalizar con errores.
- Los gadgets deberían funcionar en la mayoría de los principales navegadores (compatibilidad entre navegadores). Las excepciones deben indicarse claramente.
- La duplicación de dispositivos sólo debe realizarse si es razonable.
- Las colecciones de scripts deben dividirse si tienen funciones dispares.
- Los gadgets que requieren permisos deben estar marcados y deben fallar correctamente si los permisos no están presentes.
- Los gadgets que solo funcionan en algunas máscaras deben marcarse como tales si esos datos están disponibles.
Los gadgets que están marcados como predeterminados y se cargan para grandes grupos de usuarios tienen criterios adicionales que deben cumplir.
Propuestas
Se deberían proponer nuevos dispositivos en el centro técnico Village Pump .
Históricamente, se proponían nuevos gadgets en una subpágina de esta página , pero esa página se marcó como histórica debido a la baja participación. Además, los scripts de usuario de WikiProject existentes solían evaluarse para su conversión a gadgets, pero ese proceso también se ha marcado como histórico.
Instalación
Los administradores de la interfaz pueden instalar los gadgets después de una discusión en la sección técnica de la bomba del pueblo de la siguiente manera:
- Agregue el encabezado a continuación y el código del script a MediaWiki: Gadget - scriptname.js
- Opcionalmente, agregue el siguiente encabezado y el código CSS a MediaWiki: Gadget - scriptname.css
- Agregue una descripción del script a MediaWiki:Gadget- scriptname . Enlace a la página de inicio y/o ayuda del script e indique los requisitos del navegador si es necesario.
- Agregar a MediaWiki: Definición de gadgets bajo el encabezado correspondiente
* nombre de script|nombre de script.js [|nombre de script.css|otroscript.js|...]
El gadget debería aparecer ahora en Especial:Gadgets .
Comentarios
Se pueden agregar comentarios o advertencias a las plantillas de descripción de gadgets de dos maneras:
- etiqueta noinclude (visible en la página de descripción con enlaces):
<noinclude> comment </noinclude>
- Comentarios HTML (visibles solo en el texto fuente):
<!-- comment -->
Los comentarios agregados de esta manera se descartarán automáticamente durante el proceso de creación de la página.
Encabezamiento
Se agregará el siguiente encabezado a los archivos del gadget:
/* _____________________________________________________________________________ * | | * | === ADVERTENCIA: ARCHIVO GLOBAL DE DISPOSITIVOS === | * | Los cambios en esta página afectan a muchos usuarios. | * | Discuta los cambios en la página de discusión o en [[WT:Gadget]] antes de editarlos. | * |__________________________________________________________________________________________| * * Importado de la versión XXXX a partir del DATE de [[SCRIPT_SOURCE]] * SHORT_DESCRIPTION, ver [[SCRIPT_HOME_PAGE]] */
Gadgets predeterminados
Un gadget con una palabra clave predeterminada está habilitado para todos los visitantes de Wikipedia y sólo los usuarios registrados pueden desactivarlo. Un gadget con [default|rights=minoredit]
descripción se habilitaría automáticamente solo para usuarios registrados.
Criterios
Los gadgets que están habilitados de forma predeterminada para todos los usuarios deben cumplir reglas más estrictas. Estas son esencialmente las mismas reglas que se aplican a todos los códigos enviados por defecto. Esto se debe a que los usuarios no tienen ninguna opción activa para habilitarlos y los dispositivos pueden afectar el rendimiento, la seguridad y la estabilidad de todo el sitio web. Estos dispositivos deberían:
- Han sido revisados por un desarrollador de JavaScript experimentado (generalmente un administrador de interfaz).
- Estar "bien mantenido".
- Cumplir con la política de recursos de terceros.
- Estar escrito para ejecutarse de manera eficiente, es decir, con tan poco código como sea necesario. Si la funcionalidad completa del gadget requiere una gran cantidad de código JavaScript, entonces este código debe cargarse de forma condicional y lenta, o solo según demanda (haga clic para cargar).
- No causar problemas de accesibilidad.
- No es necesario para que el contenido sea legible, excepto en el caso de los gadgets de solo estilos.
- No interfiere con la impresión de páginas.
- Cumplir con los estándares vigentes de seguridad y privacidad.
Esta lista no debe considerarse exhaustiva.
Dispositivos actualmente instalados
Los usuarios pueden explorar una lista de todos los gadgets disponibles en la sección de gadgets de su página de preferencias:
Preferencias → Gadgets
Consulte Especial: Gadgets para obtener una lista de todos los gadgets activos y enlaces a sus archivos de script.
Pros y contras de cambiar un script de usuario por un gadget
Ventajas
- Agrega el script a Special:Preferences , lo que facilita mucho la instalación.
- Agrega el script a Special:Preferences , lo que ayudará a comercializar el script y aumentará el número de instalaciones con el tiempo.
- Proporciona el script de usuario a la comunidad, lo que hace que los administradores de la interfaz sean más propensos a aceptar solicitudes de edición de otros usuarios, lo que reduce la necesidad de bifurcar el script de usuario si el mantenedor queda inactivo.
- Posibilidad de marcarlo como "gadget predeterminado", que se cargará para todos.
- Los módulos ResourceLoader y CSS del script dependen de la carga al cargar la página, lo que permite que el script esté listo más rápido.
Especialmente una vez que un script de usuario tiene muchos usuarios...
- Los gadgets proporcionan minificación y agrupación con otros gadgets, lo que reduce el tamaño de los archivos y el tráfico HTTP.
- Posible protección contra piratería. Todos los administradores de interfaz tienen autenticación de dos factores y se eliminan si quedan inactivos. Un mantenedor habitual podría quedar inactivo y luego ver comprometida su cuenta en una fecha posterior.
- Posible protección contra un desarrollador de scripts de usuario deshonesto. Los administradores de interfaz han pasado por RFA y posiblemente sea menos probable que se vuelvan deshonestos.
Contras
- Permite el uso de funciones de JavaScript hasta ES7 únicamente. Algunas características de ES8 como async-await se pueden usar con la
requiresES6
bandera. - Si el mantenedor no es un administrador de interfaz, ahora deberá realizar solicitudes {{ Editar interfaz protegida }} para realizar cambios en el código, lo que ralentizará el desarrollo.
- Muchos pasos. Es necesario asegurarse de que el mantenedor esté de acuerdo, obtener consenso en WP:VPT y luego conseguir que un administrador de interfaz configure todo. Es posible que necesite un plan para cambiar a todos del script de usuario anterior al gadget. Si le preocupan los errores, es posible que deba realizar una implementación escalonada.
Ver también