Страница параметров

Обзор

Представленный в ACF PRO 6.2 интерфейс страниц параметров упрощает создание новых пользовательских страниц администрирования и дочерних страниц для редактирования полей ACF.

Все данные, сохраненные на странице параметров, являются глобальными и сохраняются в таблице wp_options, а не привязываются к определенной записи или странице. Благодаря этому данные можно отображать на любой странице сайта, что особенно удобно для данных шапки и подвала.

Чтобы открыть интерфейс страниц параметров в ACF PRO, наведите указатель мыши на пункт ACF в админ-панели WordPress или нажмите его, а затем выберите Страницы параметров. Новую страницу параметров можно связать с существующей группой полей или создать новую группу полей прямо в процессе работы, не прерывая рабочий процесс.

Описание процесса приведено в видео ниже.

Страницы параметров являются глобальными

Группы полей ACF не следует использовать на нескольких страницах параметров, если только вы не собираетесь также использовать общие значения этой группы полей. Ввод данных в поле, сопоставленное более чем с одной страницей параметров, загрузит это значение на всех страницах параметров, с которыми оно связано.

Обратите внимание: это поведение применяется только к группам полей, используемым на страницах параметров. Все данные со страниц параметров сохраняются в одном месте — таблице wp_options. Это ограничение не распространяется на группы полей ACF, используемые в записях и страницах.

Один из вариантов решения — создать отдельную группу полей для каждой страницы параметров и присвоить каждому полю уникальное имя.

В качестве альтернативы можно настроить пользовательское хранилище данных для одной из страниц параметров, чтобы она отображала значения только из этого источника. Откройте вкладку Разрешения в разделе «Расширенные настройки» интерфейса страниц параметров, затем нажмите раскрывающийся список «Хранилище данных». Выберите Пользовательское хранилище и укажите другую строку, которая будет использоваться в качестве префикса option_name в таблице wp_options, например options2.

Скриншоты

Интерфейс страниц параметров ACF.

Создание новой страницы параметров в интерфейсе.

Вкладка «Видимость» в разделе «Расширенные настройки».

Так может выглядеть для пользователей простая страница параметров «Настройки сайта».

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

Все функции API можно использовать с полями страницы параметров. Однако для указания страницы параметров требуется второй параметр. Это аналогично передаче $post_id для указания конкретного объекта записи. В этом примере показано, как загрузить значение со страницы параметров.

<?php the_field('header_title', 'option'); ?>

Продолжение: Получение значений со страницы параметров

Параметры

Ниже перечислены все параметры, которые можно настроить через интерфейс:

• Заголовок страницы
  Заголовок страницы параметров. Он также используется как имя страницы параметров в админ-панели WordPress, если это не изменено в разделе «Расширенные настройки». Страницу параметров нельзя сохранить, если это поле не заполнено. По умолчанию используется значение «Настройки сайта».

• Ярлык меню
  Задает URL страницы параметров. Перед сохранением страницы параметров необходимо указать «Ярлык меню». По умолчанию используется значение «Заголовок страницы», но в нижнем регистре и с заменой пробелов на дефисы.

• Родительская страница
  Раскрывающийся список, позволяющий сделать страницу параметров дочерней страницей существующей страницы параметров. Пока не будет создана хотя бы одна страница параметров, доступен только вариант «Нет родительской страницы».

• Расширенная конфигурация
  Включение этого параметра открывает доступ к настройкам расширенной конфигурации.

Расширенные настройки

Видимость

• Значок меню
  Управляет значком, используемым для пункта страницы параметров в админ-панели WordPress. В качестве значения можно указать URL или имя класса Dashicon.

• Заголовок меню
  Управляет заголовком страницы параметров в админ-панели WordPress, не изменяя «Заголовок страницы».

• Позиция меню
  Управляет расположением меню страницы параметров в админ-панели WordPress. Введенное значение должно соответствовать структуре меню, используемой параметром $position функции WordPress add_menu_page().

• Перенаправлять на дочернюю страницу
  Включение этого параметра перенаправит страницу на ее первую дочернюю страницу, если дочерние страницы существуют.

• Описание
  В этом поле можно указать описание страницы параметров.

Ярлыки

• Текст кнопки обновления
  Управляет текстом кнопки, которая обновляет поля на странице параметров. Если поле оставить пустым, по умолчанию используется текст «Обновить».

• Сообщение об обновлении
  Управляет сообщением, отображаемым пользователю после успешного обновления страницы параметров. Если поле оставить пустым, по умолчанию используется сообщение «Параметры обновлены».

Разрешения

• Возможность
  Управляет возможностью WordPress, которой должен обладать пользователь сайта для просмотра страницы параметров. По умолчанию используется edit_posts.

• Хранилище данных
  Управляет местом хранения данных полей страницы параметров. По умолчанию используется вариант «Параметры», при котором данные полей сохраняются в таблице параметров. Выбор «Пользовательское хранилище» вместо «Параметры» позволяет загружать данные полей из записи, пользователя или термина.

• Пользовательское хранилище
  Этот параметр отображается только в том случае, если в поле «Хранилище данных» выбран вариант «Пользовательское хранилище». В качестве значения можно указать числовой ID записи или строку.

• Автозагрузка параметров
  Включение этого параметра автоматически загружает поля записей параметров при загрузке WordPress для повышения производительности.

Разумеется, не всем пользователям ACF PRO понадобится регистрировать страницы параметров через интерфейс. Инструкции по отключению этой функции в админ-панели плагина приведены здесь.

Регистрация страниц параметров с помощью кода

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

Чтобы создать страницу параметров, откройте файл functions.php и добавьте следующий код:

add_action('acf/init', function() {
  if( function_exists('acf_add_options_page') ) {

    acf_add_options_page();

  }
});

Если не передавать этой функции параметры, в боковую панель wp-admin будет добавлена стандартная страница параметров.

Расширенное использование

В этом примере показано, как создать пользовательскую страницу параметров с дочерними страницами.

add_action('acf/init', function() {
  if( function_exists('acf_add_options_page') ) {

    acf_add_options_page(array(
        'page_title'    => 'Общие настройки темы',
        'menu_title'    => 'Настройки темы',
        'menu_slug'     => 'theme-general-settings',
        'capability'    => 'edit_posts',
        'redirect'      => false
    ));

    acf_add_options_sub_page(array(
        'page_title'    => 'Настройки шапки темы',
        'menu_title'    => 'Шапка',
        'parent_slug'   => 'theme-general-settings',
    ));

    acf_add_options_sub_page(array(
        'page_title'    => 'Настройки подвала темы',
        'menu_title'    => 'Подвал',
        'parent_slug'   => 'theme-general-settings',
    ));

  }
});

Примечания

WordPress 6.8

Начиная с WordPress 6.8 любая функция, вызывающая раннюю инициализацию ACF, например эта, приведет к появлению уведомления PHP, если вызвать ее до выполнения действия acf/init:

Уведомление: функция _load_textdomain_just_in_time вызвана некорректно. Загрузка переводов для домена acf была запущена слишком рано. Обычно это означает, что некоторый код плагина или темы выполняется слишком рано. Переводы следует загружать во время действия init или позже.

Чтобы избежать этого, не вызывайте функции ACF до выполнения действия acf/init. В приведенных выше примерах показано, как правильно обернуть эти вызовы.

Обновлено: 30.09.2026