Skip to main content

Add a line beside an episode’s references in its feed show notes

Free Intermediate

Every feed item’s <content:encoded> show notes end with the episode’s references. The episode page’s benecaster_before_episode_references action does not fire there, so a line that belongs beside the list (an affiliate disclosure, a “links may earn us a commission” note) goes through benecaster_episode_references_html, which receives the built block and the list it was built from.

Code

<?php
add_filter( 'benecaster_episode_references_html', function ( string $html, array $refs, int $episode_id, int $show_id, string $context ): string {
    // In 'rss' this runs once per tier when the feed is compiled, and the
    // result is cached for every listener: decide from the episode, never the user.
    $has_affiliate = (bool) array_filter( $refs, static fn( $r ) => str_contains( (string) $r['url'], 'tag=' ) );
    if ( ! $has_affiliate ) {
        return $html;
    }
    return '<p>' . esc_html__( 'Some of these links earn us a commission.', 'myplugin' ) . '</p>' . "\n" . $html;
}, 10, 5 );

View on GitHub →

Hooks Used

Need this built rather than just documented? See our services →