хук-фильтр
since 2.8.0
set-screen-option
Проверено на WordPress 6.9, обновлено Источник: WordPress Developer Resources.
Сигнатура
apply_filters( 'set-screen-option', mixed $screen_option, string $option, int $value )Описание
Этот фильтр также можно использовать для изменения нестандартных настроек [items]_per_page. Полный список стандартных опций см. в родительской функции.
Возврат false из фильтра пропустит сохранение текущей опции.
См. alsoset_screen_options()
Оригинал (английский)
The filter can also be used to modify non-standard [items]_per_page settings. See the parent function for a full list of standard options.
Returning false from the filter will skip saving the current option.
Фильтруемое значение
Значение, сохраняемое вместо значения опции.
Значение по умолчанию false (чтобы пропустить сохранение текущей опции).
Параметры
$screen_option
mixed
обязательный
Значение, сохраняемое вместо значения опции.
Значение по умолчанию false (чтобы пропустить сохранение текущей опции).
$option
string
обязательный
Имя опции.
$value
int
обязательный
Значение опции.
Исходный код
wp-admin/includes/misc.php:778
$screen_option = apply_filters( 'set-screen-option', $screen_option, $option, $value ); // phpcs:ignore WordPress.NamingConventions.ValidHookName.UseUnderscoresИстория изменений
| Версия | Описание |
|---|---|
| 5.4.2 | Only applied to options ending with '_page', or the 'layout_columns' option. |
| 2.8.0 | Introduced. |
