html-admin-settings.php
199 lines
| 1 | <?php |
| 2 | |
| 3 | use Give\Helpers\Utils; |
| 4 | |
| 5 | /** |
| 6 | * Admin View: Settings |
| 7 | */ |
| 8 | if ( ! defined('ABSPATH')) { |
| 9 | exit; |
| 10 | } |
| 11 | |
| 12 | // Bailout: Do not output anything if setting tab is not defined. |
| 13 | if ( ! empty($tabs) && array_key_exists(give_get_current_setting_tab(), $tabs)) : |
| 14 | /** |
| 15 | * Filter the form action. |
| 16 | * |
| 17 | * Note: filter dynamically fire on basis of setting page slug |
| 18 | * For example: if you register a setting page with give-settings menu slug and general current tab |
| 19 | * then filter will be give-settings_form_method_tab_general |
| 20 | * |
| 21 | * @since 1.8 |
| 22 | */ |
| 23 | $form_method = apply_filters(self::$setting_filter_prefix . '_form_method_tab_' . $current_tab, 'post'); |
| 24 | |
| 25 | /** |
| 26 | * Filter the main form tab. |
| 27 | * |
| 28 | * Note: You can stop print main form if you want to filter dynamically fire on basis of setting page slug |
| 29 | * For example: if you register a setting page with give-settings menu slug |
| 30 | * then filter will be give-settings_open_form, give-settings_close_form |
| 31 | * We are using this filter in includes/admin/tools/class-settings-data.php#L52 |
| 32 | * |
| 33 | * @since 1.8 |
| 34 | */ |
| 35 | $form_open_tag = apply_filters( |
| 36 | self::$setting_filter_prefix . '_open_form', |
| 37 | '<form method="' . $form_method . '" id="give-mainform" action="" enctype="multipart/form-data">' |
| 38 | ); |
| 39 | $form_close_tag = apply_filters(self::$setting_filter_prefix . '_close_form', '</form>'); |
| 40 | |
| 41 | $wrapper_class = implode( |
| 42 | ' ', |
| 43 | [ |
| 44 | self::$setting_filter_prefix . '-setting-page', |
| 45 | self::$setting_filter_prefix . '-' . give_get_current_setting_section() . '-section', |
| 46 | self::$setting_filter_prefix . '-' . give_get_current_setting_tab() . '-tab', |
| 47 | ] |
| 48 | ); |
| 49 | ?> |
| 50 | |
| 51 | <div class="wrap give-settings-page <?php |
| 52 | echo esc_html($wrapper_class); ?>"> |
| 53 | |
| 54 | <?php |
| 55 | echo $form_open_tag; ?> |
| 56 | |
| 57 | <div class="give-settings-header"> |
| 58 | <?php |
| 59 | /* @var Give_Settings_Page $current_setting_obj */ |
| 60 | if ( |
| 61 | ! empty($current_setting_obj) |
| 62 | && method_exists($current_setting_obj, 'get_heading_html') |
| 63 | ) { |
| 64 | echo $current_setting_obj->get_heading_html(); |
| 65 | } else { |
| 66 | // Backward compatibility. |
| 67 | echo sprintf( |
| 68 | '<h1 class="wp-heading-inline">%s</h1>', |
| 69 | esc_html($tabs[$current_tab]) |
| 70 | ); |
| 71 | } |
| 72 | |
| 73 | self::show_messages(); |
| 74 | |
| 75 | do_action('give_settings_page_header'); |
| 76 | ?> |
| 77 | |
| 78 | </div> |
| 79 | |
| 80 | <?php |
| 81 | /* |
| 82 | Default behavior of WordPress places admin notices directly after the first h-tag inside any element |
| 83 | with the class of wrap. The tag below will instruct WordPress to place these notices below the header. |
| 84 | */ |
| 85 | ?> |
| 86 | <hr class="wp-header-end hidden"> |
| 87 | |
| 88 | <div class="nav-tab-wrapper give-nav-tab-wrapper"> |
| 89 | <?php |
| 90 | /** |
| 91 | * Render Recurring Donations UTM link. |
| 92 | * |
| 93 | * @since 2.27.1 |
| 94 | */ |
| 95 | foreach ($tabs as $name => $label) { |
| 96 | $target = $name === 'recurring' ? 'target="_blank" ' : false; |
| 97 | $urlPath = $name === 'recurring' ? 'https://docs.givewp.com/recurring-link' : admin_url( |
| 98 | 'edit.php?post_type=give_forms&page=' . self::$setting_filter_prefix . "&tab={$name}" |
| 99 | ); |
| 100 | echo '<a ' . $target . 'href="' . $urlPath . '"' . ' class="nav-tab ' . ($current_tab === $name ? 'nav-tab-active' : 'give-mobile-hidden') . '">' . $label . '</a>'; |
| 101 | } |
| 102 | |
| 103 | /** |
| 104 | * Render Addon product recommendation link if Recurring Donations is active. |
| 105 | * |
| 106 | * @since 2.27.1 |
| 107 | */ |
| 108 | if (Utils::isPluginActive('give-recurring/give-recurring.php')) { |
| 109 | echo ' |
| 110 | <a class="give-nav-addons-tab" href="' . esc_url( |
| 111 | admin_url('edit.php?post_type=give_forms&page=give-add-ons') |
| 112 | ) . '"> |
| 113 | <img src="' . GIVE_PLUGIN_URL . '/assets/dist/images/admin/add-on-star-icon.svg"/> |
| 114 | <span>' . __('ADD-ONS', 'give') . '</span> |
| 115 | </a> |
| 116 | '; |
| 117 | } |
| 118 | |
| 119 | /** |
| 120 | * Trigger Action. |
| 121 | * |
| 122 | * Note: action dynamically fire on basis of setting page slug. |
| 123 | * For example: if you register a setting page with give-settings menu slug |
| 124 | * then action will be give-settings_tabs |
| 125 | * |
| 126 | * @since 1.8 |
| 127 | */ |
| 128 | do_action(self::$setting_filter_prefix . '_tabs'); |
| 129 | |
| 130 | // Show link to New Reports page |
| 131 | $isReports = isset($_GET['page']) && $_GET['page'] === 'give-reports'; |
| 132 | if ($isReports === true) { |
| 133 | echo sprintf( |
| 134 | '<a href="%1$s" class="nav-tab nav-tab" id="new-reports-link">%2$s</a>', |
| 135 | admin_url('edit.php?post_type=give_forms&page=give-reports'), |
| 136 | esc_html__('New Reports Dashboard', 'give') |
| 137 | ); |
| 138 | } |
| 139 | ?> |
| 140 | |
| 141 | <div class="give-sub-nav-tab-wrapper"> |
| 142 | <a href="#" id="give-show-sub-nav" class="nav-tab give-not-tab" title="<?php |
| 143 | esc_html_e('View remaining setting tabs', 'give'); ?>"> |
| 144 | <span class="dashicons dashicons-arrow-down-alt2"></span> |
| 145 | </a> |
| 146 | <nav class="give-sub-nav-tab give-hidden"></nav> |
| 147 | </div> |
| 148 | </div> |
| 149 | |
| 150 | <?php |
| 151 | |
| 152 | /** |
| 153 | * Trigger Action. |
| 154 | * |
| 155 | * Note: action dynamically fire on basis of setting page slug. |
| 156 | * For example: if you register a setting page with give-settings menu slug and general current tab |
| 157 | * then action will be give-settings_sections_general_page |
| 158 | * |
| 159 | * @since 1.8 |
| 160 | */ |
| 161 | do_action(self::$setting_filter_prefix . "_sections_{$current_tab}_page"); |
| 162 | |
| 163 | /** |
| 164 | * Trigger Action. |
| 165 | * |
| 166 | * Note: action dynamically fire on basis of setting page slug. |
| 167 | * For example: if you register a setting page with give-settings menu slug and general current tab |
| 168 | * then action will be give-settings_settings_general_page |
| 169 | * |
| 170 | * @since 1.8 |
| 171 | */ |
| 172 | do_action(self::$setting_filter_prefix . "_settings_{$current_tab}_page"); |
| 173 | |
| 174 | wp_nonce_field('give-save-settings', '_give-save-settings'); |
| 175 | |
| 176 | if (empty($GLOBALS['give_hide_save_button'])) : |
| 177 | ?> |
| 178 | <div class="give-submit-wrap"> |
| 179 | <input name="save" class="button-primary give-save-button" type="submit" value="<?php |
| 180 | esc_html_e('Save changes', 'give'); ?>" /> |
| 181 | </div> |
| 182 | <?php |
| 183 | endif; ?> |
| 184 | <?php |
| 185 | echo $form_close_tag; ?> |
| 186 | </div> |
| 187 | <?php |
| 188 | else : |
| 189 | ?> |
| 190 | <div class="error"> |
| 191 | <p> |
| 192 | <?php |
| 193 | esc_html_e('Oops, this settings page does not exist.', 'give'); ?> |
| 194 | </p> |
| 195 | </div> |
| 196 | <?php |
| 197 | endif; |
| 198 | ?> |
| 199 |