LuchoWiki

Cosas que debería hacer más a menudo

User Tools

Site Tools


desarrollo:dokuwiki:plugin-countdown

plugin:countdown

  • Countdown: muestra los días que faltas hasta la fecha específica.
  • Descarga Versión 2.5, 2011-06-06
  • 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 2187 days 04:55 since para el fin del mundo (12/22/2012) .
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

2543 days 04:55 since Caso 1 (01/01/2012) Año Nuevo 2012, sólo la fecha
2543 days 02:25 since Caso 3 (01/01/2012) Dos horas y media pasadas del Año Nuevo 2012
2541 days 16:55 since Caso 4 (01/02/2012) Dos de Enero de 2012 al mediodía, hora y fecha
0 days 13:04 until Caso 5 (12/18/2018) 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.


desarrollo/dokuwiki/plugin-countdown.txt · Last modified: 20120526 10:53 (external edit)