Обзор
И ACF, и ACF PRO можно установить с помощью Composer.
В этих инструкциях описана установка бесплатной версии ACF с помощью Composer. Чтобы узнать, как использовать ACF PRO с Composer, см. Установка ACF PRO с помощью Composer.
Добавьте наш репозиторий
Добавьте наш репозиторий в файл composer.json:
"repositories": [
{
"type": "composer",
"url": "https://composer.advancedcustomfields.com"
}
]
Установите плагин
В CLI выполните require ACF с помощью следующей команды:
composer require wpengine/advanced-custom-fields
Ограничения версий
Вы можете использовать любые ограничения версий Composer или указать точную версию плагина:
"require": {
"wpengine/advanced-custom-fields": "6.3.9"
}
Настройка мест установки
Мы используем composer/installers, чтобы автоматически устанавливать пакет нашего плагина в wp-content/plugins/. Однако вы можете изменить место установки, добавив в файл composer.json следующее:
"extra": {
"installer-paths": {
"wp-content/plugins/{$name}/": ["type:wordpress-plugin"]
}
}
Установка как MU-плагин
Если вы предпочитаете установить ACF как плагин обязательной загрузки (mu-plugin), чтобы он всегда загружался WordPress и не мог быть деактивирован в админ-панели как обычный плагин, вы можете изменить путь установки, добавив в файл composer.json следующее:
"extra": {
"installer-paths": {
"wp-content/mu-plugins/{$name}/": ["wpengine/advanced-custom-fields"]
}
}
Однако каталоги плагинов внутри каталога mu-plugin не будут загружаться WordPress автоматически, поэтому вам нужно будет подключить его вручную с помощью файла acf.php в корне каталога mu-plugin:
<?php
require_once WPMU_PLUGIN_DIR . '/advanced-custom-fields/acf.php';
В качестве альтернативы есть пакет, который автоматически обрабатывает загрузку каталогов в директории mu-plugin.
Пример composer.json
{
"name": "wpengine/composer-test.dev",
"description": "ACF на сайте WordPress",
"repositories": [
{
"type": "composer",
"url": "https://composer.advancedcustomfields.com"
}
],
"require": {
"wpengine/advanced-custom-fields": "^6"
}
}
Обновлено: 02.06.2026