bp_group_get_album_status( int|bool $group_id = false )

Get the album status of a group.

Description

This function can be used either in or out of the loop.

Parameters

$group_id

(Optional) The ID of the group whose status you want to check. Default: the displayed group, or the current group in the loop.

Default value: false

Return

(bool|string) Returns false when no group can be found. Otherwise returns the group album status, from among 'members', 'mods', and 'admins'.

Source

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

function bp_group_get_album_status( $group_id = false ) {
    global $groups_template;
 
    if ( !$group_id ) {
        $bp = buddypress();
 
        if ( isset( $bp->groups->current_group->id ) ) {
            // Default to the current group first.
            $group_id = $bp->groups->current_group->id;
        } elseif ( isset( $groups_template->group->id ) ) {
            // Then see if we're in the loop.
            $group_id = $groups_template->group->id;
        } else {
            return false;
        }
    }
 
    $album_status = groups_get_groupmeta( $group_id, 'album_status' );
 
    // Backward compatibility. When 'album_status' is not set, fall back to a default value.
    if ( !$album_status ) {
        $album_status = apply_filters( 'bp_group_album_status_fallback', 'members' );
    }
 
    /**
     * Filters the album status of a group.
     *
     * Invite status in this case means who from the group can send invites.
     *
     * @since BuddyBoss 1.0.0
     *
     * @param string $album_status Membership level needed to manage albums.
     * @param int    $group_id      ID of the group whose status is being checked.
     */
    return apply_filters( 'bp_group_get_album_status', $album_status, $group_id );
}

Expand full source code Collapse full source code

Changelog

Changelog
Version	Description
BuddyBoss 1.0.0	Introduced.

Uses

Uses
Uses	Description
bp-loader.php: buddypress()	The main function responsible for returning the one true BuddyBoss Instance to functions everywhere.
bp-groups/bp-groups-functions.php: groups_get_groupmeta()	Get a piece of group metadata.
bp-groups/bp-groups-template.php: bp_group_get_album_status	Filters the album status of a group.

Used By
Used By	Description
bp-groups/classes/class-bp-rest-group-settings-endpoint.php: BP_REST_Group_Settings_Endpoint::get_settings_fields()	Get Group Settings.
bp-groups/classes/class-bp-rest-group-settings-endpoint.php: BP_REST_Group_Settings_Endpoint::update_settings_fields()	Update Group settings.
bp-groups/bp-groups-admin.php: bp_groups_admin_edit_metabox_settings()	Markup for the single group’s Settings metabox.
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-groups/bp-groups-template.php: bp_group_show_albums_status_setting()	Output the ‘checked’ value, if needed, for a given album_status on the group create/admin screens

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