setting-functions.php — GiveWP – Donation Plugin and Fundraising Platform 2.4.4

give / includes / setting-functions.php

give / includes Last commit date

setting-functions.php

207 lines

1	<?php
2	/**
3	* Helps get a single option from the give_get_settings() array.
4	*
5	* @since 0.1.0
6	*
7	* @param string $key Options array key
8	* @param string\|bool $default The default option if the option isn't set
9	*
10	* @return mixed Option value
11	*/
12	function give_get_option( $key = '', $default = false ) {
13	$give_options = give_get_settings();
14	$value = ! empty( $give_options[ $key ] ) ? $give_options[ $key ] : $default;
15	$value = apply_filters( 'give_get_option', $value, $key, $default );
16
17	return apply_filters( "give_get_option_{$key}", $value, $key, $default );
18	}
19
20
21	/**
22	* Update an option
23	*
24	* Updates an give setting value in both the db and the global variable.
25	* Warning: Passing in an empty, false or null string value will remove
26	* the key from the give_options array.
27	*
28	* @since 1.0
29	*
30	* @param string $key The Key to update
31	* @param string\|bool\|int $value The value to set the key to
32	*
33	* @return boolean True if updated, false if not.
34	*/
35	function give_update_option( $key = '', $value = false ) {
36
37	// If no key, exit
38	if ( empty( $key ) ) {
39	return false;
40	}
41
42	if ( empty( $value ) ) {
43	$remove_option = give_delete_option( $key );
44
45	return $remove_option;
46	}
47
48	// First let's grab the current settings.
49	$options = give_get_settings();
50
51	// Let's developers alter that value coming in.
52	$value = apply_filters( 'give_update_option', $value, $key );
53
54	// Next let's try to update the value
55	$options[ $key ] = $value;
56	$did_update = update_option( 'give_settings', $options, false );
57
58	// If it updated, let's update the global variable
59	if ( $did_update ) {
60	global $give_options;
61	$give_options[ $key ] = $value;
62	}
63
64	return $did_update;
65	}
66
67	/**
68	* Remove an option
69	*
70	* Removes an give setting value in both the db and the global variable.
71	*
72	* @since 1.0
73	*
74	* @global $give_options
75	*
76	* @param string $key The Key to delete
77	*
78	* @return boolean True if updated, false if not.
79	*/
80	function give_delete_option( $key = '' ) {
81
82	// If no key, exit
83	if ( empty( $key ) ) {
84	return false;
85	}
86
87	// First let's grab the current settings
88	$options = get_option( 'give_settings' );
89
90	// Next let's try to update the value
91	if ( isset( $options[ $key ] ) ) {
92	unset( $options[ $key ] );
93	}
94
95	$did_update = update_option( 'give_settings', $options, false );
96
97	// If it updated, let's update the global variable
98	if ( $did_update ) {
99	global $give_options;
100	$give_options = $options;
101	}
102
103	return $did_update;
104	}
105
106
107	/**
108	* Get Settings
109	*
110	* Retrieves all Give plugin settings
111	*
112	* @since 1.0
113	* @return array Give settings
114	*/
115	function give_get_settings() {
116
117	$settings = Give_Cache_Setting::get_settings();
118
119	return (array) apply_filters( 'give_get_settings', $settings );
120
121	}
122
123	/**
124	* Check if radio(enabled/disabled) and checkbox(on) is active or not.
125	*
126	* @since 1.8
127	*
128	* @param mixed $value
129	* @param string $compare_with
130	*
131	* @return bool
132	*/
133	function give_is_setting_enabled( $value, $compare_with = null ) {
134	if ( ! is_null( $compare_with ) ) {
135
136	if ( is_array( $compare_with ) ) {
137	// Output.
138	return in_array( $value, $compare_with );
139	}
140
141	// Output.
142	return ( $value === $compare_with );
143	}
144
145	// Backward compatibility: From version 1.8 most of setting is modified to enabled/disabled
146	// Output.
147	return ( in_array( $value, array( 'enabled', 'on', 'yes' ) ) ? true : false );
148	}
149
150	/**
151	* Verify admin setting nonce
152	*
153	* @since 2.4.0
154	* @access public
155	*
156	* @return bool
157	*/
158	function give_is_saving_settings() {
159	if (
160	empty( $_REQUEST['_give-save-settings'] )
161	\|\| ! wp_verify_nonce( $_REQUEST['_give-save-settings'], 'give-save-settings' )
162	) {
163	return false;
164	}
165
166	return true;
167	}
168
169
170	/**
171	* Give Settings Array Insert.
172	*
173	* Allows other Add-ons and plugins to insert Give settings at a desired position.
174	*
175	* @since 1.3.5
176	*
177	* @param $array
178	* @param $position \|int\|string Expects an array key or 'id' of the settings field to appear after
179	* @param $insert \|array a valid array of options to insert
180	*
181	* @return array
182	*/
183	function give_settings_array_insert( $array, $position, $insert ) {
184	if ( is_int( $position ) ) {
185	array_splice( $array, $position, 0, $insert );
186	} else {
187
188	foreach ( $array as $index => $subarray ) {
189	if ( isset( $subarray['id'] ) && $subarray['id'] == $position ) {
190	$pos = $index;
191	}
192	}
193
194	if ( ! isset( $pos ) ) {
195	return $array;
196	}
197
198	$array = array_merge(
199	array_slice( $array, 0, $pos ),
200	$insert,
201	array_slice( $array, $pos )
202	);
203	}
204
205	return $array;
206	}
207