Skip to content

Hooks and Filters

These are the filters the plugin exposes for customization, verified against the source. All are in the bp-check-in text domain.

Filters the display label of the Check-ins profile tab.

add_filter( 'bpchk_member_profile_checkin_tab_name', function ( $name ) {
return __( 'Travel Log', 'your-textdomain' );
} );

Filters the URL slug of the Check-ins profile tab. The default is derived from the tab name with sanitize_title().

add_filter( 'bpchk_member_profile_checkin_tab_slug', function ( $slug ) {
return 'my-locations';
} );

bpchk_activity_listing_per_page_user_profile

Section titled “bpchk_activity_listing_per_page_user_profile”

Number of saved check-ins shown per page on the profile tab. Default 10.

add_filter( 'bpchk_activity_listing_per_page_user_profile', function ( $per_page ) {
return 20;
} );

Filters the activity action string for a check-in (the “[member] checked-in” line). Receives the action string and the BP_Activity_Activity object.

add_filter( 'bpchk_activity_new_checkin_action', function ( $action, $activity ) {
return sprintf( '%s shared a location', bp_core_get_userlink( $activity->user_id ) );
}, 10, 2 );

Filters the BuddyPress members template used to render the Check-ins tab screen. Default members/single/plugins.

add_filter( 'bpchk_core_template_plugin', function ( $template ) {
return 'members/single/custom-checkins';
} );

Filters whether the plugin’s CSS and JS load on the current request. Receives the computed boolean, the current $post, the check-in tab slug, and the current BuddyPress component.

add_filter( 'bpchk_enqueue_checkins_assets', function ( $should_enqueue, $post, $tab_slug, $component ) {
if ( is_page( 'my-map-page' ) ) {
return true;
}
return $should_enqueue;
}, 10, 4 );

For reference, the plugin registers these admin-ajax.php actions:

Action Context Purpose
bpchk_verify_apikey admin Verify the Google Maps API key
bpchk_save_xprofile_location logged-in Save the Location profile field value
bpchk_delete_user_checkin_location logged-in and no-priv Delete saved check-ins from the tab
bpchk_checkin_activity_read_more logged-in and no-priv Load the embedded map on read-more

Each handler verifies its own nonce.