Descrición
📅 Simple & Lightweight WordPress Event Calendar
VentoCalendar é un potente pero sinxelo plugin de WordPress para crear e xestionar eventos. Ofrece unha interface intuitiva para engadir eventos con datas de inicio e fin, cores personalizables e unha vista de calendario interactiva.
Deseñado para centrarte no esencial, VentoCalendar permíteche contar cun xeito limpo de xestionar e mostrar eventos sen complexidade innecesaria.
Plugin gratuíto e respectuoso coa privacidade: Sen anuncios, sen seguimento e sen servizos externos obrigatorios para a funcionalidade principal do calendario. Os teus datos de eventos quedan no teu servidor. Desenvolvido pensando nas normas de código de WordPress e nas boas prácticas.
Características do calendario
- Tipo de contido personalizado para eventos – Tipo de entrada dedicado para eventos con todas as características de WordPress
- Xestión de Data e Hora – Selector de data e hora doado de usar para as datas de inicio e fin
- Cor personalizada – Asigna cores personalizadas aos eventos para unha mellor organización visual
- Calendario interactivo – Calendario bonito con tipo de vista seleccionable (calendario mensual ou lista de eventos), con botóns «Engadir ao calendario» para Google Calendar e Apple Calendar.
- Opcións de deseño – Escolle entre deseño básico, compacto ou limpo para personalizar a aparencia do calendario
- Bloques de Gutenberg – Dous bloques personalizados para mostrar calendarios e información de eventos
- Shortcodes – Shortcodes flexibles para mostrar calendarios e información de eventos en calquera lugar
- API REST – Endpoints da API REST integrados para integracións personalizadas
- Deseño Adaptable – Calendario totalmente adaptable que funciona en todos os dispositivos
- Listo para internacionalización – Totalmente traducible con arquivo .pot incluído
📍 Localizacións de eventos e mapas opcionais
Os eventos tamén poden ter unha localización física. Engade unha localización ou un enderezo aos teus eventos e, se queres, mostra un mapa interactivo.
- Localizacións do evento – Engade información de localización e enderezo aos teus eventos
- Mapas interactivos opcionais – amosa un mapa para os eventos que teñan unha localización física
- Selector de localización do mapa: selecciona a localización do evento directamente no mapa
- Feito con OpenFreeMap e MapLibre: tecnoloxía de mapas de código aberto e impulsada pola comunidade, coa biblioteca MapLibre GL JS incluída localmente
- Sen clave da API de Google Maps: os mapas non necesitan unha clave da API de Google Maps nin unha conta de Google
- Non é necesario o xeocodificado – Elixe manualmente a localización do mapa sen enviar un enderezo a un servizo de xeocodificado
Os mapas son totalmente opcionais e non cambian o funcionamiento básico do calendario.
Bloques de Gutenberg
- Bloque de calendario – Amosa unha vista mensual do calendario con todos os teus eventos
- Bloque de Información do Evento – Mostra a data e a hora do evento usando os formatos de data/hora de WordPress
Shortcodes
[ventocalendar-calendar]– Amosar vista completa do calendario[ventocalendar-start-date]– Amosar a data de inicio do evento[ventocalendar-end-date]– Amosar a data de finalización do evento[ventocalendar-start-time]– Amosar a hora de inicio do evento[ventocalendar-end-time]– Amosar a hora de finalización do evento[ventocalendar-location]– Amosar a localización do evento[ventocalendar-address]– Mostra o enderezo do evento[ventocalendar-map]– Mostra o mapa do evento
Todos os shortcodes usan os formatos de data e hora configurados en Axustes Xeral.
Perfecto para
- Organizacións comunitarias
- Lugares de eventos
- Igrexas e organizacións relixiosas
- Escolas e universidades
- Calendarios de eventos de negocios
- Webs de conferencias
- Horarios de obradoiros e clases
Privacidade e cumprimento
VentoCalendar está deseñado tendo en conta a privacidade e as directrices de WordPress.org:
Licenza
- GPLv2 ou posterior – Este plugin é software libre con licenza da Licenza Pública Xeral da GNU v2 ou posterior
- Deseñado para cumprir coas directrices de WordPress.org
- Todo o código é de código aberto e está dispoñible para valoración
Sen código ofuscado
- Todo o código JavaScript, PHP e CSS é legíbel e sen minimizar
- Non é necesario ningún proceso de construción ou compilación
- Todo o código fonte é legíbel e editable por persoas
- Sen funcionalidades ocultas nin código cifrado
Sen servizos externos obrigatorios
- Solución autoxestionada: a funcionalidade principal do calendario funciona no teu servidor de WordPress
- Non é necesario ningún servizo de terceiros obrigatorio ou claves de API.
- Vue.js library is bundled with the plugin and loaded locally (no CDN)
- A biblioteca MapLibre GL JS ven incluída co plugin e cargase localmente (sen CDN)
- Non fai falta ningunha conta externa, subscricións nin servizos de pago para o calendario
Mapas opcionais
Os mapas son opcionais. Cando se mostra un mapa, o VentoCalendar usa OpenFreeMap para proporcionar os recursos do mapa.
- Non fai falta unha clave da API de Google Maps nin unha conta de Google
- Non se envía ningún enderezo a un servizo de xeocodificación
- As coordenadas do mapa gárdanse co evento na túa base de datos de WordPress
- OpenFreeMap só se usa cando se mostra un mapa dun evento
Sen publicidade
- O plugin non amosa anuncios na área de administración de WordPress nin na portada
- Non se inclúen ligazóns de afiliados nin contido patrocinado
- Todas as características están dispoñibles sen avisos promocionais ou vendas adicionais
Amigable coa privacidade
- O plugin non recolle, rastrexa nin transmite datos de usuarios para analítica ou publicidade
- O plugin non engade ningún tipo de analítica, scripts de seguimento ou cookies.
- Os datos do evento están gardados localmente na base de datos de WordPress e permanecen baixo o control do dono do sitio.
- Os recursos de mapas opcionais carganse desde OpenFreeMap cando se mostra un mapa
Que datos se gardan
- Información do evento (títulos, descricións, datas, cores) – gardada na base de datos de WordPress
- Información da localización e do enderezo do evento, cando se facilite
- Coordenadas do mapa e axustes de visualización do mapa, cando o mapa está activado
- Os datos do evento quedan no teu servidor baixo teu control
Notas do desenvolvedor
Arquitectura
O plugin segue a arquitectura do Plugin Boilerplate de WordPress cun sistema de carga centralizado. Todos os ganchos son rexistrados a través da clase principal do plugin.
API REST
Endpoint: GET /wp-json/ventocalendar/v1/events
Parámetros:
- `
iniciar(opcional) – Filtro de data de inicio (formato Y-m-d)` end(opcional) – Filtro de data de finalización (formato Y-m-d)
Resposta: Array de obxectos de evento con id, título, datas, horas, cor e ligazón permanente.
Estrutura de arquivos
administrador/– Funcionalidade específica do administrador (PHP, JS, CSS)public/– Funcionalidade pública (PHP, JS, CSS)includes/– Clases principais do pluginincludes/blocks/– Clases de bloques de Gutenbergincludes/cpt/– Definicións de tipos de contido personalizadolanguages/– Arquivos de tradución
Desenvolvemento
Non é necesario ningún proceso de construción. Todos os arquivos están sen minificar e listos para edición directa. O plugin usa as funcións estándar de engadir de WordPress para todos os recursos.
Doazóns
Este plugin é de balde. As doazóns son un apoio voluntario para o seu desenvolvemento.
Se atopas o VentoCalendar útil, podes dar soporte ao seu desenvolvemento aquí: Doar a través de Ko-fi
Soporte
Para soporte, peticións de características ou informes de fallos, por favor visita o foro de soporte do plugin en WordPress.org.
Créditos
- Construído usando WordPress Plugin Boilerplate
- Calendario feito con Vue.js
- Mapas interativos feitos con OpenFreeMap e MapLibre
Capturas
Blocks
Este plugin proporciona 2 bloques.
- Events Calendar
- Event Info
Instalación
Instalación automática
- Inicia sesión no teu panel de administrador de WordPress.
- Vai a Plugins Engadir Novo
- Busca «VentoCalendar»
- Fai clic en «Instalar agora» e despois en «Activar».
Instalación manual
- Descarga o arquivo zip do plugin
- Inicia sesión no teu panel de administrador de WordPress.
- Vai a Plugins Engadir Novo Subir plugin
- Escolle o arquivo zip descargado e fai clic en «Instalar agora»
- Activa o plugin a través do menú «Plugins» en WordPress
Despois da activación
- Vai a VentoCalendar Engadir Novo Evento para crear o teu primeiro evento
- Engadir detalles do evento incluíndo título, descrición, datas e cor.
- Usa o bloque de Calendario ou o shortcode para mostrar eventos en calquera páxina
- Vai a Axustes para configurar a visualización automática da información dos eventos
Preguntas frecuentes
-
Como podo mostrar o calendario na miña web?
-
Podes mostrar o calendario de tres maneiras:
1. Usa o bloque Gutenberg «Calendario VentoCalendar» no editor de bloques
2. Usa o shortcode[ventocalendar-calendar]en calquera entrada ou páxina
3. Engádeo directamente ao modelo do teu tema usandodo_shortcode('[ventocalendar-calendar]') -
Podo personalizar os formatos de data e hora?
-
Si! O plugin usa os formatos de data e hora configurados en Axustes Xeral. Todos os eventos, bloques e shortcodes usan automaticamente estes formatos para manter a consistencia no teu sitio. Para cambiar os formatos, simplemente actualízaos nos teus axustes xerais de WordPress.
-
Os eventos mostranse en orde cronolóxica?
-
Sí, os eventos ordénanse automaticamente por data na vista do calendario e nas respostas da API REST.
-
Podo ter eventos de varios días?
-
Por suposto! Os eventos poden durar varios días. Simplemente establece diferentes datas de inicio e fin, e o calendario mostrará como barras horizontais abarcando o rango de datas.
-
Podo engadir unha localización a un evento?
-
¡Si! Podes engadir unha localización e un enderezo aos teus eventos. Se o evento ten unha localización física, tamén podes activar opcionalmente un mapa interactivo e seleccionar a localización directamente no mapa.
-
Necesito unha clave da API de Google Maps?
-
Non. Os mapas opcionais de VentoCalendar non che piden unha clave da API de Google Maps nin unha conta de Google.
-
VentoCalendar converte automaticamente os enderezos en localizacións de mapa?
-
Non. VentoCalendar non necesita xeocodificación automática do enderezo. Ao usar un mapa, podes seleccionar e colocar a localización do evento directamente no mapa.
-
¿Son os mapas obrigatorios?
-
Non. Os mapas son completamente opcionais. Se un evento non necesita un mapa, simplemente déixao desactivado.
-
Está o plugin listo para ser traducido?
-
Si! O plugin inclúe un arquivo .pot para traducións e segue as mellores prácticas de internacionalización de WordPress. Tanto as cadeas de PHP como de Javascript son traducibles.
-
Funciona co meu tema?
-
VentoCalendar está deseñado para funcionar con calquera tema de WordPress codificado correctamente. O calendario usa un estilo mínimo e neutro que se adapta ao deseño do teu sitio.
-
Podo personalizar as cores do evento?
-
Si! Cada evento ten un selector de cor que che permite escoller calquera cor. Os eventos móstranse coas súas cores asignadas na vista do calendario.
-
Como mostro a información do evento automáticamente?
-
Vai a VentoCalendar Axustes e marca «Amosar automáticamente a información do evento nas páxinas individuais dos eventos». Podes escoller se queres amosar as horas de inicio e fin. Os formatos de data e hora usan os axustes xerais de WordPress.
-
Hai unha API para desenvolvedores?
-
Si! O plugin inclúe endpoints da API REST en
/wp-json/ventocalendar/v1/eventspara recuperar eventos.
Comentarios
Colaboradores e desenvolvedores
“VentoCalendar” é un software de código aberto. As seguintes persoas colaboraron con este plugin.
Colaboradores
“VentoCalendar” foi traducido a 4 idiomas. Grazas aos desenvolvedores polas súas contribucións.
Traduce “VentoCalendar” ao teu idioma.
Interesado no desenvolvemento?
Revisa o código, bota unha ollada aorepositorio SVN, ou subscríbete ao log de desenvolvemento por RSS.
Rexistro de cambios
1.3.0
- Característica: Engadidas as localizacións dos eventos, con campos de localización e enderezo para cada evento.
- Característica: Engadido mapas interactivos opcionais para eventos, impulsados por OpenFreeMap e MapLibre.
- Característica: Engadido un selector de localización no mapa para escoller a localización do evento directamente no mapa.
- Característica: Os mapas non necesitan unha clave da API de Google Maps nin un servizo de xeocodificación de enderezos.
- Corrección: Corrixido un erro tipográfico nunha cadea da interface.
1.2.0
- Característica: Engadiuse un campo de CSS personalizado en Axustes para permitir estilos personalizados sen modificar os arquivos do plugin.
- Axuste: Melloras menores de CSS
1.1.4
- Mellora: modificado o algoritmo que calcula as posicións dos eventos no calendario.
1.1.3
- Mellora: modificado o algoritmo que calcula as posicións dos eventos no calendario.
- Axuste: Melloras menores de CSS
1.1.2
- Corrección: Resolto o desprazamento de data relacionado co fuso horario na xeración da URL «Engadir ao Calendario»
- Axuste: Melloras menores de CSS
- Axuste: Axuste menor no posicionamento das barras do calendario
1.1.1
- Arquivo POT rexerado.
1.1.0
- Engadido o axuste do tipo de vista no calendario
- Engadiuse o axuste de deseño no calendario
- Botóns de engadir ao calendario engadidos no calendario
- Axustes na interface de usuario e estilos
1.0.2
- Versión do plugin corrixida no arquivo principal e no readme.
1.0.1
- Engadidas columnas de data de inicio e data de finalización na lista de administrador de eventos.
- Axustadas e melloradas varias cadeas da interface de usuario para maior claridade.
1.0.0
- Versión inicial
- Tipo de contido personalizado para eventos con datas de inicio e fin
- Cor para os eventos
- Calendario interactivo de Vue.js
- Bloques de Gutenberg para información de eventos e calendario
- Shortcodes para opcións de visualización flexibles
- Endpoints da API REST
- Deseño totalmente adaptable
- Soporte de internacionalización