Обзор
Синхронизирует локальные изменения JSON с базой данных.
Описание
Импортирует ожидающие изменения JSON для типов элементов ACF (группы полей, типы записей, таксономии, страницы опций). Эта команда читает файлы JSON из каталога acf-json вашей темы/плагина и создаёт или обновляет соответствующие записи в базе данных.
Внимание: Эта команда изменяет вашу базу данных. Сначала используйте --dry-run, чтобы предварительно посмотреть изменения перед запуском на продакшене.
Параметры
wp acf json sync [--type=<type>] [--key=<key>] [--dry-run]
--type=<type>
(string) Необязательно. Ограничивает синхронизацию конкретным типом элемента. По умолчанию — все типы элементов (группы полей, типы записей, таксономии, страницы опций).
– field-group
– post-type
– taxonomy
– options-page (только ACF PRO)
--key=<key>
(string) Необязательно. Синхронизирует конкретный элемент по его ключу ACF (например, group_abc123).
--dry-run
(flag) Необязательно. Показывает, что было бы синхронизировано, без внесения изменений. Рекомендуется для продакшн-развёртываний.
Примеры
Предварительный просмотр того, что будет синхронизировано (безопасно)
$ wp acf json sync --dry-run
3 элемента ожидают синхронизации:
+-------------------+------------------+---------------+---------+
| Ключ | Заголовок | Тип | Действие|
+-------------------+------------------+---------------+---------+
| group_abc123 | Product Fields | field-group | Обновить|
| group_def456 | Homepage | field-group | Создать |
| taxonomy_ghi789 | Product Category | taxonomy | Обновить|
+-------------------+------------------+---------------+---------+
Синхронизировать все ожидающие изменения
$ wp acf json sync
Обновлён field-group: Product Fields (group_abc123)
Создан field-group: Homepage (group_def456)
Обновлён taxonomy: Product Category (taxonomy_ghi789)
Успешно: синхронизировано 3 элемента.
Синхронизировать только группы полей
$ wp acf json sync --type=field-group
Синхронизировать конкретную группу полей
$ wp acf json sync --key=group_abc123
Обновлён field-group: Product Fields (group_abc123)
Успешно: синхронизирован 1 элемент.
Рабочий процесс развёртывания CI/CD
# Предварительный просмотр изменений
$ wp acf json sync --dry-run
# Применить изменения
$ wp acf json sync
# Проверить, что синхронизация завершена
$ wp acf json status
Примечания
- Всегда сначала запускайте
--dry-runв production-окружении - Команда sync повторяет функцию «Sync» в админке WordPress
- Элементы, отмеченные как private, пропускаются
- Если нет ожидающих элементов, команда выводит «Всё уже синхронизировано.»
- Страницы опций требуют ACF PRO
Обновлено: 02.06.2026