iCalendar y suscripciones

TimelyChurch puede tanto publicar el calendario de su iglesia al mundo exterior (para que los visitantes de su sitio web y los miembros puedan suscribirse en su aplicación de calendario personal) como importar otros calendarios (para que los eventos de un calendario denominacional, de un socio o comunitario aparezcan dentro de TimelyChurch).

Este artículo cubre tres funciones estrechamente relacionadas pero distintas:

1. Inserción de calendario público — Un widget iframe que inserta en el sitio web de su iglesia.
2. Fuentes iCal salientes — URL .ics en vivo a las que Apple Calendar, Google Calendar y Outlook pueden suscribirse.
3. Suscripciones de calendario entrantes — Extraer eventos de URL .ics externas hacia TimelyChurch según una programación.

Consejo: Para exportaciones .ics de una sola vez de un solo evento, una sola serie o un rango de fechas, consulte la sección Exportación e importación de iCalendar. La exportación allí es una instantánea estática. Las fuentes de suscripción de este artículo permanecen en vivo y se actualizan a medida que cambian los eventos.

1. Inserción de calendario público

El calendario público es un widget autocontenido que puede insertar en el sitio web de su iglesia usando un iframe. Los visitantes pueden explorar todos sus eventos públicos sin una cuenta.

URL de inserción

https://your-app-domain.com/c/{churchSlug}/calendar

Parámetros de consulta

La inserción acepta estos parámetros de consulta opcionales para personalizar lo que ven los visitantes:

Código de inserción de ejemplo

<iframe
  src="https://your-app-domain.com/c/grace-community/calendar?types=worship,event&view=month"
  width="100%"
  height="700"
  frameborder="0"
  title="Grace Community Calendar">
</iframe>

Lo que ven los visitantes

La inserción muestra solo los eventos marcados como Público y Activo, filtrados por el parámetro types y el rango de fechas que se está viendo en ese momento. Al hacer clic en un evento se abre su página de detalle pública.

2. Fuentes iCal salientes (suscribirse desde fuera)

El calendario de su iglesia se expone como una fuente iCalendar en vivo en dos URL:

Ambas fuentes incluyen eventos desde hace un mes hasta un año adelante, limitados solo a eventos públicos y activos.

Suscripción en Calendario de Apple (macOS / iOS)

1. Copie la URL de suscripción de su iglesia: https://your-app-domain.com/c/grace-community/calendar.ics
2. Mac: Abra Calendario y elija Archivo > Nueva suscripción de calendario.... Pegue la URL y haga clic en Suscribirse.
3. iOS: Abra Configuración > Calendario > Cuentas > Agregar cuenta > Otro > Agregar calendario suscrito. Pegue la URL y toque Siguiente.
4. Establezca el intervalo de actualización automática (Apple recomienda cada 1 hora o diariamente).

Suscripción en Google Calendar

1. Abra Google Calendar en un navegador.
2. En la barra lateral izquierda, en Otros calendarios, haga clic en el icono + y elija Desde URL.
3. Pegue la URL de suscripción: https://your-app-domain.com/c/grace-community/calendar.ics
4. Haga clic en Agregar calendario.

Nota: Google Calendar solo actualiza las suscripciones .ics externas cada varias horas. No espere que los cambios en TimelyChurch aparezcan en Google de inmediato.

Suscripción en Microsoft Outlook (escritorio o web)

1. Outlook en la web: Haga clic en Agregar calendario > Suscribirse desde la web. Pegue la URL de suscripción y haga clic en Importar.
2. Outlook de escritorio: Elija Agregar calendario > Desde Internet, pegue la URL y haga clic en Aceptar.

Filtrar la fuente por tipo de evento

Agregue un parámetro de consulta types a cualquiera de las URL de fuente para restringirla:

https://your-app-domain.com/c/grace-community/calendar.ics?types=worship

Los valores pueden combinarse con comas: ?types=worship,class.

3. Suscripciones de calendario entrantes (extraer hacia TimelyChurch)

También puede suscribir TimelyChurch a una fuente de calendario externa. Esto es útil cuando:

• Un organismo denominacional publica un calendario de eventos compartido.
• Una iglesia socia desea compartir su calendario con usted.
• Desea que un calendario de eventos cívicos/comunitarios aparezca junto al suyo.

Los eventos externos se importan a TimelyChurch y se muestran en su calendario de administración. También pueden publicarse automáticamente en su calendario público.

Dónde gestionar suscripciones

Navegue a Configuración > Suscripciones de calendario en el área de administración.

Agregar una suscripción

Haga clic en Agregar suscripción y complete:

Al guardar, TimelyChurch valida que la URL sea accesible y contenga datos iCalendar válidos, y luego ejecuta una primera sincronización inmediata.

Cómo funciona la sincronización

• Cada suscripción tiene un intervalo de sincronización que determina con qué frecuencia TimelyChurch vuelve a obtener la fuente.
• Durante una sincronización, los eventos de la fuente externa se emparejan por UID. Se crean eventos nuevos, se actualizan los existentes y se eliminan los que desaparecen de la fuente.
• Los eventos importados se etiquetan con la suscripción, para que siempre pueda distinguir cuáles son locales frente a externos.
• Haga clic en Sincronizar ahora en cualquier suscripción para forzar una actualización inmediata.

Eliminación de una suscripción

Al eliminar una suscripción, elige qué sucede con los eventos que importó:

• Conservar eventos importados — Desvincula los eventos de la suscripción para que se conviertan en eventos locales normales.
• Eliminar eventos importados — Elimina todos los eventos que provinieron de esta suscripción.

Notas de seguridad

• Las suscripciones de calendario solo pueden gestionarlas usuarios que tengan permiso para la función de Calendario.
• Las URL de fuentes externas se validan antes de agregarse, por lo que esta función no puede usarse indebidamente para recuperar URL arbitrarias.

Elegir la herramienta adecuada