Customize [benecaster_current_tier] output

Free Beginner Since v1.0.0

benecaster_current_tier_output fires immediately before the shortcode returns. $tier_slug and $user are null on the fallback path (guest, no token, non-active token). Use the filter to greet the subscriber by name, prefix with a role indicator, or produce a fully-different string from the fallback attribute.

Code

<?php
add_filter(
    'benecaster_current_tier_output',
    function ( string $output, int $show_id, ?string $tier_slug, ?\WP_User $user, array $atts ): string {
        if ( null === $tier_slug || null === $user ) {
            return $output; // guest / no token — respect the shortcode's fallback
        }
        return sprintf(
            /* translators: 1: first name, 2: tier display name */
            __( 'Welcome back, %1$s — your current tier is %2$s.', 'my-addon' ),
            esc_html( $user->display_name ),
            esc_html( $output )
        );
    },
    10,
    5
);

View on GitHub →

Hooks Used

benecaster_current_tier_output