Open Source Event Calendar

By digitaldonkey

★ 5.0/5 (2 ratings)100+ active installationsVersion 1.2.2

An event calendar with native iCal / ICS import and export

Description

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.

Tom Select (Apache-2.0) is bundled for the calendar’s category and tag filters.

Developer documentation

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

Installation

Install as any other plugin, or from GitHub.

Setup steps

  1. Open the plugin settings page and save once
  2. Configure:
    • Timezone
    • UI date formats
    • Week start day
  3. Review WordPress → Settings → General for output date formats.
  4. (Optional) Override constants file:
    Copy constants-local.php.example and save as constants-local.php

To remove all plugin data on uninstall, set: define('OSEC_UNINSTALL_PLUGIN_DATA', true);

FAQ

“I really need feature XYZ”

Let’s draft it out on GitHub. You could donnate/pay me development time to get it contributed. Invoices possible. Or feel free to implement the requested feature yourself and create a Pull Request for it.
I may also provide paid support.

Event descriptions show other content (page builders, share buttons, related posts)

Event descriptions in the agenda view and the ICS feed are passed through WordPress’ the_content filter, in the context of the event, so plugins hooking into it behave as on the event itself. Most of them can be switched off per post type in their own settings.

If a plugin still adds unwanted content, enable OSEC Settings → Advanced → Strict compatibility content filtering. Event descriptions in agenda view and the ICS feed then only get basic formatting (wptexturize, convert_smilies, convert_chars, wpautop); developers can change that list with the osec_event_the_content_strict_filters filter.

A feed fails with “cURL error 60: SSL certificate problem”

Feeds are fetched with certificate verification, so a server with a self-signed, expired or incomplete certificate is refused (before 1.1.15 certificates were not checked). WordPress checks against its own list of certificate authorities, not the one of your server.

If the certificate is issued by an authority installed on your server, such as a company or local certificate authority (“unable to get local issuer certificate”), enable Settings → Advanced → Trust this server’s CA certificates for feeds. Certificates are still verified, against WordPress’ list plus your server’s.

Otherwise ask the feed’s provider to fix the certificate, or use http:// if the provider offers it. If you trust that server anyway, you can exempt just its host with WordPress’ http_request_args filter:

`php

add_filter(‘http_request_args’, function ($args, $url) {
if (‘calendar.example.org’ === wp_parse_url($url, PHP_URL_HOST)) {
$args[‘sslverify’] = false;
}
return $args;
}, 10, 2);
`

Screenshots

Changelog

1.2.2

Highlights

  • Category and tag filters are searchable multiselects: Plana picks several terms and applies them together, Vortex applies each pick; with more than 300 terms in use the filter searches on the server (#86)
  • Filtered calendar views are no longer indexed by search engines; category and tag links on events are nofollow

Fixes

  • Names and labels show their text once, not Arts & Culture or l'événement: categories, tags, translated labels, ticket links, the event name for search engines
  • ICS feeds: & no longer arrives as &, long lines stay correctly folded (#76)
  • ICS feeds: text written with angle brackets stays in the description (#78), and its line breaks are kept
  • ICS feeds: excluded dates in one EXDATE property, without the invalid leading comma (#77)
  • ICS feeds: an event address with accents (translated /événement/ slug) no longer breaks the whole feed
  • Single event export: the calendar name shows the site title as text (“Bob’s Calendar”)
  • Event page: a wrong date in the URL is a “400 Bad Request” instead of an error page; a date no longer on the event leads to the event with a notice (#74)
  • Feeds: a deleted category no longer adds a category named after its number to imported events, nor breaks the feed form
  • Feed imports with ACF or SCF active no longer end in a fatal error when they create new events (#82)

Developers

  • Custom calendar themes with their own categories.twig / tags.twig from 1.2.1 or earlier: term.href and term.color are only built with OSEC_BUILD_LEGACY_TERM_ARGS; an admin notice names affected templates. New template taxonomy-filter-select.twig
  • Frontend Select2 removed; Tom Select 2.7.0 bundled (Apache-2.0)
  • New: REST route osec/v1/terms, action osec_event_url_not_exportable, constants OSEC_TAXONOMY_FILTER_SEARCH_THRESHOLD and OSEC_BUILD_LEGACY_TERM_ARGS

1.2.1

Fixes

  • Excluding a date on a repeating event no longer removes the whole series; a review page repairs affected events, also wp osec repair-exclusions (#71)
  • “Edit this instance” and Clone now check the permission for that event; a clone only includes what the user may read (#73)
  • Editing an occurrence of a private event no longer makes that occurrence public (#73)
  • “Edit this instance”: a moved occurrence no longer comes back on its old date; the first occurrence no longer adds a date at the end or shows twice, and no longer loses the rest of a private or draft series
  • Clone no longer leaves empty items in the media library, and a clone of an occurrence is now its own event (#73)
  • ICS export respects “Hide event cost” and the map setting
  • Plana: the subscribe button follows filters chosen without a page reload (#72)
  • With WPML, a single event’s “Add event to…” exports that event, not the whole calendar

1.2.0

Highlights

  • Plana fits the WordPress theme: colours, lines and text sizes as Theme Options, defaults from the theme
  • Faster: SVG icons, stylesheet 406 to 227 KB, served as a static file; new “Clear all caches”
  • Calendar block: width follows the page, agenda expanded or collapsed per block, print icon setting
  • Print: month, week and day fill the page on any paper size
  • Emoji in events and feeds (utf8mb4), longer event fields, option to trust the server’s CA certificates for feeds
  • Complete schema.org/Event microdata in all themes; names for icon-only buttons
  • Updated translations; full SQLite support (for the Live Preview)

Fixes

  • 5 security fixes: imported feed fields, event titles in the views, JSONP callback, cache report permission, admin output
  • Fields escaped twice since 1.0.7 (“D&D”); repair from the admin notice or with wp osec repair-escaping
  • Feed import: categories and tags #62, duplicates, timeouts, long fields, UTC offsets
  • Excluded dates of recurring events on SQLite and in other time zones #44
  • Month view, agenda, date picker, print and theme fixes: 50 fixes in all

Developers

  • Internet Explorer is no longer supported; custom themes: only the icons in osec-icons-map.less remain
  • Templates: new event-popup.twig, event.image_html; frontend rendering with twig.js 3 and autoescape
  • WP-CLI: wp osec theme, wp osec content generate, wp osec repair-escaping
  • Calendar URLs carry exact_date as ISO date; URLs in the input date format keep working

All changes and older versions: CHANGELOG.md