class-evf-deprecated-action-hooks.php — Everest Forms – Contact Form, Payment Form, Quiz, Survey & Custom Form Builder with AI 3.5.3

everest-forms / includes / class-evf-deprecated-action-hooks.php

everest-forms / includes Last commit date

class-evf-deprecated-action-hooks.php

109 lines

1	<?php
2	/**
3	* Deprecated action hooks
4	*
5	* @package EverestForms\Abstracts
6	* @since 1.2.0
7	*/
8
9	defined( 'ABSPATH' ) \|\| exit;
10
11	/**
12	* Handles deprecation notices and triggering of legacy action hooks.
13	*/
14	class EVF_Deprecated_Action_Hooks extends EVF_Deprecated_Hooks {
15
16	/**
17	* Array of deprecated hooks we need to handle. Format of 'new' => 'old'.
18	*
19	* @var array
20	*/
21	protected $deprecated_hooks = array(
22	'everest_forms_builder_page_init' => array(
23	'everest_forms_page_init',
24	'everest_forms_builder_init',
25	),
26	'admin_enqueue_scripts' => array(
27	'everest_forms_page_init',
28	'everest_forms_builder_scripts',
29	'everest_forms_builder_enqueues_before',
30	),
31	'everest_forms_builder_tabs' => 'everest_forms_builder_panel_buttons',
32	'everest_forms_builder_output' => 'everest_forms_builder_panels',
33	'everest_forms_builder_fields_preview' => 'everest_forms_builder_preview',
34	'everest_forms_display_field_before' => 'evf_display_field_before',
35	'everest_forms_display_field_after' => 'evf_display_field_after',
36	'everest_forms_display_fields_before' => 'evf_display_fields_before',
37	'everest_forms_display_fields_after' => 'evf_display_fields_after',
38	'everest_forms_display_field_{field_type}' => 'evf_display_field_{field_type}',
39	'everest_forms_frontend_output_before' => 'evf_frontend_output_before',
40	'everest_forms_frontend_output_success' => 'evf_frontend_output_success',
41	'everest_forms_frontend_output' => 'evf_frontend_output',
42	'everest_forms_frontend_output_after' => 'evf_frontend_output_after',
43	'everest_forms_display_submit_before' => 'evf_display_submit_before',
44	'everest_forms_display_submit_after' => 'evf_display_submit_after',
45	);
46
47	/**
48	* Array of versions on each hook has been deprecated.
49	*
50	* @var array
51	*/
52	protected $deprecated_version = array(
53	'everest_forms_page_init' => '1.2.0',
54	'everest_forms_builder_init' => '1.2.0',
55	'everest_forms_builder_scripts' => '1.2.0',
56	'everest_forms_builder_enqueues_before' => '1.2.0',
57	'everest_forms_builder_panel_buttons' => '1.2.0',
58	'everest_forms_builder_panels' => '1.2.0',
59	'everest_forms_builder_preview' => '1.2.0',
60	'evf_display_field_before' => '1.2.0',
61	'evf_display_field_after' => '1.2.0',
62	'evf_display_fields_before' => '1.3.0',
63	'evf_display_fields_after' => '1.3.0',
64	'evf_frontend_output_before' => '1.3.2',
65	'evf_frontend_output_success' => '1.3.2',
66	'evf_frontend_output' => '1.3.2',
67	'evf_frontend_output_after' => '1.3.2',
68	'evf_display_submit_before' => '1.3.2',
69	'evf_display_submit_after' => '1.3.2',
70	);
71
72	/**
73	* Hook into the new hook so we can handle deprecated hooks once fired.
74	*
75	* @param string $hook_name Hook name.
76	*/
77	public function hook_in( $hook_name ) {
78	add_action( $hook_name, array( $this, 'maybe_handle_deprecated_hook' ), -1000, 8 );
79	}
80
81	/**
82	* If the old hook is in-use, trigger it.
83	*
84	* @param string $new_hook New hook name.
85	* @param string $old_hook Old hook name.
86	* @param array $new_callback_args New callback args.
87	* @param mixed $return_value Returned value.
88	* @return mixed
89	*/
90	public function handle_deprecated_hook( $new_hook, $old_hook, $new_callback_args, $return_value ) {
91	if ( has_action( $old_hook ) ) {
92	$this->display_notice( $old_hook, $new_hook );
93	$return_value = $this->trigger_hook( $old_hook, $new_callback_args );
94	}
95	return $return_value;
96	}
97
98	/**
99	* Fire off a legacy hook with it's args.
100	*
101	* @param string $old_hook Old hook name.
102	* @param array $new_callback_args New callback args.
103	* @return mixed
104	*/
105	protected function trigger_hook( $old_hook, $new_callback_args ) {
106	do_action_ref_array( $old_hook, $new_callback_args );
107	}
108	}
109