Обзор
acf/settings
Описание
Фильтрует различные настройки, используемые в плагине.
История изменений
- Добавлено в версии 5.0.0
Параметры
apply_filters( "acf/settings/{$name}", $value );
$value(mixed) Значение настройки.
Настройки
В следующей таблице перечислены доступные настройки, которые можно изменить.
| Название | Тип | Добавлено | Описание |
|---|---|---|---|
path | string | 5.0.0 | Абсолютный путь к папке плагина ACF, включая завершающий слеш. По умолчанию используется plugin_dir_path() |
url | string | 5.6.8 | URL папки плагина ACF, включая завершающий слеш. По умолчанию используется plugin_dir_url() |
dir | string | 5.0.0 | URL папки плагина ACF, включая завершающий слеш. По умолчанию используется plugin_dir_url(). Устарело в версии 5.6.8. Вместо этого используйте url |
show_admin | boolean | 5.0.0 | Показывать или скрывать пункт меню ACF. По умолчанию — true |
stripslashes | boolean | 5.0.0 | Запускает функцию stripslashes() для всех данных $_POST. Некоторым серверам или установкам WP может потребоваться эта дополнительная функциональность. По умолчанию — false |
local | boolean | 5.0.0 | Включает или отключает локальные поля (PHP/JSON). По умолчанию — true |
json | boolean | 5.0.0 | Включает или отключает поля JSON. По умолчанию — true |
save_json | string | 5.0.0 | Абсолютный путь к папке, в которой будут создаваться JSON-файлы при сохранении групп полей. По умолчанию — папка «acf-json» в текущей теме |
load_json | array | 5.0.0 | Массив абсолютных путей к папкам, из которых можно загружать JSON-файлы групп полей. По умолчанию в элементе с индексом 0 находится папка «acf-json» текущей темы |
default_language | string | 5.0.0 | Код языка по умолчанию. По умолчанию — ''. Если активен WPML, ACF использует язык по умолчанию, заданный в WPML |
current_language | string | 5.0.0 | Код языка текущей записи. По умолчанию — ''. Если активен WPML, ACF использует текущий язык WPML |
capability | string | 5.1.9 | Возможность, используемая для типов записей ACF и проверки того, может ли текущий пользователь видеть пункт меню ACF. По умолчанию — «manage_options». |
show_updates | boolean | 5.2.2 | Включает или отключает отображение обновлений в списке установленных плагинов, а также показывает или скрывает страницу обновлений ACF в админ-панели. По умолчанию — true. |
export_textdomain | string | 5.2.9 | Используется во время функции «Экспорт в PHP» для оборачивания строк в функцию __(). Устарело в версии 5.4.4 — см. l10n_textdomain |
export_translate | array | 5.3.2 | Массив ключей, используемых во время функции «Экспорт в PHP» для оборачивания строк в функцию __(). По умолчанию — array('title', 'label', 'instructions'). Устарело в версии 5.3.4 — см. l10n_field и l10n_field_group |
autoload | boolean | 5.2.8 | Задает настройку «autoload» по умолчанию, используемую в add_option(). Эта функция применяется при сохранении новых строк в таблицу wp_options. По умолчанию — false |
l10n | boolean | 5.3.4 | Позволяет ACF переводить настройки полей и групп полей с помощью функции __(). По умолчанию — true. Полезно для переопределения перевода без изменения текстового домена |
l10n_textdomain | string | 5.3.4 | Задает текстовый домен, используемый при переводе настроек полей и групп полей. По умолчанию — ''. Строки не будут переводиться, если эта настройка пуста |
l10n_field | array | 5.3.4 | Массив настроек, которые нужно переводить при загрузке и экспорте поля. По умолчанию — array('label', 'instructions'). Устарело в версии 5.3.6 — см. фильтр acf/translate_field |
l10n_field_group | array | 5.3.4 | Массив настроек, которые нужно переводить при загрузке и экспорте группы полей. По умолчанию — array('title'). Устарело в версии 5.3.6 — см. фильтр acf/translate_field_group |
google_api_key | string | 5.4.0 | Укажите API Google Maps, чтобы предотвратить ограничения использования. По умолчанию — '' google_api_client string 5.4.0 Укажите API Google Maps, чтобы предотвратить ограничения использования. Не требуется при использовании google_api_key. По умолчанию — '' enqueue_google_maps boolean 5.5.0 Разрешает ACF добавлять в очередь и загружать JS-библиотеку API Google Maps. По умолчанию — true enqueue_select2 boolean 5.5.0 Разрешает ACF добавлять в очередь и загружать библиотеку Select2 JS/CSS. По умолчанию — true select2_version numeric 5.5.0 Определяет версию библиотеки Select2, добавляемую в очередь. Возможные значения — 3 или 4. Начиная с ACF 5.6.0 по умолчанию используется 4 enqueue_datepicker boolean 5.5.0 Разрешает ACF добавлять в очередь и загружать библиотеку WP datepicker JS/CSS. По умолчанию — true enqueue_datetimepicker boolean 5.5.0 Разрешает ACF добавлять в очередь и загружать библиотеку datetimepicker JS/CSS. По умолчанию — true row_index_offset numeric 5.5.6 Определяет начальный индекс, используемый во всех функциях «loop» и «row». По умолчанию — 1 (первая строка), но можно изменить на 0 (первая строка) remove_wp_meta_box boolean 5.6.0 Разрешает ACF удалять стандартный метабокс пользовательских полей WP. По умолчанию — true rest_api_enabled boolean 5.11 Включает или отключает интеграцию ACF с REST API. По умолчанию — true rest_api_format string 5.11 Определяет, как ACF форматирует значения полей в REST API. По умолчанию — light |
rest_api_embed_links | boolean | 5.11 | Включает или отключает встраиваемые ссылки для полей ACF в REST API. По умолчанию — true |
preload_blocks | boolean | 5.12 | Разрешает ACF предварительно загружать HTML исходного отображения блоков ACF в редактор блоков. По умолчанию — true |
Примеры
Фильтр
В этом примере показано, как изменить настройку с помощью фильтра "acf/settings/{$name}".
functions.php
add_filter('acf/settings/path', 'my_acf_settings_path');
function my_acf_settings_path( $path ) {
return get_stylesheet_directory() . '/acf/';
}
Функция
В этом примере показано, как изменить настройку с помощью функции acf_update_setting(). Эту функцию лучше всего использовать во время действия acf/init.
functions.php
add_action('acf/init', 'my_acf_init');
function my_acf_init() {
acf_update_setting('show_admin', false);
acf_update_setting('google_api_key', 'xxx');
}
Обновлено: 30.09.2026