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
3 years ago
class-settings-display.php
361 lines
| 1 | <?php |
| 2 | /** |
| 3 | * Give Settings Page/Tab |
| 4 | * |
| 5 | * @package Give |
| 6 | * @subpackage Classes/Give_Settings_Display |
| 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_Display' ) ) : |
| 17 | |
| 18 | /** |
| 19 | * Give_Settings_Display. |
| 20 | * |
| 21 | * @sine 1.8 |
| 22 | */ |
| 23 | class Give_Settings_Display extends Give_Settings_Page { |
| 24 | |
| 25 | /** |
| 26 | * Constructor. |
| 27 | */ |
| 28 | public function __construct() { |
| 29 | $this->id = 'display'; |
| 30 | $this->label = __( 'Default Options', 'give' ); |
| 31 | |
| 32 | $this->default_tab = 'display-settings'; |
| 33 | |
| 34 | parent::__construct(); |
| 35 | } |
| 36 | |
| 37 | /** |
| 38 | * Get settings array. |
| 39 | * |
| 40 | * @since 1.8 |
| 41 | * @return array |
| 42 | */ |
| 43 | public function get_settings() { |
| 44 | $settings = []; |
| 45 | $current_section = give_get_current_setting_section(); |
| 46 | |
| 47 | switch ( $current_section ) { |
| 48 | case 'display-settings': |
| 49 | $settings = [ |
| 50 | // Section 1: Display |
| 51 | [ |
| 52 | 'id' => 'give_title_display_settings_1', |
| 53 | 'type' => 'title', |
| 54 | ], |
| 55 | [ |
| 56 | 'name' => __( 'Name Title Prefix', 'give' ), |
| 57 | 'desc' => __( 'Do you want a Name Title Prefix field to appear before First Name?', 'give' ), |
| 58 | 'id' => 'name_title_prefix', |
| 59 | 'type' => 'radio_inline', |
| 60 | 'default' => 'disabled', |
| 61 | 'options' => [ |
| 62 | 'disabled' => __( 'Disabled', 'give' ), |
| 63 | 'required' => __( 'Required', 'give' ), |
| 64 | 'optional' => __( 'Optional', 'give' ), |
| 65 | ], |
| 66 | ], |
| 67 | [ |
| 68 | 'name' => __( 'Title Prefixes', 'give' ), |
| 69 | 'desc' => __( 'Add or remove salutations from the dropdown using the field above.', 'give' ), |
| 70 | 'id' => 'title_prefixes', |
| 71 | 'type' => 'chosen', |
| 72 | 'data_type' => 'multiselect', |
| 73 | 'allow-custom-values' => true, |
| 74 | 'wrapper_class' => 'give-title-prefixes-settings-wrap', |
| 75 | 'style' => 'width: 30%', |
| 76 | 'options' => give_get_default_title_prefixes(), |
| 77 | ], |
| 78 | [ |
| 79 | 'name' => __( 'Company Field', 'give' ), |
| 80 | 'desc' => __( 'Do you want a Company field to appear after First Name and Last Name fields on all donation forms? You can enable this option per form as well.', 'give' ), |
| 81 | 'id' => 'company_field', |
| 82 | 'type' => 'radio_inline', |
| 83 | 'default' => 'disabled', |
| 84 | 'options' => [ |
| 85 | 'disabled' => __( 'Disabled', 'give' ), |
| 86 | 'required' => __( 'Required', 'give' ), |
| 87 | 'optional' => __( 'Optional', 'give' ), |
| 88 | ], |
| 89 | ], |
| 90 | [ |
| 91 | 'name' => __( 'Last Name Field Required', 'give' ), |
| 92 | 'desc' => __( 'Do you want to require donor last names/surnames? By default, only the first name field on a donation is required. This setting is also configurable on a per-form basis.', 'give' ), |
| 93 | 'id' => 'last_name_field_required', |
| 94 | 'type' => 'radio_inline', |
| 95 | 'default' => 'optional', |
| 96 | 'options' => [ |
| 97 | 'required' => __( 'Required', 'give' ), |
| 98 | 'optional' => __( 'Optional', 'give' ), |
| 99 | ], |
| 100 | ], |
| 101 | [ |
| 102 | 'name' => __( 'Anonymous Donations', 'give' ), |
| 103 | 'desc' => __( 'Do you want to provide donors the ability mark themselves anonymous while giving? This will prevent their information from appearing publicly on your website but you will still receive their information for your records in the admin panel.', 'give' ), |
| 104 | 'id' => 'anonymous_donation', |
| 105 | 'type' => 'radio_inline', |
| 106 | 'default' => 'disabled', |
| 107 | 'options' => [ |
| 108 | 'enabled' => __( 'Enabled', 'give' ), |
| 109 | 'disabled' => __( 'Disabled', 'give' ), |
| 110 | ], |
| 111 | ], |
| 112 | [ |
| 113 | 'name' => __( 'Donor Comments', 'give' ), |
| 114 | 'desc' => __( 'Do you want to provide donors the ability to add a comment to their donation? The comment will display publicly on the donor wall if they do not select to give anonymously.', 'give' ), |
| 115 | 'id' => 'donor_comment', |
| 116 | 'type' => 'radio_inline', |
| 117 | 'default' => 'disabled', |
| 118 | 'options' => [ |
| 119 | 'enabled' => __( 'Enabled', 'give' ), |
| 120 | 'disabled' => __( 'Disabled', 'give' ), |
| 121 | ], |
| 122 | ], |
| 123 | [ |
| 124 | 'name' => __( 'Display Settings Docs Link', 'give' ), |
| 125 | 'id' => 'display_settings_docs_link', |
| 126 | 'url' => esc_url( 'http://docs.givewp.com/settings-form-options' ), |
| 127 | 'title' => __( 'Display Options Settings', 'give' ), |
| 128 | 'type' => 'give_docs_link', |
| 129 | ], |
| 130 | [ |
| 131 | 'id' => 'give_title_display_settings_1', |
| 132 | 'type' => 'sectionend', |
| 133 | ], |
| 134 | ]; |
| 135 | break; |
| 136 | |
| 137 | case 'post-types': |
| 138 | $settings = [ |
| 139 | [ |
| 140 | 'id' => 'give_title_display_settings_2', |
| 141 | 'type' => 'title', |
| 142 | ], |
| 143 | [ |
| 144 | 'name' => __( 'Form Single Views', 'give' ), |
| 145 | 'desc' => __( 'By default, all donation forms have single views enabled. This creates a specific URL on your website for that form. Selecting "Disabled" will prevent the single view from being publicly displayed. Note: if selecting "Disabled", to display each form you will need to embed it using a block, shortcode, or widget.', 'give' ), |
| 146 | 'id' => 'forms_singular', |
| 147 | 'type' => 'radio_inline', |
| 148 | 'default' => 'enabled', |
| 149 | 'options' => [ |
| 150 | 'enabled' => __( 'Enabled', 'give' ), |
| 151 | 'disabled' => __( 'Disabled', 'give' ), |
| 152 | ], |
| 153 | ], |
| 154 | [ |
| 155 | 'name' => __( 'Form Archives', 'give' ), |
| 156 | 'desc' => sprintf( |
| 157 | wp_kses( |
| 158 | __( 'Archive pages list all the donation forms you have created. This option will disable only the form\'s archive page(s). The form\'s single view will still be displayed. Note: you will need to <a href="%s">refresh your permalinks</a> after this option has been enabled.', 'give' ), |
| 159 | [ |
| 160 | 'a' => [ |
| 161 | 'href' => [], |
| 162 | 'target' => [], |
| 163 | ], |
| 164 | ] |
| 165 | ), |
| 166 | esc_url( admin_url( 'options-permalink.php' ) ) |
| 167 | ), |
| 168 | 'id' => 'forms_archives', |
| 169 | 'type' => 'radio_inline', |
| 170 | 'default' => 'enabled', |
| 171 | 'options' => [ |
| 172 | 'enabled' => __( 'Enabled', 'give' ), |
| 173 | 'disabled' => __( 'Disabled', 'give' ), |
| 174 | ], |
| 175 | ], |
| 176 | [ |
| 177 | 'name' => __( 'Form Excerpts', 'give' ), |
| 178 | 'desc' => __( 'The excerpt is an optional summary or description of a donation form; in short, a summary as to why the user should give.', 'give' ), |
| 179 | 'id' => 'forms_excerpt', |
| 180 | 'type' => 'radio_inline', |
| 181 | 'default' => 'enabled', |
| 182 | 'options' => [ |
| 183 | 'enabled' => __( 'Enabled', 'give' ), |
| 184 | 'disabled' => __( 'Disabled', 'give' ), |
| 185 | ], |
| 186 | ], |
| 187 | [ |
| 188 | 'name' => __( 'Form Featured Image', 'give' ), |
| 189 | 'desc' => __( 'If you do not wish to use the featured image functionality you can disable it using this option and it will not be displayed for single donation forms.', 'give' ), |
| 190 | 'id' => 'form_featured_img', |
| 191 | 'type' => 'radio_inline', |
| 192 | 'default' => 'enabled', |
| 193 | 'options' => [ |
| 194 | 'enabled' => __( 'Enabled', 'give' ), |
| 195 | 'disabled' => __( 'Disabled', 'give' ), |
| 196 | ], |
| 197 | ], |
| 198 | [ |
| 199 | 'name' => __( 'Featured Image Size', 'give' ), |
| 200 | 'desc' => __( 'The Featured Image is an image that is chosen as the representative image for a donation form. Some themes may have custom featured image sizes. Please select the size you would like to display for your single donation form\'s featured image.', 'give' ), |
| 201 | 'id' => 'featured_image_size', |
| 202 | 'type' => 'select', |
| 203 | 'default' => 'large', |
| 204 | 'options' => give_get_featured_image_sizes(), |
| 205 | ], |
| 206 | [ |
| 207 | 'name' => __( 'Single Form Sidebar', 'give' ), |
| 208 | 'desc' => __( 'The sidebar allows you to add additional widgets to the GiveWP single form view. If you don\'t plan on using the sidebar you may disable it with this option.', 'give' ), |
| 209 | 'id' => 'form_sidebar', |
| 210 | 'type' => 'radio_inline', |
| 211 | 'default' => 'enabled', |
| 212 | 'options' => [ |
| 213 | 'enabled' => __( 'Enabled', 'give' ), |
| 214 | 'disabled' => __( 'Disabled', 'give' ), |
| 215 | ], |
| 216 | ], |
| 217 | [ |
| 218 | 'name' => __( 'Post Types Docs Link', 'give' ), |
| 219 | 'id' => 'post_types_settings_docs_link', |
| 220 | 'url' => esc_url( 'http://docs.givewp.com/settings-post-types' ), |
| 221 | 'title' => __( 'Post Types Settings', 'give' ), |
| 222 | 'type' => 'give_docs_link', |
| 223 | ], |
| 224 | [ |
| 225 | 'id' => 'give_title_display_settings_2', |
| 226 | 'type' => 'sectionend', |
| 227 | ], |
| 228 | ]; |
| 229 | break; |
| 230 | |
| 231 | case 'taxonomies': |
| 232 | $settings = [ |
| 233 | [ |
| 234 | 'id' => 'give_title_display_settings_3', |
| 235 | 'type' => 'title', |
| 236 | ], |
| 237 | [ |
| 238 | 'name' => __( 'Form Categories', 'give' ), |
| 239 | 'desc' => __( 'Enable Categories for all GiveWP forms.', 'give' ), |
| 240 | 'id' => 'categories', |
| 241 | 'type' => 'radio_inline', |
| 242 | 'default' => 'disabled', |
| 243 | 'options' => [ |
| 244 | 'enabled' => __( 'Enabled', 'give' ), |
| 245 | 'disabled' => __( 'Disabled', 'give' ), |
| 246 | ], |
| 247 | ], |
| 248 | [ |
| 249 | 'name' => __( 'Form Tags', 'give' ), |
| 250 | 'desc' => __( 'Enable Tags for all GiveWP forms.', 'give' ), |
| 251 | 'id' => 'tags', |
| 252 | 'type' => 'radio_inline', |
| 253 | 'default' => 'disabled', |
| 254 | 'options' => [ |
| 255 | 'enabled' => __( 'Enabled', 'give' ), |
| 256 | 'disabled' => __( 'Disabled', 'give' ), |
| 257 | ], |
| 258 | ], |
| 259 | [ |
| 260 | 'name' => __( 'Taxonomies Docs Link', 'give' ), |
| 261 | 'id' => 'taxonomies_settings_docs_link', |
| 262 | 'url' => esc_url( 'http://docs.givewp.com/settings-taxonomies' ), |
| 263 | 'title' => __( 'Taxonomies Settings', 'give' ), |
| 264 | 'type' => 'give_docs_link', |
| 265 | ], |
| 266 | [ |
| 267 | 'id' => 'give_title_display_settings_3', |
| 268 | 'type' => 'sectionend', |
| 269 | ], |
| 270 | ]; |
| 271 | break; |
| 272 | |
| 273 | case 'term-and-conditions': |
| 274 | $settings = [ |
| 275 | [ |
| 276 | 'id' => 'give_title_display_settings_4', |
| 277 | 'type' => 'title', |
| 278 | ], |
| 279 | [ |
| 280 | 'name' => __( 'Terms and Conditions', 'give' ), |
| 281 | 'desc' => __( 'Would you like to require that donors agree to your terms when donating? Note: You can enable/disable this option and customize the terms per form as well.', 'give' ), |
| 282 | 'id' => 'terms', |
| 283 | 'type' => 'radio_inline', |
| 284 | 'default' => 'disabled', |
| 285 | 'options' => [ |
| 286 | 'enabled' => __( 'Enabled', 'give' ), |
| 287 | 'disabled' => __( 'Disabled', 'give' ), |
| 288 | ], |
| 289 | ], |
| 290 | [ |
| 291 | 'name' => __( 'Agree to Terms Label', 'give' ), |
| 292 | 'desc' => __( 'The label shown next to the agree to terms check box. Customize it here or leave blank to use the default placeholder text. Note: You can customize the label per form.', 'give' ), |
| 293 | 'id' => 'agree_to_terms_label', |
| 294 | 'attributes' => [ |
| 295 | 'placeholder' => esc_attr__( 'Agree to Terms?', 'give' ), |
| 296 | 'rows' => 1, |
| 297 | ], |
| 298 | 'type' => 'textarea', |
| 299 | ], |
| 300 | [ |
| 301 | 'name' => __( 'Agreement Text', 'give' ), |
| 302 | 'desc' => __( 'This is the actual text which the user will be asked to agree to in order to donate. Note: You can customize the content per form as needed.', 'give' ), |
| 303 | 'id' => 'agreement_text', |
| 304 | 'type' => 'wysiwyg', |
| 305 | ], |
| 306 | [ |
| 307 | 'name' => __( 'Terms and Conditions Docs Link', 'give' ), |
| 308 | 'id' => 'terms_settings_docs_link', |
| 309 | 'url' => esc_url( 'http://docs.givewp.com/settings-terms' ), |
| 310 | 'title' => __( 'Terms and Conditions Settings', 'give' ), |
| 311 | 'type' => 'give_docs_link', |
| 312 | ], |
| 313 | [ |
| 314 | 'id' => 'give_title_display_settings_4', |
| 315 | 'type' => 'sectionend', |
| 316 | ], |
| 317 | ]; |
| 318 | break; |
| 319 | } |
| 320 | |
| 321 | /** |
| 322 | * Filter the display options settings. |
| 323 | * Backward compatibility: Please do not use this filter. This filter is deprecated in 1.8 |
| 324 | */ |
| 325 | $settings = apply_filters( 'give_settings_display', $settings ); |
| 326 | |
| 327 | /** |
| 328 | * Filter the settings. |
| 329 | * |
| 330 | * @since 1.8 |
| 331 | * |
| 332 | * @param array $settings |
| 333 | */ |
| 334 | $settings = apply_filters( 'give_get_settings_' . $this->id, $settings ); |
| 335 | |
| 336 | // Output. |
| 337 | return $settings; |
| 338 | } |
| 339 | |
| 340 | /** |
| 341 | * Get sections. |
| 342 | * |
| 343 | * @since 1.8 |
| 344 | * @return array |
| 345 | */ |
| 346 | public function get_sections() { |
| 347 | $sections = [ |
| 348 | 'display-settings' => __( 'Form Fields', 'give' ), |
| 349 | 'post-types' => __( 'Post Types', 'give' ), |
| 350 | 'taxonomies' => __( 'Taxonomies', 'give' ), |
| 351 | 'term-and-conditions' => __( 'Terms and Conditions', 'give' ), |
| 352 | ]; |
| 353 | |
| 354 | return apply_filters( 'give_get_sections_' . $this->id, $sections ); |
| 355 | } |
| 356 | } |
| 357 | |
| 358 | endif; |
| 359 | |
| 360 | return new Give_Settings_Display(); |
| 361 |