kaymanmk

<p>CalDav Calendar Viewer fetches and displays events from any standard iCal (.ics) feed directly on your site using a simple shortcode. It supports multiple calendar feeds, each with its own URL and optional username/password for authenticated endpoints.</p>
<p><strong>Key Features:</strong></p>
<ul>
<li><strong>Multiple Calendar Feeds</strong> – Configure as many feeds as you need, each with a unique ID.</li>
<li><strong>iCal / RFC 5545 Support</strong> – Parses standard <code>.ics</code> calendar feeds including all-day events, times, locations, and descriptions.</li>
<li><strong>Recurring Events</strong> – Expands RRULE recurrences (DAILY, WEEKLY, MONTHLY, YEARLY) including BYDAY, BYMONTHDAY, INTERVAL, COUNT, UNTIL, and EXDATE.</li>
<li><strong>DURATION Support</strong> – Derives the end time from a <code>DURATION</code> property when <code>DTEND</code> is absent.</li>
<li><strong>Basic Authentication</strong> – Supply a username and password per feed for protected calendars.</li>
<li><strong>Encrypted Credentials</strong> – Passwords are stored using AES-256-CBC encryption in the database.</li>
<li><strong>Caching</strong> – Configurable cache lifetime reduces external HTTP requests (defaults to 1 hour).</li>
<li><strong>Cache Management</strong> – View the number of currently cached feed entries and clear them with one click from the admin settings page.</li>
<li><strong>Async Loading</strong> – Calendar events are fetched via AJAX so the containing page renders immediately.</li>
<li><strong>Label / Category Filtering</strong> – Filter events by iCal <code>CATEGORIES</code> labels using the <code>label</code> shortcode attribute.<br />
Accepts a comma-separated list; <strong>all</strong> plain labels must be present on an event for it to be shown.<br />
Prefix a label with <code>!</code> to exclude events that carry that category. Matching is case-insensitive.</li>
<li><strong>Clickable Events</strong> – Events that carry a <code>URL</code> property in the iCal feed are rendered as clickable links.</li>
<li><strong>7-Day Rolling Window</strong> – Automatically fetches and displays only the next 7 days of events.</li>
<li><strong>Responsive Event List</strong> – Clean event list layout that adapts to all screen sizes.</li>
<li><strong>Event Tooltips</strong> – Hover over an event to see its description.</li>
<li><strong>Description Prefix Filtering</strong> – Remove lines from event descriptions that start with configurable prefixes. Useful for hiding internal metadata added by calendar applications.</li>
</ul>
<h3>Configuration</h3>
<p>Navigate to <strong>Settings <span aria-hidden="true" class="wp-exclude-emoji">→</span> CalDav Calendar Viewer</strong> in the WordPress admin panel.</p>
<h4>Adding a Feed</h4>
<p>Click <strong>+ Add Feed</strong> and fill in:</p>
<ul>
<li><strong>Feed ID</strong> – A unique lowercase identifier (letters, numbers, hyphens, underscores) used in the shortcode.</li>
<li><strong>iCal Feed URL</strong> – The full URL to the <code>.ics</code> calendar feed.</li>
<li><strong>Username</strong> – Username for Basic Authentication. Leave blank for public feeds.</li>
<li><strong>Password</strong> – Password for Basic Authentication. Stored encrypted. Leave blank to keep the current value.</li>
</ul>
<p>You can configure multiple feeds — each gets its own ID.</p>
<h4>General Settings</h4>
<ul>
<li><strong>Cache Lifetime (seconds)</strong> – How long fetched calendar data is cached. Set to <code>0</code> to disable caching. Default: <code>3600</code> (1 hour).</li>
<li><strong>Description Line Prefixes to Remove</strong> – Newline-separated list of prefixes. Any line in an event’s description that starts with one of these prefixes is removed from the tooltip. Useful for hiding internal metadata added by calendar apps (e.g. <code>X-APPLE-</code>, <code>Reminder:</code>).</li>
</ul>
<h4>Cache Management</h4>
<p>The settings page shows how many calendar feeds are currently cached. Use the <strong>Clear Cache</strong> button to delete all cached responses and force fresh fetches on the next page load.</p>
<h3>Usage</h3>
<h4>Basic Shortcode</h4>
<pre><code>[caldcavi_calendar id="my-feed"]
</code></pre>
<h4>Shortcode Attributes</h4>
<ul>
<li><code>id</code> (required) – The feed ID configured in <strong>Settings <span aria-hidden="true" class="wp-exclude-emoji">→</span> CalDav Calendar Viewer</strong>.</li>
<li><code>label</code> (optional) – A comma-separated list of iCal <code>CATEGORIES</code> values to filter events by. <strong>All</strong> plain labels<br />
must be present on an event for it to be shown. Prefix a label with <code>!</code> to exclude events that carry that category.<br />
Matching is case-insensitive. Omit to show all events.</li>
</ul>
<h4>Examples</h4>
<pre><code>[caldcavi_calendar id="team-calendar"]

[caldcavi_calendar id="hr-events"]

[caldcavi_calendar id="team-calendar" label="Work"]

[caldcavi_calendar id="team-calendar" label="Work,Important"]

[caldcavi_calendar id="team-calendar" label="Work,!Cancelled"]

[caldcavi_calendar id="team-calendar" label="!Private"]
</code></pre>


CalDav Calendar Viewer

Displays events from iCal (.ics) feeds in a responsive list. Supports recurring events, multiple feeds with Basic Auth and encrypted credentials.

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>


Open Source Event Calendar

An event calendar with native iCal / ICS import and export

CalDav Calendar Viewer vs Open Source Event Calendar