Open Source Event Calendar

Features

All features are provided in their entirety. No features are locked behind any add-ons.

• Full iCal / ICS import & export
  • Automatically import external calendars
  • Categorize and tag imported feeds
• Recurring events, including complex recurrence rules (RFC 5545)
• Filtering by category and tag
• Calendar sharing with Google Calendar, Apple iCal, Outlook, and any other system that accepts iCalendar (.ics) feeds
• Month, week, day, and agenda views
• Upcoming Events Gutenberg block
• Direct links to filtered calendar views
• Color-coded events by category
• Featured event images and category images
• SEO-optimized event pages
• Mobile-friendly and responsive layouts
• Embedded OpenStreetMap
• Plana follows your WordPress theme’s colours and font sizes; adjust them in Theme Options
• Your calendar can be embedded into a WordPress page without needing to create template files or modify the theme.

Import events from other calendars and offer users the ability to subscribe to your calendar.

Importing and exporting iCalendar (.ics) feeds is one of the strongest features of the Event Calendar system. This allows you to manage your websites calendar by providing a public calendar from your Google, Apple or other calendar management software.

Blocks

You can embed the calendar by adding a OSEC Calendar Block to any page or post. Alternatively there is a shortcode available.

[!WARNING]
At this time, only one calendar per page or post is supported.

On the long run it’s planned to have a Rest API to allow the calendar being rendered with more modern frontend tools than the current, improved Bootstrap 3 stuff.

Shortcodes

Calendar Views

[osec]                       // Default view per settings
[osec view="monthly"]
[osec view="weekly"]
[osec view="agenda"]
[osec view="daily"]

Filtering

By category

[osec cat_name="Holidays"]
[osec cat_name="Lunar Cycles,zodia-date-ranges"]
[osec cat_id="1"]
[osec cat_id="1,2"]

By tag

[osec tag_name="tips-and-tricks"]
[osec tag_name="creative writing,performing arts"]
[osec tag_id="1"]
[osec tag_id="1,2"]

By post ID

[osec post_id="1"]
[osec post_id="1,2"]

Requirements

• WordPress: 6.7 or newer
• PHP:
  • PHP 8.2+ required for development
  • PHP 8.1 may work for production builds when installed with composer install --no-dev

Languages

OSEC supports multiple languages

This Is a Fork

OSEC is a fork of the GPL licensed plugin All-in-one-Event-Calendar by Timely. At it’s time a great plugin with a solid but unmaintainable codebase (not all required developer tools where opensourced).

If you love truly open source software and don’t mind to get your hands dirty you should join here. Free people need free software to manage and share events in a selfhosted manner.

External services

OSEC may connect to OpenStreetMap to render maps. If you using maps feature make sure you agree with Terms of Service

OSEC may connect to OpenStreetMap Nominatim geocoding API. Terms of Service.
You may need to switch the servive on a heavy traffic site as Nominatim allows an absolute maximum of 1 request per second.

Leaflet and leaflet-control-geocoder are bundled with the plugin, so rendering a map does not request
them from a third party.

You can load them from elsewhere, for example a CDN, using the hooks osec_leaflet_library_alter and
osec_leaflet_geocoder_library_alter.

Developer documentation

Caching, WP-CLI, Custom calendar themes, Migration Notes, Development & Support (README.md on GitHub)