Обзор
Эта функция добавляет дополнительную страницу опций на боковую панель wp-admin.
Все данные, сохраненные на странице параметров, являются глобальными. Это означает, что он не привязан к какому-либо конкретному посту или странице, но сохраняется в таблице wp_options.
Требования
- ACF версии 5.0.0 или выше
- Эта функция должна быть вызвана до экшена admin_menu (приоритет 99), поскольку в этот момент страницы настроек добавляются в WordPress.
Параметры
<?php acf_add_options_sub_page($page); ?>
- $page (смешанный) Заголовка для страницы опций или массив параметров. Если не заполнено, то будут использоваться настройки по-умолчанию.
Параметр acf_add_options_sub_page() аналогичны параметрам acf_add_options_page(), кроме одного нюанса. Параметр «parent_slug» не может быть пустым.
По умолчанию, для параметра «parent_slug» установлено значение «acf-options» (страница опций по-умолчанию). Вы конечно можете поменять ее на любую другую страницу из панели администратора.
Посмотрите весь список параметров.
Использование
Базовая страница с опциями
В этом примере показано, как создать дополнительную страницу с опциями под названием «Social». Следующий код должен быть в помещен в файл functions.php. Помните, вызывая эту функцию без установленного«parent_slug», будет использоваться значение по умолчанию. Кроме того, если страница опций по-умолчанию еще не существует, она будет добавлена.
if( function_exists('acf_add_options_sub_page') ) {
acf_add_options_sub_page('Social');
}
Кастомизация страницы с опциями
В этом примере показано, как создать настраиваемую страницу опций и сохранить данные в переменной для последующего использования.
if( function_exists('acf_add_options_page') ) {
// добавляем родителя
$parent = acf_add_options_page(array(
'page_title' => 'Основные настройки',
'menu_title' => 'Основные настройки',
'redirect' => false
));
// добавляем дочернюю страницу
acf_add_options_sub_page(array(
'page_title' => 'Социальные сети',
'menu_title' => 'Социальные сети',
'parent_slug' => $parent['menu_slug'],
));
}
Похожие
- Функции: acf_add_options_page()
- Возможности: Страница с опциями