WordPress at a glance
filter is not described

default_option_(option) filter-hook . WP 3.4.0

Filters the default value for an option.

The dynamic portion of the hook name, $option, refers to the option name.

Usage

add_filter( 'default_option_(option)', 'filter_function_name_607', 10, 3 );
function filter_function_name_607( $default, $option, $passed_default ){
	// filter...

	return $default;
}
$default(mixed)
The default value to return if the option does not exist in the database.
$option(string)
Option name.
$passed_default(true/false)
Was get_option() passed a default value?

Notes

  • Since 4.4.0 The $option parameter was added.
  • Since 4.7.0 The $passed_default parameter was added to distinguish between a false value and the default parameter value.

Where the hook is called

get_option()
default_option_(option)
update_option()
default_option_(option)
add_option()
default_option_(option)
wp-includes/option.php 87
return apply_filters( "default_option_{$option}", $default, $option, $passed_default );
wp-includes/option.php 112
return apply_filters( "default_option_{$option}", $default, $option, $passed_default );
wp-includes/option.php 124
return apply_filters( "default_option_{$option}", $default, $option, $passed_default );
wp-includes/option.php 339
if ( apply_filters( "default_option_{$option}", false, $option, false ) === $old_value ) {
wp-includes/option.php 460
if ( apply_filters( "default_option_{$option}", false, $option, false ) !== get_option( $option ) )

Where the hook is used (in WP core)

wp-includes/customize/class-wp-customize-nav-menu-setting.php 222
add_filter( 'default_option_nav_menu_options', array( $this, 'filter_nav_menu_options' ) );
wp-includes/option.php 2029
add_filter( "default_option_{$option_name}", 'filter_default_option', 10, 3 );
wp-includes/default-filters.php 397
add_filter( 'default_option_link_manager_enabled', '__return_true' );
wp-includes/class-wp-customize-setting.php 369
add_filter( "default_option_{$id_base}", $multidimensional_filter );