class-wc-deprecated-filter-hooks.php — WooCommerce 6.9.2

woocommerce / includes / class-wc-deprecated-filter-hooks.php

woocommerce / includes Last commit date

class-wc-deprecated-filter-hooks.php

147 lines

1	<?php
2	/**
3	* Deprecated filter hooks
4	*
5	* @package WooCommerce\Abstracts
6	* @since 3.0.0
7	* @version 3.3.0
8	*/
9
10	defined( 'ABSPATH' ) \|\| exit;
11
12	/**
13	* Handles deprecation notices and triggering of legacy filter hooks
14	*/
15	class WC_Deprecated_Filter_Hooks extends WC_Deprecated_Hooks {
16
17	/**
18	* Array of deprecated hooks we need to handle.
19	* Format of 'new' => 'old'.
20	*
21	* @var array
22	*/
23	protected $deprecated_hooks = array(
24	'woocommerce_structured_data_order' => 'woocommerce_email_order_schema_markup',
25	'woocommerce_add_to_cart_fragments' => 'add_to_cart_fragments',
26	'woocommerce_add_to_cart_redirect' => 'add_to_cart_redirect',
27	'woocommerce_product_get_width' => 'woocommerce_product_width',
28	'woocommerce_product_get_height' => 'woocommerce_product_height',
29	'woocommerce_product_get_length' => 'woocommerce_product_length',
30	'woocommerce_product_get_weight' => 'woocommerce_product_weight',
31	'woocommerce_product_get_sku' => 'woocommerce_get_sku',
32	'woocommerce_product_get_price' => 'woocommerce_get_price',
33	'woocommerce_product_get_regular_price' => 'woocommerce_get_regular_price',
34	'woocommerce_product_get_sale_price' => 'woocommerce_get_sale_price',
35	'woocommerce_product_get_tax_class' => 'woocommerce_product_tax_class',
36	'woocommerce_product_get_stock_quantity' => 'woocommerce_get_stock_quantity',
37	'woocommerce_product_get_attributes' => 'woocommerce_get_product_attributes',
38	'woocommerce_product_get_gallery_image_ids' => 'woocommerce_product_gallery_attachment_ids',
39	'woocommerce_product_get_review_count' => 'woocommerce_product_review_count',
40	'woocommerce_product_get_downloads' => 'woocommerce_product_files',
41	'woocommerce_order_get_currency' => 'woocommerce_get_currency',
42	'woocommerce_order_get_discount_total' => 'woocommerce_order_amount_discount_total',
43	'woocommerce_order_get_discount_tax' => 'woocommerce_order_amount_discount_tax',
44	'woocommerce_order_get_shipping_total' => 'woocommerce_order_amount_shipping_total',
45	'woocommerce_order_get_shipping_tax' => 'woocommerce_order_amount_shipping_tax',
46	'woocommerce_order_get_cart_tax' => 'woocommerce_order_amount_cart_tax',
47	'woocommerce_order_get_total' => 'woocommerce_order_amount_total',
48	'woocommerce_order_get_total_tax' => 'woocommerce_order_amount_total_tax',
49	'woocommerce_order_get_total_discount' => 'woocommerce_order_amount_total_discount',
50	'woocommerce_order_get_subtotal' => 'woocommerce_order_amount_subtotal',
51	'woocommerce_order_get_tax_totals' => 'woocommerce_order_tax_totals',
52	'woocommerce_get_order_refund_get_amount' => 'woocommerce_refund_amount',
53	'woocommerce_get_order_refund_get_reason' => 'woocommerce_refund_reason',
54	'default_checkout_billing_country' => 'default_checkout_country',
55	'default_checkout_billing_state' => 'default_checkout_state',
56	'default_checkout_billing_postcode' => 'default_checkout_postcode',
57	'woocommerce_system_status_environment_rows' => 'woocommerce_debug_posting',
58	'woocommerce_credit_card_type_labels' => 'wocommerce_credit_card_type_labels',
59	'woocommerce_settings_tabs_advanced' => 'woocommerce_settings_tabs_api',
60	'woocommerce_settings_advanced' => 'woocommerce_settings_api',
61	'woocommerce_csv_importer_check_import_file_path' => 'woocommerce_product_csv_importer_check_import_file_path',
62	);
63
64	/**
65	* Array of versions on each hook has been deprecated.
66	*
67	* @var array
68	*/
69	protected $deprecated_version = array(
70	'woocommerce_email_order_schema_markup' => '3.0.0',
71	'add_to_cart_fragments' => '3.0.0',
72	'add_to_cart_redirect' => '3.0.0',
73	'woocommerce_product_width' => '3.0.0',
74	'woocommerce_product_height' => '3.0.0',
75	'woocommerce_product_length' => '3.0.0',
76	'woocommerce_product_weight' => '3.0.0',
77	'woocommerce_get_sku' => '3.0.0',
78	'woocommerce_get_price' => '3.0.0',
79	'woocommerce_get_regular_price' => '3.0.0',
80	'woocommerce_get_sale_price' => '3.0.0',
81	'woocommerce_product_tax_class' => '3.0.0',
82	'woocommerce_get_stock_quantity' => '3.0.0',
83	'woocommerce_get_product_attributes' => '3.0.0',
84	'woocommerce_product_gallery_attachment_ids' => '3.0.0',
85	'woocommerce_product_review_count' => '3.0.0',
86	'woocommerce_product_files' => '3.0.0',
87	'woocommerce_get_currency' => '3.0.0',
88	'woocommerce_order_amount_discount_total' => '3.0.0',
89	'woocommerce_order_amount_discount_tax' => '3.0.0',
90	'woocommerce_order_amount_shipping_total' => '3.0.0',
91	'woocommerce_order_amount_shipping_tax' => '3.0.0',
92	'woocommerce_order_amount_cart_tax' => '3.0.0',
93	'woocommerce_order_amount_total' => '3.0.0',
94	'woocommerce_order_amount_total_tax' => '3.0.0',
95	'woocommerce_order_amount_total_discount' => '3.0.0',
96	'woocommerce_order_amount_subtotal' => '3.0.0',
97	'woocommerce_order_tax_totals' => '3.0.0',
98	'woocommerce_refund_amount' => '3.0.0',
99	'woocommerce_refund_reason' => '3.0.0',
100	'default_checkout_country' => '3.0.0',
101	'default_checkout_state' => '3.0.0',
102	'default_checkout_postcode' => '3.0.0',
103	'woocommerce_debug_posting' => '3.0.0',
104	'wocommerce_credit_card_type_labels' => '3.0.0',
105	'woocommerce_settings_tabs_api' => '3.4.0',
106	'woocommerce_settings_api' => '3.4.0',
107	'woocommerce_product_csv_importer_check_import_file_path' => '6.5.0',
108	);
109
110	/**
111	* Hook into the new hook so we can handle deprecated hooks once fired.
112	*
113	* @param string $hook_name Hook name.
114	*/
115	public function hook_in( $hook_name ) {
116	add_filter( $hook_name, array( $this, 'maybe_handle_deprecated_hook' ), -1000, 8 );
117	}
118
119	/**
120	* If the old hook is in-use, trigger it.
121	*
122	* @param string $new_hook New hook name.
123	* @param string $old_hook Old hook name.
124	* @param array $new_callback_args New callback args.
125	* @param mixed $return_value Returned value.
126	* @return mixed
127	*/
128	public function handle_deprecated_hook( $new_hook, $old_hook, $new_callback_args, $return_value ) {
129	if ( has_filter( $old_hook ) ) {
130	$this->display_notice( $old_hook, $new_hook );
131	$return_value = $this->trigger_hook( $old_hook, $new_callback_args );
132	}
133	return $return_value;
134	}
135
136	/**
137	* Fire off a legacy hook with it's args.
138	*
139	* @param string $old_hook Old hook name.
140	* @param array $new_callback_args New callback args.
141	* @return mixed
142	*/
143	protected function trigger_hook( $old_hook, $new_callback_args ) {
144	return apply_filters_ref_array( $old_hook, $new_callback_args );
145	}
146	}
147