bp_insert_activity_meta( string $content = '' )

Attach metadata about an activity item to the activity content.

Description

This metadata includes the time since the item was posted (which will appear as a link to the item’s permalink).

Parameters

$content

(Optional) The activity content.

Default value: ''

Return

(string) The activity content with the metadata string attached.

Source

File: bp-activity/bp-activity-template.php

function bp_insert_activity_meta( $content = '' ) {
    global $activities_template;
 
    // Strip any legacy time since placeholders from BP 1.0-1.1.
    $new_content = str_replace( '<span class="time-since">%s</span>', '', $content );
 
    // Get the time since this activity was recorded.
    $date_recorded  = bp_core_time_since( $activities_template->activity->date_recorded );
 
    // Set up 'time-since' <span>.
    $time_since = sprintf(
        '<span class="time-since" data-livestamp="%1$s">%2$s</span>',
        bp_core_get_iso8601_date( $activities_template->activity->date_recorded ),
        $date_recorded
    );
 
    /**
     * Filters the activity item time since markup.
     *
     * @since BuddyPress 1.2.0
     *
     * @param array $value Array containing the time since markup and the current activity component.
     */
    $time_since = apply_filters_ref_array( 'bp_activity_time_since', array(
        $time_since,
        &$activities_template->activity
    ) );
 
    // Insert the permalink.
    if ( ! bp_is_single_activity() ) {
 
        // Setup variables for activity meta.
        $activity_permalink = bp_activity_get_permalink( $activities_template->activity->id, $activities_template->activity );
        $activity_meta      = sprintf( '%1$s <a href="%2$s" class="view activity-time-since">%3$s</a>',
            $new_content,
            $activity_permalink,
            $time_since
        );
 
        /**
         * Filters the activity permalink to be added to the activity content.
         *
         * @since BuddyPress 1.2.0
         *
         * @param array $value Array containing the html markup for the activity permalink, after being parsed by
         *                     sprintf and current activity component.
         */
        $new_content = apply_filters_ref_array( 'bp_activity_permalink', array(
            $activity_meta,
            &$activities_template->activity
        ) );
    } else {
        $new_content .= str_pad( $time_since, strlen( $time_since ) + 2, ' ', STR_PAD_BOTH );
    }
 
    /**
     * Filters the activity content after activity metadata has been attached.
     *
     * @since BuddyPress 1.2.0
     *
     * @param string $content Activity content with the activity metadata added.
     */
    return apply_filters( 'bp_insert_activity_meta', $new_content, $content );
}

Expand full source code Collapse full source code

Changelog

Changelog
Version	Description
BuddyPress 1.2.0	Introduced.

Uses

Uses
Uses	Description
bp-core/bp-core-template.php: bp_is_single_activity()	Is the current page a single activity item permalink?
bp-core/bp-core-functions.php: bp_core_time_since()	Get an English-language representation of the time elapsed since a given date.
bp-core/bp-core-functions.php: bp_core_get_iso8601_date()	Return an ISO-8601 date from a date string.
bp-activity/bp-activity-functions.php: bp_activity_get_permalink()	Get the permalink for a single activity item.
bp-activity/bp-activity-template.php: bp_activity_time_since	Filters the activity item time since markup.
bp-activity/bp-activity-template.php: bp_activity_permalink	Filters the activity permalink to be added to the activity content.
bp-activity/bp-activity-template.php: bp_insert_activity_meta	Filters the activity content after activity metadata has been attached.

Show 2 more uses Hide more uses

Used By
Used By	Description
bp-activity/bp-activity-template.php: bp_get_activity_content_body()	Return the activity content body.
bp-activity/bp-activity-template.php: bp_get_activity_action()	Return the activity action.

Questions?

We're always happy to help with code or other questions you might have! Search our developer docs, contact support, or connect with our sales team.

Contents