VentoCalendar

Descripción

📅 Simple & Lightweight WordPress Event Calendar

VentoCalendar es un plugin de WordPress potente pero sencillo para crear y gestionar eventos. Ofrece una interfaz intuitiva para añadir eventos con fechas de inicio y fin, colores personalizables y una vista de calendario interactiva.

Diseñado para centrarse en lo esencial, VentoCalendar te ofrece una forma clara de gestionar y mostrar eventos sin complicaciones innecesarias.

Plugin gratuito y respetuoso con la privacidad: Sin anuncios, sin seguimiento y sin servicios externos obligatorios para la funcionalidad principal del calendario. Tus datos de eventos se quedan en tu servidor. Desarrollado teniendo en cuenta los estándares de código de WordPress y las buenas prácticas.

📅 Características del calendario

• Tipo de contenido personalizado para eventos – Tipo de contenido dedicado para eventos con todas las características de WordPress
• Gestión de Fecha y Hora – Selector de fecha y hora fácil de usar para las fechas de inicio y fin
• Codificación de colores – Asigna colores personalizados a los eventos para una mejor organización visual
• Calendario interactivo – Un calendario atractivo con tipo de vista seleccionable (calendario mensual o lista de eventos), con botones «Añadir al calendario» para Google Calendar y Apple Calendar
• Opciones de diseño – Elige entre diseños básico, compacto o limpio para personalizar la apariencia del calendario
• Bloques de Gutenberg – Dos bloques personalizados para mostrar información de eventos y calendarios
• Shortcodes – Shortcodes flexibles para mostrar calendarios e información de eventos en cualquier lugar
• API REST – Endpoints de API REST integrados para integraciones personalizadas
• Diseño adaptable: calendario totalmente adaptable que funciona en todos los dispositivos
• Listo para internacionalización – Totalmente traducible con archivo .pot incluido

📍 Ubicaciones de eventos y mapas opcionales

Los eventos también pueden tener una ubicación física. Añade una ubicación o dirección a tus eventos y, si quieres, muestra un mapa interactivo.

• Ubicaciones de eventos – Añade información de la ubicación y la dirección de tus eventos
• Mapas interactivos opcionales – Muestra un mapa para los eventos que tienen una ubicación física
• Selector de ubicación del mapa: selecciona la ubicación del evento directamente en el mapa
• Funciona con OpenFreeMap y MapLibre – tecnología de mapas de código abierto e impulsada por la comunidad, con la biblioteca MapLibre GL JS incluida en local
• Sin clave de la API de Google Maps – Los mapas no requieren una clave de la API de Google Maps ni una cuenta de Google
• No se requiere geocodificación – Elige la ubicación del mapa manualmente sin enviar una dirección a un servicio de geocodificación

Los mapas son totalmente opcionales y no cambian el funcionamiento básico del calendario.

Bloques de Gutenberg

1. Bloque de calendario – Muestra una vista mensual del calendario con todos los eventos
2. Bloque de información del evento – Muestra la fecha y hora del evento utilizando los formatos de fecha/hora de WordPress.

Shortcodes

• [ventocalendar-calendar] – Mostrar vista completa del calendario
• [ventocalendar-start-date] – Mostrar la fecha de inicio del evento
• [ventocalendar-end-date] – Mostrar la fecha de finalización del evento
• [ventocalendar-start-time] – Mostrar la hora de inicio del evento
• [ventocalendar-end-time] – Mostrar la hora de finalización del evento
• [ventocalendar-location] – Muestra la ubicación del evento
• [ventocalendar-address] – Muestra la dirección del evento
• [ventocalendar-map] – Muestra el mapa del evento

Todos los shortcodes usan los formatos de fecha y hora configurados en «Ajustes → Generales».

Perfecto para

• Organizaciones comunitarias
• Espacios para eventos
• Iglesias y organizaciones religiosas
• Colegios y universidades
• Calendarios de eventos empresariales
• Sitios web de conferencias
• Horarios de talleres y clases

Privacidad y cumplimiento

VentoCalendar está diseñado teniendo en cuenta la privacidad y las directrices de WordPress.org:

Licencia

• GPLv2 o posterior – Este plugin es software libre con licencia bajo la Licencia Pública General de GNU v2 o posterior
• Diseñado para cumplir con las directrices de WordPress.org
• Todo el código es de código abierto y está disponible para su valoración

Sin código ofuscado

• Todo el código JavaScript, PHP y CSS es legible y no está minificado
• No es necesario ningún proceso de compilación.
• Todo el código fuente es legible y editable por humanos
• Sin funcionalidades ocultas ni código cifrado.

«Sin servicios externos obligatorios»

• Solución autoalojada – La funcionalidad principal del calendario se ejecuta en tu servidor de WordPress
• No se requieren servicios de terceros obligatorios ni claves de API.
• Vue.js library is bundled with the plugin and loaded locally (no CDN)
• La biblioteca MapLibre GL JS viene en el plugin y se carga localmente (sin CDN)
• No necesitas cuentas externas, suscripciones ni servicios de pago para el calendario

Mapas opcionales

Los mapas son opcionales. Cuando se muestra un mapa, VentoCalendar usa OpenFreeMap para proporcionar los recursos del mapa.

• No necesitas una clave de la API de Google Maps ni cuenta de Google
• No se envía ninguna dirección a un servicio de geocodificación
• Las coordenadas del mapa se guardan con el evento en tu base de datos de WordPress
• OpenFreeMap solo se usa cuando se muestra un mapa de un evento

Sin anuncios

• El plugin no muestra anuncios en el área de administración de WordPress ni en la portada
• No se incluyen enlaces de afiliados ni contenido patrocinado
• Todas las características básicas del calendario están disponibles sin avisos promocionales ni ofertas

Privacidad amigable

• El plugin no recopila, rastrea ni transmite datos de los usuarios para analítica o publicidad.
• El plugin no añade analíticas, scripts de seguimiento ni cookies.
• Los datos del evento se almacenan localmente en la base de datos de WordPress y permanecen bajo el control del propietario del sitio.
• Los recursos de mapa opcionales se cargan desde OpenFreeMap cuando se muestra un mapa

Qué datos se almacenan

• Información del evento (títulos, descripciones, fechas, colores) – almacenada en la base de datos de WordPress
• Información de la ubicación del evento y la dirección, cuando se facilite
• Coordenadas del mapa y ajustes de visualización del mapa, cuando el mapa está activado
• Los datos del evento se quedan en tu servidor bajo tu control

Notas del desarrollador

Arquitectura

El plugin sigue la arquitectura de WordPress Plugin Boilerplate con un sistema de carga centralizado. Todos los ganchos se registran a través de la clase principal del plugin.

API REST

Variable: GET /wp-json/ventocalendar/v1/events

Parámetros:

• inicio (opcional): filtro de fecha de inicio (formato Y-m-d)
• fin (opcional): filtro de fecha de finalización (formato Y-m-d)

Respuesta: Array de objetos de eventos con id, título, fechas, horas, color y enlace permanente.

Estructura de archivos

• admin/ – Funcionalidad específica para el administrador (PHP, JS, CSS)
• public/ – Funcionalidad pública (PHP, JS, CSS)
• includes/ – Clases principales del plugin
• includes/blocks/ – Clases de bloques de Gutenberg
• includes/cpt/ – Definiciones de tipos de contenido personalizado
• languages/ – Archivos de traducción

Desarrollo

No es necesario ningún proceso de compilación. Todos los archivos están sin minimizar y listos para ser editados directamente. El plugin utiliza las funciones estándar de WordPress para encolar todos los activos.

Donaciones

Este plugin es gratuito. Las donaciones son un apoyo voluntario para su desarrollo.

Si encuentras útil VentoCalendar, puedes apoyar su desarrollo aquí: Donar a través de Ko-fi

Soporte

Para recibir soporte, solicitar nuevas características o informar sobre fallos, por favor visita el foro de soporte del plugin en WordPress.org.

Créditos

• Creado utilizando WordPress Plugin Boilerplate
• El calendario funciona con Vue.js
• Mapas interactivos que funcionan con OpenFreeMap y MapLibre