Страницы параметров WordPress — Глобальные пользовательские поля

Для чего нужны страницы параметров

Не все данные пользовательских полей должны находиться в записи. Некоторые данные действительно являются глобальными для сайта:

• Информация о компании — название, адрес, телефон, электронная почта, номер НДС
• URL-адреса в социальных сетях — Facebook, Instagram, Twitter/X, LinkedIn, YouTube
• Глобальные CTA — кнопки «Подписаться на рассылку», «Записаться на звонок», «Получить предложение», используемые на всех шаблонах
• Изображения по умолчанию — запасное изображение для записи, изображение Open Graph по умолчанию, герой страницы 404
• Флаги функций — «показать всплывающее окно рассылки», «включить переключатель темной темы»
• Контент бренда — слоганы, миссия, описание о компании
• Контент подвала — авторские права, юридические ссылки, информация о поддержке

Без страниц параметров вы бы хранили эти данные в параметрах WordPress (get_option('company_name')), что означает сырые строки без пользовательского интерфейса администратора и без типовой безопасности. С помощью страниц параметров вы получаете правильный интерфейс пользовательских полей и типизированные значения.

---

Регистрация страницы параметров

В Field Forge зарегистрируйте страницу параметров с помощью одного вызова функции в functions.php вашей темы или в плагине:

«php if (function_exists('fieldforge_add_options_page')) { fieldforge_add_options_page([ 'page_title' => 'Настройки сайта', 'menu_title' => 'Настройки сайта', 'menu_slug' => 'site-settings', 'capability' => 'manage_options', 'icon_url' => 'dashicons-admin-generic', 'position' => 80, ]); } «

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

Подстраницы

Вы можете зарегистрировать подстраницы под родительской для организации связанных настроек:

«`php fieldforge_add_options_sub_page([ ‘page_title’ => ‘Настройки заголовка’, ‘menu_title’ => ‘Заголовок’, ‘parent_slug’ => ‘site-settings’, ]);

fieldforge_add_options_sub_page([ ‘page_title’ => ‘Настройки подвала’, ‘menu_title’ => ‘Подвал’, ‘parent_slug’ => ‘site-settings’, ]); «`

Подстраницы появляются вложенными под «Настройки сайта» в меню администратора.

---

Назначение групп полей страницам параметров

После регистрации страницы параметров создайте группу полей в визуальном конструкторе Field Forge и установите правила расположения:

« Правила расположения: Страница параметров равна "site-settings" «

Любые поля в этой группе появляются на странице параметров Настройки сайта. Создавайте столько групп полей, сколько хотите для каждой страницы параметров, логически разделяя (например, «Информация о компании», «Социальные профили», «Контент подвала»).

---

Шаблонный код

Получите значения страницы параметров с помощью той же функции get_field(), которую вы используете для метаданных записей, но передайте 'options' в качестве второго аргумента:

«`php // Синтаксис, совместимый с ACF $company_name = get_field(‘company_name’, ‘options’); $company_phone = get_field(‘phone’, ‘options’); $facebook_url = get_field(‘facebook_url’, ‘options’);

// Оба псевдо-ID ‘options’ и ‘option’ работают $logo = get_field(‘site_logo’, ‘option’); // Тот же результат «`

В шаблонах:

«php

«

Тот же синтаксис работает на сайтах ACF, SCF и Field Forge. Портативность кода между тремя плагинами является намеренной — если вам когда-либо нужно будет переключиться между ними, ваша тема не сломается.

---

Хранение

Значения страниц параметров хранятся в отдельной таблице: wp_fieldforge_options. Отдельно от значений полей записей, отдельно от родной таблицы WordPress wp_options.

Почему отдельная таблица:

• Чистое разделение — страницы параметров против полей записей против параметров ядра WordPress концептуально различны
• Производительность — специальные индексы для быстрого поиска страниц параметров
• Изоляция — другие плагины, записывающие в wp_options, не влияют на данные параметров Field Forge
• Массовые операции — экспорт/импорт всех данных страниц параметров — это один запрос к таблице

---

Несколько страниц параметров

Вы можете зарегистрировать столько страниц параметров, сколько нужно вашему сайту:

«`php // Глобальный брендинг fieldforge_add_options_page([ ‘page_title’ => ‘Настройки бренда’, ‘menu_slug’ => ‘brand-settings’, ]);

// Маркетинговая конфигурация fieldforge_add_options_page([ ‘page_title’ => ‘Маркетинг’, ‘menu_slug’ => ‘marketing’, ]);

// Разработчик / расширенные настройки fieldforge_add_options_page([ ‘page_title’ => ‘Настройки разработчика’, ‘menu_slug’ => ‘dev-settings’, ‘capability’ => ‘manage_options’, // только для администраторов ]); «`

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

---

Миграция с ACF страниц параметров

Страницы параметров ACF автоматически импортируются инструментом миграции ACF от Field Forge. После импорта:

• Страницы параметров регистрируются через функцию Field Forge (вам может потребоваться обновить ваш вызов functions.php)
• Все назначения групп полей сохраняются
• Все существующие значения параметров мигрируют в таблицу хранения Field Forge
• Шаблонный код, использующий get_field('name', 'options'), продолжает работать через слой совместимости ACF

Большинство сайтов завершают миграцию страниц параметров без изменений в шаблонах.

Смотрите полный гид по миграции →

---

Доступ к REST API

Значения страниц параметров доступны через REST API Field Forge:

« GET /wp-json/fieldforge/v1/options/{page-slug} «

Возвращает объект со всеми значениями полей для указанной страницы параметров. Идеально подходит для безголовых сайтов WordPress, которым нужны глобальные настройки сайта на фронтенде JavaScript.

Для пользователей WPGraphQL страницы параметров также автоматически регистрируются как типы GraphQL, когда плагин WPGraphQL активен.

---

Готовы добавить страницы параметров?

Получите Field Forge — от $35/год →

Страницы параметров включены в каждый платный план.