Активация ACF Pro через WP-CLI: без кликов в админке

Лицензию ACF Pro в админке вводить каждый раз при поднятии стенда – скучная рутина. На новых проектах, локалках и stage это повторяется снова и снова. Через WP-CLI ключ можно прописать одной командой и вшить шаг в скрипт деплоя.

Зачем активировать через CLI

• Скорость – не нужно логиниться в wp-admin и искать экран лицензии
• Повторяемость – один и тот же шаг на dev, stage, fresh clone
• CI/CD – можно вызвать после wp plugin activate в pipeline

Базовая команда

При установленном и активном ACF Pro:

wp eval 'acf_pro_update_license("ACF_LICENSE_KEY");'

Подставьте реальный ключ вместо ACF_LICENSE_KEY. Команда:

• wp eval – выполняет PHP в контексте WordPress (плагины уже загружены)
• acf_pro_update_license() – API ACF Pro для записи и проверки лицензии

Ключ лучше не светить в shell history: берите из переменной окружения.

wp eval 'acf_pro_update_license(getenv("ACF_PRO_KEY"));'

Shell-скрипт для стенда

Минимальный activate_acf.sh:

#!/bin/bash
set -euo pipefail

if [[ -z "${ACF_PRO_KEY:-}" ]]; then
  echo "Задайте ACF_PRO_KEY в окружении" >&2
  exit 1
fi

wp eval 'acf_pro_update_license(getenv("ACF_PRO_KEY"));'
echo "ACF Pro: лицензия записана"

chmod +x activate_acf.sh
export ACF_PRO_KEY='ваш-ключ'
./activate_acf.sh

Деплой и CI

Типичная последовательность после выкладки кода:

wp plugin activate advanced-custom-fields-pro
wp eval 'acf_pro_update_license(getenv("ACF_PRO_KEY"));'
wp cache flush

Секрет кладите в secrets CI (GitHub Actions, GitLab CI, Ansible vault), не в git. В wp-cli.yml можно держать alias-обёртки, но сам ключ туда не коммитьте.

Про константу в wp-config.php

На момент написания исходного материала надёжный путь для скриптов – acf_pro_update_license() через CLI. Если в вашей версии ACF появилась поддержка константы вида ACF_PRO_LICENSE, сверьтесь с changelog и docs плагина: поведение зависит от релиза. До этого не стоит рассчитывать, что одного define() достаточно на всех стендах.

На что смотреть при ошибках

• Плагин Pro активен, не free-редакция
• Сервер достучится до API активации ACF (firewall, outbound HTTPS)
• Ключ не истёк и не превышен лимит активаций
• Команда запущена из правильного --path к WordPress

Итог

Активация ACF Pro через WP-CLI – короткий шаг, который убирает клики в админке из чеклиста развёртывания. Ключ из env, одна wp eval, при необходимости hook в deploy. Меньше рутины, меньше расхождений между окружениями.

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