WordPress.org
Get WordPress
WordPress.org

WordPress Developer Resources

pre_update_option_{$option}

apply_filters( “pre_update_option_{$option}”, mixed $value, mixed $old_value, string $option )

In this article

Back to top

Filters a specific option before its value is (maybe) serialized and updated.

Description

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

Parameters

$valuemixed
The new, unserialized option value.
$old_valuemixed
The old option value.
$optionstring
Option name.

More Information

This filter is applied to the option value before being saved to the database; this allows the overriding value to be stored. To use this filter, you will need to add filters for specific options names, such as “pre_update_option_foo” to filter the option “foo“.

Source

$value = apply_filters( "pre_update_option_{$option}", $value, $old_value, $option );

View all references View on Trac View on GitHub

Used byDescription
update_option()wp-includes/option.php

Updates the value of an option that was already added.

Changelog

VersionDescription
4.4.0The $option parameter was added.
2.6.0Introduced.

User Contributed Notes

  1. Skip to note 2 content
    Steven Lin
    You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note

    Example migrated from Codex:

    add_action( 'init', 'myplugin_init' );

function myplugin_init() {
	add_filter( 'pre_update_option_foo', 'myplugin_update_field_foo', 10, 2 );
}

function myplugin_update_field_foo( $new_value, $old_value ) {
	$new_value = intval( $new_value );
	$new_value ++;
	return $new_value;
}

You must log in before being able to contribute a note or feedback.