A collection of WordPress plugins for running event websites with fair, transparent pricing. Built as a monorepo with shared development tools and standardized patterns.

All plugins are available on WordPress.org:

• Fair Events - Core event management with custom post types and blocks
• Fair Calendar Button - Add events to Google Calendar, Apple Calendar, etc.
• Fair Timetable - Display event schedules in an organized timetable format
• Fair Schedule Blocks - Gutenberg blocks for event schedules
• Fair RSVP - Event registration and attendance management
• Fair Membership - Membership management with fees and groups

• fair-platform - OAuth proxy for Mollie Connect (deployed to fair-event-plugins.com only)

Start the development environment with Docker:

docker compose up

This provides:

• WordPress: http://localhost:8080
• phpMyAdmin: http://localhost:8081

# Start all plugins in watch mode
npm start

# Build all plugins for production
npm run build

# Format code (JavaScript, CSS, PHP)
npm run format

# Run tests
npm test

Each plugin is a workspace in the monorepo:

# Work in a specific plugin
cd fair-events
npm run start    # Watch mode for this plugin only
npm run build    # Build this plugin only

• CLAUDE.md - Project overview, coding standards, and AI assistant instructions
• ADDING_NEW_PLUGIN.md - How to add new plugins to the monorepo
• PHP_PATTERNS.md - PHP best practices and security patterns
• REST_API_BACKEND.md - REST API security and implementation standards
• REST_API_USAGE.md - Frontend REST API patterns with apiFetch
• REACT_ADMIN_PATTERN.md - React admin pages architecture
• TESTING.md - Testing strategy (Jest, Playwright)

• DEPLOYMENT.md - Automated deployment setup
• RELEASES.md - Release process and versioning

Generate and update translations:

cd fair-events  # Or any plugin
npm run makepot      # Generate .pot template
npm run updatepo     # Update .po files
npm run makemo       # Generate .mo files
npm run build        # Build with translations

Translation files:

• PHP translations: languages/*.po, languages/*.mo
• JavaScript translations: build/languages/*.json (auto-generated)

• WordPress: 6.7+
• PHP: 8.0+
• Node.js: 18+
• Composer: 2.0+

GPL v2 or later (unless specified otherwise in individual plugin)

For plugin issues and questions, visit the support forums on WordPress.org or open an issue.