class-settings-addon.php
6 years ago
class-settings-advanced.php
6 years ago
class-settings-display.php
6 years ago
class-settings-email.php
6 years ago
class-settings-gateways.php
6 years ago
class-settings-general.php
6 years ago
class-settings-license.php
6 years ago
class-settings-advanced.php
277 lines
| 1 | <?php |
| 2 | /** |
| 3 | * Give Settings Page/Tab |
| 4 | * |
| 5 | * @package Give |
| 6 | * @subpackage Classes/Give_Settings_Advanced |
| 7 | * @copyright Copyright (c) 2016, GiveWP |
| 8 | * @license http://opensource.org/licenses/gpl-2.0.php GNU Public License |
| 9 | * @since 1.8 |
| 10 | */ |
| 11 | |
| 12 | if ( ! defined( 'ABSPATH' ) ) { |
| 13 | exit; // Exit if accessed directly |
| 14 | } |
| 15 | |
| 16 | if ( ! class_exists( 'Give_Settings_Advanced' ) ) : |
| 17 | |
| 18 | /** |
| 19 | * Give_Settings_Advanced. |
| 20 | * |
| 21 | * @sine 1.8 |
| 22 | */ |
| 23 | class Give_Settings_Advanced extends Give_Settings_Page { |
| 24 | |
| 25 | /** |
| 26 | * Constructor. |
| 27 | */ |
| 28 | public function __construct() { |
| 29 | $this->id = 'advanced'; |
| 30 | $this->label = __( 'Advanced', 'give' ); |
| 31 | |
| 32 | $this->default_tab = 'advanced-options'; |
| 33 | |
| 34 | if ( $this->id === give_get_current_setting_tab() ) { |
| 35 | add_action( 'give_admin_field_remove_cache_button', array( $this, 'render_remove_cache_button' ), 10, 1 ); |
| 36 | add_action( 'give_save_settings_give_settings', array( $this, 'validate_settngs' ) ); |
| 37 | } |
| 38 | |
| 39 | parent::__construct(); |
| 40 | } |
| 41 | |
| 42 | /** |
| 43 | * Get settings array. |
| 44 | * |
| 45 | * @since 1.8 |
| 46 | * @return array |
| 47 | */ |
| 48 | public function get_settings() { |
| 49 | $settings = array(); |
| 50 | |
| 51 | $current_section = give_get_current_setting_section(); |
| 52 | |
| 53 | switch ( $current_section ) { |
| 54 | case 'advanced-options': |
| 55 | $settings = array( |
| 56 | array( |
| 57 | 'id' => 'give_title_data_control_2', |
| 58 | 'type' => 'title', |
| 59 | ), |
| 60 | array( |
| 61 | 'name' => __( 'Remove Data on Uninstall', 'give' ), |
| 62 | 'desc' => __( 'When the plugin is deleted, completely remove all GiveWP data. This includes all GiveWP settings, forms, form meta, donor, donor data, donations. Everything.', 'give' ), |
| 63 | 'id' => 'uninstall_on_delete', |
| 64 | 'type' => 'radio_inline', |
| 65 | 'default' => 'disabled', |
| 66 | 'options' => array( |
| 67 | 'enabled' => __( 'Yes, Remove all data', 'give' ), |
| 68 | 'disabled' => __( 'No, keep my GiveWP settings and donation data', 'give' ), |
| 69 | ), |
| 70 | ), |
| 71 | array( |
| 72 | 'name' => __( 'Default User Role', 'give' ), |
| 73 | 'desc' => __( 'Assign default user roles for donors when donors opt to register as a WP User.', 'give' ), |
| 74 | 'id' => 'donor_default_user_role', |
| 75 | 'type' => 'select', |
| 76 | 'default' => 'give_donor', |
| 77 | 'options' => give_get_user_roles(), |
| 78 | ), |
| 79 | array( |
| 80 | /* translators: %s: the_content */ |
| 81 | 'name' => sprintf( __( '%s filter', 'give' ), '<code>the_content</code>' ), |
| 82 | /* translators: 1: https://codex.wordpress.org/Plugin_API/Filter_Reference/the_content 2: the_content */ |
| 83 | 'desc' => sprintf( __( 'If you are seeing extra social buttons, related posts, or other unwanted elements appearing within your forms then you can disable WordPress\' content filter. <a href="%1$s" target="_blank">Learn more</a> about %2$s filter.', 'give' ), esc_url( 'https://codex.wordpress.org/Plugin_API/Filter_Reference/the_content' ), '<code>the_content</code>' ), |
| 84 | 'id' => 'the_content_filter', |
| 85 | 'default' => 'enabled', |
| 86 | 'type' => 'radio_inline', |
| 87 | 'options' => array( |
| 88 | 'enabled' => __( 'Enabled', 'give' ), |
| 89 | 'disabled' => __( 'Disabled', 'give' ), |
| 90 | ), |
| 91 | ), |
| 92 | array( |
| 93 | 'name' => __( 'Script Loading Location', 'give' ), |
| 94 | 'desc' => __( 'This allows you to load your GiveWP scripts either in the <code><head></code> or footer of your website.', 'give' ), |
| 95 | 'id' => 'scripts_footer', |
| 96 | 'type' => 'radio_inline', |
| 97 | 'default' => 'disabled', |
| 98 | 'options' => array( |
| 99 | 'disabled' => __( 'Head', 'give' ), |
| 100 | 'enabled' => __( 'Footer', 'give' ), |
| 101 | ), |
| 102 | ), |
| 103 | array( |
| 104 | 'name' => __( 'Babel Polyfill Script', 'give' ), |
| 105 | 'desc' => __( 'Decide whether to load the Babel polyfill, which provides backwards compatibility for older browsers such as IE 11. The polyfill may be disabled to avoid conflicts with other themes or plugins that load the same script.', 'give' ), |
| 106 | 'id' => 'babel_polyfill_script', |
| 107 | 'type' => 'radio_inline', |
| 108 | 'default' => 'enabled', |
| 109 | 'options' => array( |
| 110 | 'enabled' => __( 'Enabled', 'give' ), |
| 111 | 'disabled' => __( 'Disabled', 'give' ), |
| 112 | ), |
| 113 | ), |
| 114 | array( |
| 115 | 'name' => __( 'Akismet SPAM Protection', 'give' ), |
| 116 | 'desc' => __( 'Add a layer of SPAM protection to your donation submissions with Akismet. When enabled, donation submissions will be first sent to Akismet\'s API if you have the plugin activated and configured.', 'give' ), |
| 117 | 'id' => 'akismet_spam_protection', |
| 118 | 'type' => 'radio_inline', |
| 119 | 'default' => ( give_check_akismet_key() ) ? 'enabled' : 'disabled', |
| 120 | 'options' => array( |
| 121 | 'enabled' => __( 'Enabled', 'give' ), |
| 122 | 'disabled' => __( 'Disabled', 'give' ), |
| 123 | ), |
| 124 | ), |
| 125 | array( |
| 126 | 'name' => __( 'Welcome Screen', 'give' ), |
| 127 | /* translators: %s: about page URL */ |
| 128 | 'desc' => sprintf( wp_kses( __( 'Enable this option if you would like to disable the <a href="%s" target="_blank">GiveWP Welcome screen</a> that displays each time GiveWP is activated or updated.', 'give' ), array( |
| 129 | 'a' => array( |
| 130 | 'href' => array(), |
| 131 | 'target' => array(), |
| 132 | ), |
| 133 | ) ), esc_url( admin_url( 'index.php?page=give-getting-started' ) ) ), |
| 134 | 'id' => 'welcome', |
| 135 | 'type' => 'radio_inline', |
| 136 | 'default' => 'enabled', |
| 137 | 'options' => array( |
| 138 | 'enabled' => __( 'Enabled', 'give' ), |
| 139 | 'disabled' => __( 'Disabled', 'give' ), |
| 140 | ), |
| 141 | ), |
| 142 | array( |
| 143 | 'name' => 'GiveWP Cache', |
| 144 | 'id' => 'give-clear-cache', |
| 145 | 'buttonTitle' => __( 'Clear Cache', 'give' ), |
| 146 | 'desc' => __( 'Click this button if you want to clear Give\'s cache. The plugin stores common settings and queries in cache to optimize performance. Clearing cache will remove and begin rebuilding these saved queries.', 'give' ), |
| 147 | 'type' => 'remove_cache_button' |
| 148 | ), |
| 149 | array( |
| 150 | 'name' => __( 'Advanced Settings Docs Link', 'give' ), |
| 151 | 'id' => 'advanced_settings_docs_link', |
| 152 | 'url' => esc_url( 'http://docs.givewp.com/settings-advanced' ), |
| 153 | 'title' => __( 'Advanced Settings', 'give' ), |
| 154 | 'type' => 'give_docs_link', |
| 155 | ), |
| 156 | array( |
| 157 | 'id' => 'give_title_data_control_2', |
| 158 | 'type' => 'sectionend', |
| 159 | ), |
| 160 | ); |
| 161 | break; |
| 162 | } |
| 163 | |
| 164 | /** |
| 165 | * Hide caching setting by default. |
| 166 | * |
| 167 | * @since 2.0 |
| 168 | */ |
| 169 | if ( apply_filters( 'give_settings_advanced_show_cache_setting', false ) ) { |
| 170 | array_splice( $settings, 1, 0, array( |
| 171 | array( |
| 172 | 'name' => __( 'Cache', 'give' ), |
| 173 | 'desc' => __( 'If caching is enabled the plugin will start caching custom post type related queries and reduce the overall load time.', 'give' ), |
| 174 | 'id' => 'cache', |
| 175 | 'type' => 'radio_inline', |
| 176 | 'default' => 'enabled', |
| 177 | 'options' => array( |
| 178 | 'enabled' => __( 'Enabled', 'give' ), |
| 179 | 'disabled' => __( 'Disabled', 'give' ), |
| 180 | ), |
| 181 | ) |
| 182 | ) ); |
| 183 | } |
| 184 | |
| 185 | |
| 186 | /** |
| 187 | * Filter the advanced settings. |
| 188 | * Backward compatibility: Please do not use this filter. This filter is deprecated in 1.8 |
| 189 | */ |
| 190 | $settings = apply_filters( 'give_settings_advanced', $settings ); |
| 191 | |
| 192 | /** |
| 193 | * Filter the settings. |
| 194 | * |
| 195 | * @since 1.8 |
| 196 | * |
| 197 | * @param array $settings |
| 198 | */ |
| 199 | $settings = apply_filters( 'give_get_settings_' . $this->id, $settings ); |
| 200 | |
| 201 | // Output. |
| 202 | return $settings; |
| 203 | } |
| 204 | |
| 205 | /** |
| 206 | * Get sections. |
| 207 | * |
| 208 | * @since 1.8 |
| 209 | * @return array |
| 210 | */ |
| 211 | public function get_sections() { |
| 212 | $sections = array( |
| 213 | 'advanced-options' => __( 'Advanced Options', 'give' ), |
| 214 | ); |
| 215 | |
| 216 | return apply_filters( 'give_get_sections_' . $this->id, $sections ); |
| 217 | } |
| 218 | |
| 219 | |
| 220 | /** |
| 221 | * Render remove_cache_button field type |
| 222 | * |
| 223 | * @since 2.1 |
| 224 | * @access public |
| 225 | * |
| 226 | * @param array $field |
| 227 | */ |
| 228 | public function render_remove_cache_button( $field ) { |
| 229 | ?> |
| 230 | <tr valign="top" <?php echo ! empty( $field['wrapper_class'] ) ? 'class="' . $field['wrapper_class'] . '"' : '' ?>> |
| 231 | <th scope="row" class="titledesc"> |
| 232 | <label |
| 233 | for="<?php echo esc_attr( $field['id'] ); ?>"><?php echo esc_html( $field['name'] ) ?></label> |
| 234 | </th> |
| 235 | <td class="give-forminp"> |
| 236 | <button type="button" id="<?php echo esc_attr( $field['id'] ); ?>" |
| 237 | class="button button-secondary"><?php echo esc_html( $field['buttonTitle'] ) ?></button> |
| 238 | <?php echo Give_Admin_Settings::get_field_description( $field ); ?> |
| 239 | </td> |
| 240 | </tr> |
| 241 | <?php |
| 242 | } |
| 243 | |
| 244 | |
| 245 | /** |
| 246 | * Validate setting |
| 247 | * |
| 248 | * @since 2.2.0 |
| 249 | * @access public |
| 250 | * |
| 251 | * @param array $options |
| 252 | */ |
| 253 | public function validate_settngs( $options ) { |
| 254 | // Sanitize data. |
| 255 | $akismet_spam_protection = isset( $options['akismet_spam_protection'] ) |
| 256 | ? $options['akismet_spam_protection'] |
| 257 | : ( give_check_akismet_key() ? 'enabled' : 'disabled' ); |
| 258 | |
| 259 | // Show error message if Akismet not configured and Admin try to save 'enabled' option. |
| 260 | if ( |
| 261 | give_is_setting_enabled( $akismet_spam_protection ) |
| 262 | && ! give_check_akismet_key() |
| 263 | ) { |
| 264 | Give_Admin_Settings::add_error( |
| 265 | 'give-akismet-protection', |
| 266 | __( 'Please properly configure Akismet to enable SPAM protection.', 'give' ) |
| 267 | ); |
| 268 | |
| 269 | give_update_option( 'akismet_spam_protection', 'disabled' ); |
| 270 | } |
| 271 | } |
| 272 | } |
| 273 | |
| 274 | endif; |
| 275 | |
| 276 | return new Give_Settings_Advanced(); |
| 277 |