Filters the value of an existing option before it is retrieved.
Description
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.
Parameters
$pre_optionmixed
The value to return instead of the option value. This differs from $default_value, which is used as the fallback value in the event the option doesn't exist elsewhere in get_option(). Default false (to skip past the short-circuit).
$optionstring
Option name.
$default_valuemixed
The fallback value to return if the option does not exist. Default false.
126<?php127 * the option doesn't exist elsewhere in get_option().128 * Default false (to skip past the short-circuit).129 * @param string $option Option name.130 * @param mixed $default_value The fallback value to return if the option does not exist.131 * Default false.132 */133 $pre = apply_filters( "pre_option_{$option}", false, $option, $default_value );134135 /**136 * Filters the value of all existing options before it is retrieved.137 *138 * Returning a truthy value from the filter will effectively short-circuit retrieval139 * and return the passed value instead.
History
Introduced in 1.5.0. Unchanged from 6.7.7 through 7.1.0.