get_admin_page_parent()
Получает ключ родительской страницы админки, относительно текущей страницы.
Устанавливает глобальную переменную админки global $parent_file в которой храниться имя родительского файла, который отвечает за вывод текущей страницы админки. Это имя может быть использовано в ключах глобального массива $submenu: $submenu[ $parent ], в который добавляются подпункты меню через функцию add_submenu_page().
1 раз — 0.000001 сек (скорость света) | 50000 раз — 0.60 сек (очень быстро) | PHP 7.3.20, WP 5.5.3
Хуков нет.
Возвращает
Строку
. Ключ родительской страницы админке. Примеры возвращаемых значений:
profile.php users.php edit.php edit.php?post_type=page tools.php edit-tags.php?taxonomy=link_category
Использование
get_admin_page_parent( $parent );
- $parent(строка)
- Ярлык (slug) родительского пункта админ-меню (или имя файла для дефолтных пунктов меню).
По умолчанию: ''
Примеры
#1 Отобразим название родительского файла дефолтного пункта меню
Добавим под-пункт меню с помощью add_submenu_page() в пункт меню "Инструменты":
add_action( 'admin_menu', 'mat_add_submenu_page' ); function mat_add_submenu_page() { add_submenu_page( 'tools.php', 'Массовое добавление терминов', 'Массовое добавление терминов', 'manage_categories', 'mat-admin', 'mat_admin_page_content' ); } function mat_admin_page_content() { echo get_admin_page_parent(); // Выведет: tools.php }
#2 Отобразим название родительского файла у CF7
Добавим подменю в основное меню Contact Form 7.
add_action( 'admin_menu', 'cf7_submodule_add_menu_page' ); function cf7_submodule_add_menu_page() { add_submenu_page( 'wpcf7', 'Модуль для CF7', 'Страница модуля для CF7', 'wpcf7_read_contact_forms', 'cf7-submodule-admin', 'cf7_submodule_admin_page_content' ); } function cf7_submodule_admin_page_content() { echo get_admin_page_parent(); // Выведет: wpcf7 }
Заметки
- Global. Строка. $parent_file
- Global. Массив. $menu
- Global. Массив. $submenu
- Global. Строка. $pagenow The filename of the current screen.
- Global. Строка. $typenow The post type of the current screen.
- Global. Строка. $plugin_page
- Global. Массив. $_wp_real_parent_file
- Global. Массив. $_wp_menu_nopriv
- Global. Массив. $_wp_submenu_nopriv
Список изменений
С версии 1.5.0 | Введена. |