WP_Customize_Setting::validate()publicWP 4.6.0

Validates an input.

Method of the class: WP_Customize_Setting{}

Hooks from the method

Return

true|WP_Error. True if the input was validated, otherwise WP_Error.

Usage

$WP_Customize_Setting = new WP_Customize_Setting();
$WP_Customize_Setting->validate( $value );
$value(mixed) (required)
Value to validate.

Notes

Changelog

Since 4.6.0 Introduced.

WP_Customize_Setting::validate() code WP 6.4.3

public function validate( $value ) {
	if ( is_wp_error( $value ) ) {
		return $value;
	}
	if ( is_null( $value ) ) {
		return new WP_Error( 'invalid_value', __( 'Invalid value.' ) );
	}

	$validity = new WP_Error();

	/**
	 * Validates a Customize setting value.
	 *
	 * Plugins should amend the `$validity` object via its `WP_Error::add()` method.
	 *
	 * The dynamic portion of the hook name, `$this->ID`, refers to the setting ID.
	 *
	 * @since 4.6.0
	 *
	 * @param WP_Error             $validity Filtered from `true` to `WP_Error` when invalid.
	 * @param mixed                $value    Value of the setting.
	 * @param WP_Customize_Setting $setting  WP_Customize_Setting instance.
	 */
	$validity = apply_filters( "customize_validate_{$this->id}", $validity, $value, $this );

	if ( is_wp_error( $validity ) && ! $validity->has_errors() ) {
		$validity = true;
	}
	return $validity;
}