Tabla de Contenidos
plugin:countdown
- Countdown: muestra los días que faltas hasta la fecha específica.
- DokuWiki: plugin:countdown
- Original: Ekkart Kleinod (hasta Junio de 2009).
Resumen
countdown es un plugin para DokuWiki que inserta un contador en una página Wiki que permite ver el tiempo remanente/pasado hasta/desde una fecha dada. Utiliza una sintaxis sencilla.
El plugin fue originalmente desarrollado por Ekkart Kleinod para DokuWiki. Desde Junio de 2009 estoy tomando a cargo el desarrollo del plugin, debido a que Ekkart no puede seguir desrrollándolo más. Créditos al hombre.
| Contacto con Ekkart Kleinod. |
|---|
Uso
El formato es bastante sencillo:
<COUNTDOWN:date|description>
Esto resultará en un mensaje como el siguiente, asumiendo que la instalación de DokuWiki está en inglés:
XX days until description XX days since description
Parametros
| Parámetro | Forma | Ejemplos |
|---|---|---|
date | un formato de fecha aceptado por strtotime. | mm/dd/yyyy,dd.mm.yyyy,yyyy-mm-dd, etc. |
description | Texto | nombre o descripción de un evento. |
Configuración
(Desde 2.1) Las siguientes opciones de configuracion pueden ser modificadas en el Administrador de Configuración:
| Parámetro | Valor por defecto | Efecto |
|---|---|---|
include_date | true | Muestra la fecha |
use_today | true | Muestra simplemente “hoy” cuando llega la fecha |
with_hours | false | Muestra las horas y minutos restantes |
Opcion de configuracion include_date: cuando se activa este parámetro, la fecha del conteo se muestra a continuación de la descripcion del evento.
deshabilitado : XX days until description habilitado : XX days until description (mm/dd/yyyy)
Opcion de configuracion use_today: cuando se activa, se muestra la descripción de la fecha del evento como “hoy” cuando corresponde a un evento que ocurre este mismo día.
deshabilitado : 0 days until description habilitado : Today is description
Opcion de configuracion with_hours: cuando se activa, se muestra además las horas y minutos restantes para el evento del conteo.
deshabilitado : XX days until description (mm/dd/yyyy) habilitado : XX days HH:MM until description (mm/dd/yyyy)
Demo
Ejemplo básico de uso de Countdown:
| <all-lucky-sevens>¡El fin del mundo!</all-lucky-sevens> | El final del calendario Maya marca como fecha de terminación de un ciclo de existencia la fecha que corresponde en nuestro calendario al 22 de Diciembre de 2012. En este momento faltan <COUNTDOWN:2012-12-22 | para el fin del mundo>. |
|---|
El final del calendario Maya marca como fecha de terminación de un ciclo de existencia la fecha que corresponde en nuestro calendario al [u]22 de Diciembre de 2012[/u]. En este momento faltan <COUNTDOWN:2012-12-22|para el fin del mundo>.
Soporte de Horas y Minutos
| <COUNTDOWN:2012-01-01 | Caso 1> | Año Nuevo 2012, sólo la fecha |
| <COUNTDOWN:2012-01-01 02:30 | Caso 3> | Dos horas y media pasadas del Año Nuevo 2012 |
| <COUNTDOWN:2012-01-02 12:00 | Caso 4> | Dos de Enero de 2012 al mediodía, hora y fecha |
| <COUNTDOWN:18:00 | Caso 5> | Seis de la tarde de hoy, solo hora |
| <COUNTDOWN:2012-01-01|Caso 1> | Año Nuevo 2012, sólo la fecha | | <COUNTDOWN:2012-01-01 02:30|Caso 3> | Dos horas y media pasadas del Año Nuevo 2012 | | <COUNTDOWN:2012-01-02 12:00|Caso 4> | Dos de Enero de 2012 al mediodía, hora y fecha | | <COUNTDOWN:18:00|Caso 5> | Seis de la tarde de hoy, solo hora |
Historial
Changelog
TOBEDONE
Mejoras Futuras
- Agregar más archivos de idioma
- Aceptar entrada en formato ISO 8601 o equivalente para hacer la entrada de fecha independiente de la locale.
Estas mejoras, si se implementan, marcarán el siguiente release de este plugin.
- Implementar un modo container de manera que sea posible mostrar más valores, como horas, minutos y segundos, en cualquier parte de la descripción.
Esta mejora es más complicada y a mi parecer puede dar origen a un fork del plugin, o a una revisión de código lo bastante grande para dar el salto a la versión 3.0; por tanto este cambio tomará mucho más tiempo.