LuchoWiki

Cosas que debería hacer más a menudo

User Tools

Site Tools


desarrollo:dokuwiki:plugin-noie

plugin:noiewarning

Resumen

NoIEWarning (advertencia de MSIE) es un plugin basado en el plugin de Shockingly Big IE Warning para Wordpress y cumple una función similar: mostrar una advertencia al visitante si se detecta que usa el pésimo navegador web “Internet Explorer”.

Simplemente instala y configura el plugin a gusto, y luego limpia la caché de DokuWiki. El plugin debiera empezar a operar inmediatamente.

Configuración

La configuración del plugin se alcanza mediante Administrador de Configuración y tiene las siguientes opciones:

Opción de Configuración Efecto
method Método de lanzamiento de la advertencia.
Por defecto “subsection”.
source Fuente para el mensaje de advertencia.
No disponible en esta versión.
wikipage pagename de una página que contiene el mensaje
si se estableció source a “wikipage”.
better Navegador alternativo recomendado.
Por defecto “firefox”.
min_ie_version Versión mínima de DokuWiki aceptada.
No disponible en esta versión.

Valores de los parámetros

:?: Un hash (#) indica la opción por default.

Métodos de lanzamiento de la advertencia
(opción method)
subsection # La advertencia se lanza como texto normal, estilizado, justo antes del primer encabezado de la página. Esta opción modifica el renderizado de la pagina.
notify La advertencia se lanza por medio del sistema de notificación de DokuWiki. Esta opción es menos intrusiva y no afecta el renderizado de la página.
note Se utiliza el plugin Note para lanzar la advertencia.
splash Se utiliza un splash screen con Javascript para lanzar la advertencia.
No disponible en esta versión.
Fuente del Mensaje
(opción source)
language Se carga la cadena de mensaje adecuada desde las localizaciones de idioma en lang/*/lang.php.
Este es el método por defecto en DokuWiki.
wikipage Se carga la wikipágina indicada en conf:wikipage (por defecto noie) para presentar la advertencia.
Actualmente no utilizado.
Navegador web recomendado
(opción better)
(vacío) No se entrega ninguna recomendación.
custom Se carga el archivo DOKU_CONF/better-browser.txt para extraer una recomendación.
El archivo debe ser creado por el usuario.
otro # Se carga el archivo con la recomendación del navegador web indicado.
El valor por defecto es firefox

Las recomendaciones están almacenadas en el subdirectorio recommend/ del plugin; un archivo corresponde a un hash de recomendación como es leído por confToHash: el campo url determina la página web desde donde se descarga el navegador alternativo.

:!: Si se detecta que la recomendación cargada trata de llevar a Internet Explorer o hacer referencia a Microsoft, se notifica un error grave (ver Imágenes).

Personalización

Estilos

El archivo style.css contiene los estilos utilizados para las advertencias.

Advertencia

La wikipágina noie (:wiki:noie) puede contener un mensaje de advertencia personalizado.

Otros Detalles

Changelog

<source ryan.gulix.cl/dw/lib/plugins/noiewarning/ChangeLog ChangeLog|Changelog de noiewarning>

Características Futuras

  • Volver a implementar conf['wikipage'].
  • Implementar un modo splash.
  • Felicitar a los usuarios que ya están utilizando el navegador recomendado.

Idioma

El plugin obtiene los mensajes y configuraciones de idioma desde el directorio lang/?? donde ?? es el código ISO del idioma, siguiendo el estándar usado en DokuWiki. El archivo lang.php contiene las cadenas usadas por el plugin acorde a las siguientes claves:

plugininfo_desc Descripción del plugin en el idioma deseado, cargado sobre la descripción en plugin.info.txt acorde a esta discusión.
wedetect Mensaje a mostrar cuando se ha detectado Internet Explorer.
werecommend Mensaje introductorio para recomendar un browser alternativo.

Imágenes

desarrollo/dokuwiki/plugin-noie.txt · Last modified: 20170320 19:23 by manager