class-settings-addon.php
6 years ago
class-settings-advanced.php
1 year ago
class-settings-display.php
2 years ago
class-settings-email.php
2 years ago
class-settings-gateways.php
1 year ago
class-settings-general.php
1 year ago
class-settings-license.php
4 years ago
class-settings-recurring.php
1 year ago
class-settings-advanced.php
495 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 | use Give\FeatureFlags\OptionBasedFormEditor\OptionBasedFormEditor; |
| 13 | use Give\Onboarding\Setup\Page as SetupPage; |
| 14 | |
| 15 | if ( ! defined( 'ABSPATH' ) ) { |
| 16 | exit; // Exit if accessed directly |
| 17 | } |
| 18 | |
| 19 | if ( ! class_exists( 'Give_Settings_Advanced' ) ) : |
| 20 | |
| 21 | /** |
| 22 | * Give_Settings_Advanced. |
| 23 | * |
| 24 | * @sine 1.8 |
| 25 | */ |
| 26 | class Give_Settings_Advanced extends Give_Settings_Page |
| 27 | { |
| 28 | |
| 29 | /** |
| 30 | * Constructor. |
| 31 | */ |
| 32 | public function __construct() |
| 33 | { |
| 34 | $this->id = 'advanced'; |
| 35 | $this->label = __('Advanced', 'give'); |
| 36 | |
| 37 | $this->default_tab = 'advanced-options'; |
| 38 | |
| 39 | if ($this->id === give_get_current_setting_tab()) { |
| 40 | add_action( |
| 41 | 'give_admin_field_remove_cache_button', |
| 42 | [ |
| 43 | $this, |
| 44 | 'render_remove_cache_button', |
| 45 | ], |
| 46 | 10, |
| 47 | 1 |
| 48 | ); |
| 49 | add_action('give_save_settings_give_settings', [$this, 'validate_settngs']); |
| 50 | add_filter( "give_admin_settings_sanitize_option_donor_default_user_role", [$this, 'sanitize_option_donor_default_user_role']); |
| 51 | add_action('give_admin_field_give_option_based_form_editor_notice', |
| 52 | [$this, '_render_give_based_form_editor_notice'], 10, 2); |
| 53 | } |
| 54 | |
| 55 | parent::__construct(); |
| 56 | } |
| 57 | |
| 58 | /** |
| 59 | * Get settings array. |
| 60 | * |
| 61 | * @since 4.1.0 Added Donation Forms section |
| 62 | * @since 1.8 |
| 63 | * @return array |
| 64 | */ |
| 65 | public function get_settings() |
| 66 | { |
| 67 | $settings = []; |
| 68 | |
| 69 | $current_section = give_get_current_setting_section(); |
| 70 | $setupPage = esc_url(admin_url('edit.php?post_type=give_forms&page=give-setup')); |
| 71 | |
| 72 | switch ($current_section) { |
| 73 | case 'advanced-options': |
| 74 | $settings = [ |
| 75 | [ |
| 76 | 'id' => 'give_title_data_control_2', |
| 77 | 'type' => 'title', |
| 78 | ], |
| 79 | [ |
| 80 | 'name' => __('Option-Based Form Editor', 'give'), |
| 81 | 'desc' => __('If enabled, you\'ll gain access to the legacy settings and can create forms using the Option-Based Editor. Disabling this option will not affect existing forms created with the Option-Based Editor.', |
| 82 | 'give'), |
| 83 | 'id' => 'option_based_form_editor', |
| 84 | 'type' => 'radio_inline', |
| 85 | 'default' => (OptionBasedFormEditor::existOptionBasedFormsOnDb()) ? 'enabled' : 'disabled', |
| 86 | 'options' => [ |
| 87 | 'enabled' => __('Enabled', 'give'), |
| 88 | 'disabled' => __('Disabled', 'give'), |
| 89 | ], |
| 90 | ], |
| 91 | [ |
| 92 | 'id' => 'option_based_form_editor_notice', |
| 93 | 'type' => 'give_option_based_form_editor_notice', |
| 94 | ], |
| 95 | [ |
| 96 | 'name' => __('Default GiveWP Styles', 'give'), |
| 97 | 'desc' => __('This controls GiveWP\'s default styles for legacy donation forms and other front end elements. Disabling this option means that you\'ll need to supply your own styles.', |
| 98 | 'give'), |
| 99 | 'id' => 'css', |
| 100 | 'type' => 'radio_inline', |
| 101 | 'default' => 'enabled', |
| 102 | 'options' => [ |
| 103 | 'enabled' => __('Enabled', 'give'), |
| 104 | 'disabled' => __('Disabled', 'give'), |
| 105 | ], |
| 106 | ], |
| 107 | [ |
| 108 | 'name' => __('Remove Data on Uninstall', 'give'), |
| 109 | 'desc' => __('When the plugin is deleted, completely remove all GiveWP data. This includes all GiveWP settings, forms, form meta, donor, donor data, donations. Everything.', |
| 110 | 'give'), |
| 111 | 'id' => 'uninstall_on_delete', |
| 112 | 'type' => 'radio_inline', |
| 113 | 'default' => 'disabled', |
| 114 | 'options' => [ |
| 115 | 'enabled' => __('Yes, Remove all data', 'give'), |
| 116 | 'disabled' => __('No, keep my GiveWP settings and donation data', 'give'), |
| 117 | ], |
| 118 | ], |
| 119 | [ |
| 120 | 'name' => __('Default User Role', 'give'), |
| 121 | 'desc' => __('Users are given this user role when they opt into creating a WordPress/site account along with their donation.', |
| 122 | 'give'), |
| 123 | 'id' => 'donor_default_user_role', |
| 124 | 'type' => 'select', |
| 125 | 'default' => 'give_donor', |
| 126 | 'options' => give_get_user_roles(), |
| 127 | ], |
| 128 | [ |
| 129 | /* translators: %s: the_content */ |
| 130 | 'name' => sprintf(__('%s filter', 'give'), '<code>the_content</code>'), |
| 131 | /* translators: 1: https://codex.wordpress.org/Plugin_API/Filter_Reference/the_content 2: the_content */ |
| 132 | 'desc' => sprintf(__('This controls whether or not GiveWP legacy form content is treated like WordPress content. Disabling this option means that things like social sharing and other theme- or plugin-added functionality to enhance or append things to content will not be applied to GiveWP legacy form content. <a href="%1$s" target="_blank">Learn more</a> about %2$s filter.', |
| 133 | 'give'), esc_url('https://docs.givewp.com/thecontent-filter'), |
| 134 | '<code>the_content</code>'), |
| 135 | 'id' => 'the_content_filter', |
| 136 | 'default' => 'enabled', |
| 137 | 'type' => 'radio_inline', |
| 138 | 'options' => [ |
| 139 | 'enabled' => __('Enabled', 'give'), |
| 140 | 'disabled' => __('Disabled', 'give'), |
| 141 | ], |
| 142 | ], |
| 143 | [ |
| 144 | 'name' => __('Script Loading Location', 'give'), |
| 145 | 'desc' => __('This allows you to load your GiveWP scripts either in the <code><head></code> or footer of your website.', |
| 146 | 'give'), |
| 147 | 'id' => 'scripts_footer', |
| 148 | 'type' => 'radio_inline', |
| 149 | 'default' => 'disabled', |
| 150 | 'options' => [ |
| 151 | 'disabled' => __('Head', 'give'), |
| 152 | 'enabled' => __('Footer', 'give'), |
| 153 | ], |
| 154 | ], |
| 155 | [ |
| 156 | 'name' => __('Setup Page', 'give'), |
| 157 | /* translators: %s: about page URL */ |
| 158 | 'desc' => sprintf( |
| 159 | wp_kses( |
| 160 | __( |
| 161 | 'This option controls the display of the %s when GiveWP is first installed.', |
| 162 | 'give' |
| 163 | ), |
| 164 | [ |
| 165 | 'a' => [ |
| 166 | 'href' => [], |
| 167 | 'target' => [], |
| 168 | ], |
| 169 | ] |
| 170 | ), |
| 171 | SetupPage::getSetupPageEnabledOrDisabled( |
| 172 | ) === SetupPage::ENABLED ? "<a href='$setupPage' target='_blank'>GiveWP Setup page</a>" : 'GiveWP Setup page' |
| 173 | ), |
| 174 | 'id' => 'setup_page_enabled', |
| 175 | 'type' => 'radio_inline', |
| 176 | 'default' => give_is_setting_enabled( |
| 177 | SetupPage::getSetupPageEnabledOrDisabled() |
| 178 | ) |
| 179 | ? SetupPage::ENABLED |
| 180 | : SetupPage::DISABLED, |
| 181 | 'options' => [ |
| 182 | SetupPage::ENABLED => __('Enabled', 'give'), |
| 183 | SetupPage::DISABLED => __('Disabled', 'give'), |
| 184 | ], |
| 185 | 'wrapper_class' => version_compare(get_bloginfo('version'), '5.0', |
| 186 | '<=') ? 'give-hidden' : null, |
| 187 | ], |
| 188 | [ |
| 189 | 'name' => __('Form Page URL Prefix', 'give'), |
| 190 | 'desc' => sprintf( |
| 191 | __('This slug is used as a base for the (invisible to users/site visitors) iframe URL that contains all form templates besides the legacy form template. The URL currently looks like this: %1$s. This option allows you to modify that URL to avoid conflicts that might exist with other pages and URLs on the site.', |
| 192 | 'give'), |
| 193 | '<code>' . trailingslashit(home_url()) . Give()->routeForm->getBase() . '/{form-slug}</code>' |
| 194 | ), |
| 195 | 'id' => Give()->routeForm->getOptionName(), |
| 196 | 'type' => 'text', |
| 197 | 'default' => Give()->routeForm->getBase(), |
| 198 | ], |
| 199 | [ |
| 200 | 'name' => __('Advanced Database Updates', 'give'), |
| 201 | 'desc' => __('This option is only for advanced users and/or those directed by GiveWP support. Once you enable this, you\'ll have the ability to override the run order and to force re-running for database updates at Donations > Tools > Data. If you don\'t know what you are doing, you can easily break things with this option enabled. Do not leave this option enabled after you\'re done troubleshooting.', |
| 202 | 'give'), |
| 203 | 'id' => 'enable_database_updates', |
| 204 | 'type' => 'radio_inline', |
| 205 | 'default' => 'disabled', |
| 206 | 'options' => [ |
| 207 | 'enabled' => __('Enabled', 'give'), |
| 208 | 'disabled' => __('Disabled', 'give'), |
| 209 | ], |
| 210 | ], |
| 211 | [ |
| 212 | 'name' => __('Orphaned Donation Forms', 'give'), |
| 213 | 'desc' => __('Show orphaned donation forms list-table. Tools > Data > Orphaned forms', 'give'), |
| 214 | 'id' => 'show_orphaned_forms_table', |
| 215 | 'type' => 'radio_inline', |
| 216 | 'default' => 'disabled', |
| 217 | 'options' => [ |
| 218 | 'enabled' => __('Enabled', 'give'), |
| 219 | 'disabled' => __('Disabled', 'give'), |
| 220 | ], |
| 221 | ], |
| 222 | [ |
| 223 | 'name' => __('GiveWP Cache', 'give'), |
| 224 | 'id' => 'give-clear-cache', |
| 225 | 'buttonTitle' => __('Clear Cache', 'give'), |
| 226 | 'desc' => __('Click this button if you want to clear GiveWP\'s cache. The plugin stores common settings and queries in cache to optimize performance. Clearing cache will remove and begin rebuilding these saved queries.', |
| 227 | 'give'), |
| 228 | 'type' => 'remove_cache_button', |
| 229 | ], |
| 230 | [ |
| 231 | 'name' => __('Advanced Settings Docs Link', 'give'), |
| 232 | 'id' => 'advanced_settings_docs_link', |
| 233 | 'url' => esc_url('http://docs.givewp.com/settings-advanced'), |
| 234 | 'title' => __('Advanced Settings', 'give'), |
| 235 | 'type' => 'give_docs_link', |
| 236 | ], |
| 237 | [ |
| 238 | 'id' => 'give_title_data_control_2', |
| 239 | 'type' => 'sectionend', |
| 240 | ], |
| 241 | ]; |
| 242 | break; |
| 243 | |
| 244 | case 'donation-forms': |
| 245 | $settings = [ |
| 246 | [ |
| 247 | 'id' => 'give_setting_advanced_section_donation_forms', |
| 248 | 'type' => 'title', |
| 249 | ], |
| 250 | [ |
| 251 | 'name' => __('Custom Styles', 'give'), |
| 252 | 'desc' => __( |
| 253 | 'Add your own custom CSS styles here to customize the appearance of all donation forms across your site. These styles will be applied globally, allowing you to maintain consistent design without editing each form individually.', |
| 254 | 'give' |
| 255 | ), |
| 256 | 'id' => 'custom_form_styles', |
| 257 | 'type' => 'code_editor', |
| 258 | 'css' => 'width: 100%;', |
| 259 | 'editor_attributes' => [ |
| 260 | 'mode' => 'css', |
| 261 | ], |
| 262 | ], |
| 263 | [ |
| 264 | 'id' => 'give_setting_advanced_section_donation_forms', |
| 265 | 'type' => 'sectionend', |
| 266 | ], |
| 267 | ]; |
| 268 | break; |
| 269 | |
| 270 | case 'akismet-spam-protection': |
| 271 | $settings = [ |
| 272 | [ |
| 273 | 'id' => 'give_setting_advanced_section_akismet_spam_protection', |
| 274 | 'type' => 'title', |
| 275 | ], |
| 276 | [ |
| 277 | 'name' => __('Akismet SPAM Protection', 'give'), |
| 278 | '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.', |
| 279 | 'give'), |
| 280 | 'id' => 'akismet_spam_protection', |
| 281 | 'type' => 'radio_inline', |
| 282 | 'default' => (give_check_akismet_key()) ? 'enabled' : 'disabled', |
| 283 | 'options' => [ |
| 284 | 'enabled' => __('Enabled', 'give'), |
| 285 | 'disabled' => __('Disabled', 'give'), |
| 286 | ], |
| 287 | ], |
| 288 | [ |
| 289 | 'name' => __('Whitelist by Email', 'give'), |
| 290 | 'desc' => sprintf( |
| 291 | '%1$s %2$s', |
| 292 | __('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.', |
| 293 | 'give'), |
| 294 | sprintf( |
| 295 | __('To permanently prevent emails from being flagged as SPAM by Akismet <a href="%1$s" target="_blank">contact their team here</a>.', |
| 296 | 'give'), |
| 297 | esc_url('https://docs.givewp.com/akismet-contact') |
| 298 | ) |
| 299 | ), |
| 300 | 'id' => 'akismet_whitelisted_email_addresses', |
| 301 | 'type' => 'email', |
| 302 | 'attributes' => [ |
| 303 | 'placeholder' => 'test@example.com', |
| 304 | ], |
| 305 | 'repeat' => true, |
| 306 | 'repeat_btn_title' => esc_html__('Add Email', 'give'), |
| 307 | ], |
| 308 | [ |
| 309 | 'id' => 'give_setting_advanced_section_akismet_spam_protection', |
| 310 | 'type' => 'sectionend', |
| 311 | ], |
| 312 | ]; |
| 313 | break; |
| 314 | } |
| 315 | |
| 316 | /** |
| 317 | * Hide caching setting by default. |
| 318 | * |
| 319 | * @since 2.0 |
| 320 | */ |
| 321 | if (apply_filters('give_settings_advanced_show_cache_setting', false)) { |
| 322 | array_splice( |
| 323 | $settings, |
| 324 | 1, |
| 325 | 0, |
| 326 | [ |
| 327 | [ |
| 328 | 'name' => __('Cache', 'give'), |
| 329 | 'desc' => __('If caching is enabled the plugin will start caching custom post type related queries and reduce the overall load time.', |
| 330 | 'give'), |
| 331 | 'id' => 'cache', |
| 332 | 'type' => 'radio_inline', |
| 333 | 'default' => 'enabled', |
| 334 | 'options' => [ |
| 335 | 'enabled' => __('Enabled', 'give'), |
| 336 | 'disabled' => __('Disabled', 'give'), |
| 337 | ], |
| 338 | ], |
| 339 | ] |
| 340 | ); |
| 341 | } |
| 342 | |
| 343 | /** |
| 344 | * Filter the advanced settings. |
| 345 | * Backward compatibility: Please do not use this filter. This filter is deprecated in 1.8 |
| 346 | */ |
| 347 | $settings = apply_filters('give_settings_advanced', $settings); |
| 348 | |
| 349 | /** |
| 350 | * Filter the settings. |
| 351 | * |
| 352 | * @since 1.8 |
| 353 | * |
| 354 | * @param array $settings |
| 355 | * |
| 356 | */ |
| 357 | $settings = apply_filters('give_get_settings_' . $this->id, $settings); |
| 358 | |
| 359 | // Output. |
| 360 | return $settings; |
| 361 | } |
| 362 | |
| 363 | /** |
| 364 | * Get sections. |
| 365 | * |
| 366 | * @since 1.8 |
| 367 | * @return array |
| 368 | */ |
| 369 | public function get_sections() |
| 370 | { |
| 371 | $sections = [ |
| 372 | 'advanced-options' => __('Advanced Options', 'give'), |
| 373 | 'donation-forms' => __('Donation Forms', 'give'), |
| 374 | 'akismet-spam-protection' => __('Akismet SPAM Protection', 'give'), |
| 375 | ]; |
| 376 | |
| 377 | return apply_filters('give_get_sections_' . $this->id, $sections); |
| 378 | } |
| 379 | |
| 380 | |
| 381 | /** |
| 382 | * Render remove_cache_button field type |
| 383 | * |
| 384 | * @since 2.25.2 add nonce field |
| 385 | * @since 2.1 |
| 386 | * @access public |
| 387 | * |
| 388 | * @param array $field |
| 389 | * |
| 390 | */ |
| 391 | public function render_remove_cache_button($field) |
| 392 | { |
| 393 | ?> |
| 394 | <tr valign="top" <?php |
| 395 | echo ! empty($field['wrapper_class']) ? 'class="' . $field['wrapper_class'] . '"' : ''; ?>> |
| 396 | <th scope="row" class="titledesc"> |
| 397 | <label |
| 398 | for="<?php |
| 399 | echo esc_attr($field['id']); ?>"><?php |
| 400 | echo esc_html($field['name']); ?></label> |
| 401 | </th> |
| 402 | <td class="give-forminp"> |
| 403 | <button type="button" id="<?php |
| 404 | echo esc_attr($field['id']); ?>" |
| 405 | class="button button-secondary"><?php |
| 406 | echo esc_html($field['buttonTitle']); ?></button> |
| 407 | <?php |
| 408 | echo Give_Admin_Settings::get_field_description($field ); ?> |
| 409 | <?php wp_nonce_field('give_cache_flush', 'give_cache_flush_nonce'); ?> |
| 410 | </td> |
| 411 | </tr> |
| 412 | <?php |
| 413 | } |
| 414 | |
| 415 | |
| 416 | /** |
| 417 | * Validate setting |
| 418 | * |
| 419 | * @since 2.2.0 |
| 420 | * @access public |
| 421 | * |
| 422 | * @param array $options |
| 423 | * |
| 424 | */ |
| 425 | public function validate_settngs($options) |
| 426 | { |
| 427 | // Sanitize data. |
| 428 | $akismet_spam_protection = isset($options['akismet_spam_protection']) |
| 429 | ? $options['akismet_spam_protection'] |
| 430 | : (give_check_akismet_key() ? 'enabled' : 'disabled'); |
| 431 | |
| 432 | // Show error message if Akismet not configured and Admin try to save 'enabled' option. |
| 433 | if ( |
| 434 | give_is_setting_enabled($akismet_spam_protection) |
| 435 | && ! give_check_akismet_key() |
| 436 | ) { |
| 437 | Give_Admin_Settings::add_error( |
| 438 | 'give-akismet-protection', |
| 439 | __('Please properly configure Akismet to enable SPAM protection.', 'give') |
| 440 | ); |
| 441 | |
| 442 | give_update_option('akismet_spam_protection', 'disabled' ); |
| 443 | } |
| 444 | } |
| 445 | |
| 446 | public function sanitize_option_donor_default_user_role($value) { |
| 447 | $baseRole = ( ( $give_donor = wp_roles()->is_role( 'give_donor' ) ) && ! empty( $give_donor ) ? 'give_donor' : 'subscriber' ); |
| 448 | $defaultUserRoles = (array) give_get_option( 'donor_default_user_role', get_option( 'default_role', $baseRole ) ); |
| 449 | if(!current_user_can('manage_options')){ |
| 450 | if('administrator' === $value) { |
| 451 | if(!in_array('administrator', $defaultUserRoles)) { |
| 452 | $value = $baseRole; |
| 453 | } |
| 454 | } |
| 455 | } |
| 456 | |
| 457 | return $value; |
| 458 | } |
| 459 | |
| 460 | /** |
| 461 | * @since 3.18.0 |
| 462 | */ |
| 463 | public function _render_give_based_form_editor_notice($field, $value) |
| 464 | { |
| 465 | if (OptionBasedFormEditor::isEnabled()) { |
| 466 | ?> |
| 467 | <tr valign="top" <?php |
| 468 | echo ! empty($field['wrapper_class']) ? 'class="' . $field['wrapper_class'] . '"' : ''; ?>> |
| 469 | <th scope="row" class="titledesc"> |
| 470 | </th> |
| 471 | <td class="give-forminp"> |
| 472 | <div class="give_option_based_form_editor_notice"> |
| 473 | <svg width="20" height="20" viewBox="0 0 20 20" fill="none" |
| 474 | xmlns="http://www.w3.org/2000/svg"> |
| 475 | <path fill-rule="evenodd" clip-rule="evenodd" |
| 476 | d="M10.678 1.39a1.667 1.667 0 0 0-1.355 0c-.333.148-.549.409-.7.621-.147.21-.306.483-.48.784l-6.89 11.9c-.174.301-.333.576-.441.809-.11.237-.228.555-.19.918.048.47.295.898.677 1.176.295.214.63.271.89.295.256.023.573.023.922.023H16.89c.349 0 .666 0 .922-.023.26-.024.594-.08.89-.295.382-.278.628-.706.677-1.176.038-.363-.08-.681-.19-.918a10.943 10.943 0 0 0-.442-.81l-6.89-11.9a10.856 10.856 0 0 0-.48-.783c-.15-.212-.367-.473-.7-.621zm.156 6.11a.833.833 0 0 0-1.667 0v3.333a.833.833 0 0 0 1.667 0V7.5zM10 13.333A.833.833 0 0 0 10 15h.009a.833.833 0 0 0 0-1.667H10z" |
| 477 | fill="#F29718" /> |
| 478 | </svg> |
| 479 | <p> |
| 480 | <?php |
| 481 | echo esc_html__('We recommend moving away from Legacy settings and the Option-Based Editor as they are not compatible with newer features and will eventually be removed.', |
| 482 | 'give'); ?> |
| 483 | </p> |
| 484 | </div> |
| 485 | </td> |
| 486 | </tr> |
| 487 | <?php |
| 488 | } |
| 489 | } |
| 490 | } |
| 491 | |
| 492 | endif; |
| 493 | |
| 494 | return new Give_Settings_Advanced(); |
| 495 |