Известные проблемы

Все группы полей, созданные с помощью плагина Advanced Custom Fields, отображаются как пустые видимые метабоксы при редактировании записи, независимо от правил размещения этих групп полей.

Это связано с решением в Gutenberg переопределить CSS display:none, который ACF добавляет к метабоксам-заполнителям — они используются для динамического обновления метабоксов во время редактирования записи.

Статус: Решено.

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

Следовало уделить больше внимания стилям метабоксов, чтобы избежать такого несогласованного UI и UX.

Статус: Это также известная проблема, которую перенесли в WordPress 5.0.1.

Еще одна широко используемая функция ACF — наша AJAX-проверка. Она позволяет разработчикам гибко настраивать процесс проверки через PHP, предоставляя удобную обратную связь пользователю, когда значение поля не соответствует требованиям.

Статус: Мы продолжаем работать над внедрением валидации в AJAX-блоки. Мы ждали, пока команда Gutenberg предоставит пользовательские хуки валидации, которые позволят сделать это единообразно и подключиться ко всей стандартной логике сохранения страницы.

Сообщалось об ошибке, при которой последовательные вызовы get_field() использовали одно и то же кэшированное значение, даже если сайт переключался через switch_to_blog().

Статус: Решено. Пожалуйста, повторно скачайте файлы плагина ACF PRO.

Ошибка в классе правила размещения post_template приводила к тому, что в выпадающем списке правил отображались неверные варианты. Варианты показывались как «Название шаблона» => «template-file-name.php» вместо «template-file-name.php» => «Название шаблона».

Статус: Решено. Пожалуйста, повторно скачайте файлы плагина ACF PRO.

Ошибка, обнаруженная в функции проверки полей text и textarea, приводила к неверному подсчёту символов при проверке значения, содержащего специальные символы.

Статус: Решено. Пожалуйста, повторно скачайте файлы плагина ACF PRO.

Ошибка, обнаруженная в логике «Local Fields», приводила к тому, что все метабоксы отображались в обратном порядке.

Статус: Решено. Пожалуйста, повторно скачайте файлы плагина ACF PRO.

Ошибка, обнаруженная в функции acf_get_meta(), вызывала проблемы при копировании значений метаданных для ревизий и предпросмотров. Эта ошибка затрагивала сериализованные значения массивов и приводила к тому, что поле Flexible Content выглядело пустым при предварительном просмотре или восстановлении ревизии.

Статус: Решено. Пожалуйста, повторно скачайте файлы плагина ACF PRO.

Ошибка, обнаруженная в функции get_field_object(), не позволяла загрузить поле по его ключу.

Статус: Решено. Пожалуйста, повторно скачайте файлы плагина ACF PRO.

Ошибка, обнаруженная в функции get_sub_field(), приводила к возврату неверных значений для некоторых подполей. Чаще всего это проявлялось, когда существовало подполе со значением «name», равным названию типа поля, например «text» или «image».

Статус: Решено. Пожалуйста, повторно скачайте файлы плагина ACF PRO.

Ошибка в логике синхронизации групп полей (из Local JSON) приводила к тому, что импортированные поля теряли свои дочерние элементы.

Статус: Решено. Пожалуйста, повторно скачайте файлы плагина ACF PRO.

Ошибка в функции acf_update_metadata() приводила к тому, что значения со страницы Options Page неверно экранировались, из-за чего появлялось несколько обратных слэшей.

Статус: Решено. Пожалуйста, повторно скачайте файлы плагина ACF PRO.

Функция register_field_group() была случайно удалена.

Статус: Решено. Пожалуйста, повторно скачайте файлы плагина ACF PRO.

Быстро была обнаружена и исправлена ошибка JS с сообщением Object.e.getPreference. Ошибки JS имеют тенденцию накапливаться и превращаться в более серьёзные проблемы, такие как неотвечающие кнопки и сломанная функциональность. Если у вас возникают какие-либо проблемы при редактировании записи, пожалуйста, повторно скачайте файлы плагина ACF PRO, чтобы получить исправленный JS.

Совет: Вы также можете заставить ACF заново обновиться, отредактировав основной файл плагина «acf.php» и изменив два вхождения «5.7.2» на «5.7.1». Это позволит WP проверить обновления плагина, после чего вы сможете обновить его снова.

Статус: Решено. Пожалуйста, повторно скачайте файлы плагина ACF PRO.

Была обнаружена ошибка, из-за которой ACF неверно возвращал «значение по умолчанию» для полей, у которых нет значения. Если у вас возникают проблемы, когда функции ACF возвращают нежелательные значения, отредактируйте файл ‘includes/api/api-field.php’ и измените строку 1083 на следующее:

function acf_maybe_get_field( $selector, $post_id = false, $strict = true ) {

Статус: Решено. Пожалуйста, повторно скачайте файлы плагина ACF PRO.

[/accordion>

ACF 5.6.6

Проблемы с условной логикой

Ошибка в JS условной логики вызывает проблемы с проверкой для недавно добавленных макетов Flexible Content. Если вы сталкиваетесь с неверными ошибками проверки, пожалуйста, повторно скачайте файлы плагина и свяжитесь с нашей службой поддержки, если проблемы сохраняются.

Статус: Решено. Пожалуйста, повторно скачайте файлы плагина ACF PRO.

Слишком усердная функция esc_js() вызывает проблемы с символами в значении acf.fields.google_map.url. Это может помешать работе функции автозаполнения Google Map. Пожалуйста, отредактируйте файл ‘includes/fields/class-acf-field-google-map.php’ и измените строку 300 на следующее:

if( acf ) acf.fields.google_map.url = '';

Статус: Решено. Пожалуйста, повторно скачайте файлы плагина ACF PRO.

Эта ошибка вызвана отсутствующим атрибутом step у поля ввода числа. Пожалуйста, отредактируйте файл ‘includes/fields/class-acf-field-range.php’ и измените строку 101 на следующее:

$html .= acf_get_text_input(array(
    'type'  => 'number', 
    'id'    => $atts['id'] . '-alt', 
    'value' => $atts['value'],
    'step'  => $atts['step']
));

Статус: Решено в 5.6.3.

Ошибка в Clone field вызывает проблемы с отображением, когда он используется как подполе внутри макета Flexible Content.

Статус: Решено. Пожалуйста, повторно скачайте файлы плагина ACF PRO.

Это ожидаемое поведение, добавленное в v5.5.13 и включённое по умолчанию в 5.6.0. Теперь ACF удаляет стандартный метабокс пользовательских полей WP, чтобы ускорить загрузку страницы редактирования записи. Эту функцию можно отключить следующим кодом.

add_filter('acf/settings/remove_wp_meta_box', '__return_false');

Ошибка в логике правил размещения приводит к тому, что правила Post и Page неверно совпадают при использовании оператора !=.

Статус: Решено. Пожалуйста, повторно скачайте файлы плагина ACF PRO.

Ошибка в этом правиле размещения мешает значению «all» работать так, как ожидается. Обратите внимание, что «user_role = all» можно добиться с помощью правила размещения User Form. Попробуйте изменить правило на «user_form = all».

Статус: Решено. Пожалуйста, повторно скачайте файлы плагина ACF PRO.

Недавние изменения в базовом классе acf_field вызвали конфликт с некоторыми сторонними типами полей (например, image crop и component), которые расширяют базовые поля ACF (например, image и repeater), из-за чего базовые поля рендерятся дважды. Скорее всего, сторонний плагин уже выпустил обновление для решения этой проблемы, но если нет, добавьте пустой initialize() в класс стороннего поля. Подробнее можно узнать в этой проблеме на GitHub.

function initialize() {
        
        /* ничего не делать */
            
    }

Недавние изменения в действии ‘acf/save_post’ приводят к тому, что любые изменения данных $_POST['acf'] (во время действия ‘acf/save_post’) игнорируются. Кроме того, любой пользовательский код, вызывающий действие ‘acf/save_post’, будет завершаться без ошибки, если в качестве второго параметра не определён массив значений.

Статус: Решено. Пожалуйста, повторно скачайте файлы плагина ACF PRO.

Эта проблема вызвана описанной выше ошибкой «Проблемы при изменении данных $_POST и действия acf/save_post» и не позволяет базовому загрузчику сохранить ID загруженного вложения.

Статус: Решено. Пожалуйста, повторно скачайте файлы плагина ACF PRO.

Эта проблема вызвана тем, что некоторый код ядра WP изменяет данные $_POST во время действия сохранения меню. Намерение этого кода WP — предотвратить ограничения PHP max_input_vars — это отлично, но из-за него несколько значений типа «array» не сохраняются.

Мы открыли тикет в WP и нашли удачное исправление для ACF PRO!

Статус: Решено. Пожалуйста, повторно скачайте файлы плагина ACF PRO.

Эта проблема вызвана небольшим изменением в логике страницы Options Page и затронет тех, кто регистрирует страницы options pages напрямую в корне файла functions.php (не внутри действия ‘acf/init’).

Статус: Решено. Пожалуйста, повторно скачайте файлы плагина ACF PRO.

В настоящее время вы не можете включить пагинацию для полей Repeater, если они являются подполями поля Flexible Content или Repeater. Поддержка этого появится в более поздней версии.

Для ACF Blocks, использующих blockVersion: 2 и jsx: true (оба значения по умолчанию для блоков block.json), ваш PHP-шаблон для блока не может начинаться с HTML-комментария. Если это так, ваш блок будет аварийно завершаться при вставке предпросмотра с сервера, поскольку React не может добавить ссылки к HTML-комментариям, а ACF Blocks нужно прикрепить одну к первому элементу в вашем шаблоне.