activity->slug );
}
/**
* Output the activity component root slug
*
* @since 1.5.0
*
* @uses bp_get_activity_root_slug()
*/
function bp_activity_root_slug() {
echo bp_get_activity_root_slug();
}
/**
* Return the activity component root slug
*
* @since 1.5.0
*
* @global object $bp BuddyPress global settings
* @uses apply_filters() To call the 'bp_get_activity_root_slug' hook
*/
function bp_get_activity_root_slug() {
global $bp;
return apply_filters( 'bp_get_activity_root_slug', $bp->activity->root_slug );
}
/**
* Output member directory permalink
*
* @since 1.5.0
*
* @uses bp_get_activity_directory_permalink()
*/
function bp_activity_directory_permalink() {
echo bp_get_activity_directory_permalink();
}
/**
* Return member directory permalink
*
* @since 1.5.0
*
* @uses traisingslashit()
* @uses bp_get_root_domain()
* @uses bp_get_activity_root_slug()
* @uses apply_filters() To call the 'bp_get_activity_directory_permalink' hook
*
* @return string Activity directory permalink
*/
function bp_get_activity_directory_permalink() {
return apply_filters( 'bp_get_activity_directory_permalink', trailingslashit( bp_get_root_domain() . '/' . bp_get_activity_root_slug() ) );
}
/**
* The main activity template loop
*
* This is responsible for loading a group of activity items and displaying them
*
* @since 1.0.0
*/
class BP_Activity_Template {
var $current_activity = -1;
var $activity_count;
var $total_activity_count;
var $activities;
var $activity;
var $in_the_loop;
var $pag_page;
var $pag_num;
var $pag_links;
var $full_name;
function bp_activity_template( $page, $per_page, $max, $include, $sort, $filter, $search_terms, $display_comments, $show_hidden, $exclude = false, $in = false ) {
$this->__construct( $page, $per_page, $max, $include, $sort, $filter, $search_terms, $display_comments, $show_hidden, $exclude, $in );
}
function __construct( $page, $per_page, $max, $include, $sort, $filter, $search_terms, $display_comments, $show_hidden, $exclude = false, $in = false ) {
global $bp;
$this->pag_page = isset( $_REQUEST['acpage'] ) ? intval( $_REQUEST['acpage'] ) : $page;
$this->pag_num = isset( $_REQUEST['num'] ) ? intval( $_REQUEST['num'] ) : $per_page;
// Check if blog/forum replies are disabled
$this->disable_blogforum_replies = isset( $bp->site_options['bp-disable-blogforum-comments'] ) ? $bp->site_options['bp-disable-blogforum-comments'] : false;
// Get an array of the logged in user's favorite activities
$this->my_favs = maybe_unserialize( bp_get_user_meta( $bp->loggedin_user->id, 'bp_favorite_activities', true ) );
// Fetch specific activity items based on ID's
if ( !empty( $include ) )
$this->activities = bp_activity_get_specific( array( 'activity_ids' => explode( ',', $include ), 'max' => $max, 'page' => $this->pag_page, 'per_page' => $this->pag_num, 'sort' => $sort, 'display_comments' => $display_comments, 'show_hidden' => $show_hidden ) );
// Fetch all activity items
else
$this->activities = bp_activity_get( array( 'display_comments' => $display_comments, 'max' => $max, 'per_page' => $this->pag_num, 'page' => $this->pag_page, 'sort' => $sort, 'search_terms' => $search_terms, 'filter' => $filter, 'show_hidden' => $show_hidden, 'exclude' => $exclude, 'in' => $in ) );
if ( !$max || $max >= (int)$this->activities['total'] )
$this->total_activity_count = (int)$this->activities['total'];
else
$this->total_activity_count = (int)$max;
$this->activities = $this->activities['activities'];
if ( $max ) {
if ( $max >= count($this->activities) ) {
$this->activity_count = count( $this->activities );
} else {
$this->activity_count = (int)$max;
}
} else {
$this->activity_count = count( $this->activities );
}
$this->full_name = $bp->displayed_user->fullname;
// Fetch parent content for activity comments so we do not have to query in the loop
foreach ( (array)$this->activities as $activity ) {
if ( 'activity_comment' != $activity->type )
continue;
$parent_ids[] = $activity->item_id;
}
if ( !empty( $parent_ids ) )
$activity_parents = bp_activity_get_specific( array( 'activity_ids' => $parent_ids ) );
if ( !empty( $activity_parents['activities'] ) ) {
foreach( $activity_parents['activities'] as $parent )
$this->activity_parents[$parent->id] = $parent;
unset( $activity_parents );
}
if ( (int)$this->total_activity_count && (int)$this->pag_num ) {
$this->pag_links = paginate_links( array(
'base' => add_query_arg( 'acpage', '%#%' ),
'format' => '',
'total' => ceil( (int)$this->total_activity_count / (int)$this->pag_num ),
'current' => (int)$this->pag_page,
'prev_text' => _x( '←', 'Activity pagination previous text', 'buddypress' ),
'next_text' => _x( '→', 'Activity pagination next text', 'buddypress' ),
'mid_size' => 1
) );
}
}
function has_activities() {
if ( $this->activity_count )
return true;
return false;
}
function next_activity() {
$this->current_activity++;
$this->activity = $this->activities[$this->current_activity];
return $this->activity;
}
function rewind_activities() {
$this->current_activity = -1;
if ( $this->activity_count > 0 ) {
$this->activity = $this->activities[0];
}
}
function user_activities() {
if ( $this->current_activity + 1 < $this->activity_count ) {
return true;
} elseif ( $this->current_activity + 1 == $this->activity_count ) {
do_action('activity_loop_end');
// Do some cleaning up after the loop
$this->rewind_activities();
}
$this->in_the_loop = false;
return false;
}
function the_activity() {
global $activity;
$this->in_the_loop = true;
$this->activity = $this->next_activity();
if ( is_array( $this->activity ) )
$this->activity = (object) $this->activity;
if ( $this->current_activity == 0 ) // loop has just started
do_action('activity_loop_start');
}
}
/**
* Initializes the activity loop.
*
* Based on the $args passed, bp_has_activities() populates the $activities_template global.
*
* @since 1.0.0
*
* @param array $args Arguments for limiting the contents of the activity loop. Can be passed as an associative array or as a URL argument string
*
* @global object $activities_template {@link BP_Activity_Template}
* @global object $bp BuddyPress global settings
* @uses groups_is_user_member()
* @uses bp_current_action()
* @uses bp_is_current_action()
* @uses bp_get_activity_slug()
* @uses bp_action_variable()
* @uses wp_parse_args()
* @uses bp_is_active()
* @uses friends_get_friend_user_ids()
* @uses groups_get_user_groups()
* @uses bp_activity_get_user_favorites()
* @uses apply_filters() To call the 'bp_has_activities' hook
*
* @return bool Returns true when activities are found
*/
function bp_has_activities( $args = '' ) {
global $activities_template, $bp;
/***
* Set the defaults based on the current page. Any of these will be overridden
* if arguments are directly passed into the loop. Custom plugins should always
* pass their parameters directly to the loop.
*/
$user_id = false;
$include = false;
$exclude = false;
$in = false;
$show_hidden = false;
$object = false;
$primary_id = false;
// User filtering
if ( !empty( $bp->displayed_user->id ) )
$user_id = $bp->displayed_user->id;
// Group filtering
if ( !empty( $bp->groups->current_group ) ) {
$object = $bp->groups->id;
$primary_id = $bp->groups->current_group->id;
if ( 'public' != $bp->groups->current_group->status && ( groups_is_user_member( $bp->loggedin_user->id, $bp->groups->current_group->id ) || $bp->loggedin_user->is_super_admin ) )
$show_hidden = true;
}
// The default scope should recognize custom slugs
if ( array_key_exists( $bp->current_action, (array)$bp->loaded_components ) ) {
$scope = $bp->loaded_components[$bp->current_action];
}
else
$scope = bp_current_action();
// Support for permalinks on single item pages: /groups/my-group/activity/124/
if ( bp_is_current_action( bp_get_activity_slug() ) )
$include = bp_action_variable( 0 );
// Note: any params used for filtering can be a single value, or multiple values comma separated.
$defaults = array(
'display_comments' => 'threaded', // false for none, stream/threaded - show comments in the stream or threaded under items
'include' => $include, // pass an activity_id or string of IDs comma-separated
'exclude' => $exclude, // pass an activity_id or string of IDs comma-separated
'in' => $in, // comma-separated list or array of activity IDs among which to search
'sort' => 'DESC', // sort DESC or ASC
'page' => 1, // which page to load
'per_page' => 20, // number of items per page
'max' => false, // max number to return
'show_hidden' => $show_hidden, // Show activity items that are hidden site-wide?
// Scope - pre-built activity filters for a user (friends/groups/favorites/mentions)
'scope' => $scope,
// Filtering
'user_id' => $user_id, // user_id to filter on
'object' => $object, // object to filter on e.g. groups, profile, status, friends
'action' => false, // action to filter on e.g. activity_update, new_forum_post, profile_updated
'primary_id' => $primary_id, // object ID to filter on e.g. a group_id or forum_id or blog_id etc.
'secondary_id' => false, // secondary object ID to filter on e.g. a post_id
// Searching
'search_terms' => false // specify terms to search on
);
$r = wp_parse_args( $args, $defaults );
extract( $r );
// If you have passed a "scope" then this will override any filters you have passed.
if ( 'just-me' == $scope || 'friends' == $scope || 'groups' == $scope || 'favorites' == $scope || 'mentions' == $scope ) {
if ( 'just-me' == $scope )
$display_comments = 'stream';
// determine which user_id applies
if ( empty( $user_id ) )
$user_id = ( !empty( $bp->displayed_user->id ) ) ? $bp->displayed_user->id : $bp->loggedin_user->id;
// are we displaying user specific activity?
if ( is_numeric( $user_id ) ) {
$show_hidden = ( $user_id == $bp->loggedin_user->id && $scope != 'friends' ) ? 1 : 0;
switch ( $scope ) {
case 'friends':
if ( bp_is_active( 'friends' ) )
$friends = friends_get_friend_user_ids( $user_id );
if ( empty( $friends ) )
return false;
$user_id = implode( ',', (array)$friends );
break;
case 'groups':
if ( bp_is_active( 'groups' ) ) {
$groups = groups_get_user_groups( $user_id );
if ( empty( $groups['groups'] ) )
return false;
$object = $bp->groups->id;
$primary_id = implode( ',', (array)$groups['groups'] );
$user_id = 0;
}
break;
case 'favorites':
$favs = bp_activity_get_user_favorites( $user_id );
if ( empty( $favs ) )
return false;
$include = implode( ',', (array)$favs );
$display_comments = true;
break;
case 'mentions':
$user_nicename = ( !empty( $bp->displayed_user->id ) ) ? $bp->displayed_user->userdata->user_nicename : $bp->loggedin_user->userdata->user_nicename;
$user_login = ( !empty( $bp->displayed_user->id ) ) ? $bp->displayed_user->userdata->user_login : $bp->loggedin_user->userdata->user_login;
$search_terms = '@' . bp_core_get_username( $user_id, $user_nicename, $user_login ) . '<'; // Start search at @ symbol and stop search at closing tag delimiter.
$display_comments = 'stream';
$user_id = 0;
break;
}
}
}
// Do not exceed the maximum per page
if ( !empty( $max ) && ( (int)$per_page > (int)$max ) )
$per_page = $max;
// Support for basic filters in earlier BP versions.
if ( isset( $_GET['afilter'] ) )
$filter = array( 'object' => $_GET['afilter'] );
else if ( !empty( $user_id ) || !empty( $object ) || !empty( $action ) || !empty( $primary_id ) || !empty( $secondary_id ) )
$filter = array( 'user_id' => $user_id, 'object' => $object, 'action' => $action, 'primary_id' => $primary_id, 'secondary_id' => $secondary_id );
else
$filter = false;
$activities_template = new BP_Activity_Template( $page, $per_page, $max, $include, $sort, $filter, $search_terms, $display_comments, $show_hidden, $exclude, $in );
return apply_filters( 'bp_has_activities', $activities_template->has_activities(), $activities_template );
}
/**
* Determines if there are still activities left in the loop.
*
* @since 1.0.0
*
* @global object $activities_template {@link BP_Activity_Template}
* @uses BP_Activity_Template::user_activities() {@link BP_Activity_Template::user_activities()}
*
* @return bool Returns true when activities are found
*/
function bp_activities() {
global $activities_template;
return $activities_template->user_activities();
}
/**
* Gets the current activity object in the loop
*
* @since 1.0.0
*
* @global object $activities_template {@link BP_Activity_Template}
* @uses BP_Activity_Template::the_activity() {@link BP_Activity_Template::the_activity()}
*
* @return object The current activity within the loop
*/
function bp_the_activity() {
global $activities_template;
return $activities_template->the_activity();
}
/**
* Outputs the activity pagination count
*
* @since 1.0.0
*
* @global object $activities_template {@link BP_Activity_Template}
* @uses BP_Activity_Template::the_activity() {@link BP_Activity_Template::the_activity()}
*/
function bp_activity_pagination_count() {
echo bp_get_activity_pagination_count();
}
/**
* Returns the activity pagination count
*
* @since 1.2.0
*
* @global object $bp BuddyPress global settings
* @global object $activities_template {@link BP_Activity_Template}
* @uses bp_core_number_format()
*
* @return string The pagination text
*/
function bp_get_activity_pagination_count() {
global $bp, $activities_template;
$start_num = intval( ( $activities_template->pag_page - 1 ) * $activities_template->pag_num ) + 1;
$from_num = bp_core_number_format( $start_num );
$to_num = bp_core_number_format( ( $start_num + ( $activities_template->pag_num - 1 ) > $activities_template->total_activity_count ) ? $activities_template->total_activity_count : $start_num + ( $activities_template->pag_num - 1 ) );
$total = bp_core_number_format( $activities_template->total_activity_count );
return sprintf( __( 'Viewing item %1$s to %2$s (of %3$s items)', 'buddypress' ), $from_num, $to_num, $total );
}
/**
* Outputs the activity pagination links
*
* @since 1.0.0
*
* @uses bp_get_activity_pagination_links()
*/
function bp_activity_pagination_links() {
echo bp_get_activity_pagination_links();
}
/**
* Outputs the activity pagination links
*
* @since 1.0.0
*
* @global object $activities_template {@link BP_Activity_Template}
* @uses apply_filters() To call the 'bp_get_activity_pagination_links' hook
*
* @return string The pagination links
*/
function bp_get_activity_pagination_links() {
global $activities_template;
return apply_filters( 'bp_get_activity_pagination_links', $activities_template->pag_links );
}
/**
* Returns true when there are more activity items to be shown than currently appear
*
* @since 1.5.0
*
* @global object $activities_template {@link BP_Activity_Template}
* @uses apply_filters() To call the 'bp_activity_has_more_items' hook
*
* @return bool $has_more_items True if more items, false if not
*/
function bp_activity_has_more_items() {
global $activities_template;
$remaining_pages = floor( ( $activities_template->total_activity_count - 1 ) / ( $activities_template->pag_num * $activities_template->pag_page ) );
$has_more_items = (int)$remaining_pages ? true : false;
return apply_filters( 'bp_activity_has_more_items', $has_more_items );
}
/**
* Outputs the activity count
*
* @since 1.2.0
*
* @uses bp_get_activity_count()
*/
function bp_activity_count() {
echo bp_get_activity_count();
}
/**
* Returns the activity count
*
* @since 1.2.0
*
* @global object $activities_template {@link BP_Activity_Template}
* @uses apply_filters() To call the 'bp_get_activity_count' hook
*
* @return int The activity count
*/
function bp_get_activity_count() {
global $activities_template;
return apply_filters( 'bp_get_activity_count', (int)$activities_template->activity_count );
}
/**
* Outputs the number of activities per page
*
* @since 1.2.0
*
* @uses bp_get_activity_per_page()
*/
function bp_activity_per_page() {
echo bp_get_activity_per_page();
}
/**
* Returns the number of activities per page
*
* @since 1.2.0
*
* @global object $activities_template {@link BP_Activity_Template}
* @uses apply_filters() To call the 'bp_get_activity_per_page' hook
*
* @return int The activities per page
*/
function bp_get_activity_per_page() {
global $activities_template;
return apply_filters( 'bp_get_activity_per_page', (int)$activities_template->pag_num );
}
/**
* Outputs the activities title
*
* @since 1.0.0
*
* @uses bp_get_activities_title()
*/
function bp_activities_title() {
global $bp_activity_title;
echo bp_get_activities_title();
}
/**
* Returns the activities title
*
* @since 1.0.0
*
* @global string $bp_activity_title
* @uses apply_filters() To call the 'bp_get_activities_title' hook
*
* @return int The activities title
*/
function bp_get_activities_title() {
global $bp_activity_title;
return apply_filters( 'bp_get_activities_title', $bp_activity_title );
}
/**
* {@internal Missing Description}
*
* @since 1.0.0
*
* @uses bp_get_activities_no_activity()
*/
function bp_activities_no_activity() {
global $bp_activity_no_activity;
echo bp_get_activities_no_activity();
}
/**
* {@internal Missing Description}
*
* @since 1.0.0
*
* @global string $bp_activity_no_activity
* @uses apply_filters() To call the 'bp_get_activities_no_activity' hook
*
* @return unknown_type
*/
function bp_get_activities_no_activity() {
global $bp_activity_no_activity;
return apply_filters( 'bp_get_activities_no_activity', $bp_activity_no_activity );
}
/**
* Outputs the activity id
*
* @since 1.2.0
*
* @uses bp_get_activity_id()
*/
function bp_activity_id() {
echo bp_get_activity_id();
}
/**
* Returns the activity id
*
* @since 1.2.0
*
* @global object $activities_template {@link BP_Activity_Template}
* @uses apply_filters() To call the 'bp_get_activity_id' hook
*
* @return int The activity id
*/
function bp_get_activity_id() {
global $activities_template;
return apply_filters( 'bp_get_activity_id', $activities_template->activity->id );
}
/**
* Outputs the activity item id
*
* @since 1.2.0
*
* @uses bp_get_activity_item_id()
*/
function bp_activity_item_id() {
echo bp_get_activity_item_id();
}
/**
* Returns the activity item id
*
* @since 1.2.0
*
* @global object $activities_template {@link BP_Activity_Template}
* @uses apply_filters() To call the 'bp_get_activity_item_id' hook
*
* @return int The activity item id
*/
function bp_get_activity_item_id() {
global $activities_template;
return apply_filters( 'bp_get_activity_item_id', $activities_template->activity->item_id );
}
/**
* Outputs the activity secondary item id
*
* @since 1.2.0
*
* @uses bp_get_activity_secondary_item_id()
*/
function bp_activity_secondary_item_id() {
echo bp_get_activity_secondary_item_id();
}
/**
* Returns the activity secondary item id
*
* @since 1.2.0
*
* @global object $activities_template {@link BP_Activity_Template}
* @uses apply_filters() To call the 'bp_get_activity_secondary_item_id' hook
*
* @return int The activity secondary item id
*/
function bp_get_activity_secondary_item_id() {
global $activities_template;
return apply_filters( 'bp_get_activity_secondary_item_id', $activities_template->activity->secondary_item_id );
}
/**
* Outputs the date the activity was recorded
*
* @since 1.2.0
*
* @uses bp_get_activity_date_recorded()
*/
function bp_activity_date_recorded() {
echo bp_get_activity_date_recorded();
}
/**
* Returns the date the activity was recorded
*
* @since 1.2.0
*
* @global object $activities_template {@link BP_Activity_Template}
* @uses apply_filters() To call the 'bp_get_activity_date_recorded' hook
*
* @return string The date the activity was recorded
*/
function bp_get_activity_date_recorded() {
global $activities_template;
return apply_filters( 'bp_get_activity_date_recorded', $activities_template->activity->date_recorded );
}
/**
* Outputs the activity object name
*
* @since 1.2.0
*
* @uses bp_get_activity_object_name()
*/
function bp_activity_object_name() {
echo bp_get_activity_object_name();
}
/**
* Returns the activity object name
*
* @since 1.2.0
*
* @global object $activities_template {@link BP_Activity_Template}
* @uses apply_filters() To call the 'bp_get_activity_object_name' hook
*
* @return string The activity object name
*/
function bp_get_activity_object_name() {
global $activities_template;
return apply_filters( 'bp_get_activity_object_name', $activities_template->activity->component );
}
/**
* Outputs the activity type
*
* @since 1.2.0
*
* @uses bp_get_activity_type()
*/
function bp_activity_type() {
echo bp_get_activity_type();
}
/**
* Returns the activity type
*
* @since 1.2.0
*
* @global object $activities_template {@link BP_Activity_Template}
* @uses apply_filters() To call the 'bp_get_activity_type' hook
*
* @return string The activity type
*/
function bp_get_activity_type() {
global $activities_template;
return apply_filters( 'bp_get_activity_type', $activities_template->activity->type );
}
/**
* Outputs the activity action name
*
* Just a wrapper for bp_activity_type()
*
* @since 1.2.0
* @deprecated 1.5.0
*
* @todo Properly deprecate in favor of bp_activity_type() and
* remove redundant echo
*
* @uses bp_activity_type()
*/
function bp_activity_action_name() { echo bp_activity_type(); }
/**
* Returns the activity type
*
* Just a wrapper for bp_get_activity_type()
*
* @since 1.2.0
* @deprecated 1.5.0
*
* @todo Properly deprecate in favor of bp_get_activity_type()
*
* @uses bp_get_activity_type()
*
* @return string The activity type
*/
function bp_get_activity_action_name() { return bp_get_activity_type(); }
/**
* Outputs the activity user id
*
* @since 1.1.0
*
* @uses bp_get_activity_user_id()
*/
function bp_activity_user_id() {
echo bp_get_activity_user_id();
}
/**
* Returns the activity user id
*
* @since 1.1.0
*
* @global object $activities_template {@link BP_Activity_Template}
* @uses apply_filters() To call the 'bp_get_activity_user_id' hook
*
* @return int The activity user id
*/
function bp_get_activity_user_id() {
global $activities_template;
return apply_filters( 'bp_get_activity_user_id', $activities_template->activity->user_id );
}
/**
* Outputs the activity user link
*
* @since 1.2.0
*
* @uses bp_get_activity_user_link()
*/
function bp_activity_user_link() {
echo bp_get_activity_user_link();
}
/**
* Returns the activity user link
*
* @since 1.2.0
*
* @global object $activities_template {@link BP_Activity_Template}
* @uses bp_core_get_user_domain()
* @uses apply_filters() To call the 'bp_get_activity_user_link' hook
*
* @return string $link The activity user link
*/
function bp_get_activity_user_link() {
global $activities_template;
if ( empty( $activities_template->activity->user_id ) )
$link = $activities_template->activity->primary_link;
else
$link = bp_core_get_user_domain( $activities_template->activity->user_id, $activities_template->activity->user_nicename, $activities_template->activity->user_login );
return apply_filters( 'bp_get_activity_user_link', $link );
}
/**
* Output the avatar of the user that performed the action
*
* @since 1.1.0
*
* @param array $args
*
* @uses bp_get_activity_avatar()
*/
function bp_activity_avatar( $args = '' ) {
echo bp_get_activity_avatar( $args );
}
/**
* Return the avatar of the user that performed the action
*
* @since 1.1.0
*
* @param array $args optional
*
* @global object $activities_template {@link BP_Activity_Template}
* @global object $bp BuddyPress global settings
* @uses bp_is_single_activity()
* @uses wp_parse_args()
* @uses apply_filters() To call the 'bp_get_activity_avatar_object_' . $current_activity_item->component hook
* @uses apply_filters() To call the 'bp_get_activity_avatar_item_id' hook
* @uses bp_core_fetch_avatar()
* @uses apply_filters() To call the 'bp_get_activity_avatar' hook
*
* @return string User avatar
*/
function bp_get_activity_avatar( $args = '' ) {
global $activities_template, $bp;
// On activity permalink pages, default to the full-size avatar
$type_default = bp_is_single_activity() ? 'full' : 'thumb';
$defaults = array(
'alt' => __( 'Profile picture of %s', 'buddypress' ),
'class' => 'avatar',
'email' => false,
'type' => $type_default,
'user_id' => false
);
$r = wp_parse_args( $args, $defaults );
extract( $r, EXTR_SKIP );
if ( !isset( $height ) && !isset( $width ) ) {
// Backpat
if ( isset( $bp->avatar->full->height ) || isset( $bp->avatar->thumb->height ) ) {
$height = ( 'full' == $type ) ? $bp->avatar->full->height : $bp->avatar->thumb->height;
} else {
$height = 20;
}
// Backpat
if ( isset( $bp->avatar->full->width ) || isset( $bp->avatar->thumb->width ) ) {
$width = ( 'full' == $type ) ? $bp->avatar->full->width : $bp->avatar->thumb->width;
} else {
$width = 20;
}
}
// Within the loop, we the current activity should be set first to the
// current_comment, if available
$current_activity_item = isset( $activities_template->activity->current_comment ) ? $activities_template->activity->current_comment : $activities_template->activity;
// Primary activity avatar is always a user, but can be modified via a filter
$object = apply_filters( 'bp_get_activity_avatar_object_' . $current_activity_item->component, 'user' );
$item_id = $user_id ? $user_id : $current_activity_item->user_id;
$item_id = apply_filters( 'bp_get_activity_avatar_item_id', $item_id );
// If this is a user object pass the users' email address for Gravatar so we don't have to refetch it.
if ( 'user' == $object && empty( $user_id ) && empty( $email ) && isset( $activities_template->activity->user_email ) )
$email = $current_activity_item->user_email;
return apply_filters( 'bp_get_activity_avatar', bp_core_fetch_avatar( array( 'item_id' => $item_id, 'object' => $object, 'type' => $type, 'alt' => $alt, 'class' => $class, 'width' => $width, 'height' => $height, 'email' => $email ) ) );
}
/**
* Output the avatar of the object that action was performed on
*
* @since 1.2.0
*
* @param array $args optional
*
* @uses bp_get_activity_secondary_avatar()
*/
function bp_activity_secondary_avatar( $args = '' ) {
echo bp_get_activity_secondary_avatar( $args );
}
/**
* Return the avatar of the object that action was performed on
*
* @since 1.2.0
*
* @param array $args optional
*
* @global object $bp BuddyPress global settings
* @global object $activities_template {@link BP_Activity_Template}
* @uses wp_parse_args()
* @uses get_blog_option()
* @uses apply_filters() To call the 'bp_get_activity_secondary_avatar_object_' . $activities_template->activity->component hook
* @uses apply_filters() To call the 'bp_get_activity_secondary_avatar_item_id' hook
* @uses bp_core_fetch_avatar()
* @uses apply_filters() To call the 'bp_get_activity_secondary_avatar' hook
*
* @return string The secondary avatar
*/
function bp_get_activity_secondary_avatar( $args = '' ) {
global $bp, $activities_template;
$defaults = array(
'type' => 'thumb',
'width' => 20,
'height' => 20,
'class' => 'avatar',
'email' => false
);
$r = wp_parse_args( $args, $defaults );
extract( $r, EXTR_SKIP );
// Set item_id and object (default to user)
switch ( $activities_template->activity->component ) {
case 'groups' :
$object = 'group';
$item_id = $activities_template->activity->item_id;
if ( empty( $alt ) )
$alt = __( 'Group logo of %s', 'buddypress' );
break;
case 'blogs' :
$object = 'blog';
$item_id = $activities_template->activity->item_id;
if ( !$alt )
$alt = sprintf( __( 'Site authored by %s', 'buddypress' ), get_blog_option( $item_id, 'blogname' ) );
break;
case 'friends' :
$object = 'user';
$item_id = $activities_template->activity->secondary_item_id;
if ( empty( $alt ) )
$alt = __( 'Profile picture of %s', 'buddypress' );
break;
default :
$object = 'user';
$item_id = $activities_template->activity->user_id;
$email = $activities_template->activity->user_email;
if ( !$alt )
$alt = __( 'Profile picture of %s', 'buddypress' );
break;
}
// Allow object and item_id to be filtered
$object = apply_filters( 'bp_get_activity_secondary_avatar_object_' . $activities_template->activity->component, $object );
$item_id = apply_filters( 'bp_get_activity_secondary_avatar_item_id', $item_id );
// If we have no item_id or object, there is no avatar to display
if ( empty( $item_id ) || empty( $object ) )
return false;
return apply_filters( 'bp_get_activity_secondary_avatar', bp_core_fetch_avatar( array( 'item_id' => $item_id, 'object' => $object, 'type' => $type, 'alt' => $alt, 'class' => $class, 'width' => $width, 'height' => $height, 'email' => $email ) ) );
}
/**
* Output the activity action
*
* @since 1.2.0
*
* @uses bp_get_activity_action()
*/
function bp_activity_action() {
echo bp_get_activity_action();
}
/**
* Return the activity action
*
* @since 1.2.0
*
* @global object $activities_template {@link BP_Activity_Template}
* @uses apply_filters_ref_array() To call the 'bp_get_activity_action_pre_meta' hook
* @uses bp_insert_activity_meta()
* @uses apply_filters_ref_array() To call the 'bp_get_activity_action' hook
*
* @return string The activity action
*/
function bp_get_activity_action() {
global $activities_template;
$action = $activities_template->activity->action;
$action = apply_filters_ref_array( 'bp_get_activity_action_pre_meta', array( $action, &$activities_template->activity ) );
if ( !empty( $action ) )
$action = bp_insert_activity_meta( $action );
return apply_filters_ref_array( 'bp_get_activity_action', array( $action, &$activities_template->activity ) );
}
/**
* Output the activity content body
*
* @since 1.2.0
*
* @uses bp_get_activity_content_body()
*/
function bp_activity_content_body() {
echo bp_get_activity_content_body();
}
/**
* Return the activity content body
*
* @since 1.2.0
*
* @global object $activities_template {@link BP_Activity_Template}
* @uses bp_insert_activity_meta()
* @uses apply_filters_ref_array() To call the 'bp_get_activity_content_body' hook
*
* @return string The activity content body
*/
function bp_get_activity_content_body() {
global $activities_template;
// Backwards compatibility if action is not being used
if ( empty( $activities_template->activity->action ) && !empty( $activities_template->activity->content ) )
$activities_template->activity->content = bp_insert_activity_meta( $activities_template->activity->content );
return apply_filters_ref_array( 'bp_get_activity_content_body', array( $activities_template->activity->content, &$activities_template->activity ) );
}
/**
* Does the activity have content?
*
* @since 1.2.0
*
* @global object $activities_template {@link BP_Activity_Template}
*
* @return bool True if activity has content, false otherwise
*/
function bp_activity_has_content() {
global $activities_template;
if ( !empty( $activities_template->activity->content ) )
return true;
return false;
}
/**
* Output the activity content
*
* @since 1.0.0
* @deprecated 1.5.0
*
* @todo properly deprecate this function
*
* @uses bp_get_activity_content()
*/
function bp_activity_content() {
echo bp_get_activity_content();
}
/**
* Return the activity content
*
* @since 1.0.0
* @deprecated 1.5.0
*
* @todo properly deprecate this function
*
* @global object $activities_template {@link BP_Activity_Template}
* @uses bp_get_activity_action()
* @uses bp_get_activity_content_body()
* @uses apply_filters() To call the 'bp_get_activity_content' hook
*
* @return string The activity content
*/
function bp_get_activity_content() {
global $activities_template;
/**
* If you want to filter activity update content, please use
* the filter 'bp_get_activity_content_body'
*
* This function is mainly for backwards comptibility.
*/
$content = bp_get_activity_action() . ' ' . bp_get_activity_content_body();
return apply_filters( 'bp_get_activity_content', $content );
}
/**
* Insert activity meta
*
* @since 1.2.0
*
* @param string $content
*
* @global object $activities_template {@link BP_Activity_Template}
* @global object $bp BuddyPress global settings
* @uses bp_core_time_since()
* @uses apply_filters_ref_array() To call the 'bp_activity_time_since' hook
* @uses bp_is_single_activity()
* @uses bp_activity_get_permalink()
* @uses esc_attr__()
* @uses apply_filters_ref_array() To call the 'bp_activity_permalink' hook
* @uses apply_filters() To call the 'bp_insert_activity_meta' hook
*
* @return string The activity content
*/
function bp_insert_activity_meta( $content ) {
global $activities_template, $bp;
// Strip any legacy time since placeholders from BP 1.0-1.1
$content = str_replace( '%s', '', $content );
// Insert the time since.
$time_since = apply_filters_ref_array( 'bp_activity_time_since', array( '' . bp_core_time_since( $activities_template->activity->date_recorded ) . '', &$activities_template->activity ) );
// Insert the permalink
if ( !bp_is_single_activity() )
$content = apply_filters_ref_array( 'bp_activity_permalink', array( sprintf( '%1$s %4$s', $content, bp_activity_get_permalink( $activities_template->activity->id, $activities_template->activity ), esc_attr__( 'View Discussion', 'buddypress' ), $time_since ), &$activities_template->activity ) );
else
$content .= str_pad( $time_since, strlen( $time_since ) + 2, ' ', STR_PAD_BOTH );
return apply_filters( 'bp_insert_activity_meta', $content );
}
/**
* Determine if the current user can delete an activity item
*
* @since 1.2.0
*
* @param object $activity Optional
*
* @global object $activities_template {@link BP_Activity_Template}
* @global object $bp BuddyPress global settings
* @uses apply_filters() To call the 'bp_activity_user_can_delete' hook
*
* @return bool True if can delete, false otherwise
*/
function bp_activity_user_can_delete( $activity = false ) {
global $activities_template, $bp;
if ( !$activity )
$activity = $activities_template->activity;
if ( isset( $activity->current_comment ) )
$activity = $activity->current_comment;
$can_delete = false;
if ( $bp->loggedin_user->is_super_admin )
$can_delete = true;
if ( $activity->user_id == $bp->loggedin_user->id )
$can_delete = true;
if ( $bp->is_item_admin && $bp->is_single_item )
$can_delete = true;
return apply_filters( 'bp_activity_user_can_delete', $can_delete );
}
/**
* Output the activity parent content
*
* @since 1.2.0
*
* @param array $args Optional
*
* @uses bp_get_activity_parent_content()
*/
function bp_activity_parent_content( $args = '' ) {
echo bp_get_activity_parent_content($args);
}
/**
* Return the activity content
*
* @since 1.2.0
*
* @param array $args Optional
*
* @global object $bp BuddyPress global settings
* @global object $activities_template {@link BP_Activity_Template}
* @uses wp_parse_args()
* @uses apply_filters() To call the 'bp_get_activity_parent_content' hook
*
* @return mixed False on failure, otherwise the activity parent content
*/
function bp_get_activity_parent_content( $args = '' ) {
global $bp, $activities_template;
$defaults = array(
'hide_user' => false
);
$r = wp_parse_args( $args, $defaults );
extract( $r, EXTR_SKIP );
// Get the ID of the parent activity content
if ( !$parent_id = $activities_template->activity->item_id )
return false;
// Get the content of the parent
if ( empty( $activities_template->activity_parents[$parent_id] ) )
return false;
if ( empty( $activities_template->activity_parents[$parent_id]->content ) )
$content = $activities_template->activity_parents[$parent_id]->action;
else
$content = $activities_template->activity_parents[$parent_id]->action . ' ' . $activities_template->activity_parents[$parent_id]->content;
// Remove the time since content for backwards compatibility
$content = str_replace( '%s', '', $content );
// Remove images
$content = preg_replace( '/]*>/Ui', '', $content );
return apply_filters( 'bp_get_activity_parent_content', $content );
}
/**
* Output whether or not the current activity is in a current user's favorites
*
* @since 1.2.0
*
* @uses bp_get_activity_is_favorite()
*/
function bp_activity_is_favorite() {
echo bp_get_activity_is_favorite();
}
/**
* Return whether or not the current activity is in a current user's favorites
*
* @since 1.2.0
*
* @global object $bp BuddyPress global settings
* @global object $activities_template {@link BP_Activity_Template}
* @uses apply_filters() To call the 'bp_get_activity_is_favorite' hook
*
* @return bool True if user favorite, false otherwise
*/
function bp_get_activity_is_favorite() {
global $bp, $activities_template;
return apply_filters( 'bp_get_activity_is_favorite', in_array( $activities_template->activity->id, (array)$activities_template->my_favs ) );
}
/**
* Echoes the comment markup for an activity item
*
* @since 1.2.0
*
* @todo deprecate $args param
*
* @param string $args Unused. Appears to be left over from an earlier implementation.
*/
function bp_activity_comments( $args = '' ) {
echo bp_activity_get_comments( $args );
}
/**
* Gets the comment markup for an activity item
*
* @since 1.2.0
*
* @todo deprecate $args param
*
* @todo Given that checks for children already happen in bp_activity_recurse_comments(),
* this function can probably be streamlined or removed.
*
* @param string $args Unused. Appears to be left over from an earlier implementation.
*
* @global object $activities_template {@link BP_Activity_Template}
* @global object $bp BuddyPress global settings
* @uses bp_activity_recurse_comments()
*/
function bp_activity_get_comments( $args = '' ) {
global $activities_template, $bp;
if ( !isset( $activities_template->activity->children ) || !$activities_template->activity->children )
return false;
bp_activity_recurse_comments( $activities_template->activity );
}
/**
* Loops through a level of activity comments and loads the template for each
*
* Note: The recursion itself used to happen entirely in this function. Now it is
* split between here and the comment.php template.
*
* @since 1.2.0
*
* @todo remove $counter global
*
* @param object $comment The activity object currently being recursed
*
* @global object $activities_template {@link BP_Activity_Template}
* @global object $bp BuddyPress global settings
* @uses locate_template()
*/
function bp_activity_recurse_comments( $comment ) {
global $activities_template, $bp, $counter;
if ( !$comment )
return false;
if ( empty( $comment->children ) )
return false;
echo '
';
foreach ( (array)$comment->children as $comment_child ) {
// Put the comment into the global so it's available to filters
$activities_template->activity->current_comment = $comment_child;
$template = locate_template( 'activity/comment.php', false, false );
// Backward compatibility. In older versions of BP, the markup was
// generated in the PHP instead of a template. This ensures that
// older themes (which are not children of bp-default and won't
// have the new template) will still work.
if ( !$template ) {
$template = BP_PLUGIN_DIR . '/bp-themes/bp-default/activity/comment.php';
}
load_template( $template, false );
unset( $activities_template->activity->current_comment );
}
echo '
';
}
/**
* Utility function that returns the comment currently being recursed
*
* @since 1.5.0
*
* @global object $activities_template {@link BP_Activity_Template}
* @uses apply_filters() To call the 'bp_activity_current_comment' hook
*
* @return object|bool $current_comment The activity comment currently being displayed. False on failure
*/
function bp_activity_current_comment() {
global $activities_template;
$current_comment = !empty( $activities_template->activity->current_comment ) ? $activities_template->activity->current_comment : false;
return apply_filters( 'bp_activity_current_comment', $current_comment );
}
/**
* Echoes the id of the activity comment currently being displayed
*
* @since 1.5.0
*
* @uses bp_get_activity_comment_id()
*/
function bp_activity_comment_id() {
echo bp_get_activity_comment_id();
}
/**
* Gets the id of the activity comment currently being displayed
*
* @since 1.5.0
*
* @global object $activities_template {@link BP_Activity_Template}
* @uses apply_filters() To call the 'bp_activity_comment_id' hook
*
* @return int $comment_id The id of the activity comment currently being displayed
*/
function bp_get_activity_comment_id() {
global $activities_template;
$comment_id = isset( $activities_template->activity->current_comment->id ) ? $activities_template->activity->current_comment->id : false;
return apply_filters( 'bp_activity_comment_id', $comment_id );
}
/**
* Echoes the user_id of the author of the activity comment currently being displayed
*
* @since 1.5.0
*
* @uses bp_get_activity_comment_user_id()
*/
function bp_activity_comment_user_id() {
echo bp_get_activity_comment_user_id();
}
/**
* Gets the user_id of the author of the activity comment currently being displayed
*
* @since 1.5.0
*
* @global object $activities_template {@link BP_Activity_Template}
* @uses apply_filters() To call the 'bp_activity_comment_user_id' hook
*
* @return int|bool $user_id The user_id of the author of the displayed activity comment. False on failure
*/
function bp_get_activity_comment_user_id() {
global $activities_template;
$user_id = isset( $activities_template->activity->current_comment->user_id ) ? $activities_template->activity->current_comment->user_id : false;
return apply_filters( 'bp_activity_comment_user_id', $user_id );
}
/**
* Echoes the author link for the activity comment currently being displayed
*
* @since 1.5.0
*
* @uses bp_get_activity_comment_user_link()
*/
function bp_activity_comment_user_link() {
echo bp_get_activity_comment_user_link();
}
/**
* Gets the author link for the activity comment currently being displayed
*
* @since 1.5.0
*
* @uses bp_core_get_user_domain()
* @uses bp_get_activity_comment_user_id()
* @uses apply_filters() To call the 'bp_activity_comment_user_link' hook
*
* @return string $user_link The URL of the activity comment author's profile
*/
function bp_get_activity_comment_user_link() {
$user_link = bp_core_get_user_domain( bp_get_activity_comment_user_id() );
return apply_filters( 'bp_activity_comment_user_link', $user_link );
}
/**
* Echoes the author name for the activity comment currently being displayed
*
* @since 1.5.0
*
* @uses bp_get_activity_comment_name()
*/
function bp_activity_comment_name() {
echo bp_get_activity_comment_name();
}
/**
* Gets the author name for the activity comment currently being displayed
*
* The use of the bp_acomment_name filter is deprecated. Please use bp_activity_comment_name
*
* @since 1.5.0
*
* @global object $activities_template {@link BP_Activity_Template}
* @uses apply_filters() To call the 'bp_acomment_name' hook
* @uses apply_filters() To call the 'bp_activity_comment_name' hook
*
* @return string $name The full name of the activity comment author
*/
function bp_get_activity_comment_name() {
global $activities_template;
$name = apply_filters( 'bp_acomment_name', $activities_template->activity->current_comment->user_fullname, $activities_template->activity->current_comment ); // backward compatibility
return apply_filters( 'bp_activity_comment_name', $name );
}
/**
* Echoes the date_recorded of the activity comment currently being displayed
*
* @since 1.5.0
*
* @uses bp_get_activity_comment_date_recorded()
*/
function bp_activity_comment_date_recorded() {
echo bp_get_activity_comment_date_recorded();
}
/**
* Gets the date_recorded for the activity comment currently being displayed
*
* @since 1.5.0
*
* @global object $activities_template {@link BP_Activity_Template}
* @uses bp_core_time_since()
* @uses apply_filters() To call the 'bp_activity_comment_date_recorded' hook
*
* @return string|bool $date_recorded Time since the activity was recorded, of the form "%s ago". False on failure
*/
function bp_get_activity_comment_date_recorded() {
global $activities_template;
if ( empty( $activities_template->activity->current_comment->date_recorded ) )
return false;
$date_recorded = bp_core_time_since( $activities_template->activity->current_comment->date_recorded );
return apply_filters( 'bp_activity_comment_date_recorded', $date_recorded );
}
/**
* Echoes the 'delete' URL for the activity comment currently being displayed
*
* @since 1.5.0
*
* @uses bp_get_activity_comment_delete_link()
*/
function bp_activity_comment_delete_link() {
echo bp_get_activity_comment_delete_link();
}
/**
* Gets the 'delete' URL for the activity comment currently being displayed
*
* @since 1.5.0
*
* @global object $bp BuddyPress global settings
* @uses wp_nonce_url()
* @uses bp_get_root_domain()
* @uses bp_get_activity_slug()
* @uses bp_get_activity_comment_id()
* @uses apply_filters() To call the 'bp_activity_comment_delete_link' hook
*
* @return string $link The nonced URL for deleting the current activity comment
*/
function bp_get_activity_comment_delete_link() {
global $bp;
$link = wp_nonce_url( bp_get_root_domain() . '/' . bp_get_activity_slug() . '/delete/?cid=' . bp_get_activity_comment_id(), 'bp_activity_delete_link' );
return apply_filters( 'bp_activity_comment_delete_link', $link );
}
/**
* Echoes the content of the activity comment currently being displayed
*
* @since 1.5.0
*
* @uses bp_get_activity_comment_content()
*/
function bp_activity_comment_content() {
echo bp_get_activity_comment_content();
}
/**
* Gets the content of the activity comment currently being displayed
*
* The content is run through two filters. bp_get_activity_content will apply all filters
* applied to activity items in general. Use bp_activity_comment_content to modify the
* content of activity comments only.
*
* @since 1.5.0
*
* @global object $activities_template {@link BP_Activity_Template}
* @uses apply_filters() To call the 'bp_get_activity_content' hook
* @uses apply_filters() To call the 'bp_activity_comment_content' hook
*
* @return string $content The content of the current activity comment
*/
function bp_get_activity_comment_content() {
global $activities_template;
$content = apply_filters( 'bp_get_activity_content', $activities_template->activity->current_comment->content );
return apply_filters( 'bp_activity_comment_content', $content );
}
/**
* Echoes the activity comment count
*
* @since 1.2.0
*
* @uses bp_activity_get_comment_count()
*/
function bp_activity_comment_count() {
echo bp_activity_get_comment_count();
}
/**
* Gets the content of the activity comment currently being displayed
*
* The content is run through two filters. bp_get_activity_content will apply all filters
* applied to activity items in general. Use bp_activity_comment_content to modify the
* content of activity comments only.
*
* @since 1.2.0
*
* @todo deprecate $args
*
* @global object $activities_template {@link BP_Activity_Template}
* @global object $bp BuddyPress global settings
* @uses bp_activity_recurse_comment_count()
* @uses apply_filters() To call the 'bp_activity_get_comment_count' hook
*
* @return int $count The activity comment count. Defaults to zero
*/
function bp_activity_get_comment_count( $args = '' ) {
global $activities_template, $bp;
if ( !isset( $activities_template->activity->children ) || !$activities_template->activity->children )
return 0;
$count = bp_activity_recurse_comment_count( $activities_template->activity );
return apply_filters( 'bp_activity_get_comment_count', (int)$count );
}
/**
* Gets the content of the activity comment currently being displayed
*
* The content is run through two filters. bp_get_activity_content will apply all filters
* applied to activity items in general. Use bp_activity_comment_content to modify the
* content of activity comments only.
*
* @since 1.2.0
*
* @todo investigate why bp_activity_recurse_comment_count() is used while being declared
*
* @param object $comment Activity comments object
*
* @global object $activities_template {@link BP_Activity_Template}
* @global object $bp BuddyPress global settings
* @uses bp_activity_recurse_comment_count()
* @uses apply_filters() To call the 'bp_activity_get_comment_count' hook
*
* @return int $count The activity comment count.
*/
function bp_activity_recurse_comment_count( $comment, $count = 0 ) {
global $activities_template, $bp;
if ( !$comment->children )
return $count;
foreach ( (array)$comment->children as $comment ) {
$count++;
$count = bp_activity_recurse_comment_count( $comment, $count );
}
return $count;
}
/**
* Echoes the activity comment link
*
* @since 1.2.0
*
* @uses bp_get_activity_comment_link()
*/
function bp_activity_comment_link() {
echo bp_get_activity_comment_link();
}
/**
* Gets the activity comment link
*
* @since 1.2.0
*
* @global object $activities_template {@link BP_Activity_Template}
* @uses apply_filters() To call the 'bp_get_activity_comment_link' hook
*
* @return string The activity comment link
*/
function bp_get_activity_comment_link() {
global $activities_template;
return apply_filters( 'bp_get_activity_comment_link', '?ac=' . $activities_template->activity->id . '/#ac-form-' . $activities_template->activity->id );
}
/**
* Echoes the activity comment form no javascript display CSS
*
* @since 1.2.0
*
* @uses bp_get_activity_comment_form_nojs_display()
*/
function bp_activity_comment_form_nojs_display() {
echo bp_get_activity_comment_form_nojs_display();
}
/**
* Gets the activity comment form no javascript display CSS
*
* @since 1.2.0
*
* @global object $activities_template {@link BP_Activity_Template}
*
* @return string|bool The activity comment form no javascript display CSS. False on failure
*/
function bp_get_activity_comment_form_nojs_display() {
global $activities_template;
if ( isset( $_GET['ac'] ) && $_GET['ac'] == $activities_template->activity->id . '/' )
return 'style="display: block"';
return false;
}
/**
* Echoes the activity comment form action
*
* @since 1.2.0
*
* @uses bp_get_activity_comment_form_action()
*/
function bp_activity_comment_form_action() {
echo bp_get_activity_comment_form_action();
}
/**
* Gets the activity comment form action
*
* @since 1.2.0
*
* @global object $bp BuddyPress global settings
* @uses home_url()
* @uses bp_get_activity_root_slug()
* @uses apply_filters() To call the 'bp_get_activity_comment_form_action' hook
*
* @return string The activity comment form action
*/
function bp_get_activity_comment_form_action() {
global $bp;
return apply_filters( 'bp_get_activity_comment_form_action', home_url( bp_get_activity_root_slug() . '/reply/' ) );
}
/**
* Echoes the activity permalink id
*
* @since 1.2.0
*
* @uses bp_get_activity_permalink_id()
*/
function bp_activity_permalink_id() {
echo bp_get_activity_permalink_id();
}
/**
* Gets the activity permalink id
*
* @since 1.2.0
*
* @global object $bp BuddyPress global settings
* @uses apply_filters() To call the 'bp_get_activity_permalink_id' hook
*
* @return string The activity permalink id
*/
function bp_get_activity_permalink_id() {
global $bp;
return apply_filters( 'bp_get_activity_permalink_id', $bp->current_action );
}
/**
* Echoes the activity thread permalink
*
* @since 1.2.0
*
* @uses bp_get_activity_permalink_id()
*/
function bp_activity_thread_permalink() {
echo bp_get_activity_thread_permalink();
}
/**
* Gets the activity thread permalink
*
* @since 1.2.0
*
* @global object $bp BuddyPress global settings
* @uses bp_activity_get_permalink()
* @uses apply_filters() To call the 'bp_get_activity_thread_permalink' hook
*
* @return string $link The activity thread permalink
*/
function bp_get_activity_thread_permalink() {
global $bp, $activities_template;
$link = bp_activity_get_permalink( $activities_template->activity->id, $activities_template->activity );
return apply_filters( 'bp_get_activity_thread_permalink', $link );
}
/**
* Echoes the activity favorite link
*
* @since 1.2.0
*
* @uses bp_get_activity_favorite_link()
*/
function bp_activity_favorite_link() {
echo bp_get_activity_favorite_link();
}
/**
* Gets the activity favorite link
*
* @since 1.2.0
*
* @global object $bp BuddyPress global settings
* @global object $activities_template {@link BP_Activity_Template}
* @uses wp_nonce_url()
* @uses home_url()
* @uses bp_get_activity_root_slug()
* @uses apply_filters() To call the 'bp_get_activity_favorite_link' hook
*
* @return string The activity favorite link
*/
function bp_get_activity_favorite_link() {
global $bp, $activities_template;
return apply_filters( 'bp_get_activity_favorite_link', wp_nonce_url( home_url( bp_get_activity_root_slug() . '/favorite/' . $activities_template->activity->id . '/' ), 'mark_favorite' ) );
}
/**
* Echoes the activity unfavorite link
*
* @since 1.2.0
*
* @uses bp_get_activity_unfavorite_link()
*/
function bp_activity_unfavorite_link() {
echo bp_get_activity_unfavorite_link();
}
/**
* Gets the activity unfavorite link
*
* @since 1.2.0
*
* @global object $bp BuddyPress global settings
* @global object $activities_template {@link BP_Activity_Template}
* @uses wp_nonce_url()
* @uses home_url()
* @uses bp_get_activity_root_slug()
* @uses apply_filters() To call the 'bp_get_activity_unfavorite_link' hook
*
* @return string The activity unfavorite link
*/
function bp_get_activity_unfavorite_link() {
global $bp, $activities_template;
return apply_filters( 'bp_get_activity_unfavorite_link', wp_nonce_url( home_url( bp_get_activity_root_slug() . '/unfavorite/' . $activities_template->activity->id . '/' ), 'unmark_favorite' ) );
}
/**
* Echoes the activity CSS class
*
* @since 1.0.0
*
* @uses bp_get_activity_css_class()
*/
function bp_activity_css_class() {
echo bp_get_activity_css_class();
}
/**
* Gets the activity CSS class
*
* @since 1.0.0
*
* @global object $activities_template {@link BP_Activity_Template}
* @uses apply_filters() To call the 'bp_activity_mini_activity_types' hook
* @uses bp_activity_get_comment_count()
* @uses bp_activity_can_comment()
* @uses apply_filters() To call the 'bp_get_activity_css_class' hook
*
* @return string The activity css class
*/
function bp_get_activity_css_class() {
global $activities_template;
$mini_activity_actions = apply_filters( 'bp_activity_mini_activity_types', array(
'friendship_accepted',
'friendship_created',
'new_blog',
'joined_group',
'created_group',
'new_member'
) );
$class = '';
if ( in_array( $activities_template->activity->type, (array)$mini_activity_actions ) || empty( $activities_template->activity->content ) )
$class = ' mini';
if ( bp_activity_get_comment_count() && bp_activity_can_comment() )
$class .= ' has-comments';
return apply_filters( 'bp_get_activity_css_class', $activities_template->activity->component . ' ' . $activities_template->activity->type . $class );
}
/**
* Display the activity delete link.
*
* @since 1.1.0
*
* @uses bp_get_activity_delete_link()
*/
function bp_activity_delete_link() {
echo bp_get_activity_delete_link();
}
/**
* Return the activity delete link.
*
* @since 1.1.0
*
* @global object $activities_template {@link BP_Activity_Template}
* @global object $bp BuddyPress global settings
* @uses bp_get_root_domain()
* @uses bp_get_activity_root_slug()
* @uses bp_is_activity_component()
* @uses bp_current_action()
* @uses add_query_arg()
* @uses wp_get_referer()
* @uses wp_nonce_url()
* @uses apply_filters() To call the 'bp_get_activity_delete_link' hook
*
* @return string $link Activity delete link. Contains $redirect_to arg if on single activity page.
*/
function bp_get_activity_delete_link() {
global $activities_template, $bp;
$url = bp_get_root_domain() . '/' . bp_get_activity_root_slug() . '/delete/' . $activities_template->activity->id;
$class = 'delete-activity';
// Determine if we're on a single activity page, and customize accordingly
if ( bp_is_activity_component() && is_numeric( bp_current_action() ) ) {
$url = add_query_arg( array( 'redirect_to' => wp_get_referer() ), $url );
$class = 'delete-activity-single';
}
$link = '' . __( 'Delete', 'buddypress' ) . '';
return apply_filters( 'bp_get_activity_delete_link', $link );
}
/**
* Display the activity latest update link.
*
* @since 1.2.0
*
* @param int $user_id Defaults to 0
*
* @uses bp_get_activity_latest_update()
*/
function bp_activity_latest_update( $user_id = 0 ) {
echo bp_get_activity_latest_update( $user_id );
}
/**
* Return the activity latest update link.
*
* @since 1.2.0
*
* @param int $user_id Defaults to 0
*
* @global object $bp BuddyPress global settings
* @uses bp_core_is_user_spammer()
* @uses bp_core_is_user_deleted()
* @uses bp_get_user_meta()
* @uses apply_filters() To call the 'bp_get_activity_latest_update_excerpt' hook
* @uses bp_create_excerpt()
* @uses bp_get_root_domain()
* @uses bp_get_activity_root_slug()
* @uses apply_filters() To call the 'bp_get_activity_latest_update' hook
*
* @return string|bool $latest_update The activity latest update link. False on failure
*/
function bp_get_activity_latest_update( $user_id = 0 ) {
global $bp;
if ( !$user_id )
$user_id = $bp->displayed_user->id;
if ( bp_core_is_user_spammer( $user_id ) || bp_core_is_user_deleted( $user_id ) )
return false;
if ( !$update = bp_get_user_meta( $user_id, 'bp_latest_update', true ) )
return false;
$latest_update = apply_filters( 'bp_get_activity_latest_update_excerpt', trim( strip_tags( bp_create_excerpt( $update['content'], 358 ) ) ) );
$latest_update .= ' ' . __( 'View', 'buddypress' ) . '';
return apply_filters( 'bp_get_activity_latest_update', $latest_update );
}
/**
* Display the activity filter links.
*
* @since 1.1.0
*
* @param array $args Defaults to false
*
* @uses bp_get_activity_filter_links()
*/
function bp_activity_filter_links( $args = false ) {
echo bp_get_activity_filter_links( $args );
}
/**
* Return the activity filter links.
*
* @since 1.1.0
*
* @param array $args Defaults to false
*
* @global object $activities_template {@link BP_Activity_Template}
* @global object $bp BuddyPress global settings
* @uses wp_parse_args()
* @uses BP_Activity_Activity::get_recorded_components() {@link BP_Activity_Activity}
* @uses esc_attr()
* @uses add_query_arg()
* @uses remove_query_arg()
* @uses apply_filters() To call the 'bp_get_activity_filter_link_href' hook
* @uses apply_filters() To call the 'bp_get_activity_filter_links' hook
*
* @return string|bool $component_links The activity filter links. False on failure
*/
function bp_get_activity_filter_links( $args = false ) {
global $activities_template, $bp;
$defaults = array(
'style' => 'list'
);
$r = wp_parse_args( $args, $defaults );
extract( $r, EXTR_SKIP );
// Fetch the names of components that have activity recorded in the DB
$components = BP_Activity_Activity::get_recorded_components();
if ( !$components )
return false;
foreach ( (array) $components as $component ) {
/* Skip the activity comment filter */
if ( 'activity' == $component )
continue;
if ( isset( $_GET['afilter'] ) && $component == $_GET['afilter'] )
$selected = ' class="selected"';
else
unset($selected);
$component = esc_attr( $component );
switch ( $style ) {
case 'list':
$tag = 'li';
$before = '
';
$after = '
';
break;
case 'paragraph':
$tag = 'p';
$before = '
';
$after = '
';
break;
case 'span':
$tag = 'span';
$before = '';
$after = '';
break;
}
$link = add_query_arg( 'afilter', $component );
$link = remove_query_arg( 'acpage' , $link );
$link = apply_filters( 'bp_get_activity_filter_link_href', $link, $component );
// Make sure all core internal component names are translatable
$translatable_components = array( __( 'xprofile', 'buddypress'), __( 'friends', 'buddypress' ), __( 'groups', 'buddypress' ), __( 'status', 'buddypress' ), __( 'sites', 'buddypress' ) );
$component_links[] = $before . '' . ucwords( __( $component, 'buddypress' ) ) . '' . $after;
}
$link = remove_query_arg( 'afilter' , $link );
if ( isset( $_GET['afilter'] ) )
$component_links[] = '<' . $tag . ' id="afilter-clear">' . __( 'Clear Filter', 'buddypress' ) . '';
return apply_filters( 'bp_get_activity_filter_links', implode( "\n", $component_links ) );
}
/**
* Determine if a comment can be made on an activity item
*
* @since 1.2.0
*
* @global object $activities_template {@link BP_Activity_Template}
* @global object $bp BuddyPress global settings
* @uses bp_get_activity_action_name()
* @uses apply_filters() To call the 'bp_activity_can_comment' hook
*
* @return bool $can_comment Defaults to true
*/
function bp_activity_can_comment() {
global $activities_template, $bp;
$can_comment = true;
if ( false === $activities_template->disable_blogforum_replies || (int)$activities_template->disable_blogforum_replies ) {
if ( 'new_blog_post' == bp_get_activity_action_name() || 'new_blog_comment' == bp_get_activity_action_name() || 'new_forum_topic' == bp_get_activity_action_name() || 'new_forum_post' == bp_get_activity_action_name() )
$can_comment = false;
}
if ( 'activity_comment' == bp_get_activity_action_name() )
$can_comment = false;
return apply_filters( 'bp_activity_can_comment', $can_comment );
}
/**
* Determine if a comment can be made on an activity reply item
*
* @since 1.5.0
*
* @param object $comment Activity comment
*
* @uses apply_filters() To call the 'bp_activity_can_comment_reply' hook
*
* @return bool $can_comment Defaults to true
*/
function bp_activity_can_comment_reply( $comment ) {
$can_comment = true;
return apply_filters( 'bp_activity_can_comment_reply', $can_comment, $comment );
}
/**
* Determine if an favorites are allowed
*
* @since 1.5.0
*
* @uses apply_filters() To call the 'bp_activity_can_favorite' hook
*
* @return bool $can_favorite Defaults to true
*/
function bp_activity_can_favorite() {
$can_favorite = true;
return apply_filters( 'bp_activity_can_favorite', $can_favorite );
}
/**
* Echoes the total favorite count for a specified user
*
* @since 1.2.0
*
* @param int $user_id Defaults to 0
*
* @uses bp_get_total_favorite_count_for_user()
*/
function bp_total_favorite_count_for_user( $user_id = 0 ) {
echo bp_get_total_favorite_count_for_user( $user_id );
}
/**
* Returns the total favorite count for a specified user
*
* @since 1.2.0
*
* @param int $user_id Defaults to 0
*
* @uses bp_activity_total_favorites_for_user()
* @uses apply_filters() To call the 'bp_get_total_favorite_count_for_user' hook
*
* @return int The total favorite count for a specified user
*/
function bp_get_total_favorite_count_for_user( $user_id = 0 ) {
return apply_filters( 'bp_get_total_favorite_count_for_user', bp_activity_total_favorites_for_user( $user_id ) );
}
/**
* Echoes the total mention count for a specified user
*
* @since 1.2.0
*
* @param int $user_id Defaults to 0
*
* @uses bp_get_total_favorite_count_for_user()
*/
function bp_total_mention_count_for_user( $user_id = 0 ) {
echo bp_get_total_favorite_count_for_user( $user_id );
}
/**
* Returns the total mention count for a specified user
*
* @since 1.2.0
*
* @todo remove unnecessary $bp global
*
* @param int $user_id Defaults to 0
*
* @uses bp_get_user_meta()
* @uses apply_filters() To call the 'bp_get_total_mention_count_for_user' hook
*
* @return int The total mention count for a specified user
*/
function bp_get_total_mention_count_for_user( $user_id = 0 ) {
global $bp;
return apply_filters( 'bp_get_total_mention_count_for_user', bp_get_user_meta( $user_id, 'bp_new_mention_count', true ) );
}
/**
* Echoes the public message link for displayed user
*
* @since 1.2.0
*
* @uses bp_get_send_public_message_link()
*/
function bp_send_public_message_link() {
echo bp_get_send_public_message_link();
}
/**
* Returns the public message link for displayed user
*
* @since 1.2.0
*
* @global object $bp BuddyPress global settings
* @uses bp_is_my_profile()
* @uses is_user_logged_in()
* @uses wp_nonce_url()
* @uses bp_loggedin_user_domain()
* @uses bp_get_activity_slug()
* @uses bp_core_get_username()
* @uses apply_filters() To call the 'bp_get_send_public_message_link' hook
*
* @return string The public message link for displayed user
*/
function bp_get_send_public_message_link() {
global $bp;
if ( bp_is_my_profile() || !is_user_logged_in() )
return false;
return apply_filters( 'bp_get_send_public_message_link', wp_nonce_url( bp_loggedin_user_domain() . bp_get_activity_slug() . '/?r=' . bp_core_get_username( $bp->displayed_user->id, $bp->displayed_user->userdata->user_nicename, $bp->displayed_user->userdata->user_login ) ) );
}
/**
* Echoes the mentioned user display name
*
* @since 1.2.0
*
* @param int|string User id or username
*
* @uses bp_get_mentioned_user_display_name()
*/
function bp_mentioned_user_display_name( $user_id_or_username ) {
echo bp_get_mentioned_user_display_name( $user_id_or_username );
}
/**
* Returns the mentioned user display name
*
* @since 1.2.0
*
* @param int|string User id or username
*
* @uses bp_core_get_user_displayname()
* @uses apply_filters() To call the 'bp_get_mentioned_user_display_name' hook
*
* @return string The mentioned user display name
*/
function bp_get_mentioned_user_display_name( $user_id_or_username ) {
if ( !$name = bp_core_get_user_displayname( $user_id_or_username ) )
$name = __( 'a user', 'buddypress' );
return apply_filters( 'bp_get_mentioned_user_display_name', $name, $user_id_or_username );
}
/**
* Output button for sending a public message
*
* @since 1.2.0
*
* @param array $args Optional
*
* @uses bp_get_send_public_message_button()
*/
function bp_send_public_message_button( $args = '' ) {
echo bp_get_send_public_message_button( $args );
}
/**
* Return button for sending a public message
*
* @since 1.2.0
*
* @param array $args Optional
*
* @uses bp_get_send_public_message_link()
* @uses wp_parse_args()
* @uses bp_get_button()
* @uses apply_filters() To call the 'bp_get_send_public_message_button' hook
*
* @return string The button for sending a public message
*/
function bp_get_send_public_message_button( $args = '' ) {
$defaults = array(
'id' => 'public_message',
'component' => 'activity',
'must_be_logged_in' => true,
'block_self' => true,
'wrapper_id' => 'post-mention',
'link_href' => bp_get_send_public_message_link(),
'link_title' => __( 'Send a public message on your activity stream.', 'buddypress' ),
'link_text' => __( 'Public Message', 'buddypress' ),
'link_class' => 'activity-button mention'
);
$button = wp_parse_args( $args, $defaults );
// Filter and return the HTML button
return bp_get_button( apply_filters( 'bp_get_send_public_message_button', $button ) );
}
/**
* Outputs the activity post form action
*
* @since 1.2.0
*
* @uses bp_get_activity_post_form_action()
*/
function bp_activity_post_form_action() {
echo bp_get_activity_post_form_action();
}
/**
* Returns the activity post form action
*
* @since 1.2.0
*
* @uses home_url()
* @uses bp_get_activity_root_slug()
* @uses apply_filters() To call the 'bp_get_activity_post_form_action' hook
*
* @return string The activity post form action
*/
function bp_get_activity_post_form_action() {
return apply_filters( 'bp_get_activity_post_form_action', home_url( bp_get_activity_root_slug() . '/post/' ) );
}
/* RSS Feed Template Tags ****************************************************/
/**
* Outputs the sitewide activity feed link
*
* @since 1.0.0
*
* @uses bp_get_sitewide_activity_feed_link()
*/
function bp_sitewide_activity_feed_link() {
echo bp_get_sitewide_activity_feed_link();
}
/**
* Returns the sitewide activity feed link
*
* @since 1.0.0
*
* @uses home_url()
* @uses bp_get_activity_root_slug()
* @uses apply_filters() To call the 'bp_get_sitewide_activity_feed_link' hook
*
* @return string The sitewide activity feed link
*/
function bp_get_sitewide_activity_feed_link() {
return apply_filters( 'bp_get_sitewide_activity_feed_link', bp_get_root_domain() . '/' . bp_get_activity_root_slug() . '/feed/' );
}
/**
* Outputs the member activity feed link
*
* @since 1.2.0
*
* @uses bp_get_member_activity_feed_link()
*/
function bp_member_activity_feed_link() {
echo bp_get_member_activity_feed_link();
}
/**
* Outputs the member activity feed link
*
* @since 1.0.0
* @deprecated 1.2.0
*
* @todo properly deprecated in favor of bp_member_activity_feed_link()
*
* @uses bp_get_member_activity_feed_link()
*/
function bp_activities_member_rss_link() { echo bp_get_member_activity_feed_link(); }
/**
* Returns the member activity feed link
*
* @since 1.2.0
*
* @uses bp_is_profile_component()
* @uses bp_is_current_action()
* @uses bp_displayed_user_domain()
* @uses bp_get_activity_slug()
* @uses bp_is_active()
* @uses bp_get_friends_slug()
* @uses bp_get_groups_slug()
* @uses apply_filters() To call the 'bp_get_activities_member_rss_link' hook
*
* @return string $link The member activity feed link
*/
function bp_get_member_activity_feed_link() {
global $bp;
if ( bp_is_profile_component() || bp_is_current_action( 'just-me' ) )
$link = bp_displayed_user_domain() . bp_get_activity_slug() . '/feed/';
elseif ( bp_is_active( 'friends' ) && bp_is_current_action( bp_get_friends_slug() ) )
$link = bp_displayed_user_domain() . bp_get_activity_slug() . '/' . bp_get_friends_slug() . '/feed/';
elseif ( bp_is_active( 'groups' ) && bp_is_current_action( bp_get_groups_slug() ) )
$link = bp_displayed_user_domain() . bp_get_activity_slug() . '/' . bp_get_groups_slug() . '/feed/';
elseif ( 'favorites' == $bp->current_action )
$link = bp_displayed_user_domain() . bp_get_activity_slug() . '/favorites/feed/';
elseif ( 'mentions' == $bp->current_action )
$link = bp_displayed_user_domain() . bp_get_activity_slug() . '/mentions/feed/';
else
$link = '';
return apply_filters( 'bp_get_activities_member_rss_link', $link );
}
/**
* Returns the member activity feed link
*
* @since 1.0.0
* @deprecated 1.2.0
*
* @todo properly deprecated in favor of bp_get_member_activity_feed_link()
*
* @uses bp_get_member_activity_feed_link()
*
* @return string The member activity feed link
*/
function bp_get_activities_member_rss_link() { return bp_get_member_activity_feed_link(); }
/** Template tags for RSS feed output ****************************************/
/**
* Outputs the activity feed item guid
*
* @since 1.0.0
*
* @uses bp_activity_feed_item_guid()
*/
function bp_activity_feed_item_guid() {
echo bp_get_activity_feed_item_guid();
}
/**
* Returns the activity feed item guid
*
* @since 1.2.0
*
* @global object $activities_template {@link BP_Activity_Template}
* @uses apply_filters() To call the 'bp_get_activity_feed_item_guid' hook
*
* @return string The activity feed item guid
*/
function bp_get_activity_feed_item_guid() {
global $activities_template;
return apply_filters( 'bp_get_activity_feed_item_guid', md5( $activities_template->activity->date_recorded . '-' . $activities_template->activity->content ) );
}
/**
* Outputs the activity feed item title
*
* @since 1.0.0
*
* @uses bp_get_activity_feed_item_title()
*/
function bp_activity_feed_item_title() {
echo bp_get_activity_feed_item_title();
}
/**
* Returns the activity feed item title
*
* @since 1.0.0
*
* @global object $activities_template {@link BP_Activity_Template}
* @uses ent2ncr()
* @uses convert_chars()
* @uses bp_create_excerpt()
* @uses apply_filters() To call the 'bp_get_activity_feed_item_title' hook
*
* @return string $title The activity feed item title
*/
function bp_get_activity_feed_item_title() {
global $activities_template;
if ( !empty( $activities_template->activity->action ) )
$content = $activities_template->activity->action;
else
$content = $activities_template->activity->content;
$content = explode( 'activity->type )
$title .= ': ' . strip_tags( ent2ncr( trim( convert_chars( bp_create_excerpt( $activities_template->activity->content, 70, array( 'ending' => " […]" ) ) ) ) ) );
return apply_filters( 'bp_get_activity_feed_item_title', $title );
}
/**
* Outputs the activity feed item link
*
* @since 1.0.0
*
* @uses bp_get_activity_feed_item_link()
*/
function bp_activity_feed_item_link() {
echo bp_get_activity_feed_item_link();
}
/**
* Returns the activity feed item link
*
* @since 1.0.0
*
* @global object $activities_template {@link BP_Activity_Template}
* @uses apply_filters() To call the 'bp_get_activity_feed_item_link' hook
*
* @return string The activity feed item link
*/
function bp_get_activity_feed_item_link() {
global $activities_template;
return apply_filters( 'bp_get_activity_feed_item_link', $activities_template->activity->primary_link );
}
/**
* Outputs the activity feed item date
*
* @since 1.0.0
*
* @uses bp_get_activity_feed_item_date()
*/
function bp_activity_feed_item_date() {
echo bp_get_activity_feed_item_date();
}
/**
* Returns the activity feed item date
*
* @since 1.0.0
*
* @global object $activities_template {@link BP_Activity_Template}
* @uses apply_filters() To call the 'bp_get_activity_feed_item_date' hook
*
* @return string The activity feed item date
*/
function bp_get_activity_feed_item_date() {
global $activities_template;
return apply_filters( 'bp_get_activity_feed_item_date', $activities_template->activity->date_recorded );
}
/**
* Outputs the activity feed item description
*
* @since 1.0.0
*
* @uses bp_get_activity_feed_item_description()
*/
function bp_activity_feed_item_description() {
echo bp_get_activity_feed_item_description();
}
/**
* Returns the activity feed item description
*
* @since 1.0.0
*
* @global object $activities_template {@link BP_Activity_Template}
* @uses ent2ncr()
* @uses convert_chars()
* @uses apply_filters() To call the 'bp_get_activity_feed_item_description' hook
*
* @return string The activity feed item description
*/
function bp_get_activity_feed_item_description() {
global $activities_template;
if ( empty( $activities_template->activity->action ) )
$content = $activities_template->activity->content;
else
$content = $activities_template->activity->action . ' ' . $activities_template->activity->content;
return apply_filters( 'bp_get_activity_feed_item_description', ent2ncr( convert_chars( str_replace( '%s', '', $content ) ) ) );
}
/**
* Template tag so we can hook activity feed to
*
* @since 1.5.0
*
* @uses bloginfo()
* @uses bp_sitewide_activity_feed_link()
*/
function bp_activity_sitewide_feed() {
?>