PHP 8.0.30
Preview: wc-coupon-functions.php Size: 5.56 KB
/home/certprox/zang.certproxywizard.com/wp/wp-content/plugins/woocommerce/includes/wc-coupon-functions.php

<?php
/**
 * WooCommerce Coupons Functions
 *
 * Functions for coupon specific things.
 *
 * @package WooCommerce\Functions
 * @version 3.0.0
 */

defined( 'ABSPATH' ) || exit;

use Automattic\WooCommerce\Utilities\StringUtil;
use Automattic\WooCommerce\Admin\API\Reports\Coupons\DataStore as CouponsDataStore;

/**
 * Get coupon types.
 *
 * @return array
 */
function wc_get_coupon_types() {
	return (array) apply_filters(
		'woocommerce_coupon_discount_types',
		array(
			'percent'       => __( 'Percentage discount', 'woocommerce' ),
			'fixed_cart'    => __( 'Fixed cart discount', 'woocommerce' ),
			'fixed_product' => __( 'Fixed product discount', 'woocommerce' ),
		)
	);
}

/**
 * Get a coupon type's name.
 *
 * @param string $type Coupon type.
 * @return string
 */
function wc_get_coupon_type( $type = '' ) {
	$types = wc_get_coupon_types();
	return isset( $types[ $type ] ) ? $types[ $type ] : '';
}

/**
 * Coupon types that apply to individual products. Controls which validation rules will apply.
 *
 * @since  2.5.0
 * @return array
 */
function wc_get_product_coupon_types() {
	return (array) apply_filters( 'woocommerce_product_coupon_types', array( 'fixed_product', 'percent' ) );
}

/**
 * Coupon types that apply to the cart as a whole. Controls which validation rules will apply.
 *
 * @since  2.5.0
 * @return array
 */
function wc_get_cart_coupon_types() {
	return (array) apply_filters( 'woocommerce_cart_coupon_types', array( 'fixed_cart' ) );
}

/**
 * Check if coupons are enabled.
 * Filterable.
 *
 * @since  2.5.0
 *
 * @return bool
 */
function wc_coupons_enabled() {
	return apply_filters( 'woocommerce_coupons_enabled', 'yes' === get_option( 'woocommerce_enable_coupons' ) );
}

/**
 * Check if two coupon codes are the same.
 * Lowercasing to ensure case-insensitive comparison.
 *
 * @since 9.9.0
 *
 * @param string $coupon_1 Coupon code 1.
 * @param string $coupon_2 Coupon code 2.
 * @return bool
 */
function wc_is_same_coupon( $coupon_1, $coupon_2 ) {
	return wc_strtolower( $coupon_1 ) === wc_strtolower( $coupon_2 );
}

/**
 * Get coupon code by ID.
 *
 * @since 3.0.0
 * @param int $id Coupon ID.
 * @return string
 */
function wc_get_coupon_code_by_id( $id ) {
	$data_store = WC_Data_Store::load( 'coupon' );
	return empty( $id ) ? '' : (string) $data_store->get_code_by_id( $id );
}

/**
 * Get coupon ID by code.
 *
 * @since 3.0.0
 * @param string $code    Coupon code.
 * @param int    $exclude Used to exclude an ID from the check if you're checking existence.
 * @return int
 */
function wc_get_coupon_id_by_code( $code, $exclude = 0 ) {

	if ( StringUtil::is_null_or_whitespace( $code ) ) {
		return 0;
	}

	$data_store = WC_Data_Store::load( 'coupon' );
	// Coupon code allows spaces, which doesn't work well with some cache engines (e.g. memcached).
	$hashed_code = md5( wc_strtolower( $code ) );
	$cache_key   = WC_Cache_Helper::get_cache_prefix( 'coupons' ) . 'coupon_id_from_code_' . $hashed_code;

	$ids = wp_cache_get( $cache_key, 'coupons' );

	if ( false === $ids ) {
		$ids = $data_store->get_ids_by_code( $code );
		if ( $ids ) {
			wp_cache_set( $cache_key, $ids, 'coupons' );
		}
	}

	$ids = array_diff( array_filter( array_map( 'absint', (array) $ids ) ), array( $exclude ) );

	return apply_filters( 'woocommerce_get_coupon_id_from_code', absint( current( $ids ) ), $code, $exclude );
}

/**
 * Repair coupon lookup entries with zero discount_amount. A bug in WC 9.9 (fixed in 10.0)
 * caused discount_amount to be set to zero when a coupon code was used with
 * different case (e.g. "10-off" vs "10-OFF").
 *
 * @since 10.1.0
 * @return array Array with 'success' boolean and 'message' string.
 */
function wc_repair_zero_discount_coupons_lookup_table() {
	global $wpdb;

	$table_name = $wpdb->prefix . 'wc_order_coupon_lookup';

	// Check if table exists.
	// phpcs:ignore WordPress.DB.PreparedSQL.InterpolatedNotPrepared
	if ( $wpdb->get_var( "SHOW TABLES LIKE '$table_name'" ) !== $table_name ) {
		return array(
			'success' => false,
			'message' => __( 'Coupons lookup table does not exist.', 'woocommerce' ),
		);
	}

	// Get entries with zero discount_amount.
	$zero_discount_entries = $wpdb->get_results(
		$wpdb->prepare(
			// phpcs:ignore WordPress.DB.PreparedSQL.InterpolatedNotPrepared
			"SELECT order_id, coupon_id FROM $table_name WHERE discount_amount = %f",
			0.0
		),
		ARRAY_A
	);

	if ( empty( $zero_discount_entries ) ) {
		return array(
			'success' => true,
			'message' => __( 'No entries with zero discount amount found. Coupons lookup table is up to date.', 'woocommerce' ),
		);
	}

	$processed_count = 0;
	$error_count     = 0;

	foreach ( $zero_discount_entries as $entry ) {
		try {
			$result = CouponsDataStore::sync_order_coupons( $entry['order_id'] );
			if ( false !== $result ) {
				++$processed_count;
			} else {
				++$error_count;
			}
		} catch ( Exception $e ) {
			++$error_count;
			$logger = wc_get_logger();
			$logger->error(
				sprintf(
					'Error fixing coupon lookup entry for order %d: %s',
					$entry['order_id'],
					$e->getMessage()
				),
				array(
					'source'   => 'coupons-lookup-fix',
					'order_id' => $entry['order_id'],
					'error'    => $e,
				)
			);
		}
	}

	// Clear any related caches.
	wp_cache_flush_group( 'coupons' );
	WC_Cache_Helper::get_transient_version( 'woocommerce_reports', true );

	$message = sprintf(
		/* translators: %1$d: number of entries processed, %2$d: number of errors */
		__( 'Coupons lookup table entries with zero discount amount repaired successfully. Processed %1$d entries with %2$d errors.', 'woocommerce' ),
		$processed_count,
		$error_count
	);

	return array(
		'success' => true,
		'message' => $message,
	);
}

Directory Contents

Dirs: 28 × Files: 115

Name Size Perms Modified Actions
abstracts DIR
- drwxr-xr-x 2026-03-30 10:22:29
Edit Download
admin DIR
- drwxr-xr-x 2026-03-30 10:22:31
Edit Download
blocks DIR
- drwxr-xr-x 2026-03-30 10:22:31
Edit Download
cli DIR
- drwxr-xr-x 2026-03-30 10:22:33
Edit Download
- drwxr-xr-x 2026-03-30 10:22:33
Edit Download
- drwxr-xr-x 2026-03-30 10:22:34
Edit Download
emails DIR
- drwxr-xr-x 2026-03-30 10:22:34
Edit Download
export DIR
- drwxr-xr-x 2026-03-30 10:22:34
Edit Download
gateways DIR
- drwxr-xr-x 2026-03-30 10:22:34
Edit Download
import DIR
- drwxr-xr-x 2026-03-30 10:22:34
Edit Download
- drwxr-xr-x 2026-03-30 10:21:54
Edit Download
- drwxr-xr-x 2026-03-30 10:22:34
Edit Download
legacy DIR
- drwxr-xr-x 2026-03-30 10:22:35
Edit Download
libraries DIR
- drwxr-xr-x 2026-03-30 10:22:35
Edit Download
- drwxr-xr-x 2026-03-30 10:22:35
Edit Download
- drwxr-xr-x 2026-03-30 10:22:35
Edit Download
- drwxr-xr-x 2026-03-30 10:22:35
Edit Download
queue DIR
- drwxr-xr-x 2026-03-30 10:22:35
Edit Download
- drwxr-xr-x 2026-03-30 10:22:35
Edit Download
rest-api DIR
- drwxr-xr-x 2026-03-30 10:22:36
Edit Download
shipping DIR
- drwxr-xr-x 2026-03-30 10:21:54
Edit Download
- drwxr-xr-x 2026-03-30 10:22:36
Edit Download
- drwxr-xr-x 2026-03-30 10:22:36
Edit Download
tracks DIR
- drwxr-xr-x 2026-03-30 10:22:36
Edit Download
traits DIR
- drwxr-xr-x 2026-03-30 10:22:37
Edit Download
walkers DIR
- drwxr-xr-x 2026-03-30 10:22:37
Edit Download
- drwxr-xr-x 2026-03-30 10:22:37
Edit Download
widgets DIR
- drwxr-xr-x 2026-03-30 10:22:38
Edit Download
123.43 KB lrw-r--r-- 2026-03-30 10:22:31
Edit Download
12.69 KB lrw-r--r-- 2026-03-30 10:22:31
Edit Download
5.27 KB lrw-r--r-- 2026-03-30 10:22:31
Edit Download
4.58 KB lrw-r--r-- 2026-03-30 10:22:32
Edit Download
3.45 KB lrw-r--r-- 2026-03-30 10:22:32
Edit Download
1.78 KB lrw-r--r-- 2026-03-30 10:22:32
Edit Download
6.89 KB lrw-r--r-- 2026-03-30 10:22:32
Edit Download
34.80 KB lrw-r--r-- 2026-03-30 10:22:32
Edit Download
10.41 KB lrw-r--r-- 2026-03-30 10:22:32
Edit Download
12.69 KB lrw-r--r-- 2026-03-30 10:22:32
Edit Download
3.37 KB lrw-r--r-- 2026-03-30 10:22:32
Edit Download
25.38 KB lrw-r--r-- 2026-03-30 10:22:32
Edit Download
28.48 KB lrw-r--r-- 2026-03-30 10:22:32
Edit Download
74.21 KB lrw-r--r-- 2026-03-30 10:22:32
Edit Download
50.15 KB lrw-r--r-- 2026-03-30 10:22:32
Edit Download
3.34 KB lrw-r--r-- 2026-03-30 10:22:32
Edit Download
23.08 KB lrw-r--r-- 2026-03-30 10:22:32
Edit Download
50.67 KB lrw-r--r-- 2026-03-30 10:22:32
Edit Download
43.87 KB lrw-r--r-- 2026-03-30 10:22:32
Edit Download
3.37 KB lrw-r--r-- 2026-03-30 10:22:32
Edit Download
10.34 KB lrw-r--r-- 2026-03-30 10:22:32
Edit Download
33.20 KB lrw-r--r-- 2026-03-30 10:22:32
Edit Download
1.29 KB lrw-r--r-- 2026-03-30 10:22:32
Edit Download
6.59 KB lrw-r--r-- 2026-03-30 10:22:32
Edit Download
2.26 KB lrw-r--r-- 2026-03-30 10:22:32
Edit Download
6.59 KB lrw-r--r-- 2026-03-30 10:22:32
Edit Download
7.34 KB lrw-r--r-- 2026-03-30 10:22:32
Edit Download
36.64 KB lrw-r--r-- 2026-03-30 10:22:32
Edit Download
28.37 KB lrw-r--r-- 2026-03-30 10:22:32
Edit Download
39.09 KB lrw-r--r-- 2026-03-30 10:22:32
Edit Download
4.24 KB lrw-r--r-- 2026-03-30 10:22:32
Edit Download
48.17 KB lrw-r--r-- 2026-03-30 10:22:32
Edit Download
34.36 KB lrw-r--r-- 2026-03-30 10:22:32
Edit Download
30.43 KB lrw-r--r-- 2026-03-30 10:22:32
Edit Download
1.99 KB lrw-r--r-- 2026-03-30 10:22:32
Edit Download
11.34 KB lrw-r--r-- 2026-03-30 10:22:32
Edit Download
4.33 KB lrw-r--r-- 2026-03-30 10:22:32
Edit Download
116.06 KB lrw-r--r-- 2026-03-30 10:22:32
Edit Download
1.28 KB lrw-r--r-- 2026-03-30 10:22:32
Edit Download
3.90 KB lrw-r--r-- 2026-03-30 10:22:32
Edit Download
9.41 KB lrw-r--r-- 2026-03-30 10:22:32
Edit Download
2.21 KB lrw-r--r-- 2026-03-30 10:22:32
Edit Download
8.66 KB lrw-r--r-- 2026-03-30 10:22:32
Edit Download
4.08 KB lrw-r--r-- 2026-03-30 10:22:32
Edit Download
9.99 KB lrw-r--r-- 2026-03-30 10:22:32
Edit Download
5.80 KB lrw-r--r-- 2026-03-30 10:22:32
Edit Download
17.54 KB lrw-r--r-- 2026-03-30 10:22:32
Edit Download
9.58 KB lrw-r--r-- 2026-03-30 10:22:32
Edit Download
6.49 KB lrw-r--r-- 2026-03-30 10:22:32
Edit Download
21.39 KB lrw-r--r-- 2026-03-30 10:22:32
Edit Download
2.55 KB lrw-r--r-- 2026-03-30 10:22:33
Edit Download
5.99 KB lrw-r--r-- 2026-03-30 10:22:33
Edit Download
77.53 KB lrw-r--r-- 2026-03-30 10:22:32
Edit Download
16.56 KB lrw-r--r-- 2026-03-30 10:22:33
Edit Download
6.24 KB lrw-r--r-- 2026-03-30 10:22:33
Edit Download
36.87 KB lrw-r--r-- 2026-03-30 10:22:33
Edit Download
32.89 KB lrw-r--r-- 2026-03-30 10:22:33
Edit Download
1.79 KB lrw-r--r-- 2026-03-30 10:22:33
Edit Download
13.61 KB lrw-r--r-- 2026-03-30 10:22:33
Edit Download
14.69 KB lrw-r--r-- 2026-03-30 10:22:33
Edit Download
17.22 KB lrw-r--r-- 2026-03-30 10:22:33
Edit Download
7.87 KB lrw-r--r-- 2026-03-30 10:22:33
Edit Download
13.18 KB lrw-r--r-- 2026-03-30 10:22:33
Edit Download
4.98 KB lrw-r--r-- 2026-03-30 10:22:33
Edit Download
4.54 KB lrw-r--r-- 2026-03-30 10:22:33
Edit Download
6.75 KB lrw-r--r-- 2026-03-30 10:22:33
Edit Download
2.27 KB lrw-r--r-- 2026-03-30 10:22:33
Edit Download
2.70 KB lrw-r--r-- 2026-03-30 10:22:33
Edit Download
23.70 KB lrw-r--r-- 2026-03-30 10:22:33
Edit Download
20.18 KB lrw-r--r-- 2026-03-30 10:22:33
Edit Download
33.50 KB lrw-r--r-- 2026-03-30 10:22:33
Edit Download
4.00 KB lrw-r--r-- 2026-03-30 10:22:33
Edit Download
7.74 KB lrw-r--r-- 2026-03-30 10:22:33
Edit Download
15.44 KB lrw-r--r-- 2026-03-30 10:22:33
Edit Download
5.05 KB lrw-r--r-- 2026-03-30 10:22:33
Edit Download
21.55 KB lrw-r--r-- 2026-03-30 10:22:33
Edit Download
276 B lrw-r--r-- 2026-03-30 10:22:33
Edit Download
24.15 KB lrw-r--r-- 2026-03-30 10:22:33
Edit Download
9.34 KB lrw-r--r-- 2026-03-30 10:22:33
Edit Download
13.08 KB lrw-r--r-- 2026-03-30 10:22:33
Edit Download
5.00 KB lrw-r--r-- 2026-03-30 10:22:33
Edit Download
12.85 KB lrw-r--r-- 2026-03-30 10:22:33
Edit Download
18.82 KB lrw-r--r-- 2026-03-30 10:22:33
Edit Download
24.42 KB lrw-r--r-- 2026-03-30 10:22:33
Edit Download
39.74 KB lrw-r--r-- 2026-03-30 10:22:33
Edit Download
20.42 KB lrw-r--r-- 2026-03-30 10:22:33
Edit Download
51.50 KB lrw-r--r-- 2026-03-30 10:22:33
Edit Download
5.79 KB lrw-r--r-- 2026-03-30 10:22:33
Edit Download
30.08 KB lrw-r--r-- 2026-03-30 10:22:33
Edit Download
62.17 KB lrw-r--r-- 2026-03-30 10:22:33
Edit Download
14.15 KB lrw-r--r-- 2026-03-30 10:22:37
Edit Download
21.85 KB lrw-r--r-- 2026-03-30 10:22:37
Edit Download
4.17 KB lrw-r--r-- 2026-03-30 10:22:37
Edit Download
20.81 KB lrw-r--r-- 2026-03-30 10:22:37
Edit Download
15.53 KB lrw-r--r-- 2026-03-30 10:22:37
Edit Download
78.71 KB lrw-r--r-- 2026-03-30 10:22:37
Edit Download
5.56 KB lrw-r--r-- 2026-03-30 10:22:37
Edit Download
39.78 KB lrw-r--r-- 2026-03-30 10:22:37
Edit Download
49.90 KB lrw-r--r-- 2026-03-30 10:22:37
Edit Download
2.17 KB lrw-r--r-- 2026-03-30 10:22:37
Edit Download
8.49 KB lrw-r--r-- 2026-03-30 10:22:37
Edit Download
43.41 KB lrw-r--r-- 2026-03-30 10:22:37
Edit Download
5.03 KB lrw-r--r-- 2026-03-30 10:22:37
Edit Download
5.97 KB lrw-r--r-- 2026-03-30 10:22:37
Edit Download
9.43 KB lrw-r--r-- 2026-03-30 10:22:37
Edit Download
67.38 KB lrw-r--r-- 2026-03-30 10:22:37
Edit Download
13.93 KB lrw-r--r-- 2026-03-30 10:22:37
Edit Download
17.43 KB lrw-r--r-- 2026-03-30 10:22:37
Edit Download
141.89 KB lrw-r--r-- 2026-03-30 10:22:37
Edit Download
12.84 KB lrw-r--r-- 2026-03-30 10:22:37
Edit Download
24.57 KB lrw-r--r-- 2026-03-30 10:22:37
Edit Download
101.89 KB lrw-r--r-- 2026-03-30 10:22:37
Edit Download
34.17 KB lrw-r--r-- 2026-03-30 10:22:37
Edit Download
5.77 KB lrw-r--r-- 2026-03-30 10:22:37
Edit Download
2.01 KB lrw-r--r-- 2026-03-30 10:22:37
Edit Download

If ZipArchive is unavailable, a .tar will be created (no compression).