admin
4 months ago
api
3 years ago
database
5 months ago
deprecated
9 months ago
donors
5 months ago
emails
9 months ago
forms
9 months ago
frontend
6 years ago
gateways
9 months ago
libraries
9 months ago
payments
2 months ago
actions.php
9 months ago
ajax-functions.php
9 months ago
class-give-async-process.php
1 year ago
class-give-background-updater.php
9 months ago
class-give-cache-setting.php
1 year ago
class-give-cache.php
9 months ago
class-give-cli-commands.php
1 year ago
class-give-comment.php
9 months ago
class-give-cron.php
9 months ago
class-give-donate-form.php
1 year ago
class-give-donor.php
2 years ago
class-give-email-access.php
5 years ago
class-give-license-handler.php
1 year ago
class-give-logging.php
9 months ago
class-give-readme-parser.php
4 years ago
class-give-roles.php
5 months ago
class-give-scripts.php
8 months ago
class-give-session.php
9 months ago
class-give-stats.php
6 years ago
class-give-template-loader.php
6 years ago
class-give-tooltips.php
6 years ago
class-give-translation.php
4 years ago
class-notices.php
9 months ago
country-functions.php
7 months ago
currencies-list.php
7 months ago
currency-functions.php
3 years ago
error-tracking.php
6 years ago
filters.php
9 months ago
formatting.php
9 months ago
install.php
9 months ago
login-register.php
2 years ago
misc-functions.php
9 months ago
plugin-compatibility.php
6 years ago
post-types.php
1 year ago
price-functions.php
6 years ago
process-donation.php
1 year ago
setting-functions.php
6 years ago
shortcodes.php
1 year ago
template-functions.php
1 year ago
user-functions.php
3 years ago
setting-functions.php
203 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 | return Give_Cache_Setting::get_settings(); |
| 117 | } |
| 118 | |
| 119 | /** |
| 120 | * Check if radio(enabled/disabled) and checkbox(on) is active or not. |
| 121 | * |
| 122 | * @since 1.8 |
| 123 | * |
| 124 | * @param mixed $value |
| 125 | * @param string $compare_with |
| 126 | * |
| 127 | * @return bool |
| 128 | */ |
| 129 | function give_is_setting_enabled( $value, $compare_with = null ) { |
| 130 | if ( ! is_null( $compare_with ) ) { |
| 131 | |
| 132 | if ( is_array( $compare_with ) ) { |
| 133 | // Output. |
| 134 | return in_array( $value, $compare_with ); |
| 135 | } |
| 136 | |
| 137 | // Output. |
| 138 | return ( $value === $compare_with ); |
| 139 | } |
| 140 | |
| 141 | // Backward compatibility: From version 1.8 most of setting is modified to enabled/disabled |
| 142 | // Output. |
| 143 | return ( in_array( $value, array( 'enabled', 'on', 'yes' ) ) ? true : false ); |
| 144 | } |
| 145 | |
| 146 | /** |
| 147 | * Verify admin setting nonce |
| 148 | * |
| 149 | * @since 2.4.0 |
| 150 | * @access public |
| 151 | * |
| 152 | * @return bool |
| 153 | */ |
| 154 | function give_is_saving_settings() { |
| 155 | if ( |
| 156 | empty( $_REQUEST['_give-save-settings'] ) |
| 157 | || ! wp_verify_nonce( $_REQUEST['_give-save-settings'], 'give-save-settings' ) |
| 158 | ) { |
| 159 | return false; |
| 160 | } |
| 161 | |
| 162 | return true; |
| 163 | } |
| 164 | |
| 165 | |
| 166 | /** |
| 167 | * Give Settings Array Insert. |
| 168 | * |
| 169 | * Allows other Add-ons and plugins to insert Give settings at a desired position. |
| 170 | * |
| 171 | * @since 1.3.5 |
| 172 | * |
| 173 | * @param $array |
| 174 | * @param $position |int|string Expects an array key or 'id' of the settings field to appear after |
| 175 | * @param $insert |array a valid array of options to insert |
| 176 | * |
| 177 | * @return array |
| 178 | */ |
| 179 | function give_settings_array_insert( $array, $position, $insert ) { |
| 180 | if ( is_int( $position ) ) { |
| 181 | array_splice( $array, $position, 0, $insert ); |
| 182 | } else { |
| 183 | |
| 184 | foreach ( $array as $index => $subarray ) { |
| 185 | if ( isset( $subarray['id'] ) && $subarray['id'] == $position ) { |
| 186 | $pos = $index; |
| 187 | } |
| 188 | } |
| 189 | |
| 190 | if ( ! isset( $pos ) ) { |
| 191 | return $array; |
| 192 | } |
| 193 | |
| 194 | $array = array_merge( |
| 195 | array_slice( $array, 0, $pos ), |
| 196 | $insert, |
| 197 | array_slice( $array, $pos ) |
| 198 | ); |
| 199 | } |
| 200 | |
| 201 | return $array; |
| 202 | } |
| 203 |