Venue Admissions & Tickets for WooCommerce

Venue Admissions Actions & Filters

venue_admissions_export_days_ahead

Filter the number of days ahead to show in the quick export slots list.

Parameters:

• $days (int) – Number of days ahead to show (default: 30)

Example:

/**
 * Show export slots for the next 60 days instead of 30.
 */
add_filter( 'venue_admissions_export_days_ahead', function( $days ) {
    return 60;
} );

venue_admissions_export_filename

Filter the CSV export filename before download.

Parameters:

• $filename (string) – The default filename (e.g., “venue-admissions-2026-02-04.csv”)
• $date (string) – The export date in Y-m-d format

Example:

/**
 * Customise export filename to include venue name.
 */
add_filter( 'venue_admissions_export_filename', function( $filename, $date ) {
    return 'example-org-' . $date . '.csv';
}, 10, 2 );

Event Schema (SEO)

venue_admissions_schema_enabled

Enable or disable Event schema output for specific products.

Parameters:

• $enabled (bool) – Whether schema is enabled (default: true)
• $product_id (int) – WooCommerce product ID

Example:

/**
 * Disable schema for specific private events.
 */
add_filter( 'venue_admissions_schema_enabled', function( $enabled, $product_id ) {
    $private_events = array( 123, 456, 789 );
    if ( in_array( $product_id, $private_events, true ) ) {
        return false;
    }
    return $enabled;
}, 10, 2 );

venue_admissions_schema_instances_limit

Filter the maximum number of event instances to include in schema.

Parameters:

• $instances_limit (int) – Number of event instances (default: 14)
• $product_id (int) – WooCommerce product ID

Example:

/**
 * Show more instances for popular touring shows.
 */
add_filter( 'venue_admissions_schema_instances_limit', function( $limit, $product_id ) {
    $touring_shows = array( 100, 101, 102 );
    if ( in_array( $product_id, $touring_shows, true ) ) {
        return 30; // Show 30 instances instead of 14.
    }
    return $limit;
}, 10, 2 );

venue_admissions_schema_days_limit

Filter the maximum number of days ahead to include event instances in schema.

Parameters:

• $days_limit (int) – Number of days ahead (default: 365)
• $product_id (int) – WooCommerce product ID

Example:

/**
 * Limit one-off events to show only next 30 days.
 */
add_filter( 'venue_admissions_schema_days_limit', function( $days, $product_id ) {
    $one_off_events = array( 200, 201 );
    if ( in_array( $product_id, $one_off_events, true ) ) {
        return 30;
    }
    return $days;
}, 10, 2 );

venue_admissions_schema_organizer

Filter the organiser data in Event schema.

Parameters:

• $data (array) – Organiser data with @type, name, and url keys
• $product_id (int) – WooCommerce product ID

Example:

/**
 * Override organiser for specific promoter's events.
 */
add_filter( 'venue_admissions_schema_organizer', function( $data, $product_id ) {
    $live_nation_events = array( 300, 301, 302 );
    if ( in_array( $product_id, $live_nation_events, true ) ) {
        return array(
            '@type' => 'Organization',
            'name'  => 'Example Corp Entertainment',
            'url'   => 'https://example.com',
        );
    }
    return $data;
}, 10, 2 );

venue_admissions_schema_location

Filter the location/venue data in Event schema.

Parameters:

• $data (array) – Location data (Place with PostalAddress)
• $product_id (int) – WooCommerce product ID

Example:

/**
 * Use different venue for touring shows.
 */
add_filter( 'venue_admissions_schema_location', function( $data, $product_id ) {
    $touring_show_id = 400;
    if ( $product_id === $touring_show_id ) {
        return array(
            '@type'   => 'Place',
            'name'    => 'Palacio Blanco',
            'address' => array(
                '@type'           => 'PostalAddress',
                'streetAddress'   => '1600 Pennsylvania Avenue',
                'addressLocality' => 'Washington',
                'addressRegion'   => 'DC',
                'postalCode'      => '20500',
                'addressCountry'  => 'US',
            ),
        );
    }
    return $data;
}, 10, 2 );

Chart Customisation

venue_admissions_chart_palette_size

Filter the number of colours in the reporting chart colour palette.

Parameters:

• $palette_size (int) – Number of colours in palette (default: 20)

Example:

/**
 * Reduce palette size for venues with fewer events.
 */
add_filter( 'venue_admissions_chart_palette_size', function( $size ) {
    return 10;
} );

venue_admissions_chart_seed_color

Filter the seed colour used to generate the chart colour palette.

Parameters:

• $seed_color (string) – Hex colour code for palette generation (default: ‘#3498db’)

Example:

/**
 * Use brand colour as chart palette seed.
 */
add_filter( 'venue_admissions_chart_seed_color', function( $color ) {
    return '#e74c3c'; // Red theme for brand consistency.
} );

Sales Cutoff

venue_admissions_cutoff_minutes

Filter the sales cutoff time in minutes for ticket purchases.

Parameters:

• $cutoff (int) – The cutoff value in minutes (negative/zero/positive)
• $product_id (int) – WooCommerce product ID
• $mode (string) – The cutoff mode (‘before’, ‘at_start’, ‘allow_during’)
• $minutes (int) – The number of minutes configured in product settings

Example:

/**
 * Allow VIP products to be purchased up until start time.
 */
add_filter( 'venue_admissions_cutoff_minutes', function( $cutoff, $product_id, $mode, $minutes ) {
    $vip_products = array( 500, 501 );
    if ( in_array( $product_id, $vip_products, true ) ) {
        return 0; // Allow purchase until event starts.
    }
    return $cutoff;
}, 10, 4 );

Template System

venue_admissions_get_template

Filter the template file path after it has been located.

Parameters:

• $located (string) – Full path to the located template file
• $template_name (string) – Template name (e.g., ‘calendar/header.php’)
• $args (array) – Arguments passed to template
• $template_path (string) – Path within theme (default: ‘venue-admissions/’)
• $default_path (string) – Default plugin templates path

Example:

/**
 * Override specific templates programmatically.
 */
add_filter( 'venue_admissions_get_template', function( $located, $template_name, $args, $template_path, $default_path ) {
    if ( 'ticket/donation.php' === $template_name ) {
        // Use custom template for donation toggle.
        return get_stylesheet_directory() . '/custom-donation.php';
    }
    return $located;
}, 10, 5 );

venue_admissions_locate_template

Filter the template path during template location.

Parameters:

• $template (string) – Full path to template file
• $template_name (string) – Template name
• $template_path (string) – Path within theme

Example:

/**
 * Use different theme folder for templates.
 */
add_filter( 'venue_admissions_locate_template', function( $template, $template_name, $template_path ) {
    // Check in custom theme location first.
    $custom_path = get_stylesheet_directory() . '/woocommerce/venue-tickets/' . $template_name;
    if ( file_exists( $custom_path ) ) {
        return $custom_path;
    }
    return $template;
}, 10, 3 );

Donation System

venue_admissions_donation_info_link_text

Filter the text of the donation info link.

Parameters:

• $text (string) – Link text (default: “What’s this?”)

Example:

/**
 * Change donation info link text.
 */
add_filter( 'venue_admissions_donation_info_link_text', function( $text ) {
    return __( 'Learn more', 'my-theme' );
} );

Action Hooks

Frontend Template Hooks

venue_admissions_before_ticket_selector

Fires before the ticket selector widget is rendered.

Example:

/**
 * Add promotional banner before ticket selector.
 */
add_action( 'venue_admissions_before_ticket_selector', function() {
    echo '<div class="promo-banner">Early bird discount available!</div>';
} );

venue_admissions_calendar_view

Main hook for rendering calendar view components.

Default Actions:

• venue_admissions_template_calendar_header – Priority 10
• venue_admissions_template_calendar_table – Priority 20
• venue_admissions_template_time_slots – Priority 30

Example:

/**
 * Add custom instructions above the calendar.
 */
add_action( 'venue_admissions_calendar_view', function() {
    echo '<p class="calendar-instructions">Select a date to see available times.</p>';
}, 5 ); // Priority 5 runs before calendar header.

venue_admissions_calendar_nav_buttons

Fires within the calendar header navigation area.

Default Actions:

• va_template_calendar_nav_previous – Priority 10
• va_template_calendar_nav_next – Priority 20

Example:

/**
 * Add a "Today" button between navigation buttons.
 */
add_action( 'venue_admissions_calendar_nav_buttons', function() {
    echo '<button type="button" class="va-today-btn button">Today</button>';
}, 15 ); // Priority 15 renders between Previous and Next buttons.

venue_admissions_ticket_view

Main hook for rendering ticket selection view components.

Default Actions:

• venue_admissions_template_ticket_back_button – Priority 10
• venue_admissions_template_ticket_slot_info – Priority 20
• venue_admissions_template_ticket_donation – Priority 30
• venue_admissions_template_ticket_table – Priority 40
• venue_admissions_template_ticket_add_to_cart – Priority 50

Example:

/**
 * Add upsell message before ticket selection table.
 */
add_action( 'venue_admissions_ticket_view', function() {
    echo '<div class="upsell-message">Add parking for only £10!</div>';
}, 35 ); // Priority 35 runs after donation, before ticket table.

venue_admissions_after_ticket_views

Fires after both calendar and ticket views, but inside the widget container.

Default Actions:

• venue_admissions_template_loading – Priority 10
• venue_admissions_template_error – Priority 20

Example:

/**
 * Add customer support link at bottom of widget.
 */
add_action( 'venue_admissions_after_ticket_views', function() {
    echo '<p class="support-link"><a href="/contact">Need help? Contact us</a></p>';
}, 30 );

venue_admissions_after_ticket_selector

Fires after the entire ticket selector widget is rendered.

Example:

/**
 * Add accessibility information after ticket selector.
 */
add_action( 'venue_admissions_after_ticket_selector', function() {
    echo '<div class="accessibility-info">';
    echo '<p>For wheelchair access and accessibility options, please call 0800 123 4567.</p>';
    echo '</div>';
} );

Template Loading

venue_admissions_before_template_part

Fires before a template part is included.

Parameters:

• $template_name (string) – Template filename
• $template_path (string) – Path to template within theme
• $located (string) – Full path to located template file
• $args (array) – Arguments passed to template

Example:

/**
 * Log template rendering for debugging.
 */
add_action( 'venue_admissions_before_template_part', function( $template_name, $template_path, $located, $args ) {
    if ( defined( 'WP_DEBUG' ) && WP_DEBUG ) {
        error_log( 'Loading template: ' . $template_name . ' from ' . $located );
    }
}, 10, 4 );

venue_admissions_after_template_part

Fires after a template part has been included.

Parameters:

• $template_name (string) – Template filename
• $template_path (string) – Path to template within theme
• $located (string) – Full path to located template file
• $args (array) – Arguments passed to template

Example:

/**
 * Add wrapper closing tag after donation template.
 */
add_action( 'venue_admissions_after_template_part', function( $template_name ) {
    if ( 'ticket/donation.php' === $template_name ) {
        echo '</div><!-- .donation-wrapper -->';
    }
}, 10, 1 );