An event calendar with native iCal / ICS import and export

digitaldonkey

Lukas Pawlik

Borislav Angelov

Yani

Nicola Peluchetti

hubrik

farmer paul

Justas Butkus

<p>An event calendar with native iCal / ICS import and export</p>
<h3>Features</h3>
<p>All features are provided in their entirety. <strong>No features are locked behind any add-ons</strong>.</p>
<ul>
<li><strong>Full iCal / ICS import & export</strong>
<ul>
<li>Automatically import external calendars</li>
<li>Categorize and tag imported feeds</li>
</ul>
</li>
<li><strong>Recurring events</strong>, including complex recurrence rules <a href="https://icalendar.org/iCalendar-RFC-5545/3-8-5-3-recurrence-rule.html" rel="nofollow ugc">(RFC 5545)</a></li>
<li>Filtering by category and tag</li>
<li><strong>Calendar sharing</strong> with Google Calendar, Apple iCal, Outlook, and any other system that accepts iCalendar (.ics) feeds</li>
<li>Month, week, day, and agenda views</li>
<li><strong>Upcoming Events</strong> Gutenberg block</li>
<li>Direct links to <strong>filtered calendar views</strong></li>
<li>Color-coded events by category</li>
<li>Featured event images and category images</li>
<li>SEO-optimized event pages</li>
<li>Mobile-friendly and responsive layouts</li>
<li>Embedded <strong>OpenStreetMap</strong></li>
<li>Theme options to customize your calendar appearence</li>
<li>Your calendar can be embedded into a WordPress page without needing to create template files or modify the theme.</li>
</ul>
<p><strong>Import events from other calendars</strong> and offer users the <strong>ability to subscribe to your calendar</strong>.</p>
<p>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.</p>
<h3>Blocks</h3>
<p>You can embed the calendar by adding a <strong>OSEC Calendar Block</strong> to any page or post. Alternatively there is a shortcode available.</p>
<blockquote>
<p>[!WARNING]<br />
  At this time, only <strong>one calendar per page or post</strong> is supported.</p>
</blockquote>
<p>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, outdated, but nice old Bootstrap 3 stuff.</p>
<h3>Shortcodes</h3>
<h4>Calendar Views</h4>
<pre><code>[osec]                       // Default view per settings
[osec view="monthly"]
[osec view="weekly"]
[osec view="agenda"]
[osec view="daily"]
</code></pre>
<h4>Filtering</h4>
<p><strong>By category</strong></p>
<pre><code>[osec cat_name="Holidays"]
[osec cat_name="Lunar Cycles,zodia-date-ranges"]
[osec cat_id="1"]
[osec cat_id="1,2"]
</code></pre>
<p><strong>By tag</strong></p>
<pre><code>[osec tag_name="tips-and-tricks"]
[osec tag_name="creative writing,performing arts"]
[osec tag_id="1"]
[osec tag_id="1,2"]
</code></pre>
<p><strong>By post ID</strong></p>
<pre><code>[osec post_id="1"]
[osec post_id="1,2"]
</code></pre>
<h3>Requirements</h3>
<ul>
<li>WordPress: 6.6 or newer</li>
<li>PHP:
<ul>
<li>PHP 8.2+ required for development</li>
<li>PHP 8.1 may work for production builds when installed with <code>composer install --no-dev</code></li>
</ul>
</li>
</ul>
<h3>Languages</h3>
<p>OSEC supports multiple languages</p>
<h3>This Is a Fork</h3>
<p>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).</p>
<p>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.</p>
<h3>External services</h3>
<p>OSEC may connect to OpenStreetMap to render maps. If you using maps feature make sure you agree with <a href="https://operations.osmfoundation.org/policies/" rel="nofollow ugc">Terms of Service</a></p>
<p>OSEC may connect to OpenStreetMap Nominatim geocoding API. <a href="https://operations.osmfoundation.org/policies/nominatim/" rel="nofollow ugc">Terms of Service</a>.<br />
You may need to switch the servive on a heavy traffic site as Nominatim allows an <em>absolute maximum of 1 request per second</em>.</p>
<p>By default leaflet and leaflet-control-geocoder are loaded from unpkg.com. <a href="https://app.unpkg.com/policies@1.0.1" rel="nofollow ugc">Terms of Service</a>.</p>
<p>You can change using hooks: <code>osec_leaflet_library_alter</code>, <code>osec_leaflet_geocoder_library_alter</code>.</p>
<h3>Migration Notes</h3>
<p>Database structure is not fully compatible with All-in-One Event Calendar v2.3.4</p>
<p>Migration may be possible with manual effort</p>
<p>A standardized upgrade path may be developed if there is demand and contributions</p>
<p>See this <a href="https://github.com/digitaldonkey/open-source-event-calendar/wiki/migration-from-all%E2%80%90in%E2%80%90one%E2%80%90event%E2%80%90calendar" rel="nofollow ugc">wiki</a> for currently known information on migrating.</p>
<h3>Development & Support</h3>
<p>The principle behind this plugin is to be Open Source. Get in touch on <a href="https://github.com/digitaldonkey/open-source-event-calendar" rel="nofollow ugc">GitHub</a> to report issues, propose feature enhancements, and get general guidance for contributing.</p>
<p>Writing this fork was <a href="https://github.com/wp-plugins/all-in-one-event-calendar/compare/master...digitaldonkey:open-source-event-calendar:master" rel="nofollow ugc">a huge effort</a>.</p>
<p>Digitaldonkey believes everybody should be able to set up and manage public calendars.</p>
<p>If you are implementing this plugin for others you should support ongoing development with a <a href="https://www.paypal.com/donate/?hosted_button_id=ZNWEQRQNJBTE6" rel="nofollow ugc">donation</a> or <a href="https://github.com/digitaldonkey/open-source-event-calendar/issues" rel="nofollow ugc">contribution</a>.</p>
<p><a href="https://dri.es/solving-the-maker-taker-problem" rel="nofollow ugc">Be a maker</a>😀</p>
<p>Those wishing to contribute to the development of this project, please see the <a href="https://github.com/digitaldonkey/open-source-event-calendar/blob/master/.github/CONTRIBUTORS.md" rel="nofollow ugc">Development Guide</a> for more information.</p>


Alternatives to Open Source Event Calendar

Top alternatives