wordpress / latest / classes / wp_customize_control / check_capabilities.html

WP_Customize_Control::check_capabilities(): bool

Checks if the user can use this control.

Description

Returns false if the user cannot manipulate one of the associated settings, or if one of the associated settings does not exist. Also returns false if the associated section does not exist or if its capability check returns false.

Return

bool False if theme doesn't support the control or user doesn't have the required permissions, otherwise true.

Source

File: wp-includes/class-wp-customize-control.php. View all references

final public function check_capabilities() {
	if ( ! empty( $this->capability ) && ! current_user_can( $this->capability ) ) {
		return false;
	}

	foreach ( $this->settings as $setting ) {
		if ( ! $setting || ! $setting->check_capabilities() ) {
			return false;
		}
	}

	$section = $this->manager->get_section( $this->section );
	if ( isset( $section ) && ! $section->check_capabilities() ) {
		return false;
	}

	return true;
}

Uses

Uses Description

Changelog

Version Description
3.4.0 Introduced.

© 2003–2022 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/classes/wp_customize_control/check_capabilities