wp acf json export

Обзор

Экспортирует группы полей, типы записей, таксономии и страницы настроек в JSON-файл.

Описание

Экспортирует элементы ACF в JSON-файл, воспроизводя работу инструмента экспорта в админ-панели WordPress. Можно экспортировать все элементы или отфильтровать их по определённым типам и ключам.

Параметры

wp acf json export [--field-groups=<keys>] [--post-types=<keys>] [--taxonomies=<keys>] [--options-pages=<keys>] [--dir=<directory>] [--stdout]

--field-groups=<keys>
(string) Необязательный параметр. Экспорт определённых групп полей по ключу или названию, разделённых запятыми.

--post-types=<keys>
(string) Необязательный параметр. Экспорт определённых типов записей по ключу или названию, разделённых запятыми.

--taxonomies=<keys>
(string) Необязательный параметр. Экспорт определённых таксономий по ключу или названию, разделённых запятыми.

--options-pages=<keys>
(string) Необязательный параметр. Экспорт определённых страниц настроек по ключу или названию, разделённых запятыми. Требуется ACF PRO.

--dir=<directory>
(string) Обязательный параметр (если не используется --stdout). Путь к каталогу, в который будет записан JSON-файл.

--stdout
(flag) Необязательный параметр. Выводит JSON в stdout вместо записи в файл. Удобно для передачи данных другим командам.

Примеры

Экспорт всех элементов в каталог

$ wp acf json export --dir=./exports/
Успешно: экспортировано элементов: 15. Файл: ./exports/acf-export-2025-01-01.json

Экспорт определённых групп полей по ключу

$ wp acf json export --field-groups=group_abc123,group_def456 --dir=./

Экспорт группы полей по названию

$ wp acf json export --field-groups="Моя группа полей" --dir=./

Экспорт нескольких типов элементов

$ wp acf json export --field-groups=group_abc123 --post-types=post_type_def456 --dir=./exports/

Вывод в stdout для передачи другим командам

# Вывести необработанный JSON
$ wp acf json export --stdout

# Форматировать с помощью jq
$ wp acf json export --field-groups=group_abc123 --stdout | jq .

# Передать другой команде
$ wp acf json export --stdout > backup.json

Резервное копирование перед развёртыванием

# Экспортировать текущее состояние перед синхронизацией
$ wp acf json export --dir=./backups/
$ wp acf json sync

Результат

При использовании --dir команда создаёт в указанном каталоге файл с именем acf-export-YYYY-MM-DD.json и выводит сообщение об успешном выполнении с количеством элементов и путём к файлу.

При использовании --stdout JSON напрямую выводится в терминал.

Примечания

Необходимо указать --dir или --stdout
Нельзя использовать --dir и --stdout одновременно
Если параметры фильтрации не указаны, экспортируются все элементы всех типов
Элементы можно указывать по ключу ACF (например, group_abc123) или по их заголовку/названию
Экспорт включает все поля групп полей
Для страниц настроек требуется ACF PRO

Ошибки

Ошибка	Причина
Необходимо указать –dir или –stdout	Не указан ни один параметр вывода
Нельзя указать одновременно –dir и –stdout	Указаны оба параметра вывода
Каталог не найден	Указанный каталог не существует
Каталог недоступен для записи	Каталог существует, но запись в него невозможна
Элементы для экспорта не найдены	Ни один элемент не соответствует указанным фильтрам

Обновлено: 30.09.2026