Обзор
Экспортирует группы полей, типы записей, таксономии и страницы опций в 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 | Были указаны оба варианта вывода |
| Каталог не найден | Указанный каталог не существует |
| Каталог недоступен для записи | Каталог существует, но в него нельзя записывать |
| Не найдено элементов для экспорта | Ни один элемент не соответствует указанным фильтрам |
Обновлено: 02.06.2026