Рецепт: Настройка глобальных параметров с помощью страниц настроек

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

Шаг 1: Решите, как будет зарегистрирована страница параметров

Field Forge поддерживает три пути регистрации — выберите тот, который подходит для вашего рабочего процесса:

1. Админский интерфейс (рекомендуется, без кода) — перейдите в Field Forge > Options Pages, нажмите Add New Options Page, заполните Заголовок страницы, Слаг меню, Возможности, Родительскую страницу, Иконку, Позицию. Сохраните. Элемент меню появится в боковой панели админки WordPress сразу. Вы можете редактировать, мягко удалять или восстанавливать страницу из того же списка. Строка страницы находится в таблице wp_fieldforge_options_pages.
2. Автоматическая регистрация из группы полей (самый простой одноступенчатый вариант) — задайте группе полей правило расположения страницы параметров, и Field Forge автоматически создаст элемент меню с заголовком группы в качестве метки меню. Без кода, без отдельной регистрации страницы. Страница доступна только для чтения в списке страниц параметров — измените заголовок группы полей, чтобы переименовать элемент меню.
3. Явная регистрация через PHP (когда регистрация должна быть включена в тему) — вставьте фрагмент в код вашей темы functions.php:

add_action('init', function () {
    if (function_exists('fieldforge_add_options_page')) {
        fieldforge_add_options_page([
            'page_title' => 'Site Settings',
            'menu_title' => 'Site Settings',
            'menu_slug'  => 'site-settings',  // matches the location rule below
            'icon_url'   => 'dashicons-admin-settings',
            'capability' => 'manage_options',
            'position'   => 80,
        ]);
    }
});

Шим acf_add_options_page() также доступен для кода темы, мигрирующего с ACF Pro.

Шаг 2: Добавить группы полей

Создайте одну или несколько групп полей, которые нацелены на страницу настроек.

1. Перейдите в Field Forge > Новая группа полей, назовите её Информация о компании
2. Добавьте поле вкладки с названием Общее
3. Добавьте следующие поля:

1. Добавьте другое поле вкладки с названием Социальные сети
2. Добавьте следующие поля:

1. Добавьте другое поле вкладки с названием Подвал
2. Добавьте следующие поля:

1. Установите правила расположения: Страница настроек равна Настройки сайта
2. Сохраните группу полей

Шаг 3: Рабочий процесс менеджера контента

1. Нажмите Настройки сайта в боковой панели администратора
2. Вы увидите три вкладки: Общие, Социальные сети и Подвал
3. Заполните название компании, загрузите логотип и введите контактные данные на вкладке Общие
4. Переключитесь на Социальные сети и вставьте URL ваших социальных профилей
5. Переключитесь на Подвал и настройте текст авторских прав и параметры рассылки
6. Нажмите Сохранить изменения (кнопка находится вверху или внизу страницы)

Изменения применяются ко всему сайту немедленно. Каждая страница на сайте, использующая эти значения, будет обновляться автоматически.

Шаг 4: Использование данных опций в шаблонах

Ваш разработчик получает доступ к данным опций, используя параметр 'options':

• get_field('company_name', 'options') в заголовке
• get_field('social_facebook', 'options') для социальных иконок
• get_field('copyright_text', 'options') в подвале

Организация с помощью подстраниц

Для сложных сайтов создайте подстраницы под основной страницей опций:

• Настройки сайта (родительская)

— Социальные сети — все ссылки на профили в социальных сетях

— Внешний вид — цвета, шрифты, предпочтения макета

— Интеграции — ID Google Analytics, код виджета чата, скрипты сторонних разработчиков

Каждая подстраница получает свою собственную группу полей. Это позволяет каждой экрану настроек оставаться сосредоточенным и легким для навигации.

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

• Используйте вкладки в группах полей, чтобы организовать связанные поля, не создавая отдельные подстраницы для каждой категории
• Установите значения по умолчанию для полей, чтобы сайт выглядел правильно даже до заполнения настроек
• Добавьте поля сообщений с инструкциями, такими как «Загрузите прозрачный логотип PNG размером 300×100 пикселей для наилучших результатов»
• Используйте условную логику, чтобы скрыть вторичные поля, пока они не станут актуальными — например, включите условную логику для поля заголовка рассылки и установите правило «Показать подписку на рассылку равно Да», чтобы заголовок появлялся только при включенном переключателе. Доступно одиннадцать операторов (равно, содержит, regex, пусто, числовые сравнения), и связанные правила автоматически каскадируются.
• Сделайте это просто — добавляйте сюда только те данные, которые действительно должны быть на сайте. Данные на странице должны находиться в обычных группах полей, привязанных к конкретным записям или страницам