Группы полей и типы
В: Сколько групп полей я могу создать на бесплатном тарифе?О: Бесплатный тариф позволяет создать до 3 групп полей. Каждая группа полей может содержать столько полей, сколько вам нужно из 20 бесплатных типов полей. Если вам нужно больше 3 групп полей, обновите до PRO для неограниченного количества групп полей и всех 32 типов полей.
В: У меня уже есть 3 группы полей. Почему я не могу открыть редактор новой группы полей напрямую?О: Ограничение в 3 группы применяется повсюду, включая закладку или вручную введенный fieldforge-new URL администратора. Список групп полей показывает заблокированное управление Новая группа полей PRO, а прямой доступ показывает экран обновления вместо пустого редактора. Существующие группы полей остаются редактируемыми на бесплатном тарифе.
О: Группа полей — это контейнер — подумайте об этом как о форме. Поля — это отдельные вводы внутри этой формы (текстовые поля, выбор изображений, выпадающие списки и т. д.). Вы создаете группу полей, добавляете в нее поля и устанавливаете правила местоположения, чтобы контролировать, где она появляется. Когда менеджер контента редактирует соответствующий пост, вся группа полей отображается как метабокс под редактором.
В: Могу ли я использовать одну и ту же группу полей для нескольких типов постов?О: Да. Используйте правила местоположения с группами OR. Например, установите одну группу правил на «Тип поста равен Страница» и добавьте другую группу правил для «Тип поста равен Пост». Группа полей будет отображаться как на Страницах, так и на Постах. Вы можете добавить столько групп OR, сколько вам нужно.
В: Что произойдет, если я изменю тип поля после ввода данных?О: Изменение типа поля (например, с Текста на Число) не удаляет существующие данные, но данные могут отображаться некорректно в новом типе поля. Например, если текстовое поле содержало «hello», и вы измените его на числовое поле, редактор покажет пустое или недопустимое состояние. Всегда тестируйте изменения типа поля сначала на тестовом сайте. Вы можете использовать функцию История изменений, чтобы откатиться, если что-то пойдет не так.
В: Как мне изменить порядок полей внутри группы полей?О: Откройте редактор группы полей и перетащите любое поле за его ручку в новое положение. Порядок, который вы установите в редакторе, — это точный порядок, который увидят менеджеры контента при редактировании постов. Вы также можете использовать настройки ширины обертки, чтобы разместить поля рядом друг с другом в одном ряду.
В: Что такое поля макета (Вкладка, Аккордеон, Сообщение) и хранят ли они данные?О: Поля макета не хранят никаких данных. Это чисто организационные инструменты, которые улучшают процесс редактирования. Поля Вкладки разбивают вашу группу полей на кликабельные вкладки. Поля Аккордеон создают сворачиваемые секции. Поля Сообщение отображают инструктивный текст, чтобы помочь менеджерам контента понять, что вводить. Используйте их свободно — они не влияют на производительность или хранение.
Совместимость с ACF
В: Будет ли работать мой существующий код темы с Field Forge?О: Да. Field Forge предоставляет полный уровень совместимости с ACF. Функции, такие как get_field(), the_field(), have_rows(), get_sub_field() и все другие стандартные функции ACF работают идентично. Ваш код темы не требует никаких изменений. Field Forge автоматически регистрирует эти функции, когда ACF не активен. Во время запросов активации ACF Field Forge передает управление ACF, чтобы ACF Pro мог быть включен для миграции без фатальной ошибки повторного объявления PHP.
О: Технически да, но это не рекомендуется для обычного использования. Во время миграции оба плагина должны быть активны, чтобы Field Forge мог читать данные ACF. После завершения миграции и проверки, что все работает, деактивируйте ACF. Долгосрочная работа обоих плагинов может вызвать конфликты, поскольку они оба пытаются зарегистрировать одни и те же функции.
В: Поддерживает ли Field Forge функции ACF Pro, такие как Повторитель и Гибкий контент?О: Да, с лицензией Field Forge PRO. Повторитель, Группа, Гибкий контент, Клонирование, Страницы опций, Галерея, oEmbed, Выбор времени и поля Связи доступны в PRO. Инструмент миграции также обрабатывает импорт этих сложных типов полей из ACF Pro.
Миграция из ACF
В: Сломает ли миграция из ACF мой сайт?О: Нет. Процесс миграции не разрушителен. Field Forge читает ваши данные ACF и создает свою собственную копию в оптимизированных таблицах базы данных. Ваши оригинальные данные ACF остаются нетронутыми в wp_postmeta. Если что-то пойдет не так, вы можете просто повторно активировать ACF, и ваш сайт будет работать точно так же, как и раньше.
О: Для небольших сайтов (менее 100 постов) миграция завершается за секунды. Для больших сайтов с тысячами постов миграция значений (PRO) выполняется партиями по 50 постов и обрабатывается в фоновом режиме. Сайт с 5,000 постами обычно занимает 2-5 минут. Вы можете закрыть браузер во время фоновой обработки — она продолжается на сервере.
В: Нужен ли мне PRO для миграции из ACF?О: Бесплатная версия может импортировать определения групп полей (структуру). Чтобы также мигрировать фактические значения полей (данные контента, хранящиеся на каждом посте), вам нужен PRO. Для большинства практических миграций вам нужны как структура, так и данные, поэтому рекомендуется использовать PRO.
В: Что если моя настройка ACF использует зарегистрированные в PHP группы полей (не UI)?О: Field Forge обнаруживает как группы полей, хранящиеся в базе данных, так и зарегистрированные в PHP группы ACF. Если ваши группы полей зарегистрированы через acf_add_local_field_group() в вашей теме, инструмент миграции также их подберет.
О: Field Forge может читать файлы ACF Local JSON из acf-json/group_*.json в активной теме, родительской теме и отфильтрованных путях загрузки ACF. Миграция импортирует структуру группы полей из этих JSON-файлов, даже когда посты acf-field-group и acf-field отсутствуют. Значения полей все еще поступают из метаданных стиля ACF и требуют миграции значений PRO.
Страницы опций
В: Сколько страниц опций я могу создать?О: С PRO нет ограничений. Вы можете создать столько страниц опций верхнего уровня и подпунктов, сколько необходимо вашему сайту. Типичная настройка может включать главную страницу «Настройки сайта» с подпунктами для «Социальные сети», «Подвал» и «Внешний вид».
В: Где хранятся данные страниц опций?О: Данные страниц опций хранятся в собственной таблице Field Forge wp_fieldforge_options, отдельно от обычных данных постов. Вы получаете к ним доступ в шаблонах, используя get_field('field_name', 'options'). Параметр 'options' говорит Field Forge искать в таблице опций вместо текущего поста.
О: По умолчанию страницы опций требуют возможности manage_options, что означает, что только администраторы могут их видеть. Вы можете установить пользовательскую возможность при создании страницы опций, чтобы предоставить доступ редакторам или другим ролям.
Повторитель, Группа и Гибкий контент
В: В чем разница между Повторителем и Группой?О: Повторитель позволяет создавать несколько строк — менеджеры контента добавляют столько элементов, сколько им нужно (например, список членов команды). Группа всегда имеет ровно один набор подполей (например, один блок адреса). Используйте Повторитель, когда количество элементов варьируется, и Группу, когда у вас всегда есть ровно один набор связанных данных.
В: Могу ли я вложить Повторители в другие Повторители?О: Да. Вы можете вложить повторители для сложных структур данных. Например, Повторитель «Курсы» может содержать Повторитель «Уроки» внутри каждого курса. Имейте в виду, что глубоко вложенные повторители могут усложнить интерфейс редактирования для менеджеров контента — два уровня вложенности обычно являются практическим пределом.
В: Сколько макетов может иметь поле Гибкого контента?О: Жесткого ограничения нет, но рекомендуется диапазон от 4 до 8 макетов для удобства использования. Слишком много вариантов макета может перегрузить менеджеров контента. Каждый макет может содержать любую комбинацию типов полей, включая Повторители и Группы.
В: Могу ли я установить минимальное и максимальное количество строк в Повторителе?О: Да. В настройках поля Повторителя вы можете установить минимум (например, «не менее 3 функций») и максимум (например, «не более 10 элементов»). Менеджеры контента видят кнопку Добавить строку отключенной, когда достигнут максимум, и не могут удалить строки ниже минимума.
Производительность
В: Является ли Field Forge быстрее, чем ACF?О: Да. Field Forge хранит данные в своей собственной оптимизированной таблице базы данных (wp_fieldforge_values) вместо wp_postmeta. Это означает меньше запросов к базе данных, особенно на страницах с множеством полей. Посты с 20+ полями видят наибольшее улучшение, потому что ACF делает отдельный запрос к базе данных для каждого поля, в то время как Field Forge извлекает все значения в одном запросе.
О: Количество групп полей имеет минимальное влияние на производительность фронтенда. Группы полей влияют только на опыт редактирования администратора (загрузка определений полей). На фронтенде запрашиваются только значения полей, и они извлекаются эффективно, независимо от того, сколько групп полей вы определили.
В: Должен ли я беспокоиться о производительности с Повторителями, содержащими много строк?О: Повторители с до 100-200 строками работают хорошо. Если вам регулярно нужно более 200 строк данных, подумайте, может ли пользовательский тип поста быть лучшим подходом. Например, вместо повторителя с 500 строками продуктов создайте пользовательский тип поста «Продукт», где каждый продукт является своим собственным постом.
Local JSON
В: Что такое Local JSON и нужен ли он мне?О: Local JSON сохраняет определения ваших групп полей в виде файлов .json внутри папки вашей темы. Это в первую очередь полезно для рабочих процессов разработчиков, связанных с контролем версий (Git). Если вы менеджер контента без разработчика в команде, вам не нужна эта функция. Если вы работаете с разработчиком, он может включить ее, чтобы изменения группы полей могли отслеживаться в коде.
О: Когда вы сохраняете группу полей, Field Forge автоматически записывает обновленный JSON-файл в папку вашей темы. Если ваш разработчик также внес изменения в ту же группу полей через код, вы можете увидеть уведомление о синхронизации в следующий раз, когда посетите админку. Уведомление позволяет вам выбрать, какую версию сохранить.
REST API
В: Есть ли у Field Forge REST API?О: Да. Field Forge предоставляет конечные точки на /wp-json/fieldforge/v1/ для управления группами полей, чтения и записи значений полей и работы со страницами опций. Публичные чтения схемы группы полей (GET /field-groups и GET /field-groups/{id}) доступны без куки для безголовых/фронтендовых использований и включают заголовки кэша. Чтения значений и все конечные точки записи/импорта/генерации все еще требуют аутентификации (на основе куки с nonce или паролей приложений) и соответствующей возможности WordPress.
О: Чтение значений полей для опубликованных постов доступно аутентифицированным пользователям с соответствующими возможностями. Конечные точки уровня администратора (создание групп полей, импорт данных) требуют возможности manage_options. Ваш разработчик может настроить пользовательские разрешения, если это необходимо.
О: Да. Когда WPGraphQL активен, Field Forge регистрирует нативные поля схемы для соответствующих групп полей без необходимости в WPGraphQL для ACF. Поля медиа разрешаются в MediaItem, поля связи разрешаются в ContentNode, поля таксономии разрешаются в TermNode, и эти сопоставления объектов также работают внутри подполей Группы, Повторителя и Гибкого контента. Анонимные запросы получают null или отфильтрованные списки для недоступных частных/черновых/защищенных паролем постов.
В: Почему объектfieldforge пуст на /wp-json/wp/v2/posts/...?
О: Основная нагрузка REST-постов WordPress теперь является опциональной. Установите show_in_rest => true на полях, которые безопасно экспонировать публично, или используйте аутентифицированную конечную точку /wp-json/fieldforge/v1/fields/{post_id} для рабочих процессов редактора/администратора. Поля с паролем и чувствительные поля по умолчанию скрыты, даже когда родительская группа публична.
Лицензия и ограничения
В: Каковы ограничения бесплатного тарифа?О: Бесплатный тариф включает до 3 групп полей, 20 типов полей (Текст, Текстовое поле, Число, Диапазон, Электронная почта, URL, Пароль, Изображение, Файл, WYSIWYG, Выбор, Флажок, Радио, Истина/Ложь, Группа кнопок, Выбор даты, Выбор цвета, Вкладка, Аккордеон, Сообщение), историю изменений, импорт/экспорт и уровень совместимости с ACF. Вам не нужен PRO для базовых пользовательских полей на небольшом сайте.
В: Что добавляет PRO?О: PRO разблокирует неограниченные группы полей, 12 дополнительных типов полей (Повторитель, Группа, Гибкий контент, Клонирование, Связь, Объект поста, Ссылка на страницу, Таксономия, Пользователь, Галерея, oEmbed, Выбор времени), Страницы опций, Синхронизация Local JSON, миграцию значений полей из ACF, Генерацию полей AI, генерацию TypeScript и приоритетную поддержку.
В: Могу ли я использовать одну лицензию PRO на нескольких сайтах?О: Условия лицензии определяются при покупке. Проверьте детали вашей лицензии на сайте Field Forge. Обычно каждая лицензия покрывает один производственный сайт, хотя разрешены среды разработки и тестирования.
В: Что произойдет, если моя лицензия PRO истечет?О: Ваши существующие группы полей PRO и данные продолжат работать. Вы сохраняете доступ ко всем функциям, которые уже настроены. Однако вы не получите обновления и не сможете активировать PRO на новых сайтах, пока не продлите лицензию.