Descrição
Você: Eu só quero colocar um calendário do Google Agenda no meu site WordPress.
Google: Aqui está ele de um jeito bem horroroso!
Pretty Google Calendar: Deixa que eu resolvo.
Este é um plugin leve e simples que integra calendários do Google Agenda em seu website com estilo, beleza e graça.
Pontos principais:
- Suporte imediato para os modos de exibição de calendário list e grid
- Design responsivo, alterando para exibição em lista para telas menores
- Exibição em lista customizável para dia, semana, mês, ano ou um número customizável de dias.
Como funciona:
- Continue a gerenciar eventos usando o Google Agenda como você sempre fez.
- Adicione um shortcode na sua página.
- Respire com alívio.
- É isso.
Imagens de tela
Instalação
- Suba a pasta do
pretty-google-calendar
para o diretório/wp-content/plugins/
. - Ative o
Pretty Google Calendar
através do menu ‘Plugins’ no painel do WordPress. - Obtenha a sua chave de API do Google Agenda (veja abaixo)
- Adicionar a chave da API às Configurações -> Configurações do Pretty Google Calendar
- Use o shortcode
[pretty_google_calendar gcal="calendarID@group.calendar.google.com"]
diretamente na sua página ou post.
Opções do Shortcode
gcal="CalendarID,CalendarID"
O ID do calendário do Google Agenda desejado (nota: precisa ser configurado para ‘Disponibilizar publicamente’. Para exibir multiplos calendários, separe os IDs com uma vírgula. (Nota: os calendários devem estar sob o mesmo acesso da chave de API.))
locale="en"
Configura o local para regionalização do calendário. O padrão é “en”.
list_type="listCustom"
Configura o tipo de lista. Opções: listDay
, listWeek
, listMonth
, listYear
, e listCustom
. (Também aceita day, week, month, year e custom).
O padrão é listCustom
para compatibilidade retroativa.
Nota: listCustom
permite que você configure o número de dias que você deseja exibir a partir da data atual. Enquanto listMonth mostra todos os eventos deste mês (incluindo eventos passados), list_type="custom" custom_days="28"
irá mostrar os próximos 28 dias através dos meses.
custom_days="28"
Configura o número de dias a serem exibidos na aba de lista. O padrão é 28. Somente utilizado com listCustom.
custom_list_button="list"
Configura o rótulo do botão listCustom. O padrão é “list”.
views="dayGridMonth, listCustom"
Configura os tipos de calendários disponíveis. Se apenas um for provido, não serão exibidos botões para alterar os tipos de calendários. O padrão é “dayGridMonth, listCustom”.
initial_view="dayGridMonth"
Configura o tipo padrão de calendário a ser exibido assim que a página é aberta. O padrão é “dayGridMonth”.
enforce_listview_on_mobile="true"
Configura o comportamento de mudança para o tipo lista em telas pequenas. Opções: “true” e “false”. O padrão é “true”. Esta opção não tem efeito se não houver uma lista declarada na opção “views”.
show_today_button="true"
Configura a visibilidade do botão “Hoje”. Opções: “true” e “false”. O padrão é “true”.
show_title="true"
Configura a visibilidade do título do calendário. Opções: “true” e “false”. O padrão é “true”.
Obtendo a Chave de API do Google Agenda
- Vá ao Google Developer Console e crie um novo projeto (pode levar uns segundos).
- Uma vez no projeto, vá para APIs e serviços ativados na barra lateral.
- Encontre “Calendar API” na lista e o habilite (coloque em ON).
- Na barra lateral, clique em Credenciais.
- Na seção “Chaves de API”, clique em “Criar credenciais”.
- Escolha “Chave do navegador”.
- Se você souber quais domínios utilizarão o seu calendário, digite eles neste campo. Senão, deixe em branco. Você sempre pode alterar isso depois.
- Sua nova chave de API irá aparecer. Copie este valor e cole no campo de configuração do Pretty Google Calendar.
- Pode levar um segundo ou dois antes que sua API comece a funcionar.
Deixe o seu calendário do Google Agenda público:
- Na interface do Google Agenda, ache a área de “Minhas agendas” à esquerda.
- Passe o mouse sobre o calendário que você precisa e clique na seta para baixo.
- Um menu irá aparecer. Clique em “Compartilhar esta agenda”.
- Marque “Tornar este calendário público”.
- Certifique-se que “Ver apenas os níveis disponível/ocupado (ocultar detalhes)” está desmarcado.
- Clique em “Salvar”.
Obtenha o ID do seu calendário do Google Agenda:
- Na interface do Google Agenda, ache a área de “Minhas agendas” à esquerda.
- Passe o mouse sobre o calendário que você precisa e clique na seta para baixo.
- Um menu irá aparecer. Clique em “Configurações da agenda”.
- Na parte “Endereço da agenda” da tela você irá ver o seu ID do calendário. Ele se parecerá com algo como “abcd1234@group.calendar.google.com”. Este é o valor que você deve colocar no seu shortcode.
FAQ
-
Que feitiçaria é essa?!
-
O Pretty Google Calendar implementa o excelente Full Calendar para você e usa um pouco de Tippy.js e Popper para fazer as coisas… bem… popar.
-
Eu posso usar isso para gerenciar um calendário?
-
Não. Todos os eventos do calendário são mantidos através do Google Agenda. Este plugin apenas os mostra de um jeito menos pior.
-
Como eu crio um tema para o calendário?
-
Adicione um CSS customizado ao seu tema para adaptar ao seu desejo.
-
Este plugin pode fazer X, Y ou Z?
-
Provavelmente não. Mas talvez possa!
O Pretty Google Calendar é propositalmente simples e fácil, configurável com poucos valores padrão para fazer as coisas simplesmente funcionarem. Contudo, pode ser que haja uma funcionalidade matadora que outros também estão clamando.
Uma vez que é baseado no Full Calendar, teoricamente, tudo que é possível lá é possivel aqui. Entre em contato para solicitar funcionalidades adicionais e vamos ver o que nós conseguimos criar juntos!
Avaliações
Colaboradores e desenvolvedores
“Pretty Google Calendar” é um software com código aberto. As seguintes pessoas contribuíram para este plugin.
Colaboradores“Pretty Google Calendar” foi traduzido para 2 localizações. Agradecemos aos tradutores por suas contribuições.
Traduzir “Pretty Google Calendar” para o seu idioma.
Interessado no desenvolvimento?
Navegue pelo código, dê uma olhada no repositório SVN ou assine o registro de desenvolvimento via RSS.
Registro de alterações
1.4.1
- Corrigido: domínio de texto para localização
1.4.0
- Adicionado: suporte para mútiplos calendários exibidos em um
- Adicionado: internacionalização completa (Obrigado @mwguerra!)
- Adicionado: novos parâmetros de shortcode (view, initial_view, enforce_listview_on_mobile, show_today_button, show_title) (Trabalho heróico por @mwguerra!)
- Testado até o WordPress 6.0.3
1.3.1
Salto de versão para atender ao sistema de versionamento do WordPress.
1.3.0
- Adicionado: seletor para o tipo de lista
- Adicionado: texto do botão list customizável
- Adicionado: suporte à localização
1.2.0
- Adicionado: opção para desabilitar link
- Adicionado: opção “list_days” no shortcode
- Corrigido: fuso horário no tooltip
- Atualização do FullCalendar para v5.11.0
- Testado até o WordPress 5.9.3
1.1.0
Lançamento Inicial ao Público