← All changes | includes/admin/settings/charitable-settings-admin-hooks.php +103 -3 1.6.6 → 1.8.13 View file →

		@@ -4,13 +4,14 @@
4	4	*
5	5	* Action/filter hooks used for Charitable Settings API.
6	6	*
7	7	* @package Charitable/Functions/Admin
8		- * @author Eric Daams
9		- * @copyright Copyright (c) 2018, Studio 164a
	8	+ * @author David Bisset
	9	+ * @copyright Copyright (c) 2023, WP Charitable LLC
10	10	* @license http://opensource.org/licenses/gpl-2.0.php GNU Public License
11	11	* @since 1.2.0
12		- * @version 1.6.0
	12	+ * @version 1.8.4 - added user tracking option.
	13	+ * @version 1.8.6.2 - added sanitization functions for privacy policy, terms and conditions, and contact consent label fields.
13	14	*/
14	15
15	16	// Exit if accessed directly.
16	17	if ( ! defined( 'ABSPATH' ) ) {
		@@ -24,8 +25,15 @@
24	25	*/
25	26	add_action( 'admin_init', array( Charitable_Settings::get_instance(), 'register_settings' ) );
26	27
27	28	/**
	29	+ * Redirect to the default Marketing sub-tab (newsletters) when no sub_tab is supplied.
	30	+ *
	31	+ * @see Charitable_Settings::marketing_sub_tab_default()
	32	+ */
	33	+add_action( 'admin_init', array( Charitable_Settings::get_instance(), 'marketing_sub_tab_default' ), 5 );
	34	+
	35	+/**
28	36	* Maybe add "Licenses" settings tab.
29	37	*
30	38	* @see Charitable_Settings::maybe_add_extensions_tab()
31	39	*/
		@@ -38,8 +46,15 @@
38	46	*/
39	47	add_action( 'charitable_settings_tabs', array( Charitable_Settings::get_instance(), 'maybe_add_extensions_tab' ), 2 );
40	48
41	49	/**
	50	+ * Add a hidden "extensions" field.
	51	+ *
	52	+ * @see Charitable_Settings::add_hidden_extensions_setting_field()
	53	+ */
	54	+add_filter( 'charitable_settings_tab_fields', array( Charitable_Settings::get_instance(), 'add_hidden_extensions_setting_field' ) );
	55	+
	56	+/**
42	57	* Save the license when saving settings.
43	58	*
44	59	* @see Charitable_Licenses_Settings::save_license()
45	60	*/
		@@ -89,8 +104,9 @@
89	104	*
90	105	* @see Charitable_Licenses_Settings::add_license_recheck_button()
91	106	*/
92	107	add_filter( 'charitable_settings_button_licenses', array( Charitable_Licenses_Settings::get_instance(), 'add_license_recheck_button' ) );
	108	+add_filter( 'charitable_settings_button_advanced', array( Charitable_Licenses_Settings::get_instance(), 'add_license_recheck_button' ) );
93	109
94	110	/**
95	111	* Add settings to the Privacy tab.
96	112	*
		@@ -98,8 +114,34 @@
98	114	*/
99	115	add_filter( 'charitable_settings_tab_fields_privacy', array( Charitable_Privacy_Settings::get_instance(), 'add_privacy_fields' ), 5 );
100	116
101	117	/**
	118	+ * Add the Pro settings CTA.
	119	+ *
	120	+ * @see Charitable_Settings::show_settings_cta()
	121	+ */
	122	+add_action( 'charitable_pro_settings_cta', array( Charitable_Settings::get_instance(), 'show_settings_cta' ), 10, 1 );
	123	+
	124	+
	125	+/**
	126	+ * Add security settings group.
	127	+ *
	128	+ * This ensures the 'security' group is recognized by the settings API.
	129	+ * Settings will be added via the charitable_settings_tab_fields_security filter.
	130	+ *
	131	+ * @since 1.8.0
	132	+ */
	133	+add_filter( 'charitable_security_admin_settings_groups', function( $groups ) {
	134	+ if ( ! is_array( $groups ) ) {
	135	+ $groups = array();
	136	+ }
	137	+ if ( ! in_array( 'security', $groups, true ) ) {
	138	+ $groups[] = 'security';
	139	+ }
	140	+ return $groups;
	141	+} );
	142	+
	143	+/**
102	144	* Add settings to the Advanced tab.
103	145	*
104	146	* @see Charitable_Advanced_Settings::add_advanced_fields()
105	147	*/
		@@ -105,8 +147,21 @@
105	147	*/
106	148	add_filter( 'charitable_settings_tab_fields_advanced', array( Charitable_Advanced_Settings::get_instance(), 'add_advanced_fields' ), 5 );
107	149
108	150	/**
	151	+ * Preform any tasks when the advanced tab is saved.
	152	+ *
	153	+ * @see Charitable_Advanced_Settings::save_license()
	154	+ */
	155	+add_filter( 'charitable_save_settings', array( Charitable_Advanced_Settings::get_instance(), 'clear_expired_options' ), 10, 2 );
	156	+add_filter( 'charitable_save_settings', array( Charitable_Advanced_Settings::get_instance(), 'clear_activity_database' ), 10, 2 );
	157	+add_filter( 'charitable_save_settings', array( Charitable_Advanced_Settings::get_instance(), 'minification_settings' ), 10, 2 );
	158	+add_filter( 'charitable_save_settings', array( Charitable_Checklist::get_instance(), 'confirm_general_settings' ), 10, 2 );
	159	+add_filter( 'charitable_save_settings', array( Charitable_Checklist::get_instance(), 'confirm_email_settings' ), 10, 2 );
	160	+add_filter( 'charitable_save_settings', array( Charitable_Advanced_Settings::get_instance(), 'update_user_tracking_option' ), 10, 2 );
	161	+add_filter( 'admin_init', array( Charitable_Checklist::get_instance(), 'confirm_email_changes' ), 10 );
	162	+
	163	+/**
109	164	* Add extra settings for the individual gateways & emails tabs.
110	165	*
111	166	* @see Charitable_Gateway_Settings::add_individual_gateway_fields()
112	167	* @see Charitable_Email_Settings::add_individual_email_fields()
		@@ -112,4 +167,49 @@
112	167	* @see Charitable_Email_Settings::add_individual_email_fields()
113	168	*/
114	169	add_filter( 'charitable_settings_tab_fields', array( Charitable_Gateway_Settings::get_instance(), 'add_individual_gateway_fields' ), 5 );
115	170	add_filter( 'charitable_settings_tab_fields', array( Charitable_Email_Settings::get_instance(), 'add_individual_email_fields' ), 5 );
	171	+
	172	+/**
	173	+ * Add Addons Directory
	174	+ *
	175	+ * @see Charitable_Advanced_Settings::add_advanced_fields()
	176	+ */
	177	+add_action( 'admin_init', array( Charitable_Addons_Directory::get_instance(), 'init' ), 5 );
	178	+
	179	+/**
	180	+ * Checklist.
	181	+ *
	182	+ * @see Charitable_Checklist::maybe_redirect_to_checklist_after_event()
	183	+ */
	184	+add_action( 'charitable_save_settings', array( Charitable_Checklist::get_instance(), 'maybe_redirect_to_checklist_after_event' ), 99, 2 );
	185	+add_filter( 'admin_body_class', array( Charitable_Checklist::get_instance(), 'add_body_class' ), 10 );
	186	+add_filter( 'charitable_submenu_pages', array( Charitable_Checklist::get_instance(), 'add_checklist_to_menu' ), 2 );
	187	+add_action( 'admin_init', array( Charitable_Checklist::get_instance(), 'maybe_complete_checklist' ), 10 );
	188	+
	189	+/**
	190	+ * Maybe activate the Pro plugin after onboarding.
	191	+ *
	192	+ * @see Charitable_Checklist::maybe_activate_pro_after_onboarding()
	193	+ */
	194	+add_action( 'admin_init', array( Charitable_Checklist::get_instance(), 'maybe_activate_pro_after_onboarding' ), 10 );
	195	+
	196	+/**
	197	+ * Hook the sanitization function for the privacy_policy field.
	198	+ *
	199	+ * @see Charitable_Privacy_Settings::sanitize_privacy_policy_field()
	200	+ */
	201	+add_filter( 'charitable_sanitize_value_privacy_privacy_policy', array( Charitable_Privacy_Settings::get_instance(), 'sanitize_privacy_policy_field' ), 10, 3 );
	202	+
	203	+/**
	204	+ * Hook the sanitization function for the terms_conditions field.
	205	+ *
	206	+ * @see Charitable_Privacy_Settings::sanitize_terms_conditions_field()
	207	+ */
	208	+add_filter( 'charitable_sanitize_value_privacy_terms_conditions', array( Charitable_Privacy_Settings::get_instance(), 'sanitize_terms_conditions_field' ), 10, 3 );
	209	+
	210	+/**
	211	+ * Hook the sanitization function for the contact_consent_label field.
	212	+ *
	213	+ * @see Charitable_Privacy_Settings::sanitize_contact_consent_label_field()
	214	+ */
	215	+add_filter( 'charitable_sanitize_value_privacy_contact_consent_label', array( Charitable_Privacy_Settings::get_instance(), 'sanitize_contact_consent_label_field' ), 10, 3 );