bp_media_get_specific( array|string $args = '' )

Fetch specific media items.

Description

See also

Parameters

$args

(Optional) All arguments and defaults are shared with BP_Media::get(), except for the following:

  • 'Single'
    (string|int|array) media ID, comma-separated list of IDs, or array of IDs.

Default value: ''

Return

(array) $activity See BP_Media::get() for description.

Source

File: bp-media/bp-media-functions.php

334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
function bp_media_get_specific( $args = '' ) {
 
    $r = bp_parse_args( $args, array(
        'media_ids'         => false,      // A single media_id or array of IDs.
        'max'               => false,      // Maximum number of results to return.
        'page'              => 1,          // Page 1 without a per_page will result in no pagination.
        'per_page'          => false,      // Results per page.
        'sort'              => 'DESC',     // Sort ASC or DESC
        'order_by'          => false,     // Sort ASC or DESC
    ), 'media_get_specific' );
 
    $get_args = array(
        'in'                => $r['media_ids'],
        'max'               => $r['max'],
        'page'              => $r['page'],
        'per_page'          => $r['per_page'],
        'sort'              => $r['sort'],
        'order_by'          => $r['order_by'],
    );
 
    /**
     * Filters the requested specific media item.
     *
     * @since BuddyBoss
     *
     * @param BP_Media      $media    Requested media object.
     * @param array         $args     Original passed in arguments.
     * @param array         $get_args Constructed arguments used with request.
     */
    return apply_filters( 'bp_media_get_specific', BP_Media::get( $get_args ), $args, $get_args );
}

Changelog

Changelog
Version Description
BuddyBoss 1.0.0 Introduced.

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.