1
|
|
|
<?php |
|
|
|
|
2
|
|
|
|
3
|
|
|
if ( ! defined( 'ABSPATH' ) ) { |
4
|
|
|
exit; // Exit if accessed directly |
5
|
|
|
} |
6
|
|
|
|
7
|
|
|
/** |
8
|
|
|
* Product Variation Class. |
9
|
|
|
* |
10
|
|
|
* The WooCommerce product variation class handles product variation data. |
11
|
|
|
* |
12
|
|
|
* @class WC_Product_Variation |
13
|
|
|
* @version 2.2.0 |
14
|
|
|
* @package WooCommerce/Classes |
15
|
|
|
* @category Class |
16
|
|
|
* @author WooThemes |
17
|
|
|
*/ |
18
|
|
|
class WC_Product_Variation extends WC_Product { |
19
|
|
|
|
20
|
|
|
/** @public int ID of the variation itself. */ |
21
|
|
|
public $variation_id; |
22
|
|
|
|
23
|
|
|
/** @public object Parent Variable product object. */ |
24
|
|
|
public $parent; |
25
|
|
|
|
26
|
|
|
/** @public string Stores the shipping class of the variation. */ |
27
|
|
|
public $variation_shipping_class = false; |
28
|
|
|
|
29
|
|
|
/** @public int Stores the shipping class ID of the variation. */ |
30
|
|
|
public $variation_shipping_class_id = false; |
31
|
|
|
|
32
|
|
|
/** @public unused vars @deprecated in 2.2 */ |
33
|
|
|
public $variation_has_sku = true; |
34
|
|
|
public $variation_has_length = true; |
35
|
|
|
public $variation_has_width = true; |
36
|
|
|
public $variation_has_height = true; |
37
|
|
|
public $variation_has_weight = true; |
38
|
|
|
public $variation_has_tax_class = true; |
39
|
|
|
public $variation_has_downloadable_files = true; |
40
|
|
|
|
41
|
|
|
/** @private array Data which is only at variation level - no inheritance plus their default values if left blank. */ |
42
|
|
|
protected $variation_level_meta_data = array( |
43
|
|
|
'downloadable' => 'no', |
44
|
|
|
'virtual' => 'no', |
45
|
|
|
'manage_stock' => 'no', |
46
|
|
|
'sale_price_dates_from' => '', |
47
|
|
|
'sale_price_dates_to' => '', |
48
|
|
|
'price' => '', |
49
|
|
|
'regular_price' => '', |
50
|
|
|
'sale_price' => '', |
51
|
|
|
'stock' => 0, |
52
|
|
|
'stock_status' => 'instock', |
53
|
|
|
'downloadable_files' => array() |
54
|
|
|
); |
55
|
|
|
|
56
|
|
|
/** @private array Data which can be at variation level, otherwise fallback to parent if not set. */ |
57
|
|
|
protected $variation_inherited_meta_data = array( |
58
|
|
|
'tax_class' => '', |
59
|
|
|
'backorders' => 'no', |
60
|
|
|
'sku' => '', |
61
|
|
|
'weight' => '', |
62
|
|
|
'length' => '', |
63
|
|
|
'width' => '', |
64
|
|
|
'height' => '' |
65
|
|
|
); |
66
|
|
|
|
67
|
|
|
/** |
68
|
|
|
* Loads required variation data. |
69
|
|
|
* |
70
|
|
|
* @param int $variation ID of the variation to load |
71
|
|
|
* @param array $args Array of the arguments containing parent product data |
72
|
|
|
*/ |
73
|
|
|
public function __construct( $variation, $args = array() ) { |
74
|
|
|
if ( is_object( $variation ) ) { |
75
|
|
|
$this->variation_id = absint( $variation->ID ); |
76
|
|
|
} else { |
77
|
|
|
$this->variation_id = absint( $variation ); |
78
|
|
|
} |
79
|
|
|
|
80
|
|
|
/* Get main product data from parent (args) */ |
81
|
|
|
$this->id = ! empty( $args['parent_id'] ) ? intval( $args['parent_id'] ) : wp_get_post_parent_id( $this->variation_id ); |
82
|
|
|
|
83
|
|
|
// The post doesn't have a parent id, therefore its invalid. |
84
|
|
|
if ( empty( $this->id ) ) { |
85
|
|
|
return; |
86
|
|
|
} |
87
|
|
|
|
88
|
|
|
$this->product_type = 'variation'; |
89
|
|
|
$this->parent = ! empty( $args['parent'] ) ? $args['parent'] : wc_get_product( $this->id ); |
90
|
|
|
$this->post = ! empty( $this->parent->post ) ? $this->parent->post : array(); |
91
|
|
|
} |
92
|
|
|
|
93
|
|
|
/** |
94
|
|
|
* __isset function. |
95
|
|
|
* |
96
|
|
|
* @param mixed $key |
97
|
|
|
* @return bool |
98
|
|
|
*/ |
99
|
|
|
public function __isset( $key ) { |
100
|
|
|
if ( in_array( $key, array_keys( $this->variation_level_meta_data ) ) ) { |
101
|
|
|
return metadata_exists( 'post', $this->variation_id, '_' . $key ); |
102
|
|
|
} elseif ( in_array( $key, array_keys( $this->variation_inherited_meta_data ) ) ) { |
103
|
|
|
return metadata_exists( 'post', $this->variation_id, '_' . $key ) || metadata_exists( 'post', $this->id, '_' . $key ); |
104
|
|
|
} else { |
105
|
|
|
return metadata_exists( 'post', $this->id, '_' . $key ); |
106
|
|
|
} |
107
|
|
|
} |
108
|
|
|
|
109
|
|
|
/** |
110
|
|
|
* Get method returns variation meta data if set, otherwise in most cases the data from the parent. |
111
|
|
|
* |
112
|
|
|
* @param string $key |
113
|
|
|
* @return mixed |
114
|
|
|
*/ |
115
|
|
|
public function __get( $key ) { |
116
|
|
|
if ( in_array( $key, array_keys( $this->variation_level_meta_data ) ) ) { |
117
|
|
|
|
118
|
|
|
$value = get_post_meta( $this->variation_id, '_' . $key, true ); |
119
|
|
|
|
120
|
|
|
if ( '' === $value ) { |
121
|
|
|
$value = $this->variation_level_meta_data[ $key ]; |
122
|
|
|
} |
123
|
|
|
|
124
|
|
|
} elseif ( in_array( $key, array_keys( $this->variation_inherited_meta_data ) ) ) { |
125
|
|
|
|
126
|
|
|
$value = metadata_exists( 'post', $this->variation_id, '_' . $key ) ? get_post_meta( $this->variation_id, '_' . $key, true ) : get_post_meta( $this->id, '_' . $key, true ); |
127
|
|
|
|
128
|
|
|
// Handle meta data keys which can be empty at variation level to cause inheritance |
129
|
|
|
if ( '' === $value && in_array( $key, array( 'sku', 'weight', 'length', 'width', 'height' ) ) ) { |
130
|
|
|
$value = get_post_meta( $this->id, '_' . $key, true ); |
131
|
|
|
} |
132
|
|
|
|
133
|
|
|
if ( '' === $value ) { |
134
|
|
|
$value = $this->variation_inherited_meta_data[ $key ]; |
135
|
|
|
} |
136
|
|
|
|
137
|
|
|
} elseif ( 'variation_data' === $key ) { |
138
|
|
|
return $this->variation_data = wc_get_product_variation_attributes( $this->variation_id ); |
139
|
|
|
|
140
|
|
|
} elseif ( 'variation_has_stock' === $key ) { |
141
|
|
|
return $this->managing_stock(); |
142
|
|
|
|
143
|
|
|
} else { |
144
|
|
|
$value = metadata_exists( 'post', $this->variation_id, '_' . $key ) ? get_post_meta( $this->variation_id, '_' . $key, true ) : parent::__get( $key ); |
145
|
|
|
} |
146
|
|
|
|
147
|
|
|
return $value; |
148
|
|
|
} |
149
|
|
|
|
150
|
|
|
/** |
151
|
|
|
* Return the variation ID |
152
|
|
|
* |
153
|
|
|
* @since 2.5.0 |
154
|
|
|
* @return int variation (post) ID |
155
|
|
|
*/ |
156
|
|
|
public function get_id() { |
157
|
|
|
|
158
|
|
|
return $this->variation_id; |
159
|
|
|
} |
160
|
|
|
|
161
|
|
|
/** |
162
|
|
|
* Returns whether or not the product post exists. |
163
|
|
|
* |
164
|
|
|
* @return bool |
165
|
|
|
*/ |
166
|
|
|
public function exists() { |
167
|
|
|
return ! empty( $this->id ); |
168
|
|
|
} |
169
|
|
|
|
170
|
|
|
/** |
171
|
|
|
* Wrapper for get_permalink. Adds this variations attributes to the URL. |
172
|
|
|
* |
173
|
|
|
* @param $cart item array If the cart item is passed, we can get a link containing the exact attributes selected for the variation, rather than the default attributes. |
174
|
|
|
* @return string |
175
|
|
|
*/ |
176
|
|
|
public function get_permalink( $cart_item = null ) { |
177
|
|
|
return add_query_arg( array_map( 'urlencode', array_filter( isset( $cart_item['variation'] ) ? $cart_item['variation'] : $this->variation_data ) ), get_permalink( $this->id ) ); |
178
|
|
|
} |
179
|
|
|
|
180
|
|
|
/** |
181
|
|
|
* Get the add to url used mainly in loops. |
182
|
|
|
* |
183
|
|
|
* @return string |
184
|
|
|
*/ |
185
|
|
|
public function add_to_cart_url() { |
186
|
|
|
$variation_data = array_map( 'urlencode', $this->variation_data ); |
187
|
|
|
$url = $this->is_purchasable() && $this->is_in_stock() ? remove_query_arg( 'added-to-cart', add_query_arg( array_merge( array( 'variation_id' => $this->variation_id, 'add-to-cart' => $this->id ), $variation_data ) ) ) : get_permalink( $this->id ); |
188
|
|
|
|
189
|
|
|
return apply_filters( 'woocommerce_product_add_to_cart_url', $url, $this ); |
190
|
|
|
} |
191
|
|
|
|
192
|
|
|
/** |
193
|
|
|
* Get the add to cart button text. |
194
|
|
|
* |
195
|
|
|
* @return string |
196
|
|
|
*/ |
197
|
|
|
public function add_to_cart_text() { |
198
|
|
|
$text = $this->is_purchasable() && $this->is_in_stock() ? __( 'Add to cart', 'woocommerce' ) : __( 'Read More', 'woocommerce' ); |
199
|
|
|
|
200
|
|
|
return apply_filters( 'woocommerce_product_add_to_cart_text', $text, $this ); |
201
|
|
|
} |
202
|
|
|
|
203
|
|
|
/** |
204
|
|
|
* Checks if this particular variation is visible. Invisible variations are enabled and can be selected, but no price / stock info is displayed. |
205
|
|
|
* Instead, a suitable 'unavailable' message is displayed. |
206
|
|
|
* Invisible by default: Disabled variations and variations with an empty price. |
207
|
|
|
* |
208
|
|
|
* @return bool |
209
|
|
|
*/ |
210
|
|
|
public function variation_is_visible() { |
211
|
|
|
$visible = true; |
212
|
|
|
|
213
|
|
|
// Published == enabled checkbox |
214
|
|
|
if ( get_post_status( $this->variation_id ) != 'publish' ) { |
215
|
|
|
$visible = false; |
216
|
|
|
} |
217
|
|
|
|
218
|
|
|
// Price not set |
219
|
|
|
elseif ( $this->get_price() === "" ) { |
220
|
|
|
$visible = false; |
221
|
|
|
} |
222
|
|
|
|
223
|
|
|
return apply_filters( 'woocommerce_variation_is_visible', $visible, $this->variation_id, $this->id, $this ); |
224
|
|
|
} |
225
|
|
|
|
226
|
|
|
/** |
227
|
|
|
* Controls whether this particular variation will appear greyed-out (inactive) or not (active). |
228
|
|
|
* Used by extensions to make incompatible variations appear greyed-out, etc. |
229
|
|
|
* Other possible uses: prevent out-of-stock variations from being selected. |
230
|
|
|
* |
231
|
|
|
* @return bool |
232
|
|
|
*/ |
233
|
|
|
public function variation_is_active() { |
234
|
|
|
return apply_filters( 'woocommerce_variation_is_active', true, $this ); |
235
|
|
|
} |
236
|
|
|
|
237
|
|
|
/** |
238
|
|
|
* Returns false if the product cannot be bought. |
239
|
|
|
* Override abstract method so that: i) Disabled variations are not be purchasable by admins. ii) Enabled variations are not purchasable if the parent product is not purchasable. |
240
|
|
|
* |
241
|
|
|
* @return bool |
242
|
|
|
*/ |
243
|
|
|
public function is_purchasable() { |
244
|
|
|
// Published == enabled checkbox |
245
|
|
|
if ( get_post_status( $this->variation_id ) != 'publish' ) { |
246
|
|
|
$purchasable = false; |
247
|
|
|
} else { |
248
|
|
|
$purchasable = parent::is_purchasable(); |
249
|
|
|
} |
250
|
|
|
return apply_filters( 'woocommerce_variation_is_purchasable', $purchasable, $this ); |
251
|
|
|
} |
252
|
|
|
|
253
|
|
|
/** |
254
|
|
|
* Returns whether or not the variations parent is visible. |
255
|
|
|
* |
256
|
|
|
* @return bool |
257
|
|
|
*/ |
258
|
|
|
public function parent_is_visible() { |
259
|
|
|
return $this->is_visible(); |
260
|
|
|
} |
261
|
|
|
|
262
|
|
|
/** |
263
|
|
|
* Get variation ID. |
264
|
|
|
* |
265
|
|
|
* @return int |
266
|
|
|
*/ |
267
|
|
|
public function get_variation_id() { |
268
|
|
|
return absint( $this->variation_id ); |
269
|
|
|
} |
270
|
|
|
|
271
|
|
|
/** |
272
|
|
|
* Get variation attribute values. |
273
|
|
|
* |
274
|
|
|
* @return array of attributes and their values for this variation |
275
|
|
|
*/ |
276
|
|
|
public function get_variation_attributes() { |
277
|
|
|
return $this->variation_data; |
278
|
|
|
} |
279
|
|
|
|
280
|
|
|
/** |
281
|
|
|
* Check if all variation's attributes are set. |
282
|
|
|
* |
283
|
|
|
* @return boolean |
284
|
|
|
*/ |
285
|
|
|
public function has_all_attributes_set() { |
286
|
|
|
|
287
|
|
|
$set = true; |
288
|
|
|
|
289
|
|
|
// undefined attributes have null strings as array values |
290
|
|
|
foreach( $this->get_variation_attributes() as $att ){ |
291
|
|
|
if( ! $att ){ |
292
|
|
|
$set = false; |
293
|
|
|
break; |
294
|
|
|
} |
295
|
|
|
} |
296
|
|
|
|
297
|
|
|
return $set; |
298
|
|
|
|
299
|
|
|
} |
300
|
|
|
|
301
|
|
|
/** |
302
|
|
|
* Get variation price HTML. Prices are not inherited from parents. |
303
|
|
|
* |
304
|
|
|
* @return string containing the formatted price |
305
|
|
|
*/ |
306
|
|
|
public function get_price_html( $price = '' ) { |
307
|
|
|
|
308
|
|
|
$display_price = $this->get_display_price(); |
309
|
|
|
$display_regular_price = $this->get_display_price( $this->get_regular_price() ); |
310
|
|
|
$display_sale_price = $this->get_display_price( $this->get_sale_price() ); |
311
|
|
|
|
312
|
|
|
if ( $this->get_price() !== '' ) { |
313
|
|
|
if ( $this->is_on_sale() ) { |
314
|
|
|
$price = apply_filters( 'woocommerce_variation_sale_price_html', '<del>' . wc_price( $display_regular_price ) . '</del> <ins>' . wc_price( $display_sale_price ) . '</ins>' . $this->get_price_suffix(), $this ); |
315
|
|
|
} elseif ( $this->get_price() > 0 ) { |
316
|
|
|
$price = apply_filters( 'woocommerce_variation_price_html', wc_price( $display_price ) . $this->get_price_suffix(), $this ); |
317
|
|
|
} else { |
318
|
|
|
$price = apply_filters( 'woocommerce_variation_free_price_html', __( 'Free!', 'woocommerce' ), $this ); |
319
|
|
|
} |
320
|
|
|
} else { |
321
|
|
|
$price = apply_filters( 'woocommerce_variation_empty_price_html', '', $this ); |
322
|
|
|
} |
323
|
|
|
|
324
|
|
|
return apply_filters( 'woocommerce_get_variation_price_html', $price, $this ); |
325
|
|
|
} |
326
|
|
|
|
327
|
|
|
/** |
328
|
|
|
* Gets the main product image ID. |
329
|
|
|
* |
330
|
|
|
* @return int |
331
|
|
|
*/ |
332
|
|
|
public function get_image_id() { |
333
|
|
|
if ( $this->variation_id && has_post_thumbnail( $this->variation_id ) ) { |
334
|
|
|
$image_id = get_post_thumbnail_id( $this->variation_id ); |
335
|
|
|
} elseif ( has_post_thumbnail( $this->id ) ) { |
336
|
|
|
$image_id = get_post_thumbnail_id( $this->id ); |
337
|
|
View Code Duplication |
} elseif ( ( $parent_id = wp_get_post_parent_id( $this->id ) ) && has_post_thumbnail( $parent_id ) ) { |
|
|
|
|
338
|
|
|
$image_id = get_post_thumbnail_id( $parent_id ); |
339
|
|
|
} else { |
340
|
|
|
$image_id = 0; |
341
|
|
|
} |
342
|
|
|
return $image_id; |
343
|
|
|
} |
344
|
|
|
|
345
|
|
|
/** |
346
|
|
|
* Gets the main product image. |
347
|
|
|
* |
348
|
|
|
* @param string $size (default: 'shop_thumbnail') |
349
|
|
|
* @return string |
350
|
|
|
*/ |
351
|
|
|
public function get_image( $size = 'shop_thumbnail', $attr = array() ) { |
352
|
|
|
if ( $this->variation_id && has_post_thumbnail( $this->variation_id ) ) { |
353
|
|
|
$image = get_the_post_thumbnail( $this->variation_id, $size, $attr ); |
354
|
|
|
} elseif ( has_post_thumbnail( $this->id ) ) { |
355
|
|
|
$image = get_the_post_thumbnail( $this->id, $size, $attr ); |
356
|
|
View Code Duplication |
} elseif ( ( $parent_id = wp_get_post_parent_id( $this->id ) ) && has_post_thumbnail( $parent_id ) ) { |
|
|
|
|
357
|
|
|
$image = get_the_post_thumbnail( $parent_id, $size , $attr); |
358
|
|
|
} else { |
359
|
|
|
$image = wc_placeholder_img( $size ); |
360
|
|
|
} |
361
|
|
|
return $image; |
362
|
|
|
} |
363
|
|
|
|
364
|
|
|
/** |
365
|
|
|
* Returns whether or not the product (or variation) is stock managed. |
366
|
|
|
* |
367
|
|
|
* @return bool|string Bool if managed at variation level, 'parent' if managed by the parent. |
368
|
|
|
*/ |
369
|
|
|
public function managing_stock() { |
370
|
|
|
if ( 'yes' === get_option( 'woocommerce_manage_stock', 'yes' ) ) { |
371
|
|
|
if ( 'no' === $this->manage_stock ) { |
372
|
|
|
if ( $this->parent && $this->parent->managing_stock() ) { |
373
|
|
|
return 'parent'; |
374
|
|
|
} |
375
|
|
|
} else { |
376
|
|
|
return true; |
377
|
|
|
} |
378
|
|
|
} |
379
|
|
|
return false; |
380
|
|
|
} |
381
|
|
|
|
382
|
|
|
/** |
383
|
|
|
* Returns number of items available for sale from the variation, or parent. |
384
|
|
|
* |
385
|
|
|
* @return int |
386
|
|
|
*/ |
387
|
|
|
public function get_stock_quantity() { |
388
|
|
|
return true === $this->managing_stock() ? wc_stock_amount( $this->stock ) : $this->parent->get_stock_quantity(); |
389
|
|
|
} |
390
|
|
|
|
391
|
|
|
/** |
392
|
|
|
* Returns the tax status. Always use parent data. |
393
|
|
|
* |
394
|
|
|
* @return string |
395
|
|
|
*/ |
396
|
|
|
public function get_tax_status() { |
397
|
|
|
return $this->parent->get_tax_status(); |
398
|
|
|
} |
399
|
|
|
|
400
|
|
|
/** |
401
|
|
|
* Returns whether or not the product is in stock. |
402
|
|
|
* |
403
|
|
|
* @return bool |
404
|
|
|
*/ |
405
|
|
|
public function is_in_stock() { |
406
|
|
|
// If we're managing stock at variation level, check stock levels |
407
|
|
|
if ( true === $this->managing_stock() ) { |
408
|
|
|
if ( $this->backorders_allowed() ) { |
409
|
|
|
return true; |
410
|
|
|
} elseif ( $this->get_stock_quantity() <= get_option( 'woocommerce_notify_no_stock_amount' ) ) { |
411
|
|
|
return false; |
412
|
|
|
} else { |
413
|
|
|
return $this->stock_status === 'instock'; |
414
|
|
|
} |
415
|
|
|
} else { |
416
|
|
|
return $this->stock_status === 'instock'; |
417
|
|
|
} |
418
|
|
|
} |
419
|
|
|
|
420
|
|
|
/** |
421
|
|
|
* Set stock level of the product variation. |
422
|
|
|
* |
423
|
|
|
* Uses queries rather than update_post_meta so we can do this in one query (to avoid stock issues). |
424
|
|
|
* We cannot rely on the original loaded value in case another order was made since then. |
425
|
|
|
* |
426
|
|
|
* @param int $amount |
427
|
|
|
* @param string $mode can be set, add, or subtract |
428
|
|
|
* @return int new stock level |
429
|
|
|
*/ |
430
|
|
|
public function set_stock( $amount = null, $mode = 'set' ) { |
431
|
|
|
global $wpdb; |
432
|
|
|
|
433
|
|
|
if ( ! is_null( $amount ) && true === $this->managing_stock() ) { |
434
|
|
|
|
435
|
|
|
// Ensure key exists |
436
|
|
|
add_post_meta( $this->variation_id, '_stock', 0, true ); |
437
|
|
|
|
438
|
|
|
// Update stock in DB directly |
439
|
|
View Code Duplication |
switch ( $mode ) { |
|
|
|
|
440
|
|
|
case 'add' : |
441
|
|
|
$wpdb->query( $wpdb->prepare( "UPDATE {$wpdb->postmeta} SET meta_value = meta_value + %f WHERE post_id = %d AND meta_key='_stock'", $amount, $this->variation_id ) ); |
442
|
|
|
break; |
443
|
|
|
case 'subtract' : |
444
|
|
|
$wpdb->query( $wpdb->prepare( "UPDATE {$wpdb->postmeta} SET meta_value = meta_value - %f WHERE post_id = %d AND meta_key='_stock'", $amount, $this->variation_id ) ); |
445
|
|
|
break; |
446
|
|
|
default : |
447
|
|
|
$wpdb->query( $wpdb->prepare( "UPDATE {$wpdb->postmeta} SET meta_value = %f WHERE post_id = %d AND meta_key='_stock'", $amount, $this->variation_id ) ); |
448
|
|
|
break; |
449
|
|
|
} |
450
|
|
|
|
451
|
|
|
// Clear caches |
452
|
|
|
wp_cache_delete( $this->variation_id, 'post_meta' ); |
453
|
|
|
|
454
|
|
|
// Clear total stock transient |
455
|
|
|
delete_transient( 'wc_product_total_stock_' . $this->id . WC_Cache_Helper::get_transient_version( 'product' ) ); |
456
|
|
|
|
457
|
|
|
// Stock status |
458
|
|
|
$this->check_stock_status(); |
459
|
|
|
|
460
|
|
|
// Sync the parent |
461
|
|
|
WC_Product_Variable::sync( $this->id ); |
462
|
|
|
|
463
|
|
|
// Trigger action |
464
|
|
|
do_action( 'woocommerce_variation_set_stock', $this ); |
465
|
|
|
|
466
|
|
|
} elseif ( ! is_null( $amount ) ) { |
467
|
|
|
return $this->parent->set_stock( $amount, $mode ); |
468
|
|
|
} |
469
|
|
|
|
470
|
|
|
return $this->get_stock_quantity(); |
471
|
|
|
} |
472
|
|
|
|
473
|
|
|
/** |
474
|
|
|
* set_stock_status function. |
475
|
|
|
*/ |
476
|
|
|
public function set_stock_status( $status ) { |
477
|
|
|
$status = 'outofstock' === $status ? 'outofstock' : 'instock'; |
478
|
|
|
|
479
|
|
|
// Sanity check |
480
|
|
|
if ( true === $this->managing_stock() ) { |
481
|
|
|
if ( ! $this->backorders_allowed() && $this->get_stock_quantity() <= get_option( 'woocommerce_notify_no_stock_amount' ) ) { |
482
|
|
|
$status = 'outofstock'; |
483
|
|
|
} |
484
|
|
|
} elseif ( 'parent' === $this->managing_stock() ) { |
485
|
|
View Code Duplication |
if ( ! $this->parent->backorders_allowed() && $this->parent->get_stock_quantity() <= get_option( 'woocommerce_notify_no_stock_amount' ) ) { |
|
|
|
|
486
|
|
|
$status = 'outofstock'; |
487
|
|
|
} |
488
|
|
|
} |
489
|
|
|
|
490
|
|
|
if ( update_post_meta( $this->variation_id, '_stock_status', $status ) ) { |
491
|
|
|
do_action( 'woocommerce_variation_set_stock_status', $this->variation_id, $status ); |
492
|
|
|
|
493
|
|
|
WC_Product_Variable::sync_stock_status( $this->id ); |
494
|
|
|
} |
495
|
|
|
} |
496
|
|
|
|
497
|
|
|
/** |
498
|
|
|
* Reduce stock level of the product. |
499
|
|
|
* |
500
|
|
|
* @param int $amount (default: 1) Amount to reduce by |
501
|
|
|
* @return int stock level |
502
|
|
|
*/ |
503
|
|
|
public function reduce_stock( $amount = 1 ) { |
504
|
|
|
if ( true === $this->managing_stock() ) { |
505
|
|
|
return $this->set_stock( $amount, 'subtract' ); |
506
|
|
|
} else { |
507
|
|
|
return $this->parent->reduce_stock( $amount ); |
508
|
|
|
} |
509
|
|
|
} |
510
|
|
|
|
511
|
|
|
/** |
512
|
|
|
* Increase stock level of the product. |
513
|
|
|
* |
514
|
|
|
* @param int $amount (default: 1) Amount to increase by |
515
|
|
|
* @return int stock level |
516
|
|
|
*/ |
517
|
|
|
public function increase_stock( $amount = 1 ) { |
518
|
|
|
if ( true === $this->managing_stock() ) { |
519
|
|
|
return $this->set_stock( $amount, 'add' ); |
520
|
|
|
} else { |
521
|
|
|
return $this->parent->increase_stock( $amount ); |
522
|
|
|
} |
523
|
|
|
} |
524
|
|
|
|
525
|
|
|
/** |
526
|
|
|
* Returns the availability of the product. |
527
|
|
|
* |
528
|
|
|
* @return string |
529
|
|
|
*/ |
530
|
|
View Code Duplication |
public function get_availability() { |
|
|
|
|
531
|
|
|
$availability = $class = ''; |
532
|
|
|
|
533
|
|
|
if ( $this->managing_stock() ) { |
534
|
|
|
if ( $this->is_in_stock() && $this->get_stock_quantity() > get_option( 'woocommerce_notify_no_stock_amount' ) ) { |
535
|
|
|
switch ( get_option( 'woocommerce_stock_format' ) ) { |
536
|
|
|
case 'no_amount' : |
537
|
|
|
$availability = __( 'In stock', 'woocommerce' ); |
538
|
|
|
break; |
539
|
|
|
case 'low_amount' : |
540
|
|
|
if ( $this->get_stock_quantity() <= get_option( 'woocommerce_notify_low_stock_amount' ) ) { |
541
|
|
|
$availability = sprintf( __( 'Only %s left in stock', 'woocommerce' ), $this->get_stock_quantity() ); |
542
|
|
|
|
543
|
|
|
if ( $this->backorders_allowed() && $this->backorders_require_notification() ) { |
544
|
|
|
$availability .= ' ' . __( '(can be backordered)', 'woocommerce' ); |
545
|
|
|
} |
546
|
|
|
} else { |
547
|
|
|
$availability = __( 'In stock', 'woocommerce' ); |
548
|
|
|
} |
549
|
|
|
break; |
550
|
|
|
default : |
551
|
|
|
$availability = sprintf( __( '%s in stock', 'woocommerce' ), $this->get_stock_quantity() ); |
552
|
|
|
|
553
|
|
|
if ( $this->backorders_allowed() && $this->backorders_require_notification() ) { |
554
|
|
|
$availability .= ' ' . __( '(can be backordered)', 'woocommerce' ); |
555
|
|
|
} |
556
|
|
|
break; |
557
|
|
|
} |
558
|
|
|
$class = 'in-stock'; |
559
|
|
|
} elseif ( $this->backorders_allowed() && $this->backorders_require_notification() ) { |
560
|
|
|
$availability = __( 'Available on backorder', 'woocommerce' ); |
561
|
|
|
$class = 'available-on-backorder'; |
562
|
|
|
} elseif ( $this->backorders_allowed() ) { |
563
|
|
|
$availability = __( 'In stock', 'woocommerce' ); |
564
|
|
|
$class = 'in-stock'; |
565
|
|
|
} else { |
566
|
|
|
$availability = __( 'Out of stock', 'woocommerce' ); |
567
|
|
|
$class = 'out-of-stock'; |
568
|
|
|
} |
569
|
|
|
} elseif ( ! $this->is_in_stock() ) { |
570
|
|
|
$availability = __( 'Out of stock', 'woocommerce' ); |
571
|
|
|
$class = 'out-of-stock'; |
572
|
|
|
} |
573
|
|
|
|
574
|
|
|
return apply_filters( 'woocommerce_get_availability', array( 'availability' => $availability, 'class' => $class ), $this ); |
575
|
|
|
} |
576
|
|
|
|
577
|
|
|
/** |
578
|
|
|
* Returns whether or not the product needs to notify the customer on backorder. |
579
|
|
|
* |
580
|
|
|
* @return bool |
581
|
|
|
*/ |
582
|
|
|
public function backorders_require_notification() { |
583
|
|
|
if ( true === $this->managing_stock() ) { |
584
|
|
|
return parent::backorders_require_notification(); |
585
|
|
|
} else { |
586
|
|
|
return $this->parent->backorders_require_notification(); |
587
|
|
|
} |
588
|
|
|
} |
589
|
|
|
|
590
|
|
|
/** |
591
|
|
|
* is_on_backorder function. |
592
|
|
|
* |
593
|
|
|
* @param int $qty_in_cart (default: 0) |
594
|
|
|
* @return bool |
595
|
|
|
*/ |
596
|
|
|
public function is_on_backorder( $qty_in_cart = 0 ) { |
597
|
|
|
if ( true === $this->managing_stock() ) { |
598
|
|
|
return parent::is_on_backorder( $qty_in_cart ); |
599
|
|
|
} else { |
600
|
|
|
return $this->parent->is_on_backorder( $qty_in_cart ); |
601
|
|
|
} |
602
|
|
|
} |
603
|
|
|
|
604
|
|
|
/** |
605
|
|
|
* Returns whether or not the product has enough stock for the order. |
606
|
|
|
* |
607
|
|
|
* @param mixed $quantity |
608
|
|
|
* @return bool |
609
|
|
|
*/ |
610
|
|
|
public function has_enough_stock( $quantity ) { |
611
|
|
|
if ( true === $this->managing_stock() ) { |
612
|
|
|
return parent::has_enough_stock( $quantity ); |
613
|
|
|
} else { |
614
|
|
|
return $this->parent->has_enough_stock( $quantity ); |
615
|
|
|
} |
616
|
|
|
} |
617
|
|
|
|
618
|
|
|
/** |
619
|
|
|
* Get the shipping class, and if not set, get the shipping class of the parent. |
620
|
|
|
* |
621
|
|
|
* @return string |
622
|
|
|
*/ |
623
|
|
View Code Duplication |
public function get_shipping_class() { |
|
|
|
|
624
|
|
|
if ( ! $this->variation_shipping_class ) { |
625
|
|
|
$classes = get_the_terms( $this->variation_id, 'product_shipping_class' ); |
626
|
|
|
|
627
|
|
|
if ( $classes && ! is_wp_error( $classes ) ) { |
628
|
|
|
$this->variation_shipping_class = current( $classes )->slug; |
629
|
|
|
} else { |
630
|
|
|
$this->variation_shipping_class = parent::get_shipping_class(); |
|
|
|
|
631
|
|
|
} |
632
|
|
|
} |
633
|
|
|
return $this->variation_shipping_class; |
634
|
|
|
} |
635
|
|
|
|
636
|
|
|
/** |
637
|
|
|
* Returns the product shipping class ID. |
638
|
|
|
* |
639
|
|
|
* @return int |
640
|
|
|
*/ |
641
|
|
View Code Duplication |
public function get_shipping_class_id() { |
|
|
|
|
642
|
|
|
if ( ! $this->variation_shipping_class_id ) { |
643
|
|
|
$classes = get_the_terms( $this->variation_id, 'product_shipping_class' ); |
644
|
|
|
|
645
|
|
|
if ( $classes && ! is_wp_error( $classes ) ) { |
646
|
|
|
$this->variation_shipping_class_id = current( $classes )->term_id; |
647
|
|
|
} else { |
648
|
|
|
$this->variation_shipping_class_id = parent::get_shipping_class_id(); |
|
|
|
|
649
|
|
|
} |
650
|
|
|
} |
651
|
|
|
return absint( $this->variation_shipping_class_id ); |
652
|
|
|
} |
653
|
|
|
|
654
|
|
|
/** |
655
|
|
|
* Get formatted variation data with WC < 2.4 back compat and proper formatting of text-based attribute names. |
656
|
|
|
* |
657
|
|
|
* @return string |
658
|
|
|
*/ |
659
|
|
|
public function get_formatted_variation_attributes( $flat = false ) { |
660
|
|
|
$variation_data = $this->get_variation_attributes(); |
661
|
|
|
$attributes = $this->parent->get_attributes(); |
662
|
|
|
$description = array(); |
663
|
|
|
$return = ''; |
664
|
|
|
|
665
|
|
|
if ( is_array( $variation_data ) ) { |
666
|
|
|
|
667
|
|
|
if ( ! $flat ) { |
668
|
|
|
$return = '<dl class="variation">'; |
669
|
|
|
} |
670
|
|
|
|
671
|
|
|
foreach ( $attributes as $attribute ) { |
672
|
|
|
|
673
|
|
|
// Only deal with attributes that are variations |
674
|
|
|
if ( ! $attribute[ 'is_variation' ] ) { |
675
|
|
|
continue; |
676
|
|
|
} |
677
|
|
|
|
678
|
|
|
$variation_selected_value = isset( $variation_data[ 'attribute_' . sanitize_title( $attribute[ 'name' ] ) ] ) ? $variation_data[ 'attribute_' . sanitize_title( $attribute[ 'name' ] ) ] : ''; |
679
|
|
|
$description_name = esc_html( wc_attribute_label( $attribute[ 'name' ] ) ); |
680
|
|
|
$description_value = __( 'Any', 'woocommerce' ); |
681
|
|
|
|
682
|
|
|
// Get terms for attribute taxonomy or value if its a custom attribute |
683
|
|
|
if ( $attribute[ 'is_taxonomy' ] ) { |
684
|
|
|
|
685
|
|
|
$post_terms = wp_get_post_terms( $this->id, $attribute[ 'name' ] ); |
686
|
|
|
|
687
|
|
|
foreach ( $post_terms as $term ) { |
688
|
|
|
if ( $variation_selected_value === $term->slug ) { |
689
|
|
|
$description_value = esc_html( apply_filters( 'woocommerce_variation_option_name', $term->name ) ); |
690
|
|
|
} |
691
|
|
|
} |
692
|
|
|
|
693
|
|
|
} else { |
694
|
|
|
|
695
|
|
|
$options = wc_get_text_attributes( $attribute[ 'value' ] ); |
696
|
|
|
|
697
|
|
|
foreach ( $options as $option ) { |
698
|
|
|
|
699
|
|
|
if ( sanitize_title( $variation_selected_value ) === $variation_selected_value ) { |
700
|
|
|
if ( $variation_selected_value !== sanitize_title( $option ) ) { |
701
|
|
|
continue; |
702
|
|
|
} |
703
|
|
|
} else { |
704
|
|
|
if ( $variation_selected_value !== $option ) { |
705
|
|
|
continue; |
706
|
|
|
} |
707
|
|
|
} |
708
|
|
|
|
709
|
|
|
$description_value = esc_html( apply_filters( 'woocommerce_variation_option_name', $option ) ); |
710
|
|
|
} |
711
|
|
|
} |
712
|
|
|
|
713
|
|
|
if ( $flat ) { |
714
|
|
|
$description[] = $description_name . ': ' . rawurldecode( $description_value ); |
715
|
|
|
} else { |
716
|
|
|
$description[] = '<dt>' . $description_name . ':</dt><dd>' . rawurldecode( $description_value ) . '</dd>'; |
717
|
|
|
} |
718
|
|
|
} |
719
|
|
|
|
720
|
|
|
if ( $flat ) { |
721
|
|
|
$return .= implode( ', ', $description ); |
722
|
|
|
} else { |
723
|
|
|
$return .= implode( '', $description ); |
724
|
|
|
} |
725
|
|
|
|
726
|
|
|
if ( ! $flat ) { |
727
|
|
|
$return .= '</dl>'; |
728
|
|
|
} |
729
|
|
|
} |
730
|
|
|
|
731
|
|
|
return $return; |
732
|
|
|
} |
733
|
|
|
|
734
|
|
|
/** |
735
|
|
|
* Get product name with extra details such as SKU, price and attributes. Used within admin. |
736
|
|
|
* |
737
|
|
|
* @return string Formatted product name, including attributes and price |
738
|
|
|
*/ |
739
|
|
|
public function get_formatted_name() { |
740
|
|
|
if ( $this->get_sku() ) { |
741
|
|
|
$identifier = $this->get_sku(); |
742
|
|
|
} else { |
743
|
|
|
$identifier = '#' . $this->variation_id; |
744
|
|
|
} |
745
|
|
|
|
746
|
|
|
$formatted_attributes = $this->get_formatted_variation_attributes( true ); |
747
|
|
|
$extra_data = ' – ' . $formatted_attributes . ' – ' . wc_price( $this->get_price() ); |
748
|
|
|
|
749
|
|
|
return sprintf( __( '%s – %s%s', 'woocommerce' ), $identifier, $this->get_title(), $extra_data ); |
750
|
|
|
} |
751
|
|
|
|
752
|
|
|
/** |
753
|
|
|
* Get product variation description. |
754
|
|
|
* |
755
|
|
|
* @return string |
756
|
|
|
*/ |
757
|
|
|
public function get_variation_description() { |
758
|
|
|
return wpautop( do_shortcode( wp_kses_post( get_post_meta( $this->variation_id, '_variation_description', true ) ) ) ); |
759
|
|
|
} |
760
|
|
|
} |
761
|
|
|
|
The PSR-1: Basic Coding Standard recommends that a file should either introduce new symbols, that is classes, functions, constants or similar, or have side effects. Side effects are anything that executes logic, like for example printing output, changing ini settings or writing to a file.
The idea behind this recommendation is that merely auto-loading a class should not change the state of an application. It also promotes a cleaner style of programming and makes your code less prone to errors, because the logic is not spread out all over the place.
To learn more about the PSR-1, please see the PHP-FIG site on the PSR-1.