bp_album_user_can_delete( int|BP_Media_Album $album = false )

Determine if the current user can delete an album item.

Description

Parameters

$album

(Optional) BP_Media_Album object or ID of the album

Default value: false

Return

(bool) True if can delete, false otherwise.

Source

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

function bp_album_user_can_delete( $album = false ) {
 
    // Assume the user cannot delete the album item.
    $can_delete = false;
 
    if ( empty( $album ) ) {
        return $can_delete;
    }
 
    if ( ! is_object( $album ) ) {
        $album = new BP_Media_Album( $album );
    }
 
    if ( empty( $album ) ) {
        return $can_delete;
    }
 
    // Only logged in users can delete album.
    if ( is_user_logged_in() ) {
 
        // Groups albums have their own access
        if ( ! empty( $album->group_id ) && groups_can_user_manage_albums( bp_loggedin_user_id(), $album->group_id ) ) {
            $can_delete = true;
 
            // Users are allowed to delete their own album.
        } else if ( isset( $album->user_id ) && bp_loggedin_user_id() === $album->user_id ) {
            $can_delete = true;
        }
 
        // Community moderators can always delete album (at least for now).
        if ( bp_current_user_can( 'bp_moderate' ) ) {
            $can_delete = true;
        }
    }
 
    /**
     * Filters whether the current user can delete an album item.
     *
     * @since BuddyBoss 1.2.0
     *
     * @param bool   $can_delete Whether the user can delete the item.
     * @param object $album   Current album item object.
     */
    return (bool) apply_filters( 'bp_album_user_can_delete', $can_delete, $album );
}

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_album_user_can_delete	Filters whether the current user can delete an album item.
bp-media/classes/class-bp-media-album.php: BP_Media_Album::__construct()	Constructor method.
bp-groups/bp-groups-functions.php: groups_can_user_manage_albums()	Check whether a user is allowed to manage albums in a given group.
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.

Used By
Used By	Description
bp-media/classes/class-bp-rest-media-albums-endpoint.php: BP_REST_Media_Albums_Endpoint::update_item_permissions_check()	Checks if a given request has access to for the user.
bp-media/classes/class-bp-rest-media-albums-endpoint.php: BP_REST_Media_Albums_Endpoint::delete_item()	Delete a single album.
bp-media/classes/class-bp-rest-media-albums-endpoint.php: BP_REST_Media_Albums_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_album_delete()	Delete album

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