class-wc-cart-session.php — WooCommerce 6.9.0

woocommerce / includes / class-wc-cart-session.php

woocommerce / includes Last commit date

class-wc-cart-session.php

451 lines

1	<?php
2	/**
3	* Cart session handling class.
4	*
5	* @package WooCommerce\Classes
6	* @version 3.2.0
7	*/
8
9	if ( ! defined( 'ABSPATH' ) ) {
10	exit;
11	}
12
13	/**
14	* WC_Cart_Session class.
15	*
16	* @since 3.2.0
17	*/
18	final class WC_Cart_Session {
19
20	/**
21	* Reference to cart object.
22	*
23	* @since 3.2.0
24	* @var WC_Cart
25	*/
26	protected $cart;
27
28	/**
29	* Sets up the items provided, and calculate totals.
30	*
31	* @since 3.2.0
32	* @throws Exception If missing WC_Cart object.
33	*
34	* @param WC_Cart $cart Cart object to calculate totals for.
35	*/
36	public function __construct( &$cart ) {
37	if ( ! is_a( $cart, 'WC_Cart' ) ) {
38	throw new Exception( 'A valid WC_Cart object is required' );
39	}
40
41	$this->cart = $cart;
42	}
43
44	/**
45	* Register methods for this object on the appropriate WordPress hooks.
46	*/
47	public function init() {
48	/**
49	* Filters whether hooks should be initialized for the current cart session.
50	*
51	* @param bool $must_initialize Will be passed as true, meaning that the cart hooks should be initialized.
52	* @param bool $session The WC_Cart_Session object that is being initialized.
53	* @returns bool True if the cart hooks should be actually initialized, false if not.
54	*
55	* @since 6.9.0
56	*/
57	if ( ! apply_filters( 'woocommerce_cart_session_initialize', true, $this ) ) {
58	return;
59	}
60
61	add_action( 'wp_loaded', array( $this, 'get_cart_from_session' ) );
62	add_action( 'woocommerce_cart_emptied', array( $this, 'destroy_cart_session' ) );
63	add_action( 'woocommerce_after_calculate_totals', array( $this, 'set_session' ), 1000 );
64	add_action( 'woocommerce_cart_loaded_from_session', array( $this, 'set_session' ) );
65	add_action( 'woocommerce_removed_coupon', array( $this, 'set_session' ) );
66
67	// Persistent cart stored to usermeta.
68	add_action( 'woocommerce_add_to_cart', array( $this, 'persistent_cart_update' ) );
69	add_action( 'woocommerce_cart_item_removed', array( $this, 'persistent_cart_update' ) );
70	add_action( 'woocommerce_cart_item_restored', array( $this, 'persistent_cart_update' ) );
71	add_action( 'woocommerce_cart_item_set_quantity', array( $this, 'persistent_cart_update' ) );
72
73	// Cookie events - cart cookies need to be set before headers are sent.
74	add_action( 'woocommerce_add_to_cart', array( $this, 'maybe_set_cart_cookies' ) );
75	add_action( 'wp', array( $this, 'maybe_set_cart_cookies' ), 99 );
76	add_action( 'shutdown', array( $this, 'maybe_set_cart_cookies' ), 0 );
77	}
78
79	/**
80	* Get the cart data from the PHP session and store it in class variables.
81	*
82	* @since 3.2.0
83	*/
84	public function get_cart_from_session() {
85	do_action( 'woocommerce_load_cart_from_session' );
86	$this->cart->set_totals( WC()->session->get( 'cart_totals', null ) );
87	$this->cart->set_applied_coupons( WC()->session->get( 'applied_coupons', array() ) );
88	$this->cart->set_coupon_discount_totals( WC()->session->get( 'coupon_discount_totals', array() ) );
89	$this->cart->set_coupon_discount_tax_totals( WC()->session->get( 'coupon_discount_tax_totals', array() ) );
90	$this->cart->set_removed_cart_contents( WC()->session->get( 'removed_cart_contents', array() ) );
91
92	$update_cart_session = false; // Flag to indicate the stored cart should be updated.
93	$order_again = false; // Flag to indicate whether this is a re-order.
94	$cart = WC()->session->get( 'cart', null );
95	$merge_saved_cart = (bool) get_user_meta( get_current_user_id(), '_woocommerce_load_saved_cart_after_login', true );
96
97	// Merge saved cart with current cart.
98	if ( is_null( $cart ) \|\| $merge_saved_cart ) {
99	$saved_cart = $this->get_saved_cart();
100	$cart = is_null( $cart ) ? array() : $cart;
101	$cart = array_merge( $saved_cart, $cart );
102	$update_cart_session = true;
103
104	delete_user_meta( get_current_user_id(), '_woocommerce_load_saved_cart_after_login' );
105	}
106
107	// Populate cart from order.
108	if ( isset( $_GET['order_again'], $_GET['_wpnonce'] ) && is_user_logged_in() && wp_verify_nonce( wp_unslash( $_GET['_wpnonce'] ), 'woocommerce-order_again' ) ) { // WPCS: input var ok, sanitization ok.
109	$cart = $this->populate_cart_from_order( absint( $_GET['order_again'] ), $cart ); // WPCS: input var ok.
110	$order_again = true;
111	}
112
113	// Prime caches to reduce future queries.
114	if ( is_callable( '_prime_post_caches' ) ) {
115	_prime_post_caches( wp_list_pluck( $cart, 'product_id' ) );
116	}
117
118	$cart_contents = array();
119
120	foreach ( $cart as $key => $values ) {
121	if ( ! is_customize_preview() && 'customize-preview' === $key ) {
122	continue;
123	}
124
125	$product = wc_get_product( $values['variation_id'] ? $values['variation_id'] : $values['product_id'] );
126
127	if ( empty( $product ) \|\| ! $product->exists() \|\| 0 >= $values['quantity'] ) {
128	continue;
129	}
130
131	/**
132	* Allow 3rd parties to validate this item before it's added to cart and add their own notices.
133	*
134	* @since 3.6.0
135	*
136	* @param bool $remove_cart_item_from_session If true, the item will not be added to the cart. Default: false.
137	* @param string $key Cart item key.
138	* @param array $values Cart item values e.g. quantity and product_id.
139	*/
140	if ( apply_filters( 'woocommerce_pre_remove_cart_item_from_session', false, $key, $values ) ) {
141	$update_cart_session = true;
142	do_action( 'woocommerce_remove_cart_item_from_session', $key, $values );
143
144	} elseif ( ! $product->is_purchasable() ) {
145	$update_cart_session = true;
146	/* translators: %s: product name */
147	$message = sprintf( __( '%s has been removed from your cart because it can no longer be purchased. Please contact us if you need assistance.', 'woocommerce' ), $product->get_name() );
148	/**
149	* Filter message about item removed from the cart.
150	*
151	* @since 3.8.0
152	* @param string $message Message.
153	* @param WC_Product $product Product data.
154	*/
155	$message = apply_filters( 'woocommerce_cart_item_removed_message', $message, $product );
156	wc_add_notice( $message, 'error' );
157	do_action( 'woocommerce_remove_cart_item_from_session', $key, $values );
158
159	} elseif ( ! empty( $values['data_hash'] ) && ! hash_equals( $values['data_hash'], wc_get_cart_item_data_hash( $product ) ) ) { // phpcs:ignore PHPCompatibility.PHP.NewFunctions.hash_equalsFound
160	$update_cart_session = true;
161	/* translators: %1$s: product name. %2$s product permalink */
162	$message = sprintf( __( '%1$s has been removed from your cart because it has since been modified. You can add it back to your cart <a href="%2$s">here</a>.', 'woocommerce' ), $product->get_name(), $product->get_permalink() );
163	$message = apply_filters( 'woocommerce_cart_item_removed_because_modified_message', $message, $product );
164	wc_add_notice( $message, 'notice' );
165	do_action( 'woocommerce_remove_cart_item_from_session', $key, $values );
166
167	} else {
168	// Put session data into array. Run through filter so other plugins can load their own session data.
169	$session_data = array_merge(
170	$values,
171	array(
172	'data' => $product,
173	)
174	);
175
176	$cart_contents[ $key ] = apply_filters( 'woocommerce_get_cart_item_from_session', $session_data, $values, $key );
177
178	// Add to cart right away so the product is visible in woocommerce_get_cart_item_from_session hook.
179	$this->cart->set_cart_contents( $cart_contents );
180	}
181	}
182
183	// If it's not empty, it's been already populated by the loop above.
184	if ( ! empty( $cart_contents ) ) {
185	$this->cart->set_cart_contents( apply_filters( 'woocommerce_cart_contents_changed', $cart_contents ) );
186	}
187
188	do_action( 'woocommerce_cart_loaded_from_session', $this->cart );
189
190	if ( $update_cart_session \|\| is_null( WC()->session->get( 'cart_totals', null ) ) ) {
191	WC()->session->set( 'cart', $this->get_cart_for_session() );
192	$this->cart->calculate_totals();
193
194	if ( $merge_saved_cart ) {
195	$this->persistent_cart_update();
196	}
197	}
198
199	// If this is a re-order, redirect to the cart page to get rid of the `order_again` query string.
200	if ( $order_again ) {
201	wp_safe_redirect( wc_get_cart_url() );
202	exit;
203	}
204	}
205
206	/**
207	* Destroy cart session data.
208	*
209	* @since 3.2.0
210	*/
211	public function destroy_cart_session() {
212	WC()->session->set( 'cart', null );
213	WC()->session->set( 'cart_totals', null );
214	WC()->session->set( 'applied_coupons', null );
215	WC()->session->set( 'coupon_discount_totals', null );
216	WC()->session->set( 'coupon_discount_tax_totals', null );
217	WC()->session->set( 'removed_cart_contents', null );
218	WC()->session->set( 'order_awaiting_payment', null );
219	}
220
221	/**
222	* Will set cart cookies if needed and when possible.
223	*
224	* @since 3.2.0
225	*/
226	public function maybe_set_cart_cookies() {
227	if ( ! headers_sent() && did_action( 'wp_loaded' ) ) {
228	if ( ! $this->cart->is_empty() ) {
229	$this->set_cart_cookies( true );
230	} elseif ( isset( $_COOKIE['woocommerce_items_in_cart'] ) ) { // WPCS: input var ok.
231	$this->set_cart_cookies( false );
232	}
233	}
234	}
235
236	/**
237	* Sets the php session data for the cart and coupons.
238	*/
239	public function set_session() {
240	WC()->session->set( 'cart', $this->get_cart_for_session() );
241	WC()->session->set( 'cart_totals', $this->cart->get_totals() );
242	WC()->session->set( 'applied_coupons', $this->cart->get_applied_coupons() );
243	WC()->session->set( 'coupon_discount_totals', $this->cart->get_coupon_discount_totals() );
244	WC()->session->set( 'coupon_discount_tax_totals', $this->cart->get_coupon_discount_tax_totals() );
245	WC()->session->set( 'removed_cart_contents', $this->cart->get_removed_cart_contents() );
246
247	do_action( 'woocommerce_cart_updated' );
248	}
249
250	/**
251	* Returns the contents of the cart in an array without the 'data' element.
252	*
253	* @return array contents of the cart
254	*/
255	public function get_cart_for_session() {
256	$cart_session = array();
257
258	foreach ( $this->cart->get_cart() as $key => $values ) {
259	$cart_session[ $key ] = $values;
260	unset( $cart_session[ $key ]['data'] ); // Unset product object.
261	}
262
263	return $cart_session;
264	}
265
266	/**
267	* Save the persistent cart when the cart is updated.
268	*/
269	public function persistent_cart_update() {
270	if ( get_current_user_id() && apply_filters( 'woocommerce_persistent_cart_enabled', true ) ) {
271	update_user_meta(
272	get_current_user_id(),
273	'_woocommerce_persistent_cart_' . get_current_blog_id(),
274	array(
275	'cart' => $this->get_cart_for_session(),
276	)
277	);
278	}
279	}
280
281	/**
282	* Delete the persistent cart permanently.
283	*/
284	public function persistent_cart_destroy() {
285	if ( get_current_user_id() && apply_filters( 'woocommerce_persistent_cart_enabled', true ) ) {
286	delete_user_meta( get_current_user_id(), '_woocommerce_persistent_cart_' . get_current_blog_id() );
287	}
288	}
289
290	/**
291	* Set cart hash cookie and items in cart if not already set.
292	*
293	* @param bool $set Should cookies be set (true) or unset.
294	*/
295	private function set_cart_cookies( $set = true ) {
296	if ( $set ) {
297	$setcookies = array(
298	'woocommerce_items_in_cart' => '1',
299	'woocommerce_cart_hash' => WC()->cart->get_cart_hash(),
300	);
301	foreach ( $setcookies as $name => $value ) {
302	if ( ! isset( $_COOKIE[ $name ] ) \|\| $_COOKIE[ $name ] !== $value ) {
303	wc_setcookie( $name, $value );
304	}
305	}
306	} else {
307	$unsetcookies = array(
308	'woocommerce_items_in_cart',
309	'woocommerce_cart_hash',
310	);
311	foreach ( $unsetcookies as $name ) {
312	if ( isset( $_COOKIE[ $name ] ) ) {
313	wc_setcookie( $name, 0, time() - HOUR_IN_SECONDS );
314	unset( $_COOKIE[ $name ] );
315	}
316	}
317	}
318
319	do_action( 'woocommerce_set_cart_cookies', $set );
320	}
321
322	/**
323	* Get the persistent cart from the database.
324	*
325	* @since 3.5.0
326	* @return array
327	*/
328	private function get_saved_cart() {
329	$saved_cart = array();
330
331	if ( apply_filters( 'woocommerce_persistent_cart_enabled', true ) ) {
332	$saved_cart_meta = get_user_meta( get_current_user_id(), '_woocommerce_persistent_cart_' . get_current_blog_id(), true );
333
334	if ( isset( $saved_cart_meta['cart'] ) ) {
335	$saved_cart = array_filter( (array) $saved_cart_meta['cart'] );
336	}
337	}
338
339	return $saved_cart;
340	}
341
342	/**
343	* Get a cart from an order, if user has permission.
344	*
345	* @since 3.5.0
346	*
347	* @param int $order_id Order ID to try to load.
348	* @param array $cart Current cart array.
349	*
350	* @return array
351	*/
352	private function populate_cart_from_order( $order_id, $cart ) {
353	$order = wc_get_order( $order_id );
354
355	if ( ! $order->get_id() \|\| ! $order->has_status( apply_filters( 'woocommerce_valid_order_statuses_for_order_again', array( 'completed' ) ) ) \|\| ! current_user_can( 'order_again', $order->get_id() ) ) {
356	return;
357	}
358
359	if ( apply_filters( 'woocommerce_empty_cart_when_order_again', true ) ) {
360	$cart = array();
361	}
362
363	$inital_cart_size = count( $cart );
364	$order_items = $order->get_items();
365
366	foreach ( $order_items as $item ) {
367	$product_id = (int) apply_filters( 'woocommerce_add_to_cart_product_id', $item->get_product_id() );
368	$quantity = $item->get_quantity();
369	$variation_id = (int) $item->get_variation_id();
370	$variations = array();
371	$cart_item_data = apply_filters( 'woocommerce_order_again_cart_item_data', array(), $item, $order );
372	$product = $item->get_product();
373
374	if ( ! $product ) {
375	continue;
376	}
377
378	// Prevent reordering variable products if no selected variation.
379	if ( ! $variation_id && $product->is_type( 'variable' ) ) {
380	continue;
381	}
382
383	// Prevent reordering items specifically out of stock.
384	if ( ! $product->is_in_stock() ) {
385	continue;
386	}
387
388	foreach ( $item->get_meta_data() as $meta ) {
389	if ( taxonomy_is_product_attribute( $meta->key ) ) {
390	$term = get_term_by( 'slug', $meta->value, $meta->key );
391	$variations[ $meta->key ] = $term ? $term->name : $meta->value;
392	} elseif ( meta_is_product_attribute( $meta->key, $meta->value, $product_id ) ) {
393	$variations[ $meta->key ] = $meta->value;
394	}
395	}
396
397	if ( ! apply_filters( 'woocommerce_add_to_cart_validation', true, $product_id, $quantity, $variation_id, $variations, $cart_item_data ) ) {
398	continue;
399	}
400
401	// Add to cart directly.
402	$cart_id = WC()->cart->generate_cart_id( $product_id, $variation_id, $variations, $cart_item_data );
403	$product_data = wc_get_product( $variation_id ? $variation_id : $product_id );
404	$cart[ $cart_id ] = apply_filters(
405	'woocommerce_add_order_again_cart_item',
406	array_merge(
407	$cart_item_data,
408	array(
409	'key' => $cart_id,
410	'product_id' => $product_id,
411	'variation_id' => $variation_id,
412	'variation' => $variations,
413	'quantity' => $quantity,
414	'data' => $product_data,
415	'data_hash' => wc_get_cart_item_data_hash( $product_data ),
416	)
417	),
418	$cart_id
419	);
420	}
421
422	do_action_ref_array( 'woocommerce_ordered_again', array( $order->get_id(), $order_items, &$cart ) );
423
424	$num_items_in_cart = count( $cart );
425	$num_items_in_original_order = count( $order_items );
426	$num_items_added = $num_items_in_cart - $inital_cart_size;
427
428	if ( $num_items_in_original_order > $num_items_added ) {
429	wc_add_notice(
430	sprintf(
431	/* translators: %d item count */
432	_n(
433	'%d item from your previous order is currently unavailable and could not be added to your cart.',
434	'%d items from your previous order are currently unavailable and could not be added to your cart.',
435	$num_items_in_original_order - $num_items_added,
436	'woocommerce'
437	),
438	$num_items_in_original_order - $num_items_added
439	),
440	'error'
441	);
442	}
443
444	if ( 0 < $num_items_added ) {
445	wc_add_notice( __( 'The cart has been filled with the items from your previous order.', 'woocommerce' ) );
446	}
447
448	return $cart;
449	}
450	}
451