rsmith4321

<p><strong>ShootCal Web Calendar is the companion plugin for the ShootCal scheduling app for Mac and iOS.</strong> Publish your availability – or a full calendar – on your website straight from the calendar you already keep in ShootCal, which hides your personal events, builds each day’s availability from your session types, and auto-detects your timezone. It also works with <strong>any</strong> iCal (.ics) feed – Google Calendar, Apple, or Outlook – so you can use it with or without ShootCal.</p>
<p>Add it to any WordPress page or post in one of two modes. <strong>Availability</strong> mode shows which days are <strong>available</strong>, <strong>limited</strong>, or <strong>booked</strong> without ever exposing your event titles, locations, attendees, or descriptions. <strong>Full calendar</strong> mode shows each event’s title and time on the grid – handy for a public schedule like sunrise/sunset times, office hours, or class times.</p>
<p>Built for photographers and other service providers who want to show clients when they can book, without manually updating a calendar on their website every week.</p>
<h4>How it works</h4>
<p>Each calendar’s feed URL lives on the embed itself – the block’s <strong>Calendar feed URL</strong> field, or the shortcode’s <code>url</code> attribute – so different pages can show different calendars. In WP admin, <strong>Settings > ShootCal Web Calendar</strong> has a shortcode generator: paste a feed URL, pick a mode, and it checks the feed and hands you a ready-to-paste shortcode. Block users just add the “ShootCal Web Calendar” block and paste the URL in its sidebar.</p>
<p>Any iCal feed works:</p>
<ul>
<li><strong>Google Calendar</strong> – open your calendar’s settings, scroll to <strong>Integrate calendar</strong>, and copy the <strong>Secret address in iCal format</strong>.</li>
<li><strong>Apple, Outlook, or other iCal feeds</strong> – paste the feed’s iCal URL.</li>
<li><strong>ShootCal app</strong> (for ShootCal users) – open the Mac app, go to Settings > Website > Connect to your website, and click Copy URL. A ShootCal feed additionally hides your personal events, builds each day’s availability from your session types, and auto-detects your timezone and how many months to show.</li>
</ul>
<p>The plugin fetches the feed server-side, caches it for 10 minutes, and renders a clean month grid. In availability mode it keeps only busy start/end times and discards all event detail; in full calendar mode it shows the event titles and times.</p>
<h4>Privacy</h4>
<p>The plugin only reads the iCal feed server-side. The cached data lives in your WordPress site’s object cache or database (transient) and is purged when you clear the cache or change settings.</p>
<p>The feed URL lives in the shortcode or block where you use it – treat it like a password. Note that <strong>full calendar</strong> mode intentionally displays event titles and times, so only point it at a feed whose contents are meant to be public.</p>
<h4>Features</h4>
<ul>
<li>Two display modes: availability (free/busy shading, no detail) or full calendar (event titles + times)</li>
<li>Per-embed feed URL (shortcode <code>url</code> or block field) plus a built-in shortcode generator – show different calendars on different pages</li>
<li>Works with any iCal feed: Google Calendar, Apple, Outlook, or a ShootCal app feed</li>
<li>Month grid showing up to 36 months ahead, with previous / today / next navigation and keyboard arrows</li>
<li>Available / Limited / Booked status per day, with booked time windows shown on Limited days and a color legend</li>
<li>Tap-to-expand booking times, plus a tap indicator on phones</li>
<li>Per-embed Limited / Booked day colors (availability mode) and Sunday or Monday week start (the display timezone follows your WordPress site setting)</li>
<li>Optional “Page caching” mode that loads the calendar via JavaScript so it stays fresh behind Varnish or page-cache plugins</li>
<li>Privacy-first, accessible markup (ARIA grid, keyboard nav, AA contrast), and assets that load only on pages that use the calendar</li>
</ul>
<h3>Shortcode attributes</h3>
<ul>
<li><code>url</code> – the iCal (.ics) feed URL to display (required).</li>
<li><code>mode</code> – “availability” (free/busy shading, default) or “full” (show event titles + times).</li>
<li><code>multi_session_day</code> – availability mode only. “1” (default): a day with only timed sessions shows as “Limited”. “0”: any event marks the whole day “Booked”.</li>
<li><code>limited_color</code> – availability mode only. Hex color (e.g. #fce3a8) for the “Limited” day shading. Default: the built-in soft gold.</li>
<li><code>booked_color</code> – availability mode only. Hex color (e.g. #f6b9a3) for the “Booked” day shading. Default: the built-in soft coral.</li>
<li><code>months</code> – how many months to display (1-36). Default: setting value (auto-detected for ShootCal feeds).</li>
<li><code>first_day</code> – “0” for Sunday, “1” for Monday. Default: setting value.</li>
<li><code>timezone</code> – IANA timezone override for this embed. Default: your WordPress site timezone (or, for a ShootCal feed, the feed’s own).</li>
</ul>
<p>Example: <code>[shootcal_web_calendar mode="full" url="https://example.com/feed.ics" months="3"]</code></p>
<p>Tip: build a shortcode under Settings > ShootCal Web Calendar – paste a feed URL, pick a mode, and it validates the feed and outputs the shortcode for you.</p>
<h3>External Services</h3>
<p>This plugin reads a calendar from the iCal feed URL(s) you put in your shortcodes or blocks. Each request is made from your web server (not your visitor’s browser) whenever a month grid is rendered and the 10 minute cache has expired. The plugin only ever contacts the URLs you configure; with none set, it makes no external requests. Only the request itself is sent – no data from your site or your visitors is transmitted. In availability mode the plugin keeps only busy start/end times, discarding titles, locations, attendees, and descriptions; in full calendar mode it also keeps event titles and times (by design, to display them).</p>
<p>The service contacted depends on the URL you use:</p>
<p><strong>Google Calendar</strong></p>
<p>If you use a Google Calendar secret iCal address, the request goes to Google’s calendar servers (calendar.google.com). This service is provided by Google. See Google’s Terms of Service (https://policies.google.com/terms) and Privacy Policy (https://policies.google.com/privacy).</p>
<p><strong>ShootCal</strong></p>
<p>If you use a ShootCal feed URL from the ShootCal Mac app, the request goes to the ShootCal feed service (feed.shootcal.com). This service is provided by Ryan Smith Photography. See the terms and privacy information at https://shootcal.com.</p>
<p><strong>Other iCal feeds</strong></p>
<p>If you use any other iCal URL (for example from Apple or Outlook), the request goes to whichever service hosts that feed. Refer to that provider’s own terms and privacy policy.</p>


ShootCal Web Calendar

Companion plugin for the ShootCal app (Mac and iOS): show your availability or a full calendar on your WordPress site. Works with any iCal feed.

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

ShootCal Web Calendar vs Open Source Event Calendar