Описание customize_dynamic_partial_args
— Filter
Хук customize_dynamic_partial_args позволяет изменять аргументы, которые передаются динамическим частям при обновлении настроек в WordPress Customizer. Он срабатывает при каждом обновлении динамической части, позволяя настроить, какие данные и в каком формате будут отправлены на клиентскую сторону
Примеры использования
Пример добавления нового параметра в массив аргументов для динамической части:
add_filter('customize_dynamic_partial_args', function($args) {
$args['new_param'] = 'new_value';
return $args;
});
В этом примере мы добавляем новый параметр ‘new_param’ в массив аргументов, который будет доступен в динамической части
Пример изменения настройки для динамической части:
add_filter('customize_dynamic_partial_args', function($args) {
if (isset($args['partial']) && $args['partial']->id === 'site_title') {
$args['settings'][] = 'new_setting';
}
return $args;
});
Здесь мы добавляем новую настройку ‘new_setting’ в массив настроек, если обновляется заголовок сайта
Пример удаления ненужной настройки из аргументов:
add_filter('customize_dynamic_partial_args', function($args) {
if (isset($args['settings']) && in_array('unwanted_setting', $args['settings'])) {
$args['settings'] = array_diff($args['settings'], ['unwanted_setting']);
}
return $args;
});
Мы удаляем ‘unwanted_setting’ из массива настроек, если она там присутствует
— Лучшие практики
– Использование
Используйте этот хук, когда необходимо изменить или дополнить данные, отправляемые динамическим частям в WordPress Customizer
– Производительность
Хук не должен вызывать значительных проблем с производительностью, но избыточные изменения могут привести к увеличению объема передаваемых данных
– Предупреждения
Будьте осторожны с изменениями, которые могут повлиять на другие части интерфейса Customizer
Альтернативы
Тип: action
Этот хук позволяет регистрировать новые настройки и секции в Customizer
Используйте его, если нужно добавить новые настройки, а не изменять существующие аргументы динамических частей
