Extending & Customizing BricksMembers

BricksMembers is built for extensibility. Use WordPress hooks, filters, and the plugin’s API to customize behavior without modifying core files.

Custom Access Logic

The access API is not filterable. Implement custom rules by wrapping brm_user_can_access_content() in your own logic or by using redirects/actions.

Custom User Levels

User levels are not filterable; use the public functions (add/remove/set) to control access.

Reacting to Events

Hook into actions to execute custom code when events occur:

// When level is added to user
add_action( 'brm_user_level_added', function( $user_id, $level_id ) {
    // Send welcome email for premium level
    if ( $level_id === 5 ) {
        $user = get_userdata( $user_id );
        wp_mail(
            $user->user_email,
            'Welcome to Premium!',
            'You now have premium access.'
        );
    }
    
    // Your custom logic here
}, 10, 2 );

// When content is completed
add_action( 'brm_post_completed', function( $user_id, $post_id ) {
    // Award points
    $points = (int) get_user_meta( $user_id, 'points', true );
    update_user_meta( $user_id, 'points', $points + 10 );
    
    // Check if this is a course completion
    $post_type = get_post_type( $post_id );
    if ( $post_type === 'course' ) {
        // Award course completion badge
        update_user_meta( $user_id, 'course_completed_' . $post_id, true );
        do_action( 'brm_course_completed', $user_id, $post_id );
    }
}, 10, 2 );

Override Redirect Behavior

Control when redirects occur for protected content using brm_should_apply_redirect:

// Don't redirect on preview
add_filter( 'brm_should_apply_redirect', function( $should_redirect, $post_id, $user_id ) {
    if ( is_preview() ) {
        return false;
    }
    return $should_redirect;
}, 10, 3 );

Custom Batch Sizes

Adjust batch processing sizes for user backfill via brm_unlocks_user_worker_posts_per_page if needed:

add_filter( 'brm_unlocks_user_worker_posts_per_page', function( $posts_per_page ) {
    return 150; // Reduce or increase for your hosting
} );

Custom Dynamic Tags

Add custom dynamic tags for use in Bricks Builder:

// Register custom dynamic tag
add_filter( 'bricks/dynamic_tags_list', function( $tags ) {
    $tags[] = [
        'name' => 'brm_custom',
        'label' => 'Custom BRM Tag',
        'group' => 'BricksMembers',
        'callback' => 'render_custom_brm_tag'
    ];
    return $tags;
} );

function render_custom_brm_tag( $post_id, $args ) {
    $user_id = get_current_user_id();
    if ( ! $user_id ) {
        return '';
    }
    
    // Use BricksMembers API
    $levels = brm_core()->get_user_levels( $user_id );
    $level_names = array_map( function( $level_id ) {
        $level = brm_get_level_by_id( $level_id );
        return $level ? $level->name : '';
    }, $levels );
    
    return implode( ', ', array_filter( $level_names ) );
}

Best Practices

• Use hooks, don’t modify core: Always extend via filters/actions
• Check dependencies: Verify functions exist before calling
• Respect priorities: Use appropriate hook priorities (10 = default, 20+ = after plugin)
• Return values: Always return filtered values, even if unchanged
• Test thoroughly: Test your customizations with different scenarios
• Use API functions: Always use brm_* functions rather than accessing internals