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 agregar eventos con fechas de inicio y fin, colores personalizables y una vista de calendario interactiva.
Designed to focus on the essentials, VentoCalendar gives you a clean way to manage and display events without unnecessary complexity.
Free and privacy-friendly plugin: No ads, no tracking, and no mandatory external services for the core calendar functionality. Your event data stays on your server. Developed with WordPress coding standards and best practices in mind.
📅 Calendar Features
- 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
- Interactive Calendar – Beautiful calendar with selectable view type (monthly calendar or event list), with “Add to my calendar” buttons for Google Calendar and 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
📍 Event Locations & Optional Maps
Events can also have a physical location. Add a location or address to your events and optionally display an interactive map.
- Event Locations – Add location and address information to your events
- Optional Interactive Maps – Display a map for events that have a physical location
- Map Location Picker – Select the event location directly on the map
- Powered by OpenFreeMap and MapLibre – Open-source, community-driven map technology, with the MapLibre GL JS library bundled locally
- No Google Maps API Key – Maps do not require a Google Maps API key or Google account
- No Geocoding Required – Choose the map location manually without sending an address to a geocoding service
Maps are completely optional and do not change the way the core calendar works.
Bloques de Gutenberg
- Bloque de calendario – Muestra una vista mensual del calendario con todos los eventos
- 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]– Display event location[ventocalendar-address]– Display event address[ventocalendar-map]– Display event map
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.
No Mandatory External Services
- Self-hosted solution – The core calendar functionality runs on your WordPress server
- No se requieren servicios de terceros obligatorios ni claves de API.
- Vue.js library is bundled with the plugin and loaded locally (no CDN)
- MapLibre GL JS library is bundled with the plugin and loaded locally (no CDN)
- No external accounts, subscriptions, or paid services needed for the calendar
Optional Maps
Maps are optional. When a map is displayed, VentoCalendar uses OpenFreeMap to provide the map resources.
- No Google Maps API key or account is required
- No address is sent to a geocoding service
- Map coordinates are stored with the event in your WordPress database
- OpenFreeMap is only used when an event map is displayed
Sin anuncios
- The plugin does not display advertisements in the WordPress admin area or on the frontend
- No affiliate links or sponsored content are included
- All core calendar features are available without promotional notices or upsells
Privacidad amigable
- The plugin does not collect, track, or transmit user data for analytics or advertising
- El plugin no agrega 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.
- Optional map resources are loaded from OpenFreeMap when a map is displayed
Qué datos se almacenan
- Información del evento (títulos, descripciones, fechas, colores) – almacenada en la base de datos de WordPress
- Event location and address information, when provided
- Map coordinates and map display settings, when a map is enabled
- Event data remains on your server under your 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
Parameters:
start(optional) – Start date filter (Y-m-d format)end(optional) – End date filter (Y-m-d format)
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 pluginincludes/blocks/– Clases de bloques de Gutenbergincludes/cpt/– Definiciones de tipos de contenido personalizadolanguages/– 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
- Interactive maps powered by OpenFreeMap and MapLibre
Capturas de pantalla
Bloques
Este plugin proporciona 2 bloques.
- Events Calendar
- Event Info
Instalación
Instalación automática
- Accede a tu panel de administración de WordPress
- Ir a Plugins Agregar nuevo
- Busca “VentoCalendar”
- Haz clic en “Instalar ahora” y luego en “Activar”.
Instalación manual
- Descarga el archivo zip del plugin
- Accede a tu panel de administración de WordPress
- Ir a Plugins Agregar nuevo Subir plugin
- Elige el archivo zip descargado y haz clic en “Instalar ahora”
- Activa el plugin a través del menú “Plugins” en WordPress
Después de la activación
- Ir a “VentoCalendar Agregar nuevo evento” para crear tu primer evento
- Agregar detalles del evento como título, descripción, fechas y color
- Usa el bloque de calendario o el shortcode para mostrar eventos en cualquier página
- Ir a “Ajustes” para configurar la visualización automática de información de eventos
FAQ
-
¿Cómo muestro el calendario en mi web?
-
Puedes mostrar el calendario de tres formas:
1. Utiliza el bloque de Gutenberg “Calendario de eventos” en el editor de bloques
2. Utiliza el shortcode[ventocalendar-calendar]en cualquier entrada o página
3. Añádelo directamente a la plantilla de tu tema utilizandodo_shortcode('[ventocalendar-calendar]') -
¿Puedo personalizar los formatos de fecha y hora?
-
¡Sí! El plugin usa los formatos de fecha y hora configurados en Ajustes Generales. Todos los eventos, bloques y shortcodes usan automáticamente estos formatos para mantener la coherencia en tu sitio. Para cambiar los formatos, simplemente actualízalos en los ajustes generales de WordPress.
-
¿Los eventos se muestran en orden cronológico?
-
Sí, los eventos se ordenan automáticamente por fecha en la vista de calendario y en las respuestas de la API REST.
-
¿Puedo tener eventos de varios días?
-
¡Por supuesto! Los eventos pueden durar varios días. Simplemente establece diferentes fechas de inicio y fin, y el calendario los mostrará como barras horizontales que abarcan el rango de fechas.
-
Can I add a location to an event?
-
Yes! You can add a location and address to your events. If the event has a physical location, you can also optionally enable an interactive map and select the location directly on the map.
-
Do I need a Google Maps API key?
-
No. VentoCalendar’s optional maps do not require a Google Maps API key or a Google account.
-
Does VentoCalendar automatically convert addresses into map locations?
-
No. VentoCalendar does not require automatic address geocoding. When using a map, you can select and position the event location directly on the map.
-
Are maps required?
-
No. Maps are completely optional. If an event does not need a map, simply leave the map disabled.
-
¿Está el plugin listo para traducir?
-
¡Sí! El plugin incluye un archivo .pot para traducciones y sigue las mejores prácticas de internacionalización de WordPress. ¡Tanto las cadenas de PHP como las de JavaScript son traducibles!
-
¿Funciona con cualquier tema?
-
VentoCalendar está diseñado para funcionar con cualquier tema de WordPress programado correctamente. El calendario utiliza un estilo mínimo y neutro que se adapta al diseño de tu sitio.
-
¿Puedo personalizar los colores de los eventos?
-
¡Sí! Cada evento tiene un selector de color que te permite elegir cualquier color. Los eventos se muestran con sus colores asignados en la vista de calendario.
-
¿Cómo muestro la información del evento automáticamente?
-
Ve a “VentoCalendar Ajustes” y marca “Mostrar información del evento automáticamente en las entradas de eventos individuales”. Puedes elegir si mostrar las horas de inicio y fin. Los formatos de fecha y hora usan los ajustes generales de WordPress.
-
¿Hay alguna API para desarrolladores?
-
¡Sí! El plugin incluye endpoints de la API REST en
/wp-json/ventocalendar/v1/eventspara recuperar eventos.
Reseñas
Colaboradores & Desarrolladores
“VentoCalendar” es software de código abierto. Las siguientes personas han contribuido a este plugin.
Colaboradores
“VentoCalendar” ha sido traducido en 4 idiomas. Gracias a los traductores por sus contribuciones.
Traduce “VentoCalendar” a tu idioma.
¿Interesado en el desarrollo?
Revisa el código, echa un vistazo al repositorio SVN, o suscríbete al registro de desarrollo por RSS .
Historial de cambios
1.3.0
- Feature: Added event locations, with location and address fields for each event.
- Feature: Added optional interactive maps for events, powered by OpenFreeMap and MapLibre.
- Feature: Added a map location picker to select the event location directly on the map.
- Feature: Maps do not require a Google Maps API key or an address geocoding service.
- Fix: Corrected a typo in a UI string.
1.2.0
- Característica: Agregado el campo de CSS personalizado en Ajustes para permitir estilos personalizados sin modificar los archivos del plugin.
- Retoque: Mejoras menores de CSS
1.1.4
- Mejora: se ha modificado el algoritmo que calcula las posiciones de los eventos en el calendario
1.1.3
- Mejora: se ha modificado el algoritmo que calcula las posiciones de los eventos en el calendario
- Retoque: Mejoras menores de CSS
1.1.2
- Corrección: Solucionado desfase de fecha relacionado con la zona horaria en la generación de la URL de “Agregar al calendario”.
- Retoque: Mejoras menores de CSS
- Retoque: Ajuste menor en el posicionamiento de las barras del calendario
1.1.1
- Regenerado el archivo .pot.
1.1.0
- Agregado ajuste para establecer el tipo de vista en el calendario
- Agregado ajuste de diseño en el calendario
- Botones de agregar al calendario agregados en el calendario
- Ajustes en la interfaz de usuario y estilos
1.0.2
- Versión del plugin corregida en el archivo principal y en el readme.
1.0.1
- Agregadas columnas de “Fecha de inicio” y “Fecha de fin” en la lista de eventos de administración.
- Mejoradas y ajustadas varias cadenas de la interfaz de usuario para mayor claridad.
1.0.0
- Versión inicial
- Tipo de contenido personalizado para eventos con fechas de inicio/fin
- Código de colores para eventos
- Calendario interactivo de Vue.js
- Bloques de Gutenberg para información de eventos y calendario
- Shortcodes para opciones flexibles de visualización
- Endpoints de la API REST
- Diseño totalmente adaptable
- Compatible con internacionalización