Automattic\WooCommerce\Abilities
ActionableAbility::prepare_fields
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() 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;
}