EventON - API Events

La web secundaria enseña el calendario y la visita acaba en la principal

Una asociación con varias sedes, una marca con un microsite, un socio que quiere anunciar tu programa. Cada web pide tu calendario, y si lo copias a mano, un cambio de hora se convierte en varias correcciones. Mantener una sola fuente evita ese trabajo, pero trae una consecuencia que conviene pensar antes de pegar el código.

Al hacer clic en un evento, el visitante sale de la web externa y llega a los detalles en tu sitio. Para ti es una fuente de tráfico. Para quien te presta el espacio, es una salida. Si la otra web es tuya, decide qué sitio debe quedarse con la visita. Si es de un socio, cuéntale ese recorrido desde el principio.

Event API muestra tu calendario de EventON en otras webs, sin iFrames, y publica tus eventos como datos JSON para aplicaciones móviles y plataformas de terceros. Los eventos se siguen gestionando en el sitio principal. Entre sus funciones no hay creación de eventos desde fuera, ni venta de entradas en la web externa.

Calendarios incrustados con un fragmento de JavaScript

• Cualquier web de destino: el fragmento se pega en sitios con WordPress o en HTML plano, y la web externa no necesita EventON.
• Calendario completo o evento suelto: puedes incrustar ambas cosas.
• Aspecto conservado: el calendario mantiene los estilos y las interacciones de EventON.
• Selección de eventos: limita lo que se ve por categoría, etiqueta o parámetros propios.
• Parámetros por calendario: ajusta diseño, fechas y tipos de evento.
• Sin límite de calendarios externos: cada uno lleva su propia configuración.

Con esto, una web puede enseñar solo los talleres y otra solo los conciertos, siempre que tengas esos tipos de evento creados en el sitio principal.

El JSON para quien programa su propia interfaz

Si el destino es una aplicación, el complemento ofrece una URL JSON con los próximos eventos. La respuesta los agrupa bajo events, identificados por su ID, con estos datos:

• Básicos: nombre, inicio, fin, detalles, zona horaria, estado de publicación, color, subtítulo, imagen y enlace.
• Repeticiones: cada una con su propio inicio y fin.
• Tipo de duración: marcas de evento de todo el día, de un mes o de un año.
• Lugar: nombre, dirección, latitud y longitud.
• Organizador: nombre, dirección y contacto.
• Clasificación: campos personalizados y tipos de evento.

El filtro evoapi_event_data permite añadir más datos. Por ejemplo, puedes incluir un valor de los metadatos del evento desde el functions.php del tema. La salida también se puede limitar por tipo de evento o por categoría.

Qué sigue dependiendo de tu sitio principal

Todo el contenido nace allí, así que necesitas EventON instalado y los eventos bien clasificados. Sin categorías coherentes, los filtros tienen poco con qué trabajar.

La URL JSON entrega eventos próximos, de modo que, para un archivo histórico en otra aplicación, cuenta con guardar esos datos por tu cuenta y pruébalo antes. Un fragmento pegado en otra web depende además de lo que ese editor permita: en Gutenberg, el código se pega en un bloque clásico, en su editor de código.

Llevar el calendario a un segundo sitio

Requiere EventON en el sitio de origen. Después de activar el complemento:

1. Crea en la web de destino la página que mostrará el calendario.
2. En el sitio principal, abre los ajustes de EventON, entra en EventON API y copia el código.
3. Pega el código en la página de destino.
4. Si quieres un solo tipo de evento, cambia la URL de la API por la filtrada, con la forma /wp-json/eventon/calendar?event_type=6, usando tu dominio y tu ID.
5. Guarda, abre un evento y comprueba adónde lleva el clic.

Con qué se combina y qué hay en otros calendarios

EventON Weekly View añade una cuadrícula semanal con navegación entre semanas a tu calendario, para programas con actividad casi diaria.

Si trabajas con Modern Events Calendar, Event API para MEC copia eventos entre webs, exporta scripts y descarga datos en JSON. Necesita MEC Pro y permite restringir la API a un dominio.

Respuestas para integrar tu calendario

¿La web externa tiene que usar WordPress?

No. El fragmento también funciona en sitios de HTML plano.

¿Puedo tener calendarios distintos en varias webs?

Sí. Admite calendarios externos sin límite, cada uno con sus ajustes.

¿Puedo añadir campos al JSON?

Sí, mediante el filtro evoapi_event_data, lo que requiere escribir algo de código.