Часто задавані питання

Поля та типи

A: Безкоштовний план дозволяє створити до 3 груп полів. Кожна група полів може містити стільки полів, скільки вам потрібно з 20 безкоштовних типів полів. Якщо вам потрібно більше ніж 3 групи полів, оновіть до PRO для необмеженої кількості груп полів та всіх 32 типів полів.

A: Обмеження на 3 групи застосовується скрізь, включаючи закладку або вручну введену URL-адресу адміністратора fieldforge-new. Список груп полів показує заблокований контроль New Field Group PRO, а прямий доступ показує екран оновлення замість порожнього редактора. Існуючі групи полів залишаються редагованими на безкоштовному плані.

A: Група полів — це контейнер — уявіть це як форму. Поля — це окремі елементи введення всередині цієї форми (текстові поля, вибір зображення, випадаючі списки тощо). Ви створюєте групу полів, додаєте до неї поля та встановлюєте правила розташування, щоб контролювати, де вона з’являється. Коли менеджер контенту редагує відповідну публікацію, вся група полів з’являється як метабокс під редактором.

A: Так. Використовуйте правила розташування з групами OR. Наприклад, встановіть одну групу правил на “Тип публікації дорівнює Сторінка” і додайте іншу групу правил для “Тип публікації дорівнює Публікація”. Тоді група полів з’явиться як на Сторінках, так і на Публікаціях. Ви можете додати стільки груп OR, скільки вам потрібно.

A: Зміна типу поля (наприклад, з Тексту на Число) не видаляє існуючі дані, але дані можуть не відображатися правильно в новому типі поля. Наприклад, якщо текстове поле містило “hello” і ви змінюєте його на числове поле, редактор покаже порожній або недійсний стан. Завжди тестуйте зміни типу поля спочатку на тестовому сайті. Ви можете використовувати функцію Історія версій, щоб повернутися назад, якщо щось піде не так.

A: Відкрийте редактор групи полів і перетягніть будь-яке поле за його ручку на нову позицію. Порядок, який ви встановлюєте в редакторі, є точним порядком, який бачать менеджери контенту під час редагування публікацій. Ви також можете використовувати налаштування ширини обгортки, щоб розмістити поля поруч на одному рядку.

A: Поля макета не зберігають жодних даних. Вони є чисто організаційними інструментами, які покращують досвід редагування. Поля вкладок розділяють вашу групу полів на клікабельні вкладки. Поля аккордеона створюють згортані секції. Поля повідомлень відображають інструктивний текст, щоб допомогти менеджерам контенту зрозуміти, що вводити. Використовуйте їх вільно — вони не впливають на продуктивність або зберігання.

Сумісність з ACF

A: Так. Field Forge надає повний шар сумісності з ACF. Функції, такі як get_field(), the_field(), have_rows(), get_sub_field(), та всі інші стандартні функції ACF працюють ідентично. Вашому коду теми не потрібно жодних змін. Field Forge автоматично реєструє ці функції, коли ACF не активний. Під час запитів на активацію ACF Field Forge передає управління ACF, щоб ACF Pro можна було активувати для міграції без фатальної помилки повторного оголошення PHP.

A: Технічно так, але це не рекомендується для звичайного використання. Під час міграції обидва плагіни повинні бути активними, щоб Field Forge міг читати дані ACF. Після завершення міграції та перевірки, що все працює, деактивуйте ACF. Довгострокове використання обох плагінів може викликати конфлікти, оскільки вони обидва намагаються зареєструвати однакові функції.

A: Так, з ліцензією Field Forge PRO. Repeater, Group, Flexible Content, Clone, Options Pages, Gallery, oEmbed, Time Picker та Relationship поля всі доступні в PRO. Інструмент міграції також обробляє імпорт цих складних типів полів з ACF Pro.

Міграція з ACF

A: Ні. Процес міграції не є руйнівним. Field Forge читає ваші дані ACF і створює їх власну копію в оптимізованих таблицях бази даних. Ваші оригінальні дані ACF залишаються незайманими в wp_postmeta. Якщо щось піде не так, ви можете просто повторно активувати ACF, і ваш сайт працюватиме точно так, як раніше.

A: Для маленьких сайтів (менше 100 постів) міграція завершується за кілька секунд. Для більших сайтів з тисячами постів міграція значень (PRO) виконується партіями по 50 постів і обробляється у фоновому режимі. Сайт з 5,000 постами зазвичай займає 2-5 хвилин. Ви можете закрити браузер під час фонової обробки — вона продовжується на сервері.

A: Безкоштовна версія може імпортувати визначення груп полів (структуру). Щоб також мігрувати фактичні значення полів (дані контенту, збережені на кожному пості), вам потрібен PRO. Для більшості практичних міграцій вам потрібні як структура, так і дані, тому рекомендується використовувати PRO.

A: Field Forge виявляє як групи полів, збережені в базі даних, так і PHP-зареєстровані групи полів ACF. Якщо ваші групи полів зареєстровані через acf_add_local_field_group() у вашій темі, інструмент міграції також їх підхоплює.

A: Field Forge може читати файли ACF Local JSON з acf-json/group_*.json в активній темі, батьківській темі та відфільтрованих шляхах завантаження ACF. Міграція імпортує структуру групи полів з цих JSON-файлів, навіть коли пости acf-field-group і acf-field відсутні. Значення полів все ще беруться з постмета у стилі ACF і вимагають міграції значень PRO.

Сторінки параметрів

A: З PRO немає обмежень. Ви можете створити стільки основних сторінок опцій та підсторінок, скільки потрібно вашому сайту. Типова конфігурація може включати основну сторінку “Налаштування сайту” з підсторінками для “Соціальних мереж”, “Футера” та “Зовнішнього вигляду”.

A: Дані сторінки опцій зберігаються в таблиці wp_fieldforge_options Field Forge, окремо від звичайних даних постів. Ви можете отримати доступ до них у шаблонах, використовуючи get_field('field_name', 'options'). Параметр 'options' вказує Field Forge шукати в таблиці опцій, а не в поточному пості.

A: За замовчуванням сторінки опцій вимагають можливість manage_options, що означає, що їх можуть бачити лише адміністратори. Ви можете встановити власну можливість під час створення сторінки опцій, щоб надати доступ редакторам або іншим ролям.

Повторювач, група та гнучкий контент

A: Repeater дозволяє мати кілька рядків — менеджери контенту можуть додавати стільки елементів, скільки їм потрібно (наприклад, список членів команди). Group завжди має точно один набір підполів (наприклад, один блок адреси). Використовуйте Repeater, коли кількість елементів змінюється, і Group, коли у вас завжди є точно один набір пов’язаних даних.

A: Так. Ви можете вкладати repeaters для складних структур даних. Наприклад, repeater “Courses” може містити repeater “Lessons” в кожному курсі. Будьте обережні, що глибоко вкладені repeaters можуть ускладнити інтерфейс редагування для менеджерів контенту — два рівні вкладення зазвичай є практичною межею.

A: Немає жорсткої межі, але рекомендований діапазон для зручності використання становить 4-8 макетів. Занадто багато варіантів макетів може перевантажити менеджерів контенту. Кожен макет може містити будь-яку комбінацію типів полів, включаючи Repeaters і Groups.

A: Так. У налаштуваннях поля Repeater ви можете встановити мінімум (наприклад, “не менше 3 функцій”) і максимум (наприклад, “не більше 10 елементів”). Менеджери контенту бачать кнопку Додати рядок вимкненою, коли досягнуто максимуму, і не можуть видалити рядки нижче мінімуму.

Продуктивність

A: Так. Field Forge зберігає дані у власній оптимізованій таблиці бази даних (wp_fieldforge_values), а не у wp_postmeta. Це означає менше запитів до бази даних, особливо на сторінках з багатьма полями. Пости з 20+ полями бачать найбільше покращення, оскільки ACF робить окремий запит до бази даних для кожного поля, тоді як Field Forge отримує всі значення в одному запиті.

A: Кількість груп полів має незначний вплив на продуктивність фронтенду. Групи полів впливають лише на досвід редагування в адмінці (завантаження визначень полів). На фронтенді запитуються лише значення полів, і вони отримуються ефективно, незалежно від того, скільки груп полів ви визначили.

A: Ріпітери з до 100-200 рядками працюють добре. Якщо вам регулярно потрібно більше ніж 200 рядків даних, розгляньте, чи може користувацький тип поста бути кращим підходом. Наприклад, замість ріпітера з 500 рядками продуктів, створіть користувацький тип поста “Продукт”, де кожен продукт є своїм постом.

Локальний JSON

A: Local JSON зберігає визначення ваших груп полів у файлах .json всередині папки вашої теми. Це в основному корисно для робочих процесів розробників, що включають контроль версій (Git). Якщо ви менеджер контенту без розробника у вашій команді, вам не потрібна ця функція. Якщо ви працюєте з розробником, він може активувати цю функцію, щоб зміни в групах полів можна було відстежувати в коді.

A: Коли ви зберігаєте групу полів, Field Forge автоматично записує оновлений файл JSON у вашу папку теми. Якщо ваш розробник також вніс зміни до тієї ж групи полів через код, ви можете побачити повідомлення про синхронізацію наступного разу, коли відвідаєте адмінку. Це повідомлення дозволяє вам вибрати, яку версію зберегти.

REST API

A: Так. Field Forge надає кінцеві точки за адресою /wp-json/fieldforge/v1/ для управління групами полів, читання та запису значень полів, а також роботи зі сторінками параметрів. Публічні схеми груп полів для читання (GET /field-groups та GET /field-groups/{id}) доступні без куків для безголових/фронтальних використань і включають заголовки кешу. Читання значень та всі кінцеві точки запису/імпорту/генерації все ще вимагають аутентифікації (на основі куків з nonce або паролів додатка) та відповідної можливості WordPress.

A: Читання значень полів для опублікованих постів доступне для аутентифікованих користувачів з відповідними можливостями. Кінцеві точки на рівні адміністратора (створення груп полів, імпорт даних) вимагають можливості manage_options. Ваш розробник може налаштувати користувацькі дозволи, якщо це необхідно.

A: Так. Коли WPGraphQL активний, Field Forge реєструє нативні поля схеми для відповідних груп полів без вимоги WPGraphQL для ACF. Поля медіа вирішуються в MediaItem, поля зв’язків вирішуються в ContentNode, поля таксономії вирішуються в TermNode, і ці об’єктні відображення також працюють всередині підполів Group, Repeater та Flexible Content. Анонімні запити отримують null або відфільтровані списки для недоступних приватних/чернеткових/захищених паролем постів.

A: Основний вантаж REST постів WordPress тепер є опційним. Встановіть show_in_rest => true на полях, які безпечні для публічного відображення, або використовуйте аутентифікований кінцевий пункт /wp-json/fieldforge/v1/fields/{post_id} для робочих процесів редактора/адміністратора. Поля з паролями та чутливими даними за замовчуванням приховані, навіть коли батьківська група є публічною.

Ліцензія та обмеження

A: Безкоштовний план включає до 3 груп полів, 20 типів полів (Текст, Текстова область, Число, Діапазон, Електронна пошта, URL, Пароль, Зображення, Файл, WYSIWYG, Вибір, Прапорець, Радіо, Істина/Хибність, Група кнопок, Вибір дати, Вибір кольору, Вкладка, Аккордеон, Повідомлення), історію змін, імпорт/експорт та сумісність ACF. Вам не потрібен PRO для базових користувацьких полів на невеликому сайті.

A: PRO відкриває необмежену кількість груп полів, 12 додаткових типів полів (Повторювач, Група, Гнучкий контент, Клон, Взаємозв’язок, Об’єкт поста, Посилання на сторінку, Таксономія, Користувач, Галерея, oEmbed, Вибір часу), сторінки параметрів, синхронізацію локального JSON, міграцію значень полів з ACF, генерацію полів AI, генерацію TypeScript та пріоритетну підтримку.

A: Умови ліцензії визначені під час покупки. Перевірте деталі вашої ліцензії на веб-сайті Field Forge. Зазвичай, кожна ліцензія охоплює один виробничий сайт, хоча дозволені середовища розробки та тестування.

A: Ваші існуючі групи полів PRO та дані продовжать працювати. Ви зберігаєте доступ до всіх функцій, які вже налаштовані. Однак ви не отримаєте оновлення і не зможете активувати PRO на нових сайтах, поки не продовжите ліцензію.