WP_Ability::validate_input( mixed $input = null ): true|WP_Error

519	public function validate_input( $input = null ) {520		$input_schema = $this->get_input_schema();521		if ( empty( $input_schema ) ) {522			if ( null === $input ) {523				return true;524			}525 526			return new WP_Error(527				'ability_missing_input_schema',528				sprintf(529					/* translators: %s ability name. */530					__( 'Ability "%s" does not define an input schema required to validate the provided input.' ),531					$this->name532				)533			);534		}535 536		$valid_input = rest_validate_value_from_schema( $input, $input_schema, 'input' );537		if ( is_wp_error( $valid_input ) ) {538			$is_valid = new WP_Error(539				'ability_invalid_input',540				sprintf(541					/* translators: %1$s ability name, %2$s error message. */542					__( 'Ability "%1$s" has invalid input. Reason: %2$s' ),543					$this->name,544					$valid_input->get_error_message()545				)546			);547		} else {548			$is_valid = true;549		}550 551		/**552		 * Filters the input validation result for an ability.553		 *554		 * Allows developers to add custom validation logic on top of the default555		 * JSON Schema validation. If default validation already failed, the filter556		 * receives the WP_Error object and can add additional error information or557		 * override it. If default validation passed, the filter can add additional558		 * validation checks and return a WP_Error if those checks fail.559		 *560		 * @since 7.1.0561		 *562		 * @param true|WP_Error $is_valid     The validation result from default validation.563		 * @param mixed         $input        The input data being validated.564		 * @param string        $ability_name The name of the ability.565		 */566		$validity = apply_filters( 'wp_ability_validate_input', $is_valid, $input, $this->name );567		if ( false === $validity ) {568			return new WP_Error( 'ability_invalid_input', __( 'Invalid input.' ) );569		}570		if ( is_wp_error( $validity ) && $validity->has_errors() ) {571			return $validity;572		}573		return true;574	}