remove_meta_box() — описание функции WordPress на русском

Сигнатура

remove_meta_box( string $id, string|array|WP_Screen $screen, string $context )

Описание

Удаляет метабокс с одного или нескольких экранов.

Параметры

$id string обязательный

ID метабокса (используется в атрибуте 'id' метабокса).

$screen string|array|WP_Screen обязательный

Экран или экраны, на которых показывается метабокс (например, тип записи, 'link' или 'comment'). Принимает один ID экрана, объект WP_Screen или массив ID экранов.

$context string обязательный

Контекст в пределах экрана, в котором настроено отображение метабокса. Контексты различаются от экрана к экрану. Контексты экрана редактирования записи: 'normal', 'side' и 'advanced'. Контексты экрана комментариев: 'normal' и 'side'. Метабоксы меню (секции-аккордеоны) используют контекст 'side'.

Исходный код

wp-admin/includes/template.php:1489

function remove_meta_box( $id, $screen, $context ) {
	global $wp_meta_boxes;

	if ( empty( $screen ) ) {
		$screen = get_current_screen();
	} elseif ( is_string( $screen ) ) {
		$screen = convert_to_screen( $screen );
	} elseif ( is_array( $screen ) ) {
		foreach ( $screen as $single_screen ) {
			remove_meta_box( $id, $single_screen, $context );
		}
	}

	if ( ! isset( $screen->id ) ) {
		return;
	}

	$page = $screen->id;

	if ( ! isset( $wp_meta_boxes ) ) {
		$wp_meta_boxes = array();
	}
	if ( ! isset( $wp_meta_boxes[ $page ] ) ) {
		$wp_meta_boxes[ $page ] = array();
	}
	if ( ! isset( $wp_meta_boxes[ $page ][ $context ] ) ) {
		$wp_meta_boxes[ $page ][ $context ] = array();
	}

	foreach ( array( 'high', 'core', 'default', 'low' ) as $priority ) {
		$wp_meta_boxes[ $page ][ $context ][ $priority ][ $id ] = false;
	}
}

История изменений

Версия	Описание
4.4.0	The $screen parameter now accepts an array of screen IDs.
2.6.0	Introduced.