/var/www/html/wp-content/plugins/woocommerce/includes/traits/trait-wc-item-totals.php


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
<?php
/**
 * This ongoing trait will have shared calculation logic between WC_Abstract_Order and WC_Cart_Totals classes.
 *
 * @package WooCommerce\Traits
 * @version 3.9.0
 */

use Automattic\WooCommerce\Utilities\NumberUtil;

if ( ! 
defined'ABSPATH' ) ) {
    exit;
}

/**
 * Trait WC_Item_Totals.
 *
 * Right now this do not have much, but plan is to eventually move all shared calculation logic between Orders and Cart in this file.
 *
 * @since 3.9.0
 */
trait WC_Item_Totals {

    
/**
     * Line items to calculate. Define in child class.
     *
     * @since 3.9.0
     * @param string $field Field name to calculate upon.
     *
     * @return array having `total`|`subtotal` property.
     */
    
abstract protected function get_values_for_total$field );

    
/**
     * Return rounded total based on settings. Will be used by Cart and Orders.
     *
     * @since 3.9.0
     *
     * @param array $values Values to round. Should be with precision.
     *
     * @return float|int Appropriately rounded value.
     */
    
public static function get_rounded_items_total$values ) {
        return 
array_sum(
            
array_map(
                array( 
self::class, 'round_item_subtotal' ),
                
$values
            
)
        );
    }

    
/**
     * Apply rounding to item subtotal before summing.
     *
     * @since 3.9.0
     * @param float $value Item subtotal value.
     * @return float
     */
    
public static function round_item_subtotal$value ) {
        if ( ! 
self::round_at_subtotal() ) {
            
$value NumberUtil::round$value );
        }
        return 
$value;
    }

    
/**
     * Should always round at subtotal?
     *
     * @since 3.9.0
     * @return bool
     */
    
protected static function round_at_subtotal() {
        return 
'yes' === get_option'woocommerce_tax_round_at_subtotal' );
    }

    
/**
     * Apply rounding to an array of taxes before summing. Rounds to store DP setting, ignoring precision.
     *
     * @since  3.2.6
     * @param  float $value    Tax value.
     * @param  bool  $in_cents Whether precision of value is in cents.
     * @return float
     */
    
protected static function round_line_tax$value$in_cents true ) {
        if ( ! 
self::round_at_subtotal() ) {
            
$value wc_round_tax_total$value$in_cents null );
        }
        return 
$value;
    }

}