Обзор
Синхронизирует локальные изменения 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 элемент(а) ожидают синхронизации:
+-------------------+------------------+---------------+--------+
| Key | Title | Type | Action |
+-------------------+------------------+---------------+--------+
| group_abc123 | Product Fields | field-group | Update |
| group_def456 | Homepage | field-group | Create |
| taxonomy_ghi789 | Product Category | taxonomy | Update |
+-------------------+------------------+---------------+--------+
Синхронизация всех ожидающих изменений
$ wp acf json sync
Обновлена группа полей: Product Fields (group_abc123)
Создана группа полей: Homepage (group_def456)
Обновлена таксономия: Product Category (taxonomy_ghi789)
Успешно: синхронизировано элементов: 3.
Синхронизация только групп полей
$ wp acf json sync --type=field-group
Синхронизация определенной группы полей
$ wp acf json sync --key=group_abc123
Обновлена группа полей: Product Fields (group_abc123)
Успешно: синхронизирован 1 элемент.
Процесс развертывания CI/CD
# Предварительный просмотр изменений
$ wp acf json sync --dry-run
# Применение изменений
$ wp acf json sync
# Проверка завершения синхронизации
$ wp acf json status
Примечания
- Всегда сначала запускайте
--dry-runв рабочих средах - Команда синхронизации воспроизводит функцию «Синхронизация» в административной панели WordPress
- Элементы, отмеченные как приватные, пропускаются
- Если ожидающих элементов нет, команда выводит сообщение «Все уже синхронизировано.»
- Для страниц опций требуется ACF PRO
Обновлено: 30.09.2026