Instrucciones para el uso del plugin PRÓXIMO

El plugin PRÓXIMO está diseñado para mostrar mensajes amigables acerca de eventos próximos basados en una fecha específica. Maneja eventos que ocurren hoy, mañana, la próxima semana, en dos semanas, en un mes, en varios días, semanas, meses o años. También ajusta su mensaje si la fecha ya ha pasado, proporcionando un mensaje de respaldo.

Uso Básico

El plugin se llama con el siguiente formato:

==͏[proximo|cuando=YYYY-MM-DD]==

• cuando=YYYY-MM-DD: Especifica la fecha del evento próximo en el formato YYYY-MM-DD. Si el evento tiene una hora, también puede añadirse en el formato YYYY-MM-DD HHMM.

Ejemplos de Uso

1. Evento Hoy:

==͏[proximo|cuando=2024-10-12]==
Salida: "Hoy"

2. Evento Mañana:

==͏[proximo|cuando=2024-10-13]==
Salida: "Mañana"

3. Evento La Próxima Semana:

==͏[proximo|cuando=2024-10-19]==
Salida: "La próxima semana el 19 de octubre, 2024"

4. Evento en Dos Semanas (14 Días):

==͏[proximo|cuando=2024-10-26]==
Salida: "En dos semanas el 26 de octubre, 2024"

5. Evento en 10 Días:

==͏[proximo|cuando=2024-10-22]==
Salida: "En 10 días el 22 de octubre, 2024"

6. Evento en Un Mes:

==͏[proximo|cuando=2024-11-12]==
Salida: "En un mes el 12 de noviembre, 2024"

7. Evento en Un Año:

==͏[proximo|cuando=2025-10-12]==
Salida: "En un año el 12 de octubre, 2025"

8. Evento Pasado (Mensaje de Respaldo):

==͏[proximo|cuando=2024-10-01]==
Salida: "Este evento ya pasó, pero imaginemos que no, así que hoy"

Uso Avanzado con Hora

También puedes proporcionar la hora del evento añadiéndola en formato de 24 horas:

==͏[proximo|cuando=YYYY-MM-DD HHMM]==

• HHMM: Es la hora del evento en formato de 24 horas (por ejemplo, 1430 para las 14:30).

Ejemplo:

==͏[proximo|cuando=2024-10-13 1430]==
Salida: "Mañana a las 14:30"

Personalización

El plugin también puede usarse con un modo de presentador para resaltar la fecha del evento cuando está en edición. Esto se controla mediante la siguiente variable de sesión:

$_SESSION['active_presenter_mode'] = 'editing'

Cuando el modo de presentador está activo, la salida será estilizada con texto en negrita y color naranja para diferenciar el modo de edición de la visualización estándar.

Ejemplo:

$_SESSION['active_presenter_mode'] = 'editing'

Salida:

• Los eventos aparecerán con el estilo color: naranja; font-weight: bold; durante la edición.

Parámetro Repetir para Eventos Recurrentes

El plugin PRÓXIMO también admite eventos repetitivos usando el parámetro repetir. Esto permite especificar un intervalo de repetición como semanal, quincenal, mensual o intervalos personalizados en días.

Uso con Eventos Repetitivos

El formato para eventos repetitivos es el siguiente:

==͏[proximo|cuando=YYYY-MM-DD&repetir=intervalo]==

• repetir: Especifica el intervalo de repetición. Los valores posibles son:
  
  • semanal: Repite el evento cada semana.
    
  • quincenal: Repite el evento cada dos semanas.
    
  • mensual: Repite el evento cada mes.
    
  • También puedes usar un número para intervalos personalizados en días (ejemplo, repetir=10 para repetir cada 10 días).

Ejemplos de Uso con Repetición

1. Repetición semanal:

==͏[proximo|cuando=2024-10-12&repetir=semanal]==
Salida: Si hoy es 13 de octubre de 2024, el próximo evento será el 19 de octubre de 2024.
Salida esperada: "En 6 días el 19 de octubre, 2024."

2. Repetición quincenal:

==͏[proximo|cuando=2024-10-12&repetir=quincenal]==
Salida: Si hoy es 13 de octubre de 2024, el próximo evento será el 26 de octubre de 2024.
Salida esperada: "En 13 días el 26 de octubre, 2024."

3. Repetición mensual:

==͏[proximo|cuando=2024-10-12&repetir=mensual]==
Salida: Si hoy es 13 de noviembre de 2024, el próximo evento será el 12 de diciembre de 2024.
Salida esperada: "En 29 días el 12 de diciembre, 2024."

4. Repetición personalizada (cada 10 días):

==͏[proximo|cuando=2024-10-12&repetir=10]==
Salida: Si hoy es 13 de octubre de 2024, el próximo evento será el 22 de octubre de 2024.
Salida esperada: "En 9 días el 22 de octubre, 2024."

Lógica de Salida

El plugin proporciona salidas amigables dependiendo de cuán cerca esté el evento:

• Hoy: "Hoy"
  
• Mañana: "Mañana"
  
• La Próxima Semana: "La próxima semana el [fecha formateada]"
  
• En Dos Semanas: "En dos semanas el [fecha formateada]"
  
• Número Exacto de Días (para eventos entre rangos semanales): "En X días el [fecha formateada]"
  
• Meses: "En un mes el [fecha formateada]"
  
• Años: "En un año el [fecha formateada]", "En X años el [fecha formateada]" (si es más de un año)
  
• Evento Pasado: "Este evento ya pasó, pero imaginemos que no, así que hoy"

Manejo de Errores

• Si no se proporciona una fecha válida, el plugin mostrará "Hoy" como mensaje predeterminado.
  
• Los eventos pasados devolverán el mensaje "Este evento ya pasó, pero imaginemos que no, así que hoy" como respaldo, simulando que el evento ocurre hoy.