Developer Filters

All filters live in the global namespace and follow the gbqe_* prefix.

Query argument filters

gbqe_users_query_args

Modifies sanitized WP_User_Query arguments before the query runs.

add_filter( 'gbqe_users_query_args', function ( $args, $query, $attributes, $block ) {
    $args['role__not_in'] = array( 'administrator' );

    return $args;
}, 10, 4 );

Parameters: $args, $query, $attributes, $block.

gbqe_terms_query_args

Modifies sanitized get_terms() arguments before the query runs.

add_filter( 'gbqe_terms_query_args', function ( $args, $query, $attributes, $block ) {
    $args['exclude'] = array( 123 );

    return $args;
}, 10, 4 );

Parameters: $args, $query, $attributes, $block.

gbqe_max_query_number

Caps the maximum number of items a single Users or Terms query may return.

add_filter( 'gbqe_max_query_number', fn () => 200 );

Dynamic tag filters

gbqe_dynamic_tag_value

Filters the resolved value of any GB Query Extensions dynamic tag.

gbqe_dynamic_tag_link_url

Filters the link URL produced by a dynamic tag.

User access filters

gbqe_user_meta_public_keys

Whitelist additional user meta keys for public output contexts.

add_filter( 'gbqe_user_meta_public_keys', function ( $keys ) {
    $keys[] = 'twitter_handle';

    return $keys;
} );

gbqe_can_view_user_pii

Customize who can read PII fields (email, etc).

add_filter( 'gbqe_can_view_user_pii', function ( $can, $user_id ) {
    return current_user_can( 'edit_users' );
}, 10, 2 );

Term filters

gbqe_term_thumbnail_meta_key

Change the term meta key resolved by the term thumbnail dynamic tag.

add_filter( 'gbqe_term_thumbnail_meta_key', fn () => 'category_image_id' );

Editor preview filters

gbqe_preview_term_taxonomy

Fallback taxonomy used when the editor renders the Terms Query preview without a saved selection.

gbqe_preview_term_id

Fallback term ID used by the same preview.