Warning: This function has been deprecated. Use register_setting() instead.

add_option_update_handler( string $option_group, string $option_name, callable $sanitize_callback = '' )

Register a setting and its sanitization callback


Description Description

See also See also


Top ↑

Parameters Parameters

$option_group

(string) (Required) A settings group name. Should correspond to a whitelisted option key name. Default whitelisted option key names include 'general', 'discussion', 'media', 'reading', 'writing', 'misc', 'options', and 'privacy'.

$option_name

(string) (Required) The name of an option to sanitize and save.

$sanitize_callback

(callable) (Optional) A callback function that sanitizes the option's value.

Default value: ''



Top ↑

Source Source

File: wp-admin/includes/deprecated.php

function add_option_update_handler( $option_group, $option_name, $sanitize_callback = '' ) {
	_deprecated_function( __FUNCTION__, '3.0.0', 'register_setting()' );
	register_setting( $option_group, $option_name, $sanitize_callback );
}

Top ↑

Changelog Changelog

Changelog
Version Description
3.0.0 Use register_setting()
2.7.0 Introduced.

Top ↑

User Contributed Notes User Contributed Notes

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