WP_Customize_Setting::validate() WordPress Method

The WP_Customize_Setting::validate() method is used to ensure that a given setting value is valid. This is done by sanitizing the value and then validating it against the setting's rules. If the value is not valid, the method will return an error.

WP_Customize_Setting::validate( mixed $value ) #

Validates an input.


Description

Top ↑

See also


Top ↑

Parameters

$value

(mixed)(Required)Value to validate.


Top ↑

Return

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


Top ↑

Source

File: wp-includes/class-wp-customize-setting.php

	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;
	}


Top ↑

Changelog

Changelog
VersionDescription
4.6.0Introduced.

The content displayed on this page has been created in part by processing WordPress source code files which are made available under the GPLv2 (or a later version) license by theĀ Free Software Foundation. In addition to this, the content includes user-written examples and information. All material is subject to review and curation by the WPPaste.com community.