Integração iCal e Feed

Cada post de calendário no SportsPress expõe um feed iCal que aplicativos de calendário externos podem assinar. O feed é atualizado automaticamente sempre que eventos são adicionados ou alterados.

Links de Feed na Administração

Ao editar um post de calendário, a meta box Feeds (no lado direito do editor) mostra três links de assinatura prontos para uso:

Apple Calendar — uma URL webcal:// que o macOS Calendar e o iOS Calendar abrem diretamente
Outlook — uma URL webcal:// para o Microsoft Outlook
Google — uma URL webcal:// prefixada com http://www.google.com/calendar/render?cid= para que clicar nela abra o diálogo "Adicionar por URL" do Google Calendar

Cada link é exibido como um ícone clicável e uma entrada de texto somente leitura que você pode copiar.

Formato de URL do Feed

A URL bruta do feed é:

https://example.com/calendar-slug/?feed=sp-ical

Onde calendar-slug é o permalink do post de calendário. O parâmetro de consulta feed=sp-ical aciona o template de feed iCal.

O feed emite uma resposta text/calendar com o nome de arquivo <post-slug>.ics.

O que o Feed Contém

Cada evento no calendário se torna um bloco VEVENT na saída iCal:

SUMMARY — o título do evento, ou uma string de placar (por exemplo, "Time A 2 Time B 1") quando os resultados estão disponíveis
DTSTART — a data e hora agendadas do evento
DTEND — calculado adicionando a duração do Tempo Total do evento (em minutos) à hora de início; o padrão é 90 minutos se não estiver definido
LOCATION — o nome e endereço do local (de sp_address), se o evento tiver um local atribuído
GEO — latitude e longitude (de sp_latitude e sp_longitude), se as coordenadas estiverem armazenadas no local
DESCRIPTION — o conteúdo do post do evento (texto do corpo)
UID — o ID do post do WordPress

O cabeçalho do calendário inclui X-WR-CALNAME e X-WR-CALDESC definidos como o título do post do calendário, e TZID / X-WR-TIMEZONE definidos como a configuração de fuso horário do WordPress.

Assinando no Apple Calendar

Na meta box Feeds, copie o link Apple Calendar.
No Apple Calendar, escolha Arquivo > Nova Assinatura de Calendário.
Cole a URL e clique em Assinar.
Defina o intervalo de atualização automática e clique em OK.

Como alternativa, clique diretamente no ícone de link — o macOS abrirá o Calendar automaticamente e pedirá que você assine.

Assinando no Google Calendar

Na meta box Feeds, copie o link Google.
Clique no link ou cole-o em um navegador. O Google Calendar abre a tela "Adicionar calendário" com a URL pré-preenchida.
Clique em Adicionar calendário.

O Google Calendar busca novamente o feed periodicamente (tipicamente a cada 24 horas; o feed solicita um intervalo de atualização de 2 minutos via REFRESH-INTERVAL;VALUE=DURATION:PT2M mas o Google não respeita isso).

Assinando no Outlook

Na meta box Feeds, copie o link Outlook.
No Outlook, escolha Arquivo > Configurações de Conta > Configurações de Conta, depois a aba Calendários da Internet, e clique em Novo.
Cole a URL e clique em Adicionar.

Para o Outlook na web, use Adicionar calendário > Assinar da web e cole a URL.