Как устанавливать плагины WordPress через Composer

Если WordPress уже установлен через Composer, плагины логично ставить тем же способом. Тогда весь набор плагинов с точными версиями записан в composer.json и composer.lock, а новый сервер собирается одной командой.

WPackagist

WPackagist зеркалит каталог wordpress.org в формате Composer. Плагины там называются wpackagist-plugin/ярлык, темы wpackagist-theme/ярлык. Ярлык берётся из адреса плагина на wordpress.org.

Репозиторий подключается в composer.json:

"repositories": [
  { "type": "composer", "url": "https://wpackagist.org" }
]

Чтобы плагины попадали в нужную папку, в extra.installer-paths должен быть путь для type:wordpress-plugin, а в config.allow-plugins разрешён composer/installers.

Установка

composer require wpackagist-plugin/redis-cache
composer require wpackagist-plugin/the-seo-framework:^5.0

Без указания версии Composer подставит последнюю стабильную с ограничением ^.

Активация

Composer только кладёт файлы. Включить плагин можно в админке или через WP-CLI:

wp plugin activate redis-cache the-seo-framework

Обновление и удаление

composer update wpackagist-plugin/redis-cache   # один плагин
composer update                                 # всё
composer remove wpackagist-plugin/redis-cache

Перед удалением плагин стоит деактивировать: wp plugin deactivate redis-cache.

Платные и свои плагины

Платных плагинов в WPackagist нет. Варианты:

  • если у разработчика есть свой Composer-репозиторий (так делают ACF Pro, WP Migrate и другие), подключите его с ключом лицензии в auth.json;
  • положите архив плагина в приватный Git-репозиторий и подключите его как "type": "vcs";
  • храните плагин прямо в репозитории проекта.

Советы

  • Добавьте composer.lock в Git, а vendor/ и папки с плагинами из WPackagist в .gitignore.
  • На продакшене выполняйте composer install --no-dev, а не update.
  • Отключите установку и обновление из админки константой DISALLOW_FILE_MODS, иначе версии на сервере разойдутся с composer.lock.

Ещё один способ автоматизации плагинов описан в заметке об активации ACF Pro через WP-CLI.

Источники и ссылки


Комментарии загружаются…