About this plugin
A Gutenberg block for calendar integration. The block displays a button with a calendar integration with support for Google Calendar, Outlook, Yahoo Calendar, and ICS downloads. With a clean, professional dropdown interface, visitors can add events to their preferred calendar application.
Key Features:
- Multiple Calendar Providers: Google Calendar, Outlook, Yahoo Calendar, and ICS download
- Modern UI: Clean dropdown with Font Awesome icons and smooth animations
- Server-side Rendering: SEO-friendly with proper WordPress block architecture
- Automatic URL Inclusion: Event descriptions automatically include the page URL for reference
- Responsive Design: Works beautifully on desktop and mobile devices
- Multilingual Support: Available in English, Polish, German, Spanish, and French
- Fair Pricing Model: No premium tiers or hidden features – everything is included
Supported Calendar Providers:
- 🌐 Google Calendar – Opens directly in Google Calendar
- 🏢 Microsoft Outlook – Compatible with Outlook.com and Office 365
- 🟣 Yahoo Calendar – Direct integration with Yahoo Calendar
- 💾 ICS Download – Universal calendar file for any calendar application
Perfect For:
- Event organizers and venues
- Businesses hosting webinars or meetings
- Content creators with scheduled events
- Anyone wanting to make it easy for visitors to save events
The plugin uses server-side rendering for better performance and SEO, while providing a smooth user experience with JavaScript enhancements.
Development
- GitHub Repository: https://github.com/marcin-wosinek/fair-event-plugins
- Report Issues: https://github.com/marcin-wosinek/fair-event-plugins/issues
- Contribute: https://github.com/marcin-wosinek/fair-event-plugins/pulls
1.6.0
Minor Changes
- 68ef130: Each plugin now ships documentation of its blocks in block-docs/, matched
json lists every block the plugin supplies, with its
json, status, and when it is registered, and each block
has a usage guide and serialized examples that open in the editor without
validation errors. Site tooling and AI assistants can read these files from
the installed plugin and compare them with the blocks a site reports through
WordPress’s authenticated /wp/v2/block-types endpoint.
Patch Changes
- 61e9b4d: Fix “Keep in sync with event data” for buttons on Fair Events event posts. Synchronized buttons now read the event’s current dates, all-day setting, and location from Fair Events (venue name and address, or the event’s own address) in the editor and on every page view, so event changes show without saving the post again. When the event has no usable dates or Fair Events is inactive, the editor explains why and the button offers no calendar entry instead of stale values; turning off syncing unlocks the fields with the latest values. Manually configured and standalone buttons are unchanged.
- 8dbeeed: Export events to calendars only when they are all-day or have both a start and an end time. The ICS feed leaves out dates with a missing time, and the calendar button offers no entry for them instead of guessing a time. On a recurring event that mixes both, the button adds the next date that has both times, without the series rule. The event dates and public events APIs report calendar_export_eligible, and the public events feed now includes start_date, end_date, start_time and end_time.
- Updated dependencies [f32a184]
- Updated dependencies [21cf6c7]
- Updated dependencies [79f6ea4]
- Updated dependencies [d6adc05]
- Updated dependencies [f95eda6]
- Updated dependencies [157e1ea]
- Updated dependencies [b05c7e3]
1.5.5
Patch Changes
-
6 and Recharts
1. Calendar exports and the statistics and comparison
charts show the same dates, values and tooltips as before.
The Fair Events calendar button now passes all-day events to the calendar
as plain dates, so they stay on their day in every timezone. Without this,
the updated library would have moved them one day later for visitors in
UTC+12 timezones, such as New Zealand in winter or Fiji.
1.5.4
Patch Changes
- 0c94b22: Calculate Calendar Button repeat dates the same way Fair Events does. An event that repeats until a chosen date now includes the occurrence that falls on that date, even when it starts later in the day, and the editor’s occurrence calendar marks the right end day in timezones behind UTC. Existing blocks keep their saved repeat rule until the repeat settings are edited.
1.5.3
Patch Changes
- a439c54: Restore the standalone Fair Calendar Button plugin build so its wp.org listing can keep shipping, versioned independently starting from 1.5.2.
1.5.2
Patch Changes
- 7e7ea9c: Update version tested up to version to 6.9.
1.5.1
Patch Changes
- 4ed3721: Add location to fair-events
1.5.0
Minor Changes
- 13fb665: Integrate button with Fair Events content type
1.4.0
Minor Changes
- f901aa2: Add support to Plausible integration
1.3.2
Patch Changes
- 84fe629: Set correctly supported version
1.3.1
Patch Changes
- Add missing translation
1.3.0
Minor Changes
- Add translations to PL, DE, ES and FR
1.2.0
Minor Changes
- Fix multiple UX issues in block
1.1.1
Patch Changes
- Update dependencies to the newest version
1.1.0
Minor Changes
- 99a2038: Change format of recurrence description in block attributes.
All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog,
and this project adheres to Semantic Versioning.
[1.0.0] – 2025-01-30
Added
- Initial release of Fair Calendar Button
- Gutenberg block for calendar event integration
- Support for multiple calendar providers:
- Google Calendar
- Microsoft Outlook
- Yahoo Calendar
- ICS file download
- Modern dropdown UI with Font Awesome SVG icons
- Server-side rendering for better SEO performance
- Automatic URL inclusion in event descriptions
- Responsive design for all device sizes
- WordPress 5.8+ compatibility
- PHP 8.0+ requirement
Features
- Clean, professional dropdown interface
- Brand-specific hover effects for each calendar provider
- Smooth animations and transitions
- Uses WordPress core button block for maximum theme compatibility
- No external API dependencies
- GDPR compliant (no data collection)
Technical
- Built with modern WordPress block development practices
- Uses block.json for block registration
- Font Awesome SVG icons (tree-shaken for performance)
- ES6+ JavaScript with webpack compilation
- Follows WordPress PHP and JavaScript coding standards
- Server-side rendering with render.php
- Namespace isolation to prevent conflicts
Developer Notes
This plugin is built with modern WordPress development practices:
- Uses WordPress’s block.json for block registration
- Server-side rendering with render.php
- Font Awesome SVG icons (not CSS) for better performance
- ES6+ JavaScript with webpack compilation
- Follows WordPress PHP and JavaScript coding standards
com/marcin-wosinek/fair-event-plugins