wp acf json

Обзор

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

Описание

Команда wp acf json предоставляет доступ к функции Local JSON в ACF через CLI, позволяя автоматизировать рабочие процессы для контроля версий, развертываний и CI/CD-конвейеров.

Доступные команды

КомандаОписание
wp acf json statusПоказывает статус синхронизации для элементов ACF
wp acf json syncСинхронизирует локальные изменения JSON с базой данных
wp acf json importИмпортирует элементы из JSON-файла
wp acf json exportЭкспортирует элементы в JSON-файл

Примеры

# Показать статус синхронизации для всех типов элементов
$ wp acf json status

# Синхронизировать все ожидающие локальные изменения JSON с базой данных
$ wp acf json sync

# Импортировать из JSON-файла
$ wp acf json import ./acf-export.json

# Экспортировать все элементы в каталог
$ wp acf json export --dir=./exports/

# Экспортировать в stdout
$ wp acf json export --stdout

Требования

  • ACF 6.8 или новее
  • WP-CLI 2.0 или новее
  • Для страниц опций требуется ACF PRO

Примечания

Эти команды повторяют функциональность, доступную в админ-интерфейсе WordPress, что делает их идеальными для:

  • Развертываний CI/CD: синхронизация JSON-файлов с базой данных в рамках конвейера развертывания
  • Рабочих процессов контроля версий: экспорт групп полей в JSON для коммита в Git
  • Автоматизированного тестирования: настройка тестовых окружений с согласованными конфигурациями полей
  • Управления несколькими окружениями: перенос конфигураций между staging и production

Обновлено: 02.06.2026