Сумісність ACF — get_field() Просто Працює | Field Forge - Кастомні поля, створені для швидкості

Що входить до сумісного шару

Field Forge реалізує ці функції ACF нативно:

Основні функції полів

“php get_field($field_name, $post_id = null, $format_value = true); the_field($field_name, $post_id = null, $format_value = true); get_fields($post_id = null, $format_value = true); get_field_object($field_name, $post_id = null, $format_value = true, $load_value = true); get_field_objects($post_id = null, $format_value = true, $load_value = true); update_field($field_name, $value, $post_id = null); delete_field($field_name, $post_id = null); “

Функції циклу повторювачів та гнучкого контенту

“php have_rows($field_name, $post_id = null); the_row($format_value = false); get_row($format_value = false); get_row_index(); get_row_layout(); reset_rows(); “

Функції підполів (всередині повторювачів / груп / гнучких циклів)

“php get_sub_field($field_name, $format_value = true); the_sub_field($field_name, $format_value = true); get_sub_field_object($field_name, $format_value = true, $load_value = true); update_sub_field($field_name_or_selector, $value, $post_id = null); “

Функції групи полів

“php acf_get_field_group($id_or_key); acf_get_field_groups($args = []); acf_get_fields($field_group); “

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

“php // Обидва 'options' та 'option' псевдо-ID працюють get_field('site_logo', 'options'); get_field('site_logo', 'option'); “

Сумісність полів користувача

“php get_field('bio', 'user_123'); update_field('bio', $new_bio, 'user_123'); “

Реєстрація блоку Gutenberg

“php acf_register_block_type([ 'name' => 'hero', 'title' => 'Розділ Героя', 'render_callback' => 'render_hero_block', 'category' => 'theme', 'icon' => 'cover-image', ]); “

Кожна функція вище працює ідентично ACF. Ті ж параметри, ті ж значення, та ж поведінка.

Як це працює

Коли Field Forge активний:

Глобальні функції ACF визначені Field Forge через function_exists() охоронці
Виклики маршрутизуються до сховища Field Forge (кастомна wp_fieldforge_values таблиця)
Повернені значення відповідають формату ACF — масиви, об’єкти, рядки, WP_Image / WP_Post / WP_User об’єкти, де це доречно
$format_value параметр поважаються — передача false повертає сирі значення, true повертає відформатовані значення (так само, як ACF)

Якщо ACF також активний на тому ж сайті (під час міграції), функції Field Forge не реєструються — ACF має пріоритет. Після деактивації ACF версії Field Forge беруть на себе. Це означає, що ви можете встановити Field Forge разом з ACF без конфліктів під час тестування.

Чому це важливо

Міграція без переписування теми

Більшість плагінів “альтернативи ACF” вимагають, щоб ви переписали кожен виклик get_field() у вашій темі, щоб використовувати їхній власний API. Для сайту з 200 шаблонними файлами та 500+ посиланнями на поля це тижні роботи та високий ризик регресій.

Сумісний шар Field Forge зменшує міграцію до:

Встановіть Field Forge разом з ACF
Запустіть імпортер групи полів + значень
Деактивуйте ACF
Тестуйте сайт — шаблони повинні відображатися ідентично
Field Forge тепер надає ті ж дані, які раніше надавав ACF

Жодних змін у шаблонах. Жодного ризику “Я забув оновити той один шаблон.”

Сумісність SCF безкоштовно

Secure Custom Fields (форк ACF на WordPress.org, створений у жовтні 2024 року) використовує ті ж шаблонні функції, що й ACF — get_field(), have_rows() тощо. Оскільки сумісний шар Field Forge реалізує ACF API, він також працює для коду SCF. Якщо ви використовуєте SCF і хочете мігрувати до Field Forge, той же процес, той же сумісний шар.

Сумісність з плагінами третіх сторін

Плагіни, які інтегруються з ACF, зазвичай викликають глобальні функції ACF. Популярні приклади:

WPGraphQL для ACF — читає acf_get_field_groups() та acf_get_fields()
Динамічні теги Elementor — читає get_field() для динамічних контентних тегів
Beaver Themer — читає get_field() для частин шаблону
Інтеграція ACF Toolset — читає ACF API

Більшість з цих плагінів продовжують працювати, коли ви переходите з ACF на Field Forge, оскільки сумісний шар надає той же API.

`acf_register_block_type()` працює

Функція реєстрації блоку ACF є однією з найпоширеніших функцій ACF Pro, на які покладаються агентства. Кастомні блоки Gutenberg, зареєстровані через acf_register_block_type(), продовжують працювати після міграції:

“`php // Цей код працює без змін з активним Field Forge замість ACF acf_register_block_type([ ‘name’ => ‘feature-card’, ‘title’ => __(‘Картка Особливості’), ‘render_callback’ => ‘my_feature_render_callback’, ‘category’ => ‘theme’, ‘icon’ => ‘star-filled’, ]);

function my_feature_render_callback($block) { $title = get_field(‘title’); // Працює $icon = get_field(‘icon’); // Працює // … рендер HTML } “`

Що НЕ входить до сумісного шару

Для повної прозорості, ось що Field Forge не (ще) відтворює з ACF:

Екран адміністратора ACF — Field Forge має свій власний візуальний конструктор з іншим інтерфейсом
Імена хуків та фільтрів ACF — Field Forge має еквівалентні хуки, але з префіксом fieldforge/ замість acf/
acf.php JavaScript API в адмінці — Field Forge має свій власний JS API
Деякі нішеві фільтри ACF (розширення типів полів) — якщо ви покладаєтеся на кастомні типи полів, визначені через хуки ACF, міграція може вимагати невеликих коригувань

Для 95% сайтів ACF жодна з цих прогалин не має значення, оскільки розробники тем використовують лише шаблонні функції, а не внутрішні API.

Довіра до міграції

Оскільки сумісний шар ACF тестується на реальних тестових випадках ACF, ми знаємо, що він обробляє:

Основні текстові, текстові області, числові, електронні, URL поля
WYSIWYG поля з HTML
Зображення та файлові поля (повертає масиви, що відповідають формату ACF)
Поля вибору, радіо, чекбокси (з параметром format_value)
Поля вибору дати та часу
Поля повторювачів з довільним вкладенням
Гнучкий контент з кількома макетами
Групові поля
Поля зв’язку та об’єкта поста
Таксономії та поля користувача
Сторінки параметрів (як 'options', так і 'option' псевдо-ID)
acf_register_block_type() зворотні виклики
Параметр format_value у всіх функціях

Якщо ви знайдете випадок, де поведінка нашого сумісного шару відрізняється від ACF, це помилка, яку ми хочемо виправити. Напишіть на підтримку з деталями.

Готові до міграції без переписування вашої теми?

Отримайте Field Forge — від $35/рік →

Сумісний шар ACF є в кожній версії Field Forge, включаючи безкоштовну. Міграція з ACF або SCF займає хвилини, а не тижні.

Сумісність ACF — get_field() Просто Працює