class-settings-addon.php
8 years ago
class-settings-advanced.php
8 years ago
class-settings-cmb2-backward-compatibility.php
8 years ago
class-settings-display.php
8 years ago
class-settings-email.php
8 years ago
class-settings-gateways.php
8 years ago
class-settings-general.php
8 years ago
class-settings-license.php
8 years ago
class-settings-display.php
343 lines
| 1 | <?php |
| 2 | /** |
| 3 | * Give Settings Page/Tab |
| 4 | * |
| 5 | * @package Give |
| 6 | * @subpackage Classes/Give_Settings_Display |
| 7 | * @copyright Copyright (c) 2016, WordImpress |
| 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 = __( 'Display 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 = array(); |
| 45 | $current_section = give_get_current_setting_section(); |
| 46 | |
| 47 | switch ( $current_section ) { |
| 48 | case 'display-settings' : |
| 49 | $settings = array( |
| 50 | // Section 1: Display |
| 51 | array( |
| 52 | 'id' => 'give_title_display_settings_1', |
| 53 | 'type' => 'title', |
| 54 | ), |
| 55 | array( |
| 56 | 'name' => __( 'Default Give Styles', 'give' ), |
| 57 | 'desc' => __( 'You can disable Give\'s default styles for donation forms and other frontend elements.', 'give' ), |
| 58 | 'id' => 'css', |
| 59 | 'type' => 'radio_inline', |
| 60 | 'default' => 'enabled', |
| 61 | 'options' => array( |
| 62 | 'enabled' => __( 'Enabled', 'give' ), |
| 63 | 'disabled' => __( 'Disabled', 'give' ), |
| 64 | ), |
| 65 | ), |
| 66 | array( |
| 67 | 'name' => __( 'Floating Labels', 'give' ), |
| 68 | /* translators: %s: http://docs.givewp.com/form-floating-labels */ |
| 69 | 'desc' => sprintf( wp_kses( __( '<a href="%s" target="_blank">Floating labels</a> allows your labels to be inset within the form fields to provide a cleaner form appearance. Note that if the "Disable CSS" option is enabled, you will need to style the floating labels yourself.', 'give' ), array( |
| 70 | 'a' => array( |
| 71 | 'href' => array(), |
| 72 | 'target' => array(), |
| 73 | ), |
| 74 | ) ), esc_url( 'http://docs.givewp.com/form-floating-labels' ) ), |
| 75 | 'id' => 'floatlabels', |
| 76 | 'type' => 'radio_inline', |
| 77 | 'default' => 'disabled', |
| 78 | 'options' => array( |
| 79 | 'enabled' => __( 'Enabled', 'give' ), |
| 80 | 'disabled' => __( 'Disabled', 'give' ), |
| 81 | ), |
| 82 | ), |
| 83 | array( |
| 84 | 'name' => __( 'Welcome Screen', 'give' ), |
| 85 | /* translators: %s: about page URL */ |
| 86 | 'desc' => sprintf( wp_kses( __( 'Enable this option if you would like to disable the <a href="%s" target="_blank">Give Welcome screen</a> that displays each time Give is activated or updated.', 'give' ), array( |
| 87 | 'a' => array( |
| 88 | 'href' => array(), |
| 89 | 'target' => array(), |
| 90 | ), |
| 91 | ) ), esc_url( admin_url( 'index.php?page=give-about' ) ) ), |
| 92 | 'id' => 'welcome', |
| 93 | 'type' => 'radio_inline', |
| 94 | 'default' => 'enabled', |
| 95 | 'options' => array( |
| 96 | 'enabled' => __( 'Enabled', 'give' ), |
| 97 | 'disabled' => __( 'Disabled', 'give' ), |
| 98 | ), |
| 99 | ), |
| 100 | array( |
| 101 | 'name' => __( 'Company Donations', 'give' ), |
| 102 | 'desc' => __( 'Do you want a Company field to appear after First Name and Last Name?', 'give' ), |
| 103 | 'id' => 'company_field', |
| 104 | 'type' => 'radio_inline', |
| 105 | 'default' => 'disabled', |
| 106 | 'options' => array( |
| 107 | 'disabled' => __( 'Disabled', 'give' ), |
| 108 | 'required' => __( 'Required', 'give' ), |
| 109 | 'optional' => __( 'Optional', 'give' ), |
| 110 | ), |
| 111 | ), |
| 112 | array( |
| 113 | 'name' => __( 'Display Settings Docs Link', 'give' ), |
| 114 | 'id' => 'display_settings_docs_link', |
| 115 | 'url' => esc_url( 'http://docs.givewp.com/form-display-options' ), |
| 116 | 'title' => __( 'Display Options Settings', 'give' ), |
| 117 | 'type' => 'give_docs_link', |
| 118 | ), |
| 119 | array( |
| 120 | 'id' => 'give_title_display_settings_1', |
| 121 | 'type' => 'sectionend', |
| 122 | ), |
| 123 | ); |
| 124 | break; |
| 125 | |
| 126 | case 'post-types' : |
| 127 | $settings = array( |
| 128 | array( |
| 129 | 'id' => 'give_title_display_settings_2', |
| 130 | 'type' => 'title', |
| 131 | ), |
| 132 | array( |
| 133 | 'name' => __( 'Form Single Views', 'give' ), |
| 134 | 'desc' => __( 'By default, all donation form have single views enabled which creates a specific URL on your website for that form. This option disables the singular posts from being publicly viewable. Note: you will need to embed forms using a shortcode or widget if enabled.', 'give' ), |
| 135 | 'id' => 'forms_singular', |
| 136 | 'type' => 'radio_inline', |
| 137 | 'default' => 'enabled', |
| 138 | 'options' => array( |
| 139 | 'enabled' => __( 'Enabled', 'give' ), |
| 140 | 'disabled' => __( 'Disabled', 'give' ), |
| 141 | ), |
| 142 | ), |
| 143 | array( |
| 144 | 'name' => __( 'Form Archives', 'give' ), |
| 145 | 'desc' => sprintf( wp_kses( __( 'Archives pages list all the donation forms you have created. This option will disable only the form\'s archive page(s). The single form\'s view will remain in place. Note: you will need to <a href="%s">refresh your permalinks</a> after this option has been enabled.', 'give' ), array( |
| 146 | 'a' => array( |
| 147 | 'href' => array(), |
| 148 | 'target' => array(), |
| 149 | ), |
| 150 | ) ), esc_url( admin_url( 'options-permalink.php' ) ) ), |
| 151 | 'id' => 'forms_archives', |
| 152 | 'type' => 'radio_inline', |
| 153 | 'default' => 'enabled', |
| 154 | 'options' => array( |
| 155 | 'enabled' => __( 'Enabled', 'give' ), |
| 156 | 'disabled' => __( 'Disabled', 'give' ), |
| 157 | ), |
| 158 | ), |
| 159 | array( |
| 160 | 'name' => __( 'Form Excerpts', 'give' ), |
| 161 | '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' ), |
| 162 | 'id' => 'forms_excerpt', |
| 163 | 'type' => 'radio_inline', |
| 164 | 'default' => 'enabled', |
| 165 | 'options' => array( |
| 166 | 'enabled' => __( 'Enabled', 'give' ), |
| 167 | 'disabled' => __( 'Disabled', 'give' ), |
| 168 | ), |
| 169 | ), |
| 170 | array( |
| 171 | 'name' => __( 'Form Featured Image', 'give' ), |
| 172 | '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' ), |
| 173 | 'id' => 'form_featured_img', |
| 174 | 'type' => 'radio_inline', |
| 175 | 'default' => 'enabled', |
| 176 | 'options' => array( |
| 177 | 'enabled' => __( 'Enabled', 'give' ), |
| 178 | 'disabled' => __( 'Disabled', 'give' ), |
| 179 | ), |
| 180 | ), |
| 181 | array( |
| 182 | 'name' => __( 'Featured Image Size', 'give' ), |
| 183 | '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' ), |
| 184 | 'id' => 'featured_image_size', |
| 185 | 'type' => 'select', |
| 186 | 'default' => 'large', |
| 187 | 'options' => give_get_featured_image_sizes(), |
| 188 | ), |
| 189 | array( |
| 190 | 'name' => __( 'Single Form Sidebar', 'give' ), |
| 191 | 'desc' => __( 'The sidebar allows you to add additional widgets to the Give single form view. If you don\'t plan on using the sidebar you may disable it with this option.', 'give' ), |
| 192 | 'id' => 'form_sidebar', |
| 193 | 'type' => 'radio_inline', |
| 194 | 'default' => 'enabled', |
| 195 | 'options' => array( |
| 196 | 'enabled' => __( 'Enabled', 'give' ), |
| 197 | 'disabled' => __( 'Disabled', 'give' ), |
| 198 | ), |
| 199 | ), |
| 200 | array( |
| 201 | 'name' => __( 'Post Types Docs Link', 'give' ), |
| 202 | 'id' => 'post_types_settings_docs_link', |
| 203 | 'url' => esc_url( 'http://docs.givewp.com/settings-post-types' ), |
| 204 | 'title' => __( 'Post Types Settings', 'give' ), |
| 205 | 'type' => 'give_docs_link', |
| 206 | ), |
| 207 | array( |
| 208 | 'id' => 'give_title_display_settings_2', |
| 209 | 'type' => 'sectionend', |
| 210 | ), |
| 211 | ); |
| 212 | break; |
| 213 | |
| 214 | case 'taxonomies': |
| 215 | $settings = array( |
| 216 | array( |
| 217 | 'id' => 'give_title_display_settings_3', |
| 218 | 'type' => 'title', |
| 219 | ), |
| 220 | array( |
| 221 | 'name' => __( 'Form Categories', 'give' ), |
| 222 | 'desc' => __( 'Enable Categories for all Give forms.', 'give' ), |
| 223 | 'id' => 'categories', |
| 224 | 'type' => 'radio_inline', |
| 225 | 'default' => 'disabled', |
| 226 | 'options' => array( |
| 227 | 'enabled' => __( 'Enabled', 'give' ), |
| 228 | 'disabled' => __( 'Disabled', 'give' ), |
| 229 | ), |
| 230 | ), |
| 231 | array( |
| 232 | 'name' => __( 'Form Tags', 'give' ), |
| 233 | 'desc' => __( 'Enable Tags for all Give forms.', 'give' ), |
| 234 | 'id' => 'tags', |
| 235 | 'type' => 'radio_inline', |
| 236 | 'default' => 'disabled', |
| 237 | 'options' => array( |
| 238 | 'enabled' => __( 'Enabled', 'give' ), |
| 239 | 'disabled' => __( 'Disabled', 'give' ), |
| 240 | ), |
| 241 | ), |
| 242 | array( |
| 243 | 'name' => __( 'Taxonomies Docs Link', 'give' ), |
| 244 | 'id' => 'taxonomies_settings_docs_link', |
| 245 | 'url' => esc_url( 'http://docs.givewp.com/settings-taxonomies' ), |
| 246 | 'title' => __( 'Taxonomies Settings', 'give' ), |
| 247 | 'type' => 'give_docs_link', |
| 248 | ), |
| 249 | array( |
| 250 | 'id' => 'give_title_display_settings_3', |
| 251 | 'type' => 'sectionend', |
| 252 | ), |
| 253 | ); |
| 254 | break; |
| 255 | |
| 256 | case 'term-and-conditions': |
| 257 | $settings = array( |
| 258 | array( |
| 259 | 'id' => 'give_title_display_settings_4', |
| 260 | 'type' => 'title', |
| 261 | ), |
| 262 | array( |
| 263 | 'name' => __( 'Terms and Conditions', 'give' ), |
| 264 | 'desc' => __( 'Would you like donors 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' ), |
| 265 | 'id' => 'terms', |
| 266 | 'type' => 'radio_inline', |
| 267 | 'default' => 'disabled', |
| 268 | 'options' => array( |
| 269 | 'enabled' => __( 'Enabled', 'give' ), |
| 270 | 'disabled' => __( 'Disabled', 'give' ), |
| 271 | ), |
| 272 | ), |
| 273 | array( |
| 274 | 'name' => __( 'Agree to Terms Label', 'give' ), |
| 275 | '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' ), |
| 276 | 'id' => 'agree_to_terms_label', |
| 277 | 'attributes' => array( |
| 278 | 'placeholder' => esc_attr__( 'Agree to Terms?', 'give' ), |
| 279 | ), |
| 280 | 'type' => 'text', |
| 281 | ), |
| 282 | array( |
| 283 | 'name' => __( 'Agreement Text', 'give' ), |
| 284 | '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' ), |
| 285 | 'id' => 'agreement_text', |
| 286 | 'type' => 'wysiwyg', |
| 287 | ), |
| 288 | array( |
| 289 | 'name' => __( 'Terms and Conditions Docs Link', 'give' ), |
| 290 | 'id' => 'terms_settings_docs_link', |
| 291 | 'url' => esc_url( 'http://docs.givewp.com/settings-terms' ), |
| 292 | 'title' => __( 'Terms and Conditions Settings', 'give' ), |
| 293 | 'type' => 'give_docs_link', |
| 294 | ), |
| 295 | array( |
| 296 | 'id' => 'give_title_display_settings_4', |
| 297 | 'type' => 'sectionend', |
| 298 | ), |
| 299 | ); |
| 300 | break; |
| 301 | } |
| 302 | |
| 303 | /** |
| 304 | * Filter the display options settings. |
| 305 | * Backward compatibility: Please do not use this filter. This filter is deprecated in 1.8 |
| 306 | */ |
| 307 | $settings = apply_filters( 'give_settings_display', $settings ); |
| 308 | |
| 309 | /** |
| 310 | * Filter the settings. |
| 311 | * |
| 312 | * @since 1.8 |
| 313 | * |
| 314 | * @param array $settings |
| 315 | */ |
| 316 | $settings = apply_filters( 'give_get_settings_' . $this->id, $settings ); |
| 317 | |
| 318 | // Output. |
| 319 | return $settings; |
| 320 | } |
| 321 | |
| 322 | /** |
| 323 | * Get sections. |
| 324 | * |
| 325 | * @since 1.8 |
| 326 | * @return array |
| 327 | */ |
| 328 | public function get_sections() { |
| 329 | $sections = array( |
| 330 | 'display-settings' => __( 'Display', 'give' ), |
| 331 | 'post-types' => __( 'Post Types', 'give' ), |
| 332 | 'taxonomies' => __( 'Taxonomies', 'give' ), |
| 333 | 'term-and-conditions' => __( 'Terms and Conditions', 'give' ), |
| 334 | ); |
| 335 | |
| 336 | return apply_filters( 'give_get_sections_' . $this->id, $sections ); |
| 337 | } |
| 338 | } |
| 339 | |
| 340 | endif; |
| 341 | |
| 342 | return new Give_Settings_Display(); |
| 343 |