iCalendar e assinaturas

O TimelyChurch pode tanto publicar o calendário da sua igreja para o mundo externo (para que visitantes do site e membros possam assinar em seu aplicativo de calendário pessoal) quanto importar outros calendários (para que eventos de um calendário denominacional, parceiro ou comunitário apareçam dentro do TimelyChurch).

Este artigo cobre três recursos relacionados, mas distintos:

1. Incorporação do calendário público — Um widget iframe que você coloca no site da sua igreja.
2. Feeds iCal de saída — URLs .ics ao vivo que Apple Calendar, Google Calendar e Outlook podem assinar.
3. Assinaturas de calendário de entrada — Puxa eventos de URLs .ics externas para o TimelyChurch em uma programação.

Dica: Para exportações .ics únicas de um único evento, uma única série ou um intervalo de datas, consulte a seção Exportação e importação iCalendar. A exportação ali é um instantâneo estático. Os feeds de assinatura neste artigo permanecem ao vivo e se atualizam conforme os eventos mudam.

1. Incorporação do calendário público

O calendário público é um widget autocontido que você pode incorporar no site da sua igreja usando um iframe. Visitantes podem explorar todos os seus eventos públicos sem uma conta.

URL de incorporação

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

Parâmetros de consulta

A incorporação aceita estes parâmetros de consulta opcionais para personalizar o que os visitantes veem:

Exemplo de código de incorporação

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

O que os visitantes veem

A incorporação mostra apenas eventos marcados como Público e Ativo, filtrados pelo parâmetro types e pelo intervalo de datas exibido no momento. Clicar em um evento abre sua página pública de detalhes.

2. Feeds iCal de saída (assinar de fora)

O calendário da sua igreja é exposto como um feed iCalendar ao vivo em dois URLs:

Ambos os feeds incluem eventos de um mês atrás até um ano à frente, limitados a eventos públicos e ativos apenas.

Assinar no Apple Calendar (macOS / iOS)

1. Copie a URL de assinatura da sua igreja: https://your-app-domain.com/c/grace-community/calendar.ics
2. Mac: Abra o Calendário e escolha Arquivo > Nova assinatura de calendário.... Cole a URL e clique em Assinar.
3. iOS: Abra Ajustes > Calendário > Contas > Adicionar conta > Outro > Adicionar calendário assinado. Cole a URL e toque em Avançar.
4. Defina o intervalo de atualização automática (a Apple recomenda a cada 1 hora ou diariamente).

Assinar no Google Calendar

1. Abra o Google Calendar em um navegador.
2. Na barra lateral esquerda em Outros calendários, clique no ícone + e escolha Da URL.
3. Cole a URL de assinatura: https://your-app-domain.com/c/grace-community/calendar.ics
4. Clique em Adicionar calendário.

Nota: O Google Calendar só atualiza assinaturas .ics externas a cada várias horas. Não espere que alterações no TimelyChurch apareçam no Google instantaneamente.

Assinar no Microsoft Outlook (desktop ou web)

1. Outlook na web: Clique em Adicionar calendário > Assinar da web. Cole a URL de assinatura e clique em Importar.
2. Outlook desktop: Escolha Adicionar calendário > Da Internet, cole a URL e clique em OK.

Filtrar o feed por tipo de evento

Acrescente um parâmetro de consulta types a qualquer URL de feed para restringi-lo:

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

Os valores podem ser combinados com vírgulas: ?types=worship,class.

3. Assinaturas de calendário de entrada (puxar para o TimelyChurch)

Você também pode assinar o TimelyChurch a um feed de calendário externo. Isso é útil quando:

• Um organismo denominacional publica um calendário de eventos compartilhado.
• Uma igreja parceira quer compartilhar seu calendário com você.
• Você quer que um calendário de eventos cívicos/comunitários apareça junto com o seu.

Eventos externos são importados para o TimelyChurch e mostrados no seu calendário de administração. Eles podem opcionalmente ser publicados automaticamente no seu calendário público também.

Onde gerenciar assinaturas

Navegue até Configurações > Assinaturas de calendário na área de administração.

Adicionando uma assinatura

Clique em Adicionar assinatura e preencha:

Ao salvar, o TimelyChurch valida que a URL está acessível e contém dados iCalendar válidos, depois executa uma primeira sincronização imediata.

Como a sincronização funciona

• Cada assinatura tem um intervalo de sincronização que determina com que frequência o TimelyChurch busca novamente o feed.
• Durante uma sincronização, eventos do feed externo são correspondidos por UID. Novos eventos são criados, eventos existentes são atualizados e eventos que desaparecem da origem são excluídos.
• Eventos importados são marcados com a assinatura, para que você sempre saiba quais são locais versus externos.
• Clique em Sincronizar agora em qualquer assinatura para forçar uma atualização imediata.

Removendo uma assinatura

Ao excluir uma assinatura, você escolhe o que acontece com os eventos que ela importou:

• Manter eventos importados — Desvincula os eventos da assinatura para que se tornem eventos locais regulares.
• Excluir eventos importados — Remove todos os eventos que vieram desta assinatura.

Notas de segurança

• Assinaturas de calendário só podem ser gerenciadas por usuários com permissão para o recurso de Calendário.
• Os URLs de feeds externos são validados antes de serem adicionados, então este recurso não pode ser usado indevidamente para buscar URLs arbitrários.

Escolhendo a ferramenta certa