Как использовать WP-CLI для массового управления постами в WordPress

Что такое WP-CLI и зачем он нужен для управления постами

WP-CLI — это интерфейс командной строки для WordPress, который позволяет выполнять множество задач без захода в админку. Особенно полезен для массового управления постами: изменение статусов, обновление категорий, удаление, экспорт и т.д. Это экономит время и снижает риск ошибок при ручном редактировании.

Диагностика задачи: когда стоит использовать WP-CLI для постов

Если нужно массово изменить свойства сотен или тысяч записей — например, перевести их в черновики, заменить категории, добавить метаданные — WP-CLI это оптимальный инструмент. Такие задачи сложно и долго реализовать через админ-панель или плагины, особенно на больших сайтах.

Проверяем, установлен ли WP-CLI

wp --info

Если команда возвращает информацию, WP-CLI установлен. Если нет — нужно установить согласно официальной документации.

Пошаговое решение: массовое обновление статусов постов

1. Получить список постов по условию

Например, получить ID всех опубликованных постов в категории с ID 12:

wp post list --post_type=post --post_status=publish --category=12 --field=ID

2. Изменить статус всех этих постов на черновики

wp post list --post_type=post --post_status=publish --category=12 --field=ID | xargs -d "\n" -I % wp post update % --post_status=draft

Команда получает ID постов и передает их по одному в команду обновления статуса.

3. Добавить метаполе ко всем постам

wp post list --post_type=post --post_status=draft --field=ID | xargs -d "\n" -I % wp post meta add % my_custom_key "custom value"

Проверка результата после внедрения

Проверьте статус постов командой:

wp post list --post_type=post --category=12 --field=ID,post_status

Убедитесь, что у нужных постов статус изменился на draft. Для проверки метаполей:

wp post meta get POST_ID my_custom_key

где POST_ID — ID поста из списка.

Частые ошибки и как их исправить

• Ошибка: WP-CLI не найден
  Проверьте, что WP-CLI установлен и доступен в PATH пользователя, под которым вы работаете.
• Ошибка: неправильный синтаксис команды
  Обязательно используйте правильные параметры и проверяйте документацию wp help post.
• Ошибка: команды не выполняются из корня WordPress
  WP-CLI должен запускаться из корневой директории сайта или укажите параметр --path=путь_к_wp.
• Проблемы с кодировкой при использовании xargs
  Используйте -d "\n" для разделения по строкам, чтобы избежать ошибок.

Практические советы по безопасности и производительности

• Перед массовыми изменениями сделайте резервную копию базы данных.
• Запускайте команды на тестовом сайте, чтобы проверить логику.
• Для очень больших объемов данных используйте WP-CLI с ограничением по количеству записей через --number=100 и циклы в bash скриптах.
• Убедитесь, что у пользователя, под которым выполняется WP-CLI, есть права на изменение постов.

Сравнение подходов: WP-CLI против плагинов и ручной работы