1.8.0: a coupon can carry a group's shipping rules
CI / WordPress latest + WooCommerce latest on PHP 8.3 (pull_request) Successful in 1m11s
Compatibility / WP latest / WC latest / PHP 7.4 (pull_request) Skipped
Compatibility / WP latest / WC beta / PHP 8.3 (pull_request) Skipped
Compatibility / WP latest / WC latest / PHP 8.3 (pull_request) Skipped
Compatibility / WP nightly / WC latest / PHP 8.3 (pull_request) Skipped
Compatibility / WP latest / WC latest / PHP 8.4 (pull_request) Skipped
Compatibility / Keep the compatibility headers honest (pull_request) Skipped
CI / Static checks (pull_request) Successful in 4m26s

Shipping Rules gets a "Coupon codes" field per group. A customer with one
of those coupons in the cart gets the group's shipping methods, including
"Only" ones, whatever their email. Asked for on a live shop: free delivery
reserved for one company's addresses had to reach people using that
company's coupon too.

Only the shipping follows the coupon; the group's percentage discount
stays with its email assignments. An email assigned to a group still
wins. The shipping package key now carries the effective group, so
WooCommerce's rate cache follows a coupon being added or removed.

Stored as groups.shipping_coupons (dbDelta adds the column on update).
Smoke tests: 100 assertions.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
This commit is contained in:
kristianwind
2026-11-17 14:07:05 +01:00
co-authored by Claude Opus 5.5
parent b9d8611ce2
commit 654d8632d2
9 changed files with 194 additions and 14 deletions
+82
View File
@@ -45,6 +45,7 @@ class WC_EDM_DB {
id bigint(20) unsigned NOT NULL AUTO_INCREMENT,
name varchar(191) NOT NULL,
discount_percent decimal(5,2) NOT NULL DEFAULT 0.00,
shipping_coupons text NULL,
created_at datetime NOT NULL,
updated_at datetime NOT NULL,
PRIMARY KEY (id)
@@ -298,6 +299,87 @@ class WC_EDM_DB {
);
}
/**
* Coupon codes that give a customer this group's shipping rules.
*
* @param int $id Group ID.
* @return string[] Normalised coupon codes.
*/
public static function get_group_shipping_coupons( $id ) {
$group = self::get_group( $id );
return $group ? self::parse_coupon_list( isset( $group->shipping_coupons ) ? $group->shipping_coupons : '' ) : array();
}
/**
* Store the coupon codes that give a customer this group's shipping rules.
*
* @param int $id Group ID.
* @param string[] $codes Coupon codes.
* @return bool
*/
public static function set_group_shipping_coupons( $id, $codes ) {
global $wpdb;
$codes = self::parse_coupon_list( implode( ',', (array) $codes ) );
return false !== $wpdb->update(
self::table( 'groups' ),
array(
'shipping_coupons' => $codes ? implode( ',', $codes ) : null,
'updated_at' => current_time( 'mysql' ),
),
array( 'id' => $id ),
array( '%s', '%s' ),
array( '%d' )
);
}
/**
* The group whose shipping rules one of these applied coupons unlocks.
*
* @param string[] $applied Coupon codes applied to the cart.
* @return int Group ID, or 0.
*/
public static function group_for_coupons( $applied ) {
$applied = self::parse_coupon_list( implode( ',', (array) $applied ) );
if ( empty( $applied ) ) {
return 0;
}
// Ordered by name, so the answer is the same on every request when
// two groups claim the same coupon.
foreach ( self::get_groups() as $group ) {
$codes = self::parse_coupon_list( isset( $group->shipping_coupons ) ? $group->shipping_coupons : '' );
if ( array_intersect( $codes, $applied ) ) {
return (int) $group->id;
}
}
return 0;
}
/**
* Split a comma/whitespace separated list into normalised coupon codes.
*
* @param string $list Raw list.
* @return string[]
*/
public static function parse_coupon_list( $list ) {
$codes = array();
foreach ( preg_split( '/[\s,]+/', (string) $list ) as $code ) {
$code = wc_format_coupon_code( $code );
if ( '' !== $code ) {
$codes[] = $code;
}
}
return array_values( array_unique( $codes ) );
}
/**
* Delete a group and its related rows.
*