bp_activity_get_meta( int $activity_id, string $meta_key = '', bool $single = true )
Get metadata for a given activity item.
Description Description
Parameters Parameters
- $activity_id
-
(Required) ID of the activity item whose metadata is being requested.
- $meta_key
-
(Optional) If present, only the metadata matching that meta key will be returned. Otherwise, all metadata for the activity item will be fetched.
Default value: ''
- $single
-
(Optional) If true, return only the first value of the specified meta_key. This parameter has no effect if meta_key is not specified. Default: true.
Default value: true
Return Return
(mixed) The meta value(s) being requested.
Source Source
File: bp-activity/bp-activity-functions.php
function bp_activity_get_meta( $activity_id = 0, $meta_key = '', $single = true ) {
add_filter( 'query', 'bp_filter_metaid_column_name' );
$retval = get_metadata( 'activity', $activity_id, $meta_key, $single );
remove_filter( 'query', 'bp_filter_metaid_column_name' );
/**
* Filters the metadata for a specified activity item.
*
* @since 1.5.0
*
* @param mixed $retval The meta values for the activity item.
* @param int $activity_id ID of the activity item.
* @param string $meta_key Meta key for the value being requested.
* @param bool $single Whether to return one matched meta key row or all.
*/
return apply_filters( 'bp_activity_get_meta', $retval, $activity_id, $meta_key, $single );
}
Changelog Changelog
| Version | Description |
|---|---|
| 1.2.0 | Introduced. |