=== Event Koi Lite - Events Calendar, Event Tickets, RSVP & Registration ===
Contributors: eventkoi, lesleysim, ahmedfouaddev
Donate link: https://donate.stripe.com/fZubJ1auN86Y1PU8cSdUY01
Tags: event calendar, event management, event tickets, event registration, rsvp
Requires at least: 6.7
Tested up to: 7.1
Requires PHP: 8.0
Stable tag: 1.4.9.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

WordPress events calendar plugin. Take RSVPs and registrations, sell event tickets with WooCommerce, run virtual events. Works with Elementor.

== Description ==

**EventKoi Lite is a fast, modern events calendar plugin for WordPress.** Show your events in a calendar or list, take RSVPs and event registrations, sell event tickets with WooCommerce, and manage your attendees, all from a clean admin that does not bloat your site.

Use it for workshops, classes, webinars, meetups, fundraisers, community events, club and church calendars, or any in-person or virtual event you run on your WordPress site.

https://youtu.be/7D2M6G9-q9w

✓ **Events calendar and event list** - Month, week and list views, added with a block, shortcode, Elementor, Beaver Builder or Divi
✓ **Event registration and RSVP** - Set capacity, collect sign-ups, send confirmation emails with check-in codes and reminder emails
✓ **Sell event tickets with WooCommerce** - Multiple ticket types, free or paid, using any WooCommerce payment gateway including Stripe and PayPal
✓ **Attendee management** - Check people in, add attendees by hand and export your attendee list to CSV
✓ **In-person and virtual events** - Google Maps venues, per-event timezones, and visitor timezone detection for international audiences
✓ **Add to Google Calendar, iCal and Outlook** - One click for visitors to save your event to their own calendar
✓ **Event SEO** - Automatic JSON-LD event structured data, plus event date variables for Rank Math and Yoast titles and descriptions
✓ **Import events** - Move over from The Events Calendar, or import any .ics file from Google Calendar, Apple Calendar or Outlook
✓ **Accessible and responsive** - Keyboard navigation, ARIA labels and a mobile-friendly events calendar
✓ Secure code that follows WordPress coding standards, with active development and responsive support

**Need recurring events, unlimited calendars or custom fields? [Upgrade to EventKoi Pro](https://eventkoi.com/pricing?utm_source=wordpress-org&utm_medium=listing&utm_campaign=readme-pro)**


## WordPress events calendar and event list

- Embed an events calendar with a block, shortcode, Elementor widget, Beaver Builder module or Divi module (Divi 4 and Divi 5)
- Show events as a month calendar, week calendar, list or grid, and choose which views visitors can switch between
- Filter and search events by date range or calendar
- Query loop block for building your own event listings, with ready-made Elementor templates for event, series and calendar pages
- Set the starting day of the week and choose 12 or 24-hour time
- Customize event page templates in the block editor
- Works with block themes and classic themes
- Upgrade to Pro for multiple calendars to segment events by category, location or type


## Event registration and RSVP

- Set event capacity and show remaining spots to encourage sign-ups
- Let attendees register and update their RSVP
- Send automated confirmation emails with check-in codes
- Send attendees a reminder email the day before the event
- Manage registrations and check-ins from your WordPress admin
- Export your full attendee list


## Sell event tickets with WooCommerce

- Take payments with any WooCommerce gateway (Stripe, PayPal and more) directly on your own site
- Create multiple ticket types per event, such as General Admission, VIP or Early Bird
- Set price, capacity and availability for each ticket type, with free and paid tickets on the same event
- Open and close ticket sales on set dates, and cap the number of tickets per order
- Show or hide remaining ticket quantities
- Add terms and conditions per ticket type
- Require buyers to have an account, or create one automatically at checkout
- Automated ticket confirmation and refund emails
- Track tickets sold and total earnings with built-in reporting


## In-person and virtual events

- Add multiple event days, each with its own start and end time
- Combine in-person and virtual locations in one event
- Embed a Google Maps venue map
- Show times in the visitor's timezone, or set a fixed timezone per event
- Uses your WordPress date, time and timezone settings
- Localization-ready


## Calendar sync, sharing and event SEO

- Let visitors add events to Google Calendar, iCalendar, Outlook 365 or Outlook Live
- Share events on social media and by email
- Automatic JSON-LD structured data on every event page, so your events can appear as rich results in Google Search
- Event date, time, location and timezone variables for Rank Math and Yoast SEO titles and descriptions


## Page builder and block editor support

- **Block editor:** Calendar, event query loop and event data blocks
- **Shortcodes:** Build shortcodes with multiple queries to show a calendar or list of events
- **Elementor:** Native calendar and event widgets, plus ready-made templates
- **Beaver Builder:** Native calendar and event modules
- **Divi:** Native Divi 5 modules, with conversion of the Divi 4 modules
- **Other plugins:** Fields from ACF, Pods and Meta Box show up in the event editor


## Switching from The Events Calendar

- Import your events in minutes with the built-in migration tool
- Titles, descriptions, dates, times and timezones
- All-day and multi-day events
- Venues, organizers, categories and featured images
- Recurrence rules, converted to EventKoi's recurring event format
- Duplicate detection, so you can safely run the importer again


## Get more with EventKoi Pro

- **Recurring events:** Daily, weekly, monthly and yearly rules, editable individual instances and an automatic series page
- **Custom fields:** Add custom fields and field groups to any event
- **Multiple event calendars:** Lite includes one calendar. Pro unlocks unlimited calendars for event types, departments, locations or audiences
- **Advanced Elementor and Beaver Builder features:** Custom templates and loop features for queryable event lists
- **Priority support**
- **30-day money-back guarantee**

**[Get EventKoi Pro](https://eventkoi.com/pricing?utm_source=wordpress-org&utm_medium=listing&utm_campaign=readme-pro-list)**


## Helpful links

- [EventKoi documentation](https://eventkoi.com/docs/?utm_source=pluginreadme-helpfullink&utm_medium=web&utm_campaign=16-12-25)
- [EventKoi blog](https://eventkoi.com/blog/?utm_source=pluginreadme-helpfullink&utm_medium=web&utm_campaign=16-12-25)
- [Support forum](https://wordpress.org/support/plugin/eventkoi-lite/) (please check existing threads before starting a new one)
- [Contact us](https://eventkoi.com/contact/?utm_source=pluginreadme-helpfullink&utm_medium=web&utm_campaign=16-12-25) (for non-support questions)

## Screenshots

1. Events calendar view
2. Visitors can add an event to their own calendar
3. Visitors can share events by social media and email
4. Events calendar with timezone detection, timezone switcher and 12/24 hour clock
5. Events list view
6. Event management in WP Admin
7. Create event settings

== Installation ==

Installing EventKoi Lite is easy.

= Installation =

1. In your WP Admin, select Plugins, then Add plugin.
2. In the Search Plugins field, type in "EventKoi Lite"
3. When you find EventKoi Lite, click on Install Now.
4. The installation will run, then click on Activate.

= Configuring your events calendar =

1. Once the plugin is activated, head to Events, then Settings.
2. From there you can configure when you week starts, your working days, and 12/24-hour clock.

= Create your first event =

1. Head to Events > Events and select Add event
2. Fill out the form to create your event.

= Add your calendar to your site =

Head to Events > Calendar and select **Default calendar**. Then select the **Embed** tab.
There, you will see 3 ways to embed the calendar into your site:

1. Your calendar comes with a default link. Out of the box, the link is: https://yourwebsite.com/calendar/default-calendar/
2. Using either shortcodes in any page or post: [eventkoi_calendar display=calendar] or [eventkoi_calendar display=list] depending on whether you want a calendar or list view.
3. Adding a block in any page or post: Type in "/eventkoi" and then select either "EventKoi Calendar" or "EventKoi List" depending on whether you want a list or calendar view.

== Frequently Asked Questions ==

= What is the best way to add an events calendar to WordPress? =
Install EventKoi Lite, create your events, then add the EventKoi Calendar block or the [eventkoi_calendar] shortcode to any page. You can also use the Elementor widget, Beaver Builder module or Divi module.

= Does it work with block themes and classic themes? =
Yes. EventKoi Lite works with both block and classic themes. Use the blocks or shortcodes to build your events calendar.

= Can I show a responsive events calendar on mobile? =
Yes. The events calendar is fully responsive and mobile-friendly, with keyboard navigation and ARIA labels.

= Can I sell event tickets on my own WordPress site? =
Yes. EventKoi Lite includes event ticketing powered by WooCommerce. Create multiple ticket types per event with their own price and capacity, and accept payments through any WooCommerce gateway, including Stripe and PayPal. Buyers get a confirmation email with a check-in code.

= Does EventKoi charge a fee per ticket? =
EventKoi Lite does not take a cut of your ticket sales. Your payment gateway's normal processing fees still apply.

= Can I create free and paid ticket types for the same event? =
Yes. Set a ticket price to 0 for free tickets or any amount for paid tickets, and mix both on one event.

= Does EventKoi Lite support event registration and RSVP? =
Yes. Set capacity, collect attendee sign-ups, send confirmation emails with check-in codes, and manage check-ins from your WordPress admin.

= Does EventKoi Lite work with Stripe and PayPal for ticket sales? =
Yes. EventKoi uses WooCommerce's standard checkout, so any WooCommerce payment gateway works, including Stripe and PayPal.

= Does EventKoi Lite include recurring events? =
Recurring events are available in EventKoi Pro. Pro supports daily, weekly, monthly and yearly recurring events with advanced rules.

= I'm using The Events Calendar. Can I migrate my events to EventKoi? =
Yes. The built-in migration tool imports your events from The Events Calendar, including dates, venues, categories, recurrence rules and featured images. Already-migrated events are skipped, so you can run it more than once safely.

= Can I import events from Google Calendar, Apple Calendar or Outlook? =
Yes. Export your calendar as an .ics file and import it from the Import tab in the EventKoi settings.

= Does EventKoi Lite support virtual events and timezones? =
Yes. You can create virtual events, and the calendar detects each visitor's timezone so they see events in their local time. You can also set a fixed timezone for an individual event.

= Does it work with Elementor, Beaver Builder and Divi? =
Yes. EventKoi Lite includes native Elementor widgets and templates, Beaver Builder modules and Divi 5 modules.

= My calendar or event page shows "Page not found." =
Go to Settings > Permalinks and click Save Changes to refresh rewrite rules.

= Can I customize the event template? =
Yes. On a block theme, go to Appearance > Editor > Templates and customize the Event template. On a classic theme, you can edit the template files.

= Does EventKoi Lite help my events appear in Google Search? =
Yes. It adds JSON-LD structured data to every event page so Google can understand your events and show them as rich results. No setup needed.


== External services ==

This plugin can connect to the **Google Maps JavaScript API** in order to display interactive maps inside event and calendar views.
It sends your configured Google Maps API key (if provided) along with requests made by the visitor's browser when viewing a page that contains an embedded map. No personal data is sent by the plugin itself, but Google may collect usage data in accordance with their policies. This connection only happens if maps are enabled in the plugin settings and a page with an event location map is viewed.
This service is provided by Google LLC: [Terms of Service](https://cloud.google.com/maps-platform/terms), [Privacy Policy](https://policies.google.com/privacy).

== Changelog ==

The latest releases are listed here. See changelog.txt in the plugin folder for older versions.

= 1.4.9.1 – Event Data word limit and week view default month – 2026-10-25 =
* New: The Event Data block has a Max number of words setting for the Description field, like the core Excerpt block. Leave it at 0 to keep showing the summary as before.
* Fix: Calendars set to the Week view now open on the default month and year from the calendar settings instead of always on the current week.

= 1.4.9.0 – Ticket modal links, Event Data block styling and export fields – 2026-10-24 =
* New: Any button or link can open the ticket modal. Link it to #buy-tickets inside an event query loop to open that row's event, or to #buy-tickets-123 with the event ID anywhere on the site, even on pages without a ticket box.
* New: The Event Data block has border, radius and link colour controls in the block Styles panel.
* Improvement: Event query loop rows carry the same classes as the core loop (post-ID, type, status and term classes) plus the event ID, so a single event can be styled with CSS.
* Improvement: The Ticket sales export includes custom checkout fields as extra columns, and free orders now appear in the Ticket sales list and exports.
* Fix: The date and location icons in the single event template sit centred on their first line, matching the editor, and no longer pick up duplicated attributes.
* Fix: Buying a ticket without JavaScript now shows a success, pending or error message above the checkout form, and the form keeps its styling on sites where an SEO plugin renders the content early.

= 1.4.8.1 – Event URL binding, editor title preview and ampersand fixes – 2026-10-21 =
* Fix: Event titles with ampersands or quotes show as typed in the ticket sales screens, order details, email subjects and admin notifications instead of HTML codes.
* Fix: The event URL is available as a block attribute, so a Button inside the event query loop can link to each event, and attribute bindings inside the loop read the event in each row rather than the page.
* Fix: The Event Data title block shows the same link in the editor as on the site, so colours match while you design.

= 1.4.8.0 – Divi 5 modules, event reminder emails and calendar page fixes – 2026-10-19 =
* New: Native Divi 5 modules for the calendar and single events, with live previews in the builder, conversion of the Divi 4 modules and dynamic content for event data.
* New: Attendees can get a reminder email the day before their event, with its own template under Settings > Emails. Reminders are off until you switch them on.
* Improvement: Calendars in a narrow column use one-letter day headers so weekday names no longer run together on phones.
* Fix: Forms, buttons and icons in the theme header and footer are kept intact on calendar pages. Form plugins such as WPForms no longer lose their fields there.

= 1.4.7.0 – Elementor templates, series page fixes and WooCommerce emails – 2026-10-15 =
* New: Ready-made Elementor templates for event pages, series pages and calendar pages. Pick them under Settings > Single event pages, and a new onboarding step offers them when Elementor is active.
* New: Template pickers in Settings list block, Elementor, Beaver Builder and Bricks templates with an edit link for each, and a site-wide template now applies to every event page that has no template of its own.
* Improvement: The series page title is an H1, and the back to series link on event pages is a movable block in the template.
* Fix: EventKoi no longer switches off WooCommerce order emails for ticket orders. Store owners keep control of every email in WooCommerce settings.
* Fix: Images inside the Event Query Loop keep the aspect ratio, size and scale set in the editor.
* Fix: Recurrence rules on the event page are listed by date instead of the order they were added.
* Fix: Child terms are indented again in the taxonomy dropdown of the event editor.
* Fix: The block editor no longer writes empty event attribute rows to the database on every save, and old empty rows are cleaned up in the background.
* Fix: Events without a location no longer render an empty map frame.

= 1.4.6.1 – Taxonomy attributes in the block editor – 2026-10-06 =
* Fix: Event taxonomies were missing from the Attributes list in the block editor, so a block could not be connected to the taxonomy terms of an event. They are now listed and show the terms of the event.
* Fix: A taxonomy whose slug contains the word event could print nothing when used as an event attribute.

= 1.4.6.0 – Elementor calendar colours, attendee emails and calendar fixes – 2026-09-29 =
* New: Colour pickers on the Elementor calendar widget, which now starts on a white background instead of inheriting grey page colours. Elementor global colours are honoured.
* New: When adding an attendee by hand, tick a box to email them the ticket confirmation with their check-in code.
* New: A Series dates data row for page builders, and the Elementor editor previews the Event widget with a real event.
* Improvement: Event Data rows in the Elementor Event widget can carry a label, so templates read like the block templates.
* Improvement: The Text colour on the Elementor calendar widget now reaches the day headings, day numbers, event titles and search box.
* Improvement: Calendar page headings use plain markup, and builder buttons inside the calendar keep their own styling.
* Fix: Calendar search stayed disabled in months without events, and a search in list view said nothing was found while the list showed the matches. Search now works in any month and shows a searching state until the results arrive.
* Fix: The month dropdown label could take the button text colour from Beaver Builder global styles and turn white on white.
* Fix: In narrow columns the toolbar could cover the month picker and the Today button. It now wraps onto extra lines.
* Fix: Switching from the month grid to list view kept the list on a stale month, and the new month is queried on the first render after a toolbar click.
* Fix: A multi-select field could lock up the page when its selection was passed straight back to it.
* Fix: The ticket form and map inside the Elementor Event widget were stripped by output filtering and could not render.
* Fix: A Stripe webhook saved by an earlier version could come back unreadable and log warnings. It is now read safely.

= 1.4.5.1 – Calendar settings clarity – 2026-09-21 =
* Improvement: The Calendar & week settings now explain that they apply globally and can also be adjusted per calendar, and the divider lines between settings sections were removed for a cleaner layout.

== Upgrade Notice ==

= 1.4.9.1 =
Adds a max words setting to the Event Data block, and fixes Week view calendars so they open on the default month and year.