WC_REST_Orders_V2_Controller::prepare_coupon_lines() │ protected │ WC 1.0

Create or update an order coupon.

Method of the class: WC_REST_Orders_V2_Controller{}

No Hooks.

Return

WC_Order_Item_Coupon.

Usage

// protected - for code of main (parent) or child class
$result = $this->prepare_coupon_lines( $posted, $action, $item );

$posted(array) (required)

Item data.

$action(string)

'create' to add coupon or 'update' to update it.
Default: 'create'

$item(object)

Passed when updating an item. Null during creation.
Default: null

WC_REST_Orders_V2_Controller::prepare_coupon_lines() WC REST Orders V2 Controller::prepare coupon lines code ^{WC 7.7.0}

protected function prepare_coupon_lines( $posted, $action = 'create', $item = null ) {
	$item = is_null( $item ) ? new WC_Order_Item_Coupon( ! empty( $posted['id'] ) ? $posted['id'] : '' ) : $item;

	if ( 'create' === $action ) {
		$coupon_code = ArrayUtil::get_value_or_default( $posted, 'code' );
		if ( StringUtil::is_null_or_whitespace( $coupon_code ) ) {
			throw new WC_REST_Exception( 'woocommerce_rest_invalid_coupon_coupon', __( 'Coupon code is required.', 'woocommerce' ), 400 );
		}
	}

	$this->maybe_set_item_props( $item, array( 'code', 'discount' ), $posted );
	$this->maybe_set_item_meta_data( $item, $posted );

	return $item;
}