Skip to main content

Hooks & Filters

Customize Lista Recurring Events behavior with actions and filters.

Actions​

lre_cache_cleared​

Fires when an event's cache is cleared.

add_action('lre_cache_cleared', function($post_id) {
    // Perform additional cleanup
    delete_transient('my_custom_cache_' . $post_id);
}, 10, 1);

Parameters:

  • $post_id (int) — The event post ID

lre_init​

Fires when the plugin initializes. Useful for add-ons.

add_action('lre_init', function() {
    // Register custom functionality
    my_addon_init();
});

lre_after_save_recurrence​

Fires after recurrence settings are saved for an event.

add_action('lre_after_save_recurrence', function($post_id, $settings) {
    // Sync with external calendar
    sync_to_google_calendar($post_id, $settings);
}, 10, 2);

Parameters:

  • $post_id (int) — The event post ID
  • $settings (array) — The saved recurrence settings

lre_settings_tabs_nav​

Add custom tabs to the settings page navigation.

add_action('lre_settings_tabs_nav', function() {
    echo '<li><a href="#my-tab">My Add-on</a></li>';
});

lre_settings_tab_content​

Add content for custom settings tabs.

add_action('lre_settings_tab_content', function() {
    echo '<div id="my-tab" class="lre-tab-content">';
    echo '<h2>My Add-on Settings</h2>';
    // Settings form here
    echo '</div>';
});

lre_metabox_tabs_nav​

Add custom tabs to the event metabox.

add_action('lre_metabox_tabs_nav', function($post) {
    echo '<button class="lre-tab-button" data-tab="my-tab">My Tab</button>';
}, 10, 1);

lre_metabox_tabs_panels​

Add content for custom metabox tabs.

add_action('lre_metabox_tabs_panels', function($post) {
    echo '<div id="my-tab" class="lre-tab-panel">';
    // Tab content here
    echo '</div>';
}, 10, 1);

Filters​

lre_date_format​

Modify the date format used for output.

add_filter('lre_date_format', function($format, $context) {
    if ($context === 'shortcode') {
        return 'Y-m-d';
    }
    return $format;
}, 10, 2);

Parameters:

  • $format (string) — The date format
  • $context (string) — Where it's being used (shortcode, dynamic_tag, etc.)

lre_calendar_theme_presets​

Add custom calendar theme presets.

add_filter('lre_calendar_theme_presets', function($presets) {
    $presets['ocean'] = [
        'name' => 'Ocean',
        'category' => 'custom',
        'styles' => [
            'primary_color' => '#0077b6',
            'event_bg' => '#00b4d8',
            'event_text' => '#ffffff',
            'today_bg' => '#caf0f8',
            'border_color' => '#90e0ef',
        ],
    ];
    return $presets;
});

lre_calendar_event_data​

Modify event data sent to the calendar.

add_filter('lre_calendar_event_data', function($event, $post_id, $date) {
    // Add custom properties
    $event['extendedProps']['venue'] = get_post_meta($post_id, 'venue_name', true);
    $event['extendedProps']['capacity'] = get_post_meta($post_id, 'event_capacity', true);
    
    return $event;
}, 10, 3);

Parameters:

  • $event (array) — Event data array
  • $post_id (int) — Event post ID
  • $date (string) — Occurrence date (Y-m-d)

lre_calendar_events_query_args​

Modify the query arguments for calendar events.

add_filter('lre_calendar_events_query_args', function($args, $request) {
    // Only show featured events
    $args['tax_query'] = [
        [
            'taxonomy' => 'event_category',
            'field' => 'slug',
            'terms' => 'featured',
        ],
    ];
    return $args;
}, 10, 2);

Parameters:

  • $args (array) — WP_Query arguments
  • $request (WP_REST_Request) — The REST request object

lre_show_any_tabs​

Control whether metabox tabs container is shown.

add_filter('lre_show_any_tabs', function($show, $post, $show_recurrence, $show_calendar) {
    // Always show tabs if our add-on is active
    if (my_addon_is_active()) {
        return true;
    }
    return $show;
}, 10, 4);

lre_occurrences​

Filter the calculated occurrences.

add_filter('lre_occurrences', function($occurrences, $post_id, $limit) {
    // Remove weekends
    return array_filter($occurrences, function($date) {
        $day = $date->format('N');
        return $day < 6; // Mon-Fri only
    });
}, 10, 3);

lre_recurrence_types​

Add or modify available recurrence types.

add_filter('lre_recurrence_types', function($types) {
    $types['biweekly'] = __('Bi-Weekly', 'my-addon');
    return $types;
});

Extension Points​

Creating an Add-on​

/**
 * My LRE Add-on
 */
add_action('lre_init', function() {
    // Add settings tab
    add_action('lre_settings_tabs_nav', 'my_addon_settings_tab');
    add_action('lre_settings_tab_content', 'my_addon_settings_content');
    
    // Add metabox tab
    add_action('lre_metabox_tabs_nav', 'my_addon_metabox_tab');
    add_action('lre_metabox_tabs_panels', 'my_addon_metabox_content');
    
    // Hook into save
    add_action('lre_after_save_recurrence', 'my_addon_handle_save', 10, 2);
});

function my_addon_settings_tab() {
    echo '<li><a href="#my-addon-tab">My Add-on</a></li>';
}

function my_addon_settings_content() {
    ?>
    <div id="my-addon-tab" class="lre-tab-content">
        <h2>My Add-on Settings</h2>
        <!-- Settings form -->
    </div>
    <?php
}

Best Practices​

  1. Use appropriate priority — Default is 10; use lower numbers to run earlier
  2. Check context — Verify you're modifying the right data
  3. Return filtered values — Always return something from filters
  4. Namespace your functions — Avoid conflicts with other code
  5. Document your hooks — Help users understand your add-on's extension points