Merge remote-tracking branch 'origin/add-order-coupon-refund-ratios' into optimize-order-date-generation

Author: layoutd

README.md

@@ -35,9 +35,13 @@ Generate orders with a specific status.
 - `wp wc generate orders <nr of orders> --status=completed`
 
 Apply coupons to a percentage of generated orders (0.0-1.0). If no coupons exist, 6 will be created automatically (3 fixed cart, 3 percentage). Note: `--coupons` flag is equivalent to `--coupon-ratio=1.0`.
+
+**Important:** Decimal ratios are converted to percentages using integer rounding. For example, `0.505` becomes 50% (not 50.5%) because the random generation uses integer comparison. Use whole percentages like `0.50` for precise 50% ratios.
 - `wp wc generate orders <nr of orders> --coupon-ratio=0.5`
 
 Refund a percentage of completed orders (0.0-1.0). Refunds will be split evenly between partial and full, and 25% of partial refunds will receive a second partial refund.
+
+**Note:** The same decimal ratio behavior applies to refund ratios as described above for coupon ratios.
 - `wp wc generate orders <nr of orders> --status=completed --refund-ratio=0.3`
 
 #### Order Attribution

includes/CLI.php

@@ -322,13 +322,13 @@ function () use ( $progress ) {
 		array(
 			'name'        => 'coupon-ratio',
 			'type'        => 'assoc',
-			'description' => 'Decimal ratio (0.0-1.0) of orders that should have coupons applied. If no coupons exist, 6 will be created (3 fixed value, 3 percentage).',
+			'description' => 'Decimal ratio (0.0-1.0) of orders that should have coupons applied. If no coupons exist, 6 will be created (3 fixed value, 3 percentage). Note: Decimal values are converted to percentages using integer rounding (e.g., 0.505 becomes 50%).',
 			'optional'    => true,
 		),
 		array(
 			'name'        => 'refund-ratio',
 			'type'        => 'assoc',
-			'description' => 'Decimal ratio (0.0-1.0) of completed orders that should be refunded (wholly or partially).',
+			'description' => 'Decimal ratio (0.0-1.0) of completed orders that should be refunded (wholly or partially). Note: Decimal values are converted to percentages using integer rounding (e.g., 0.505 becomes 50%).',
 			'optional'    => true,
 		),
 		array(

includes/Generator/Coupon.php

@@ -24,11 +24,11 @@ class Coupon extends Generator {
 	public static function generate( $save = true, $assoc_args = array() ) {
 		parent::maybe_initialize_generators();
 
-		$defaults = array(
-			'min'           => 5,
-			'max'           => 100,
-			'discount_type' => '',
-		);
+	$defaults = array(
+		'min'           => 5,
+		'max'           => 100,
+		'discount_type' => 'fixed_cart',
+	);
 
 		$args = wp_parse_args( $assoc_args, $defaults );
 
@@ -151,7 +151,7 @@ public static function batch( $amount, array $args = array() ) {
 	 * @return \WC_Coupon|false Coupon object or false if none available.
 	 */
 	public static function get_random() {
-		// Note: Using posts_per_page=-1 loads all coupons into memory for random selection.
+		// Note: Using posts_per_page=-1 loads all coupon IDs into memory for random selection.
 		// For stores with thousands of coupons, consider using direct SQL with RAND() for better performance.
 		// This approach was chosen for consistency with WordPress APIs and to avoid raw SQL queries.
 		$coupon_ids = get_posts(