bp_has_activities( array|string $args = '' )

Parameters

$args

(Optional) Arguments for limiting the contents of the activity loop. Most arguments are in the same format as BP_Activity_Activity::get(). However, because the format of the arguments accepted here differs in a number of ways, and because bp_has_activities() determines some default arguments in a dynamic fashion, we list all accepted arguments here as well. Arguments can be passed as an associative array, or as a URL querystring (eg, 'user_id=4&display_comments=threaded').

• 'page'
  (int) Which page of results to fetch. Using page=1 without per_page will result in no pagination. Default: 1.
• 'per_page'
  (int|bool) Number of results per page. Default: 20.
• 'page_arg'
  (string) String used as a query parameter in pagination links. Default: 'acpage'.
• 'max'
  (int|bool) Maximum number of results to return. Default: false (unlimited).
• 'fields'
  (string) Activity fields to retrieve. 'all' to fetch entire activity objects, 'ids' to get only the activity IDs. Default 'all'.
• 'count_total'
  (string|bool) If true, an additional DB query is run to count the total activity items for the query. Default: false.
• 'sort'
  (string) 'ASC' or 'DESC'. Default: 'DESC'.
• 'exclude'
  (array|bool) Array of activity IDs to exclude. Default: false.
• 'in'
  (array|bool) Array of IDs to limit query by (IN). 'in' is intended to be used in conjunction with other filter parameters. Default: false.
• 'include'
  (array|bool) Array of exact activity IDs to query. Providing an 'include' array will override all other filters passed in the argument array. When viewing the permalink page for a single activity item, this value defaults to the ID of that item. Otherwise the default is false.
• 'meta_query'
  (array) Limit by activitymeta by passing an array of meta_query conditions. See WP_Meta_Query::queries for a description of the syntax.
• 'date_query'
  (array) Limit by date by passing an array of date_query conditions. See first parameter of WP_Date_Query::__construct() for syntax.
• 'filter_query'
  (array) Advanced activity filtering. See BP_Activity_Query::__construct().
• 'search_terms'
  (string) Limit results by a search term. Default: false.
• 'scope'
  (string) Use a BuddyPress pre-built filter. - 'just-me' retrieves items belonging only to a user; this is equivalent to passing a 'user_id' argument. - 'friends' retrieves items belonging to the friends of a user. - 'groups' retrieves items belonging to groups to which a user belongs to. - 'favorites' retrieves a user's favorited activity items. - 'mentions' retrieves items where a user has received an @-mention. The default value of 'scope' is set to one of the above if that value appears in the appropriate place in the URL; eg, 'scope' will be 'groups' when visiting <a href="http://example.com/members/joe/activity/groups/">http://example.com/members/joe/activity/groups/</a>. Otherwise defaults to false.
• 'user_id'
  (int|array|bool) The ID(s) of user(s) whose activity should be fetched. Pass a single ID or an array of IDs. When viewing a user profile page (but not that user's activity subpages, ie My Connections, My Groups, etc), 'user_id' defaults to the ID of the displayed user. Otherwise the default is false.
• 'object'
  (string|array|bool) Filters by the component column in the database, which is generally the component ID in the case of BuddyPress components, or the plugin slug in the case of plugins. For example, 'groups' will limit results to those that are associated with the BP Groups component. Accepts a single component string, or an array of multiple components. Defaults to 'groups' when viewing the page of a single group, the My Groups activity filter, or the Activity > Groups filter of a user profile. Otherwise defaults to false.
• 'action'
  (string|array|bool) Filters by the type column in the database, which is a string categorizing the activity item (eg, 'new_blog_post', 'created_group'). Accepts a comma-delimited string or an array of types. Default: false.
• 'primary_id'
  (int|array|bool) Filters by the item_id column in the database. The meaning of 'primary_id' differs between components/types; for example, in the case of 'created_group', 'primary_id' is the ID of the group. Accepts a single ID, or an array of multiple IDs. When viewing a single group, defaults to the current group ID. When viewing a user's Groups stream page, defaults to the IDs of the user's groups. Otherwise defaults to false.
• 'secondary_id'
  (int|array|bool) Filters by the secondary_item_id column in the database. The meaning of 'secondary_id' differs between components/types. Accepts a single ID, or an array of multiple IDs. Defaults to false.
• 'offset'
  (int) Return only activity items with an ID greater than or equal to this one. Note that providing an offset will disable pagination. Default: false.
• 'display_comments'
  (string|bool) How to handle activity comments. Possible values: - 'threaded' - comments appear in a threaded tree, under their parent items. - 'stream' - the activity feed is presented in a flat manner, with comments sorted in chronological order alongside other activity items. - false - don't fetch activity comments at all. Default: 'threaded'.
• 'show_hidden'
  (bool) Whether to show items marked hide_sitewide. Defaults to false, except in the following cases: - User is viewing his own activity feed. - User is viewing the activity feed of a non-public group of which he is a member.
• 'spam'
  (string|bool) Spam status. 'ham_only', 'spam_only', or false to show all activity regardless of spam status. Default: 'ham_only'.
• 'populate_extras'
  (bool) Whether to pre-fetch the activity metadata for the queried items. Default: true.

Default value: ''