acf_add_options_sub_page()

Описание

Добавляет новую дочернюю страницу настроек в меню администратора.

Страницы настроек используются для хранения глобальных параметров. Эти параметры не привязаны к конкретной записи, а сохраняются в таблице 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