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
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
|
<?php
/**
* WooCommerce Shipping Rate
*
* Simple Class for storing rates.
*
* @package WooCommerce\Classes\Shipping
* @since 2.6.0
*/
defined( 'ABSPATH' ) || exit;
/**
* Shipping rate class.
*/
class WC_Shipping_Rate {
/**
* Stores data for this rate.
*
* @since 3.2.0
* @since 9.2.0 Added description and delivery_time.
* @var array
*/
protected $data = array(
'id' => '',
'method_id' => '',
'instance_id' => 0,
'label' => '',
'cost' => 0,
'taxes' => array(),
'tax_status' => 'taxable',
'description' => '',
'delivery_time' => '',
);
/**
* Stores meta data for this rate.
*
* @since 2.6.0
* @var array
*/
protected $meta_data = array();
/**
* Constructor.
*
* @param string $id Shipping rate ID.
* @param string $label Shipping rate label.
* @param integer $cost Cost.
* @param array $taxes Taxes applied to shipping rate.
* @param string $method_id Shipping method ID.
* @param int $instance_id Shipping instance ID.
* @param string $tax_status Tax status.
* @param string $description Shipping rate description.
* @param string $delivery_time Shipping rate delivery time.
*/
public function __construct( $id = '', $label = '', $cost = 0, $taxes = array(), $method_id = '', $instance_id = 0, $tax_status = 'taxable', $description = '', $delivery_time = '' ) {
$this->set_id( $id );
$this->set_label( $label );
$this->set_cost( $cost );
$this->set_taxes( $taxes );
$this->set_method_id( $method_id );
$this->set_instance_id( $instance_id );
$this->set_tax_status( $tax_status );
$this->set_description( $description );
$this->set_delivery_time( $delivery_time );
}
/**
* Magic methods to support direct access to props.
*
* @since 3.2.0
* @param string $key Key.
* @return bool
*/
public function __isset( $key ) {
if ( 'meta_data' === $key ) {
wc_doing_it_wrong( __FUNCTION__, __( 'Use `array_key_exists` to check for meta_data on WC_Shipping_Rate to get the correct result.', 'woocommerce' ), '6.0' );
}
return isset( $this->data[ $key ] );
}
/**
* Magic methods to support direct access to props.
*
* @since 3.2.0
* @param string $key Key.
* @return mixed
*/
public function __get( $key ) {
if ( is_callable( array( $this, "get_{$key}" ) ) ) {
return $this->{"get_{$key}"}();
} elseif ( isset( $this->data[ $key ] ) ) {
return $this->data[ $key ];
} else {
return '';
}
}
/**
* Magic methods to support direct access to props.
*
* @since 3.2.0
* @param string $key Key.
* @param mixed $value Value.
*/
public function __set( $key, $value ) {
if ( is_callable( array( $this, "set_{$key}" ) ) ) {
$this->{"set_{$key}"}( $value );
} else {
$this->data[ $key ] = $value;
}
}
/**
* Set ID for the rate. This is usually a combination of the method and instance IDs.
*
* @since 3.2.0
* @param string $id Shipping rate ID.
*/
public function set_id( $id ) {
$this->data['id'] = (string) $id;
}
/**
* Set shipping method ID the rate belongs to.
*
* @since 3.2.0
* @param string $method_id Shipping method ID.
*/
public function set_method_id( $method_id ) {
$this->data['method_id'] = (string) $method_id;
}
/**
* Set instance ID the rate belongs to.
*
* @since 3.2.0
* @param int $instance_id Instance ID.
*/
public function set_instance_id( $instance_id ) {
$this->data['instance_id'] = absint( $instance_id );
}
/**
* Set rate label.
*
* @since 3.2.0
* @param string $label Shipping rate label.
*/
public function set_label( $label ) {
$this->data['label'] = (string) $label;
}
/**
* Set rate cost.
*
* @todo 4.0 Prevent negative value being set. #19293
* @since 3.2.0
* @param string $cost Shipping rate cost.
*/
public function set_cost( $cost ) {
$this->data['cost'] = $cost;
}
/**
* Set rate taxes.
*
* @since 3.2.0
* @param array $taxes List of taxes applied to shipping rate.
*/
public function set_taxes( $taxes ) {
$this->data['taxes'] = ! empty( $taxes ) && is_array( $taxes ) ? $taxes : array();
}
/**
* Set tax status.
*
* @since 9.6.0
* @param string $value Tax status.
*/
public function set_tax_status( $value ) {
if ( in_array( $value, array( 'taxable', 'none' ), true ) ) {
$this->data['tax_status'] = $value;
}
}
/**
* Set rate description.
*
* @since 9.2.0
* @param string $description Shipping rate description.
*/
public function set_description( $description ) {
$this->data['description'] = (string) $description;
}
/**
* Set rate delivery time.
*
* @since 9.2.0
* @param string $delivery_time Shipping rate delivery time.
*/
public function set_delivery_time( $delivery_time ) {
$this->data['delivery_time'] = (string) $delivery_time;
}
/**
* Get ID for the rate. This is usually a combination of the method and instance IDs.
*
* @since 3.2.0
* @return string
*/
public function get_id() {
return apply_filters( 'woocommerce_shipping_rate_id', $this->data['id'], $this );
}
/**
* Get shipping method ID the rate belongs to.
*
* @since 3.2.0
* @return string
*/
public function get_method_id() {
return apply_filters( 'woocommerce_shipping_rate_method_id', $this->data['method_id'], $this );
}
/**
* Get instance ID the rate belongs to.
*
* @since 3.2.0
* @return int
*/
public function get_instance_id() {
return apply_filters( 'woocommerce_shipping_rate_instance_id', $this->data['instance_id'], $this );
}
/**
* Get rate label.
*
* @return string
*/
public function get_label() {
return apply_filters( 'woocommerce_shipping_rate_label', $this->data['label'], $this );
}
/**
* Get rate cost.
*
* @since 3.2.0
* @return string
*/
public function get_cost() {
return apply_filters( 'woocommerce_shipping_rate_cost', $this->data['cost'], $this );
}
/**
* Get rate taxes.
*
* @since 3.2.0
* @return array
*/
public function get_taxes() {
return apply_filters( 'woocommerce_shipping_rate_taxes', $this->data['taxes'], $this );
}
/**
* Get shipping tax.
*
* @return float
*/
public function get_shipping_tax() {
return apply_filters( 'woocommerce_get_shipping_tax', count( $this->taxes ) > 0 && ! WC()->customer->get_is_vat_exempt() ? (float) array_sum( $this->taxes ) : 0.0, $this );
}
/**
* Get tax status.
*
* @return string
*/
public function get_tax_status() {
/**
* Filter to allow tax status to be overridden for a shipping rate.
*
* @since 9.9.0
* @param string $tax_status Tax status.
* @param WC_Shipping_Rate $this Shipping rate object.
*/
return apply_filters( 'woocommerce_shipping_rate_tax_status', $this->data['tax_status'], $this );
}
/**
* Get rate description.
*
* @since 9.2.0
* @return string
*/
public function get_description() {
/**
* Filter the shipping rate description.
*
* @since 9.2.0
*
* @param string $description The current description.
* @param WC_Shipping_Rate $this The shipping rate.
*/
return apply_filters( 'woocommerce_shipping_rate_description', $this->data['description'], $this );
}
/**
* Get rate delivery time.
*
* @since 9.2.0
* @return string
*/
public function get_delivery_time() {
/**
* Filter the shipping rate delivery time.
*
* @since 9.2.0
*
* @param string $delivery_time The current description.
* @param WC_Shipping_Rate $this The shipping rate.
*/
return apply_filters( 'woocommerce_shipping_rate_delivery_time', $this->data['delivery_time'], $this );
}
/**
* Add some meta data for this rate.
*
* @since 2.6.0
* @param string $key Key.
* @param string $value Value.
*/
public function add_meta_data( $key, $value ) {
$this->meta_data[ wc_clean( $key ) ] = wc_clean( $value );
}
/**
* Get all meta data for this rate.
*
* @since 2.6.0
* @return array
*/
public function get_meta_data() {
return $this->meta_data;
}
}
|