class-settings-addon.php
6 years ago
class-settings-advanced.php
6 years ago
class-settings-display.php
5 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
348 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( |
| 36 | 'give_admin_field_remove_cache_button', |
| 37 | [ |
| 38 | $this, |
| 39 | 'render_remove_cache_button', |
| 40 | ], |
| 41 | 10, |
| 42 | 1 |
| 43 | ); |
| 44 | add_action( 'give_save_settings_give_settings', [ $this, 'validate_settngs' ] ); |
| 45 | } |
| 46 | |
| 47 | parent::__construct(); |
| 48 | } |
| 49 | |
| 50 | /** |
| 51 | * Get settings array. |
| 52 | * |
| 53 | * @return array |
| 54 | * @since 1.8 |
| 55 | */ |
| 56 | public function get_settings() { |
| 57 | $settings = []; |
| 58 | |
| 59 | $current_section = give_get_current_setting_section(); |
| 60 | |
| 61 | switch ( $current_section ) { |
| 62 | case 'advanced-options': |
| 63 | $settings = [ |
| 64 | [ |
| 65 | 'id' => 'give_title_data_control_2', |
| 66 | 'type' => 'title', |
| 67 | ], |
| 68 | [ |
| 69 | 'name' => __( 'Default GiveWP Styles', 'give' ), |
| 70 | 'desc' => __( 'You can disable Give\'s default styles for donation forms and other frontend elements.', 'give' ), |
| 71 | 'id' => 'css', |
| 72 | 'type' => 'radio_inline', |
| 73 | 'default' => 'enabled', |
| 74 | 'options' => [ |
| 75 | 'enabled' => __( 'Enabled', 'give' ), |
| 76 | 'disabled' => __( 'Disabled', 'give' ), |
| 77 | ], |
| 78 | ], |
| 79 | [ |
| 80 | 'name' => __( 'Remove Data on Uninstall', 'give' ), |
| 81 | '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' ), |
| 82 | 'id' => 'uninstall_on_delete', |
| 83 | 'type' => 'radio_inline', |
| 84 | 'default' => 'disabled', |
| 85 | 'options' => [ |
| 86 | 'enabled' => __( 'Yes, Remove all data', 'give' ), |
| 87 | 'disabled' => __( 'No, keep my GiveWP settings and donation data', 'give' ), |
| 88 | ], |
| 89 | ], |
| 90 | [ |
| 91 | 'name' => __( 'Default User Role', 'give' ), |
| 92 | 'desc' => __( 'Assign default user roles for donors when donors opt to register as a WP User.', 'give' ), |
| 93 | 'id' => 'donor_default_user_role', |
| 94 | 'type' => 'select', |
| 95 | 'default' => 'give_donor', |
| 96 | 'options' => give_get_user_roles(), |
| 97 | ], |
| 98 | [ |
| 99 | /* translators: %s: the_content */ |
| 100 | 'name' => sprintf( __( '%s filter', 'give' ), '<code>the_content</code>' ), |
| 101 | /* translators: 1: https://codex.wordpress.org/Plugin_API/Filter_Reference/the_content 2: the_content */ |
| 102 | '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>' ), |
| 103 | 'id' => 'the_content_filter', |
| 104 | 'default' => 'enabled', |
| 105 | 'type' => 'radio_inline', |
| 106 | 'options' => [ |
| 107 | 'enabled' => __( 'Enabled', 'give' ), |
| 108 | 'disabled' => __( 'Disabled', 'give' ), |
| 109 | ], |
| 110 | ], |
| 111 | [ |
| 112 | 'name' => __( 'Script Loading Location', 'give' ), |
| 113 | 'desc' => __( 'This allows you to load your GiveWP scripts either in the <code><head></code> or footer of your website.', 'give' ), |
| 114 | 'id' => 'scripts_footer', |
| 115 | 'type' => 'radio_inline', |
| 116 | 'default' => 'disabled', |
| 117 | 'options' => [ |
| 118 | 'disabled' => __( 'Head', 'give' ), |
| 119 | 'enabled' => __( 'Footer', 'give' ), |
| 120 | ], |
| 121 | ], |
| 122 | [ |
| 123 | 'name' => __( 'Babel Polyfill Script', 'give' ), |
| 124 | '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' ), |
| 125 | 'id' => 'babel_polyfill_script', |
| 126 | 'type' => 'radio_inline', |
| 127 | 'default' => 'enabled', |
| 128 | 'options' => [ |
| 129 | 'enabled' => __( 'Enabled', 'give' ), |
| 130 | 'disabled' => __( 'Disabled', 'give' ), |
| 131 | ], |
| 132 | ], |
| 133 | [ |
| 134 | 'name' => __( 'Welcome Screen', 'give' ), |
| 135 | /* translators: %s: about page URL */ |
| 136 | 'desc' => sprintf( |
| 137 | wp_kses( |
| 138 | __( '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' ), |
| 139 | [ |
| 140 | 'a' => [ |
| 141 | 'href' => [], |
| 142 | 'target' => [], |
| 143 | ], |
| 144 | ] |
| 145 | ), |
| 146 | esc_url( admin_url( 'index.php?page=give-getting-started' ) ) |
| 147 | ), |
| 148 | 'id' => 'welcome', |
| 149 | 'type' => 'radio_inline', |
| 150 | 'default' => 'enabled', |
| 151 | 'options' => [ |
| 152 | 'enabled' => __( 'Enabled', 'give' ), |
| 153 | 'disabled' => __( 'Disabled', 'give' ), |
| 154 | ], |
| 155 | ], |
| 156 | [ |
| 157 | 'name' => __( 'Form Page URL Prefix', 'give' ), |
| 158 | 'desc' => sprintf( |
| 159 | __( 'This slug will be used as a base for the iframe URL that contains all form templates besides the legacy form template. Currently the iframe URLs look like %1$s. This options adds a rewrite rule that transforms the URL structure to a set of query vars. If you modify this URL prefix please ensure it is unique as it can cause a 404 error if a similar URL already exists.', 'give' ), |
| 160 | '<code>' . trailingslashit( home_url() ) . Give()->routeForm->getBase() . '/{form-slug}</code>' |
| 161 | ), |
| 162 | 'id' => Give()->routeForm->getOptionName(), |
| 163 | 'type' => 'text', |
| 164 | 'default' => Give()->routeForm->getBase(), |
| 165 | ], |
| 166 | [ |
| 167 | 'name' => 'GiveWP Cache', |
| 168 | 'id' => 'give-clear-cache', |
| 169 | 'buttonTitle' => __( 'Clear Cache', 'give' ), |
| 170 | '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' ), |
| 171 | 'type' => 'remove_cache_button', |
| 172 | ], |
| 173 | [ |
| 174 | 'name' => __( 'Advanced Settings Docs Link', 'give' ), |
| 175 | 'id' => 'advanced_settings_docs_link', |
| 176 | 'url' => esc_url( 'http://docs.givewp.com/settings-advanced' ), |
| 177 | 'title' => __( 'Advanced Settings', 'give' ), |
| 178 | 'type' => 'give_docs_link', |
| 179 | ], |
| 180 | [ |
| 181 | 'id' => 'give_title_data_control_2', |
| 182 | 'type' => 'sectionend', |
| 183 | ], |
| 184 | ]; |
| 185 | break; |
| 186 | |
| 187 | case 'akismet-spam-protection': |
| 188 | $settings = [ |
| 189 | [ |
| 190 | 'id' => 'give_setting_advanced_section_akismet_spam_protection', |
| 191 | 'type' => 'title', |
| 192 | ], |
| 193 | [ |
| 194 | 'name' => __( 'Akismet SPAM Protection', 'give' ), |
| 195 | 'desc' => __( 'Add a layer of SPAM protection to your donation submissions with Akismet. When enabled, donation submissions will be first sent through Akismet\'s SPAM check API if you have the plugin activated and configured.', 'give' ), |
| 196 | 'id' => 'akismet_spam_protection', |
| 197 | 'type' => 'radio_inline', |
| 198 | 'default' => ( give_check_akismet_key() ) ? 'enabled' : 'disabled', |
| 199 | 'options' => [ |
| 200 | 'enabled' => __( 'Enabled', 'give' ), |
| 201 | 'disabled' => __( 'Disabled', 'give' ), |
| 202 | ], |
| 203 | ], |
| 204 | [ |
| 205 | 'name' => __( 'Whitelist by Email', 'give' ), |
| 206 | 'desc' => sprintf( |
| 207 | '%1$s %2$s', |
| 208 | __( 'Add emails one at a time to ensure that donations using that email bypass GiveWP\'s Akismet SPAM filtering. Emails added to the list here are always allowed to donate, even if they\'ve been flagged by Akismet.', 'give' ), |
| 209 | sprintf( |
| 210 | __( 'To permanently prevent emails from being flagged as SPAM by Akismet <a href="%1$s" target="_blank">contact their team here</a>.', 'give' ), |
| 211 | esc_url( 'https://akismet.com/contact/' ) |
| 212 | ) |
| 213 | ), |
| 214 | 'id' => 'akismet_whitelisted_email_addresses', |
| 215 | 'type' => 'email', |
| 216 | 'attributes' => [ |
| 217 | 'placeholder' => 'jon@email.com', |
| 218 | ], |
| 219 | 'repeat' => true, |
| 220 | 'repeat_btn_title' => esc_html__( 'Add Email', 'give' ), |
| 221 | ], |
| 222 | [ |
| 223 | 'id' => 'give_setting_advanced_section_akismet_spam_protection', |
| 224 | 'type' => 'sectionend', |
| 225 | ], |
| 226 | ]; |
| 227 | break; |
| 228 | } |
| 229 | |
| 230 | /** |
| 231 | * Hide caching setting by default. |
| 232 | * |
| 233 | * @since 2.0 |
| 234 | */ |
| 235 | if ( apply_filters( 'give_settings_advanced_show_cache_setting', false ) ) { |
| 236 | array_splice( |
| 237 | $settings, |
| 238 | 1, |
| 239 | 0, |
| 240 | [ |
| 241 | [ |
| 242 | 'name' => __( 'Cache', 'give' ), |
| 243 | 'desc' => __( 'If caching is enabled the plugin will start caching custom post type related queries and reduce the overall load time.', 'give' ), |
| 244 | 'id' => 'cache', |
| 245 | 'type' => 'radio_inline', |
| 246 | 'default' => 'enabled', |
| 247 | 'options' => [ |
| 248 | 'enabled' => __( 'Enabled', 'give' ), |
| 249 | 'disabled' => __( 'Disabled', 'give' ), |
| 250 | ], |
| 251 | ], |
| 252 | ] |
| 253 | ); |
| 254 | } |
| 255 | |
| 256 | /** |
| 257 | * Filter the advanced settings. |
| 258 | * Backward compatibility: Please do not use this filter. This filter is deprecated in 1.8 |
| 259 | */ |
| 260 | $settings = apply_filters( 'give_settings_advanced', $settings ); |
| 261 | |
| 262 | /** |
| 263 | * Filter the settings. |
| 264 | * |
| 265 | * @param array $settings |
| 266 | * |
| 267 | * @since 1.8 |
| 268 | */ |
| 269 | $settings = apply_filters( 'give_get_settings_' . $this->id, $settings ); |
| 270 | |
| 271 | // Output. |
| 272 | return $settings; |
| 273 | } |
| 274 | |
| 275 | /** |
| 276 | * Get sections. |
| 277 | * |
| 278 | * @return array |
| 279 | * @since 1.8 |
| 280 | */ |
| 281 | public function get_sections() { |
| 282 | $sections = [ |
| 283 | 'advanced-options' => __( 'Advanced Options', 'give' ), |
| 284 | 'akismet-spam-protection' => __( 'Akismet SPAM Protection', 'give' ), |
| 285 | ]; |
| 286 | |
| 287 | return apply_filters( 'give_get_sections_' . $this->id, $sections ); |
| 288 | } |
| 289 | |
| 290 | |
| 291 | /** |
| 292 | * Render remove_cache_button field type |
| 293 | * |
| 294 | * @param array $field |
| 295 | * |
| 296 | * @since 2.1 |
| 297 | * @access public |
| 298 | */ |
| 299 | public function render_remove_cache_button( $field ) { |
| 300 | ?> |
| 301 | <tr valign="top" <?php echo ! empty( $field['wrapper_class'] ) ? 'class="' . $field['wrapper_class'] . '"' : ''; ?>> |
| 302 | <th scope="row" class="titledesc"> |
| 303 | <label |
| 304 | for="<?php echo esc_attr( $field['id'] ); ?>"><?php echo esc_html( $field['name'] ); ?></label> |
| 305 | </th> |
| 306 | <td class="give-forminp"> |
| 307 | <button type="button" id="<?php echo esc_attr( $field['id'] ); ?>" |
| 308 | class="button button-secondary"><?php echo esc_html( $field['buttonTitle'] ); ?></button> |
| 309 | <?php echo Give_Admin_Settings::get_field_description( $field ); ?> |
| 310 | </td> |
| 311 | </tr> |
| 312 | <?php |
| 313 | } |
| 314 | |
| 315 | |
| 316 | /** |
| 317 | * Validate setting |
| 318 | * |
| 319 | * @param array $options |
| 320 | * |
| 321 | * @since 2.2.0 |
| 322 | * @access public |
| 323 | */ |
| 324 | public function validate_settngs( $options ) { |
| 325 | // Sanitize data. |
| 326 | $akismet_spam_protection = isset( $options['akismet_spam_protection'] ) |
| 327 | ? $options['akismet_spam_protection'] |
| 328 | : ( give_check_akismet_key() ? 'enabled' : 'disabled' ); |
| 329 | |
| 330 | // Show error message if Akismet not configured and Admin try to save 'enabled' option. |
| 331 | if ( |
| 332 | give_is_setting_enabled( $akismet_spam_protection ) |
| 333 | && ! give_check_akismet_key() |
| 334 | ) { |
| 335 | Give_Admin_Settings::add_error( |
| 336 | 'give-akismet-protection', |
| 337 | __( 'Please properly configure Akismet to enable SPAM protection.', 'give' ) |
| 338 | ); |
| 339 | |
| 340 | give_update_option( 'akismet_spam_protection', 'disabled' ); |
| 341 | } |
| 342 | } |
| 343 | } |
| 344 | |
| 345 | endif; |
| 346 | |
| 347 | return new Give_Settings_Advanced(); |
| 348 |