bramwaas

<p>Simple block or widget to display events from a public google calendar, microsoft office outlook calendar or an other iCal file, in the style of your website.</p>
<p>The Gutenberg block requires at least WordPress 5.9.<br />
This simple block/widget fetches events from a public google calendar (or other calendar in iCal format) and displays them in simple list allowing you to fully adapt to your website by applying all kinds of CSS.<br />
Google offers some HTML snippets to embed your public Google Calendar into your website.<br />
These are great, but as soon as you want to make a few adjustments to the styling, that goes beyond changing some colors, they’re not enough.</p>
<h3>Plugin Features</h3>
<ul>
<li>Calendar block or widget to display appointments/events of a public Google calendar or other iCal file.</li>
<li>Block gives live preview in the editor and is not constrained to widget area. Old widget will be displayed in legacy widget block only in widget area. Old widget works also with Elementor (with some limitations e.g. preview in backend editor is not always available).</li>
<li>Small footprint, uses only Google ID of the calendar, or ICS link for Outlook, or Url of iCal file, to get event information via iCal</li>
<li>Merge more calendars into one block</li>
<li>Manage events in Google Calendar, or other iCalendar source.</li>
<li>Fully adaptable to your website with CSS. Output in unordered list with Bootstrap 4 listgroup classes and toggle for details.</li>
<li>Choose date / time format in settings screen that best suits your website.</li>
<li>Displays per event DTSTART, DTEND, SUMMARY, LOCATION and DESCRIPTION. DTSTART is required other components are optional. </li>
<li>Displays most common repeating events. Frequency Yearly, Monthly, Weekly, Dayly (not Hourly, Minutely and smaller periods)</li>
<li>Basic support for filter on Categories Warning: MS Outlook does not share categories via iCal now. Google and iCloud calendar don’t support categories at all. So this will not work with these calendars.    </li>
<li>In the screenshot below: Left the block with default settings and clicked on one summary. Right with some adjusted settings.<br />
Adjusted settings for start with summary:<br />
Lay-out: Start with summary.<br />
Date format first line: “.<\b\r>l jS \o\f  F”<br />
Enddate format first line: ” – l jS \o\f F”<br />
Time format time summary line: ” G:i”<br />
Time format end time summary line: ” – G:i”<br />
Time format start time: “”<br />
Time format end time: “”<br />
Tag for summary: “strong”</li>
</ul>
<h3>Documentation</h3>
<ul>
<li>Gets calendar events via iCal url or google calendar ID</li>
<li>Merge more calendars into one block</li>
<li>Displays maximum the selected number of events as listgroup-items     </li>
<li>Displays only events in a selected period with a length of the setting “Number of days after today with events” from now limited by the time of the day or the beginning of the day at the start and the and of the at the end.</li>
<li>Displays events in timezone of WordPress setting, or in Clients timezone with javascript REST call fetched from the clients browser.</li>
<li>Displays event start-date and summary; toggle details, description, start-, end-time, location. </li>
<li>Displays most common repeating events </li>
<li>Frequency Yearly, Monthly, Weekly, Dayly (not parsed Hourly, Minutely …), INTERVAL (default 1), WKST (default MO)</li>
<li>End of repeating by COUNT or UNTIL</li>
<li>By day month, monthday or setpos (BYDAY, BYMONTH, BYMONTHDAY, BYSETPOS) no other by…<br />
(not parsed: BYWEEKNO, BYYEARDAY, BYHOUR, BYMINUTE, RDATE)</li>
<li>Exclude events on EXDATE from recurrence set (after evaluating BYSETPOS)</li>
<li>Respects Timezone and Day Light Saving time. Build and tested with Iana timezones as used in php, Google, and Apple now also tested with Microsoft timezones and unknown timezones. For unknown timezone-names using the default timezone of WordPress (probably the local timezone). </li>
</ul>
<p>(This widget is a Fork of version 0.7 of that simple google calendar widget by NBoehr<br />
https://nl.wordpress.org/plugins/simple-google-calendar-widget/)</p>
<h3>Copyright and License</h3>
<p>This project is licensed under the <a href="http://www.gnu.org/licenses/old-licenses/gpl-2.0.html" rel="nofollow ugc">GNU GPL</a>, version 2 or later.<br />
2017 – 2023 © <a href="http://www.waasdorpsoekhan.nl" rel="nofollow ugc">Bram Waasdorp</a>.</p>


Simple Google Calendar Outlook Events Widget

Block widget that displays events from a public google calendar or iCal file.

digitaldonkey

Lukas Pawlik

Borislav Angelov

farmer paul

Justas Butkus

hubrik

Nicola Peluchetti

Yani

<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

Simple Google Calendar Outlook Events Widget vs Open Source Event Calendar