Releases: TimUx/grav-plugin-opencalendar
Release list
v1.3.1
What's Fixed
GPM and release ZIP installs no longer require a manual composer install on the server.
Production Composer dependencies (sabre/vobject + optimized autoload) are now included in the package. Without them, OpenCalendar exited early with “not ready”, so sync and shortcodes did nothing.
Upgrade
bin/gpm update opencalendar
bin/grav cacheOr reinstall from GPM / this release ZIP, then clear cache. No Composer step needed.
If you already ran composer install as a workaround, updating is still fine.
Full Changelog: https://github.com/TimUx/grav-plugin-opencalendar/blob/v1.3.1/CHANGELOG.md
v1.3.0 — Grav 1.7 & 2.0 compatibility
OpenCalendar 1.3.0
One plugin package for Grav 1.7 and Grav 2.0 (compatibility.grav: ['1.7', '2.0']). No separate opencalendar2 plugin.
Grav 2.0 (Admin Next)
- Custom sync field:
admin-next/fields/opencalendar_sync.js - API routes:
/api/v1/opencalendar/{status,sync,rebuild,clear-cache,upload} - Dashboard notifications with sync summary
- Twig content sandbox allow-list for OpenCalendar functions
Grav 1.7 (unchanged UX)
- Classic Admin Twig sync dashboard, path-based JSON actions, home widget
Internals
- Event subscriptions no longer gated on
isAdmin()at boot (required for Admin Next / API)
Install / update
bin/gpm install opencalendar
# or update to tag v1.3.0Grav 2.0 requires PHP 8.3+ and the Grav API plugin (ships with 2.0).
v1.2.1 — Lean install packages
OpenCalendar 1.2.1
Packaging
- GPM / GitHub release ZIPs exclude development-only paths via
.gitattributes(export-ignore) - Also excluded from Composer dist archives (
archive.exclude) - Not installed:
docs/,tests/,.github/, contributing/security/CoC files,README.de.md, PHPUnit/PHPStan/PHPCS configs - Still included: runtime plugin code, languages, templates, assets, Admin UI,
CHANGELOG.md,LICENSE,README.md, Composer files
Docs
- README documentation links point to GitHub
- Manual install guides prefer the release ZIP over
git clone
Install / update
bin/gpm install opencalendar
# or download the v1.2.1 source ZIP from this releasev1.2.0 — Admin calendar file upload
OpenCalendar 1.2.0
Admin calendar upload
- Synchronization tab: upload
.ics/.ical/.jsonfiles - Files stored under
user/data/opencalendar/uploads/ - Registered as
type: localsources and imported into SQLite immediately - Re-upload with the same source name updates the source (no duplicate)
Local sources
- Resolve under
user/data/opencalendar/(uploads) and the plugin directory
Docs (EN + DE)
- Upload covered in README, Sources, Synchronization, Configuration, FAQ, Troubleshooting, Installation
Install / update
bin/gpm install opencalendar
# or pull tag v1.2.0 and composer install --no-devGuides: Synchronization (EN) · DE
v1.1.1 — Shortcodes, grouping & calendar subscription
OpenCalendar 1.1.1
Shortcodes / Twig
max_events— hard cap on events in a widgetno_pagination— hide list pagergroup_by—none|day|week|month|year- Full parameter docs including
show_past(docs/Shortcodes.md)
Network calendar subscription
- Live ICS feed for phones/mail apps (
/opencalendar/calendar.ics) webcal://helper, refresh hints, ETag/304- Optional subscribe UI (
show_subscribe) - Guides: Abonnieren.md (DE), Subscribe.md (EN)
Install / update
bin/gpm install opencalendar
# or pull tag v1.1.1 and composer install --no-devv1.1.0 — Roadmap features
OpenCalendar 1.1.0
Completes the public roadmap after the GPM-ready 1.0.1 baseline.
New
- Admin home dashboard widget with sync status
- Webhook-triggered forced sync (shared secret)
- Public ICS export feed (
/opencalendar/calendar.icsand API/export.ics) - Event pipeline Grav hooks for custom processing
- Language packs: French, Spanish, Dutch, Italian
Improved
- Optional sync when Grav cache is cleared
- Twig helper
opencalendar_export_url()
Install
bin/gpm install opencalendar
# or
git clone … user/plugins/opencalendar && composer install --no-devDocs: https://github.com/TimUx/grav-plugin-opencalendar/tree/main/docs
v1.0.1 — GPM listing readiness
OpenCalendar 1.0.1
First tagged release prepared for the official Grav Package Manager (GPM).
Highlights
- ICS, CalDAV, JSON, and local calendar sources
- SQLite storage with FTS search, filters, and pagination
- Calendar and list views, Twig helpers, shortcodes, optional REST API
- Admin configuration, EN/DE translations, PHPUnit/CI
GPM notes
- Slug:
opencalendar - License: MIT
- Compatibility: Grav 1.7 (PHP 8.2+)
- Demo: https://www.feuerwehr-willingshausen.de/de/termine
- Docs: https://github.com/TimUx/grav-plugin-opencalendar/tree/main/docs
Install after GPM listing: bin/gpm install opencalendar
Manual: clone into user/plugins/opencalendar and run composer install --no-dev.