admin_title │ хук-фильтр │ WP 3.1.0

Позволяет изменить заголовок (метатег <title>) страницы в админке.

Использование

add_filter( 'admin_title', 'wp_kama_admin_title_filter', 10, 2 );

/**
 * Function for `admin_title` filter-hook.
 * 
 * @param string $admin_title The page title, with extra context added.
 * @param string $title       The original page title.
 *
 * @return string
 */
function wp_kama_admin_title_filter( $admin_title, $title ){

	// filter...
	return $admin_title;
}
$admin_title(строка)
Заголовок страницы с добавлением дополнительного контекста.
$title(строка)
Оригинальный заголовок страницы.

Примеры

0

#1 Данные в фильтре

Посмотрим, какие данные приходят в фильтр на странице админки "Консоль".

add_filter( 'admin_title', 'wp_kama_admin_title_filter', 10, 2 );

function wp_kama_admin_title_filter( $admin_title, $title ){
	print_r( $admin_title ); //> Консоль ‹ Название сайта — WordPress
	print_r( $title); //> Консоль

	return $admin_title;
}
0

#2 Добавим в title метку о DEV сайте

Работая на DEV сайте, можно добавить метку об этом для удобства:

add_filter( 'admin_title', 'wp_kama_admin_title_dev' );

function wp_kama_admin_title_dev( $admin_title ){
	if( wp_get_environment_type() === 'development' ){
		$admin_title = 'DEV ||| ' .  $admin_title;
	}

	return $admin_title;
}

В итоге получим, к примеру DEV ||| Консоль ‹ Название сайта — WordPress.

0

#3 Отображение оригинального title

Чтобы title в админке были лаконичными, можно отображать их оригинальный заголовок:

add_filter( 'admin_title', 'wp_kama_admin_original_title', 10, 2 );

function wp_kama_admin_original_title( $admin_title, $title ){
	return $title; //> Консоль
}
0

#4 Название и версия плагина в заголовке админки

При разработке плагина удобно видеть с какой версией плагина идёт работа. Выведем эту информацию в title в админке:

add_filter( 'admin_title', 'wp_kama_admin_title_based_on_plugin_name', 10, 2 );

function wp_kama_admin_title_based_on_plugin_name( $admin_title, $title ) {
	$plugin = get_plugins()['hello.php'] ?? [];

	if ( $plugin ) {
		$title .= " - {$plugin['Name']} {$plugin['Version']}";
	}

	return $title;
}

На главной странице админке выведет Консоль - Hello Dolly 1.7.2.

Список изменений

С версии 3.1.0 Введена.

Где вызывается хук

В файле: /wp-admin/admin-header.php
admin_title
wp-admin/admin-header.php 89 
$admin_title = apply_filters( 'admin_title', $admin_title, $title );

Где используется хук в WordPress

Использование не найдено.