Hooks & Filters Reference

This page documents every action hook and filter that BuddyPress Activity Share Pro exposes. Use them to extend or modify plugin behavior without editing plugin files directly.

All hooks live in the buddypress-share text domain. Hook names beginning with bp_share_ are registered by this plugin; do not confuse them with core BuddyPress hooks that follow a similar naming pattern.

Actions

Actions fire at specific points in the plugin lifecycle. Add your own add_action() calls to tap into them.

Activity (Internal) Resharing

`bp_share_after_create_reshare`

Fires after a reshare activity has been successfully created in the database.

Since: 1.5.2
File: public/class-buddypress-share-public.php

Parameters:

Parameter	Type	Description
`$new_activity_id`	`int`	ID of the newly created share activity.
`$reshare_data`	`array`	Reshare data: `user_id`, `activity_id`, `activity_type`, `activity_content`, `activity_in`, `destination_type`.

Example use case: Send a notification or award points when someone reshares an activity.

add_action( 'bp_share_after_create_reshare', function( $new_activity_id, $reshare_data ) {
    // Award points to the sharer
    $user_id = $reshare_data['user_id'];
    my_points_plugin_award( $user_id, 5, 'activity_reshare' );
}, 10, 2 );

`bp_share_user_reshared_activity`

Fires after a reshare completes. Designed specifically for point systems and gamification plugins because it exposes both the original and new activity IDs alongside the destination type.

Since: 2.0.0
File: public/class-buddypress-share-public.php

Parameters:

Parameter	Type	Description
`$user_id`	`int`	The user who performed the reshare.
`$destination_type`	`string`	Where the reshare was posted: `profile`, `group`, or `friend`.
`$original_activity_id`	`int`	The original activity that was reshared.
`$new_activity_id`	`int`	The newly created reshare activity.

Example use case: Connect a GamiPress or myCRED points rule to resharing.

add_action( 'bp_share_user_reshared_activity', function( $user_id, $destination_type, $original_activity_id, $new_activity_id ) {
    if ( $destination_type === 'group' ) {
        // Extra points for sharing to a group
        mycred_add( 'reshare_to_group', $user_id, 10, 'Shared activity to group' );
    }
}, 10, 4 );

`bp_share_post_shared`

Fires after a share event for a standard WordPress post (or custom post type) has been recorded in the tracking table.

Since: 2.0.0
File: includes/post-types/class-bp-share-post-type-tracker.php

Parameters:

Parameter	Type	Description
`$post_id`	`int`	ID of the post that was shared.
`$service`	`string`	Social service key (e.g. `facebook`, `twitter`, `whatsapp`).
`$user_id`	`int\|null`	User ID, or `null` if shared anonymously.
`$metadata`	`array`	Additional tracking data: `post_type`, `ip_address`, `user_agent`, `referrer`, `shared_at`.

Note: This hook only fires when the custom tracking tables exist. If the tables are absent, deactivate and reactivate the plugin so the installer can recreate them.

add_action( 'bp_share_post_shared', function( $post_id, $service, $user_id, $metadata ) {
    // Log to external analytics endpoint
    wp_remote_post( 'https://analytics.example.com/share', array(
        'body' => array(
            'post'    => $post_id,
            'service' => $service,
            'user'    => $user_id,
        ),
    ) );
}, 10, 4 );

`bp_share_post_visit_tracked`

Fires when a visitor follows a share link back to the site. The URL includes UTM and bps_* parameters that identify the original share event.

Since: 2.0.0
File: includes/post-types/class-bp-share-post-type-controller.php

Parameters:

Parameter	Type	Description
`$visit_data`	`array`	Visit context: `post_id`, `service`, `shared_by` (user ID), `visitor_ip`, `timestamp`, `referrer`.
`$post_id`	`int`	ID of the post being visited.

`bp_share_post_visit_tracked_data`

Fires inside BP_Share_Post_Type_Tracker::track_visit() with the raw visit data before it is written to post meta. Useful for routing visit data to a custom table or analytics service.

Since: 2.0.0
File: includes/post-types/class-bp-share-post-type-tracker.php

Parameters:

Parameter	Type	Description
`$visit_data`	`array`	Visit tracking data array.