bp_media_user_can_delete( int|BP_Media $media = false )

Determine if the current user can delete an media item.

Description

Parameters

$media

(Optional) BP_Media object or ID of the media

Default value: false

Return

(bool) True if can delete, false otherwise.

Source

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

function bp_media_user_can_delete( $media = false ) {
 
    // Assume the user cannot delete the media item.
    $can_delete = false;
 
    if ( empty( $media ) ) {
        return $can_delete;
    }
 
    if ( ! is_object( $media ) ) {
        $media = new BP_Media( $media );
    }
 
    if ( empty( $media ) ) {
        return $can_delete;
    }
 
    // Only logged in users can delete media.
    if ( is_user_logged_in() ) {
 
        // Community moderators can always delete media (at least for now).
        if ( bp_current_user_can( 'bp_moderate' ) ) {
            $can_delete = true;
        }
 
        // Users are allowed to delete their own media.
        if ( isset( $media->user_id ) && ( $media->user_id === bp_loggedin_user_id() ) ) {
            $can_delete = true;
        }
 
        if ( bp_is_active( 'groups' ) && $media->group_id > 0 ) {
            $manage   = groups_can_user_manage_document( bp_loggedin_user_id(), $media->group_id );
            $status   = bp_group_get_media_status( $media->group_id );
            $is_admin = groups_is_user_admin( bp_loggedin_user_id(), $media->group_id );
            $is_mod   = groups_is_user_mod( bp_loggedin_user_id(), $media->group_id );
            if ( $manage ) {
                if ( $media->user_id === bp_loggedin_user_id() ) {
                    $can_delete = true;
                } elseif ( 'members' === $status && ( $is_mod || $is_admin ) ) {
                    $can_delete = true;
                } elseif ( 'mods' == $status && ( $is_mod || $is_admin ) ) {
                    $can_delete = true;
                } elseif ( 'admins' == $status && $is_admin ) {
                    $can_delete = true;
                }
            }
        }
    }
 
    /**
     * Filters whether the current user can delete an media item.
     *
     * @since BuddyBoss 1.2.0
     *
     * @param bool   $can_delete Whether the user can delete the item.
     * @param object $media   Current media item object.
     */
    return (bool) apply_filters( 'bp_media_user_can_delete', $can_delete, $media );
}

Expand full source code Collapse full source code

Changelog

Changelog
Version	Description
BuddyBoss 1.2.0	Introduced.

Uses

Uses
Uses	Description
bp-media/bp-media-template.php: bp_media_user_can_delete	Filters whether the current user can delete an media item.
bp-groups/bp-groups-functions.php: groups_can_user_manage_document()	Check whether a user is allowed to manage document in a given group.
bp-media/classes/class-bp-media.php: BP_Media::__construct()	Constructor method.
bp-groups/bp-groups-functions.php: groups_is_user_admin()	Check whether a user is an admin of a given group.
bp-groups/bp-groups-functions.php: groups_is_user_mod()	Check whether a user is a mod of a given group.
bp-groups/bp-groups-template.php: bp_group_get_media_status()	Get the media status of a group.
bp-core/bp-core-template.php: bp_is_active()	Check whether a given component (or feature of a component) is active.
bp-core/bp-core-template.php: bp_loggedin_user_id()	Get the ID of the currently logged-in user.
bp-core/bp-core-caps.php: bp_current_user_can()	Check whether the current user has a given capability.

Show 4 more uses Hide more uses

Used By
Used By	Description
bp-media/classes/class-bp-rest-media-endpoint.php: BP_REST_Media_Endpoint::update_item_permissions_check()	Check if a given request has access to update a media.
bp-media/classes/class-bp-rest-media-endpoint.php: BP_REST_Media_Endpoint::delete_items()	Delete multiple medias.
bp-media/classes/class-bp-rest-media-endpoint.php: BP_REST_Media_Endpoint::delete_item()	Delete a single media.
bp-media/classes/class-bp-rest-media-endpoint.php: BP_REST_Media_Endpoint::delete_item_permissions_check()	Checks if a given request has access to for the user.
bp-templates/bp-nouveau/includes/media/ajax.php: bp_nouveau_ajax_media_delete()	Delete media

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