WC_REST_Coupons_V2_Controller::prepare_object_for_database()protectedWC 1.0

Prepare a single coupon for create or update.

Method of the class: WC_REST_Coupons_V2_Controller{}

Return

WP_Error|WC_Data.

Usage

// protected - for code of main (parent) or child class
$result = $this->prepare_object_for_database( $request, $creating );
$request(WP_REST_Request) (required)
Request object.
$creating(true|false)
If is creating a new object.
Default: false

WC_REST_Coupons_V2_Controller::prepare_object_for_database() code WC 8.6.1

protected function prepare_object_for_database( $request, $creating = false ) {
	$id        = isset( $request['id'] ) ? absint( $request['id'] ) : 0;
	$coupon    = new WC_Coupon( $id );
	$schema    = $this->get_item_schema();
	$data_keys = array_keys( array_filter( $schema['properties'], array( $this, 'filter_writable_props' ) ) );

	// Validate required POST fields.
	if ( $creating && StringUtil::is_null_or_whitespace( $request['code'] ?? null ) ) {
		return new WP_Error( 'woocommerce_rest_empty_coupon_code', sprintf( __( 'The coupon code cannot be empty.', 'woocommerce' ), 'code' ), array( 'status' => 400 ) );
	}

	// Handle all writable props.
	foreach ( $data_keys as $key ) {
		$value = $request[ $key ];

		if ( ! is_null( $value ) ) {
			switch ( $key ) {
				case 'code':
					$coupon_code  = wc_format_coupon_code( $value );
					$id           = $coupon->get_id() ? $coupon->get_id() : 0;
					$id_from_code = wc_get_coupon_id_by_code( $coupon_code, $id );

					if ( $id_from_code ) {
						return new WP_Error( 'woocommerce_rest_coupon_code_already_exists', __( 'The coupon code already exists', 'woocommerce' ), array( 'status' => 400 ) );
					}

					$coupon->set_code( $coupon_code );
					break;
				case 'meta_data':
					if ( is_array( $value ) ) {
						foreach ( $value as $meta ) {
							$coupon->update_meta_data( $meta['key'], $meta['value'], isset( $meta['id'] ) ? $meta['id'] : '' );
						}
					}
					break;
				case 'description':
					$coupon->set_description( wp_filter_post_kses( $value ) );
					break;
				default:
					if ( is_callable( array( $coupon, "set_{$key}" ) ) ) {
						$coupon->{"set_{$key}"}( $value );
					}
					break;
			}
		}
	}

	/**
	 * Filters an object before it is inserted via the REST API.
	 *
	 * The dynamic portion of the hook name, `$this->post_type`,
	 * refers to the object type slug.
	 *
	 * @param WC_Data         $coupon   Object object.
	 * @param WP_REST_Request $request  Request object.
	 * @param bool            $creating If is creating a new object.
	 */
	return apply_filters( "woocommerce_rest_pre_insert_{$this->post_type}_object", $coupon, $request, $creating );
}