Automattic\WooCommerce\Abilities

ActionableAbility::prepare_fields │ private │ WC 1.0

Check extensions.<namespace>.<field> input values against the schema of each field, and cast them. No callback runs here. A null value is kept as is, to delete the value.

Метод класса: ActionableAbility{}

Хуков нет.

Возвращает

array|\WP_Error. A list of update_callback and value pairs, or a WP_Error when a value is rejected.

Использование

// private - только в коде основоного (родительского) класса
$result = $this->prepare_fields( $values );
$values(array<string, mixed>) (обязательный)
Values keyed by namespace, then field.

Код ActionableAbility::prepare_fields() WC 11.3.0

private function prepare_fields( array $values ) {
	$registered = ExtensibleAbilities::get_fields( $this->get_resource() );
	$updates    = array();
	foreach ( $values as $namespace => $fields ) {
		foreach ( (array) $fields as $field => $value ) {
			$args = $registered[ $namespace ][ $field ] ?? array();
			if ( ! isset( $args['update_callback'] ) ) {
				return new \WP_Error(
					'woocommerce_ability_field_not_writable',
					/* translators: 1: Extension namespace. 2: Field name. */
					sprintf( __( 'The extension field "%1$s.%2$s" cannot be written.', 'woocommerce' ), $namespace, $field ),
					array( 'status' => 400 )
				);
			}
			if ( null !== $value ) {
				$param = 'extensions.' . $namespace . '.' . $field;
				$valid = rest_validate_value_from_schema( $value, $args['schema'], $param );
				if ( is_wp_error( $valid ) ) {
					return self::with_data( $valid, array( 'field' => $param ) );
				}
				$value = rest_sanitize_value_from_schema( $value, $args['schema'], $param );
				if ( is_wp_error( $value ) ) {
					return self::with_data( $value, array( 'field' => $param ) );
				}
			}
			$updates[ 'extensions.' . $namespace . '.' . $field ] = array( $args['update_callback'], $value );
		}
	}
	return $updates;
}