內容簡介
Fair Calendar Button 是一款專為 Gutenberg 設計的外掛，提供日曆整合功能，支援 Google Calendar、Outlook、Yahoo Calendar 及 ICS 下載。透過簡潔的下拉介面，訪客可以輕鬆將活動新增至他們偏好的日曆應用程式。
【主要功能】
• 支援多種日曆提供者：Google Calendar、Outlook、Yahoo Calendar、ICS 下載
• 現代化介面：乾淨的下拉選單與流暢動畫
• 伺服器端渲染：符合 SEO 的 WordPress 區塊架構
• 自動包含網址：活動描述自動包含頁面 URL
• 響應式設計：在桌面和行動裝置上均可完美運作
• 多語言支援：支援英文、波蘭文、德文、西班牙文和法文
外掛標籤
開發者團隊
原文外掛簡介
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
to the release: index.json lists every block the plugin supplies, with its
owning plugin, block.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
9603b8d: Update the bundled calendar-link library from 2.11.4 to 2.11.6 and Recharts
from 3.10.0 to 3.10.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
The plugin is open source and contributions are welcome on GitHub: https://github.com/marcin-wosinek/fair-event-plugins
