customize_changeset_branching — filter WordPress: параметры и применение

Сигнатура

apply_filters( 'customize_changeset_branching', bool $allow_branching, WP_Customize_Manager $wp_customize )

Описание

По умолчанию в ядре, когда ветвление наборов изменений не разрешено, наборы изменений работают линейно: в один момент времени существует только один сохранённый набор изменений (со статусом «черновик» или «запланировано»). Благодаря этому Настройщик работает подобно переходу к «редактированию» одной существующей записи: все пользователи вносят изменения в одну и ту же запись, и для этой записи создаются ревизии автосохранения.
Напротив, когда ветвление наборов изменений разрешено, модель напоминает переход пользователей к «добавлению новой» страницы, где каждый вносит изменения независимо от других, так как все они работают со своими отдельными страницами, каждая из которых получает свои отдельные первоначальные авто-черновики, а после первого сохранения — ревизии автосохранения поверх конкретной записи этого пользователя.
Поскольку линейные наборы изменений считаются более подходящими для большинства пользователей WordPress, они используются по умолчанию. Для сайтов WordPress, где несколько пользователей активно управляют сайтом через Настройщик, ветвление наборов изменений следует включить с помощью этого фильтра.

Оригинал (английский)

By default in core, when changeset branching is not allowed, changesets will operate linearly in that only one saved changeset will exist at a time (with a ‘draft’ or ‘future’ status). This makes the Customizer operate in a way that is similar to going to “edit” to one existing post: all users will be making changes to the same post, and autosave revisions will be made for that post.

By contrast, when changeset branching is allowed, then the model is like users going to “add new” for a page and each user makes changes independently of each other since they are all operating on their own separate pages, each getting their own separate initial auto-drafts and then once initially saved, autosave revisions on top of that user’s specific post.

Since linear changesets are deemed to be more suitable for the majority of WordPress users, they are the default. For WordPress sites that have heavy site management in the Customizer by multiple users then branching changesets should be enabled by means of this filter.

Фильтруемое значение

Разрешено ли ветвление. Если false (значение по умолчанию), то в один момент времени существует только один сохранённый набор изменений.

Параметры

$allow_branching bool обязательный

Разрешено ли ветвление. Если false (значение по умолчанию), то в один момент времени существует только один сохранённый набор изменений.

$wp_customize WP_Customize_Manager обязательный

Экземпляр менеджера.

Исходный код

wp-includes/class-wp-customize-manager.php:811

$this->branching = apply_filters( 'customize_changeset_branching', $this->branching, $this );

История изменений

Версия	Описание
4.9.0	Introduced.