kaiseki/wp-plugin-the-events-calendar

WordPress helpers for The Events Calendar plugin: event/venue/organizer entity utilities, default-template and option filters

1.0.0 2026-06-01 13:49 UTC

Requires

• php: ^8.2
• kaiseki/config: ^2.0
• kaiseki/wp-hook: ^2.0
• psr/container: ^1.1 || ^2.0
• thecodingmachine/safe: ^2.0

Requires (Dev)

• bnf/phpstan-psr-container: ^1.1
• kaiseki/php-coding-standard: ^1.0
• maglnet/composer-require-checker: ^4.0
• php-stubs/wordpress-stubs: ^6.2
• phpstan/extension-installer: ^1.4
• phpstan/phpstan: ^2.0
• phpstan/phpstan-phpunit: ^2.0
• phpstan/phpstan-strict-rules: ^2.0
• phpunit/phpunit: ^11.0
• roave/security-advisories: dev-latest
• roots/wordpress-core-installer: *
• roots/wordpress-no-content: @stable
• szepeviktor/phpstan-wordpress: ^2.0
• thecodingmachine/phpstan-safe-rule: ^1.4
• wpackagist-plugin/the-events-calendar: 6.2.8.2

MIT

• Kaiseki
• David Mondok
• Wolfgang Schaefer

README

WordPress helpers for The Events Calendar plugin: event/venue/organizer entity utilities, default-template and option filters.

Provides small read helpers around the plugin's data (Event, Venue, Organizer, Schedule) plus hook providers — wired through ConfigProvider and the the_events_calendar config key — to set the default event template, override plugin options, and optionally disable front-end block rendering.

Installation

composer require kaiseki/wp-plugin-the-events-calendar

Requires PHP 8.2 or newer. Expects The Events Calendar plugin to be active at runtime.

Usage

Register ConfigProvider with your laminas-style config aggregator and configure the the_events_calendar key, activating the providers you want via kaiseki/wp-hook:

use Kaiseki\WordPress\TheEventsCalendar\DefaultTemplate;
use Kaiseki\WordPress\TheEventsCalendar\DisableBlockRenderingInFrontend;
use Kaiseki\WordPress\TheEventsCalendar\FilterOptions;

return [
    'the_events_calendar' => [
        'default_template' => ['type' => 'default'],
        'disable_block_rendering' => true,
        // Overrides applied to tribe_get_single_option().
        'options' => [
            'ticket-enabled-post-types' => ['tribe_events'],
        ],
    ],
    'hook' => [
        'provider' => [
            DefaultTemplate::class,
            DisableBlockRenderingInFrontend::class,
            FilterOptions::class,
        ],
    ],
];

The EntityUtils\Event / Venue / Organizer helpers wrap the plugin's tribe_* lookups (cost, iCal/Google links, past-event check, …) behind a typed API for use in templates.

Development

composer install
composer check   # check-deps, cs-check, phpstan

License

MIT — see LICENSE.