Diferencias

Muestra las diferencias entre dos versiones de la página.


desarrollo:dokuwiki:plugin-noie [2017/03/20 19:23] (actual) – creado - editor externo 127.0.0.1
Línea 1: Línea 1:
 +===== plugin:noiewarning =====
 +<note dl>
 +
 +  * {{:desarrollo:dokuwiki:dw-plugin-noiewarning-latest.zip|Descarga}}.
 +  * **Versión** ''0.8'', ''2017-01-21''.
 +  * **DokuWiki**: [[doku>plugin:noiewarning]].
 +</note>
 +
 +==== Resumen ====
 +
 +**NoIEWarning** (//advertencia de MSIE//) es un plugin basado en el plugin de [i][[http://wordpress.org/extend/plugins/shockingly-big-ie6-warning/|Shockingly Big IE Warning]][/i] para [[wpes>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 [[#Configuración|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 [[doku>plugin_manager|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''      | [[doku>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 [[doku>plugin:note|plugin Note]] para lanzar la advertencia.  |
 +| splash           | Se utiliza un [[wp>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 [[:wiki: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 ''[[wpes>Mozilla Firefox|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 [[phpfn>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 [[:wiki: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 [[http://www.freelists.org/post/dokuwiki/Internationalization-in-plugin-descriptions-via-plugininfotxt|esta discusión]].   |
 +| ''wedetect''          | Mensaje a mostrar cuando se ha detectado Internet Explorer.  |
 +| ''werecommend''       | Mensaje introductorio para recomendar un browser alternativo.  |
 +
 +
 +===Imágenes==
 +
 +[{{http://ryan.gulix.cl/archivos/dokuwiki/scr-noiewarning-default.png?400|Comportamiento por defecto del plugin NoIEWarning:\\ Opción de método"subsection" y carga del mensaje en idioma inglés.}}]
 +~~CL~~
 +[{{http://ryan.gulix.cl/archivos/dokuwiki/scr-noiewarning-notify.png?400|Comportamiento del plugin NoIEWarning\\ utilizando la opción de método "notify" (notificaciones estándar de DokuWiki).}}]
 +~~CL~~
 +[{{http://ryan.gulix.cl/archivos/dokuwiki/scr-noiewarning-hacked.png?400|:!: El plugin tratará de detectar una recomendación fraudulenta hacia Internet Explorer y advertir de ello (no tendría sentido que un plugin anti-IE recomendara IE, después de todo).}}]
 +~~CL~~
 +
 +----
 +
 +{{indexmenu_n>39}}
 +{{tag>informatica dokuwiki plugins noiewarning}}