# set-screen-option

URL: https://chugunov.pro/api-wordpress/filters/set-screen-option/
Проверено на WordPress 6.9, обновлено 06.08.2026.
Источник: независимый русскоязычный справочник chugunov.pro. Не является официальной документацией WordPress.

Тип: хук-фильтр.
Появился в версии: 2.8.0.

## Сигнатура

```php
apply_filters( 'set-screen-option', mixed $screen_option, string $option, int $value )
```

## Описание

Этот фильтр также можно использовать для изменения нестандартных настроек [items]_per_page. Полный список стандартных опций см. в родительской функции.
Возврат false из фильтра пропустит сохранение текущей опции.
См. alsoset_screen_options()

## Параметры

- `$screen_option` `mixed` — обязательный. Значение, сохраняемое вместо значения опции.
  
  Значение по умолчанию false (чтобы пропустить сохранение текущей опции).
- `$option` `string` — обязательный. Имя опции.
- `$value` `int` — обязательный. Значение опции.

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

Значение, сохраняемое вместо значения опции.

Значение по умолчанию false (чтобы пропустить сохранение текущей опции).

## Исходный код

Файл: `wp-admin/includes/misc.php:778`

```php
$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.

## Связанные

Используется в: [`set_screen_options`](https://chugunov.pro/api-wordpress/functions/set_screen_options/).

Оригинал в официальной документации: https://developer.wordpress.org/reference/hooks/set-screen-option/