Сторінки параметрів WordPress — Загальносайтові користувацькі поля | Field Forge

Для чого потрібні сторінки параметрів

Не всі дані користувацьких полів належать до поста. Деякі дані дійсно є загальносайтовими:

Інформація про компанію — назва, адреса, телефон, електронна пошта, номер ПДВ
URL-адреси соціальних мереж — Facebook, Instagram, Twitter/X, LinkedIn, YouTube
Глобальні заклики до дії — кнопки “Підписатися на розсилку”, “Запланувати дзвінок”, “Отримати пропозицію”, що використовуються в шаблонах
Зображення за замовчуванням — зображення для відображення за замовчуванням, зображення 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 та встановіть правила розташування:

“ Location Rules: Options Page is equal to "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




 
  
  <a href="">Facebook

“

Той же синтаксис працює на сайтах 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/рік →

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