Feriae

Open-source events for WordPress, built to replace The Events Calendar and its paid add-ons. Feriae Calendar is the core; RSVP, Tickets, recurrence, and more are modules you switch on, with no upsells.

Try it in WordPress Playground to test the plugin in your browser, with nothing to install. The demo loads sample events, venues, and coloured categories for the current month, and opens on the calendar. You're logged in as admin, so you can try the setup wizard (Events → Settings → Run setup wizard) and the editor too.

• Requires: WordPress 7.1+, PHP 8.2+

• License: GPLv2 or later

• Status: in development. The demo is rebuilt from main on every push.

• Events on any post type. Use a dedicated Events post type, add event dates to post types you already have, or both. Existing posts are never changed.

• Fast at library scale. Listings read one indexed table and batch-load everything they render. With 5,000 events, a month view costs 2 more queries than a plain page.

• Works without JavaScript. Calendar views are server-rendered links. The Interactivity API upgrades them to in-place navigation.

• Theme-friendly. Blocks inherit your theme.json, the templates are editable in the Site Editor, and classic themes get fallbacks.

• Recurring events. Daily, weekly, monthly, or yearly rules (standard iCal RRULE), skipped and extra dates, and editing one date or the rest of a series.

• Calendar import. Add a Google Calendar, Outlook, or Apple Calendar by its iCal address and its events stay in sync, repeating events included. No API keys. One-off .ics files too.

• Free RSVP and tickets. Capacity limits, guests, waitlists, attendee questions (with consent boxes), pay at the door, Stripe, or PayPal, with no platform fees. See docs/payments.md.

• Open APIs. PHP functions, hooks, a module registry, REST, the Abilities API, Block Bindings, and editor SlotFills.

Requires WordPress 7.1+ and PHP 8.2+.

About the name

Feriae is pronounced FAIR-ee-eye (/ˈfɛri.aɪ/).

In ancient Rome, feriae were the days set aside for festivals and public gatherings, when ordinary business paused and people came together. The word is the root of the English "fair" and the Spanish feria. A plugin for publishing the days your community gathers seemed a fitting place for it.

Screenshots

Event details: date, venue with map link, organizer, cost, and Add to Google Calendar / .ics	List view, grouped by month, with past and upcoming events
Event panel in the editor: dates, timezone, venue and organizers (type a name to create one), cost	Setup wizard: a dedicated Events post type, existing post types, or both
Settings, built on the WordPress Design System; modules switch features on and off	RSVP: places left, guests, and a "not going" option. Works without JavaScript and on cached pages
Tickets: several types per event with price, capacity, and sale window; pay at the door, Stripe, or PayPal	Waitlist: a full event takes names and confirms them automatically when a place frees up

Status

Details and the order of work are in docs/ROADMAP.md.

Development

npm install
npm run build          # or: npm start (watch)
npm run playground     # WordPress Playground with the plugin and sample events
npm run bench          # Playground with 5,000 generated events; add ?feriae_bench=1 to a page
npm run lint:js

Tests

composer install && composer test:install   # one-time: WordPress + test library + SQLite drop-in in .wp-tests/
npm run test:php                            # PHPUnit integration tests, including query-count budgets
npm run test:e2e                            # Playwright against WordPress Playground

No Docker or MySQL is needed: PHPUnit runs WordPress on the official SQLite drop-in, and the end-to-end tests boot Playground. The same suites run in GitHub Actions on every push.

tests/phpunit/integration/PerformanceTest.php fails if rendering cost grows with the number of events (an N+1 query), so performance regressions are caught like any other bug.

The built build/ directory is not committed. Run npm run build after cloning, or use npm run plugin-zip to make an installable zip.

WP-CLI

wp feriae rebuild     # rebuild the occurrences table (after bulk imports)
wp feriae stats       # row counts and EXPLAIN plans for hot queries
wp feriae generate --count=5000   # load-test data; never on production

Documentation

• Architecture: data model, performance contract, extension APIs
• Roadmap
• Research: TEC support forum pain points, TEC data model, Event Tickets data model

Extending

// Add a module that site owners can toggle in Events → Settings → Modules.
add_filter( 'feriae/modules', function ( array $modules ) {
    $modules[] = new My_Zoom_Module(); // extends Feriae\Modules\AbstractModule
    return $modules;
} );

// Query events anywhere.
foreach ( feriae_get_upcoming( 5, array( 'categories' => array( 12 ) ) ) as $occurrence ) {
    echo esc_html( get_the_title( $occurrence->event_id ) . ': ' . feriae_format_range( $occurrence ) );
}

The full list of hooks and APIs is in docs/ARCHITECTURE.md.

License

GPL-2.0-or-later