Описание
Добавляет новую дочернюю страницу настроек в меню администратора.
Страницы настроек используются для хранения глобальных параметров. Эти параметры не привязаны к конкретной записи, а сохраняются в таблице wp_options.
После регистрации ваша страница появится в меню администратора. Затем вы сможете назначить поля этой странице с помощью правила расположения «Страница настроек» при редактировании группы полей.
Эта функция фактически является обёрткой для acf_add_options_page(), предоставляющей значение по умолчанию для атрибута parent_slug — «acf-options».
Параметры
acf_add_options_sub_page( [$settings] );$settings
(array) (Необязательно) Массив аргументов для регистрации страницы настроек. См. список доступных параметров
Примеры
Стандартная дочерняя страница настроек
В этом примере показано, как создать стандартную дочернюю страницу настроек.
functions.php
if( function_exists('acf_add_options_sub_page') ) {
acf_add_options_sub_page();
}Настроенная дочерняя страница настроек
В этом примере показано, как создать настроенную дочернюю страницу настроек и сохранить данные в переменной для дальнейшего использования.
functions.php
add_action('acf/init', 'my_acf_op_init');
function my_acf_op_init() {
// Проверяем существование функции.
if( function_exists('acf_add_options_sub_page') ) {
// Добавляем родительскую страницу.
$parent = acf_add_options_page(array(
'page_title' => __('Theme General Settings'),
'menu_title' => __('Theme Settings'),
'redirect' => false,
));
// Добавляем дочернюю страницу.
$child = acf_add_options_sub_page(array(
'page_title' => __('Social Settings'),
'menu_title' => __('Social'),
'parent_slug' => $parent['menu_slug'],
));
}
}Примечания
Приоритет
Эту функцию необходимо использовать до выполнения действия admin_menu (приоритет 99), поскольку именно в этот момент страницы администратора регистрируются в ядре WordPress. Мы рекомендуем использовать действие «acf/init».
Обновлено: 30.09.2026