Описание customize_changeset_branching
— Action
Хук customize_changeset_branching позволяет изменить поведение ветвления изменений в кастомизаторе WordPress. Он срабатывает при создании нового набора изменений (changeset) и позволяет модифицировать процесс ветвления для настройки, как изменения будут применяться к текущему набору.
Примеры использования
Пример изменения поведения ветвления для нового набора изменений:
add_action('customize_changeset_branching', function($changeset, $request) {
// Изменяем идентификатор ветки на кастомный.
$changeset->set_id('custom-branch-id');
});
В этом примере мы изменяем идентификатор ветки на кастомный при создании нового набора изменений.
Пример добавления пользовательских данных в набор изменений:
add_action('customize_changeset_branching', function($changeset, $request) {
// Добавляем пользовательские данные в набор изменений.
$changeset->set('custom_data', 'my_custom_value');
});
Здесь мы добавляем пользовательское значение в набор изменений для дальнейшего использования.
— Лучшие практики
– Использование
Используйте этот хук, когда необходимо изменить поведение ветвления в кастомизаторе, чтобы управлять изменениями более гибко
– Производительность
Хук не должен значительно влиять на производительность, но стоит следить за количеством данных, которые добавляются в набор изменений
– Предупреждения
Убедитесь, что изменения не нарушают логику работы кастомизатора и не вызывают конфликтов с другими плагинами или темами
Альтернативы
Тип: action
Этот хук позволяет добавлять новые настройки и секции в кастомизатор, что может быть полезно в некоторых случаях вместо изменения ветвления
Используйте его, если нужно добавить новые элементы настройки, а не изменять поведение существующих изменений
