хук-фильтр
динамический since 1.5.0
pre_option_{$option}
Проверено на WordPress 6.9, обновлено Источник: WordPress Developer Resources.
Сигнатура
apply_filters( "pre_option_{$option}", mixed $pre_option, string $option, mixed $default_value )Описание
Динамическая часть имени хука, $option, соответствует имени опции.
Возврат из фильтра любого значения, отличного от false, прерывает получение и возвращает это значение вместо него.
Оригинал (английский)
The dynamic portion of the hook name, $option, refers to the option name.
Returning a value other than false from the filter will short-circuit retrieval and return that value instead.
Динамические части имени
{$option}- Динамическая часть имени хука, $option, соответствует имени опции.
Фильтруемое значение
Значение, возвращаемое вместо значения опции. Отличается от $default_value, которое используется как запасное значение в случае, если опция не существует где-либо ещё в get_option() .
Значение по умолчанию — false (чтобы пропустить прерывание).
Параметры
$pre_option
mixed
обязательный
Значение, возвращаемое вместо значения опции. Отличается от $default_value, которое используется как запасное значение в случае, если опция не существует где-либо ещё в get_option() .
Значение по умолчанию — false (чтобы пропустить прерывание).
$option
string
обязательный
Имя опции.
$default_value
mixed
обязательный
Запасное значение, возвращаемое, если опция не существует.
Значение по умолчанию — false.
Исходный код
wp-includes/option.php:132
$pre = apply_filters( "pre_option_{$option}", false, $option, $default_value );История изменений
| Версия | Описание |
|---|---|
| 4.9.0 | The $default_value parameter was added. |
| 4.4.0 | The $option parameter was added. |
| 1.5.0 | Introduced. |
