Skip to main content

Assign episode numbers based on a custom sequence

Free Beginner Since v1.0.0

Benecaster assigns max + 1 across all published episodes by default. Use this filter to suppress auto-numbering for trailers and bonus episodes, restart numbering per season, or skip reserved numbers. Returning 0 suppresses auto-numbering for the episode.

Code

<?php
// Suppress auto-numbering for non-full episodes (trailers, bonus).
add_filter( 'benecaster_episode_auto_number', function ( int $next, int $episode_id, int $show_id ): int {
    $type = get_post_meta( $episode_id, '_benecaster_episode_type', true );
    if ( 'full' !== $type ) {
        return 0; // 0 = skip auto-numbering.
    }
    return $next;
}, 10, 3 );

View on GitHub →

Hooks Used