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-email.php
250 lines
| 1 | <?php |
| 2 | /** |
| 3 | * Give Settings Page/Tab |
| 4 | * |
| 5 | * @package Give |
| 6 | * @subpackage Classes/Give_Settings_Email |
| 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_Email' ) ) : |
| 17 | |
| 18 | /** |
| 19 | * Give_Settings_Email. |
| 20 | * |
| 21 | * @sine 1.8 |
| 22 | */ |
| 23 | class Give_Settings_Email extends Give_Settings_Page { |
| 24 | |
| 25 | /** |
| 26 | * Constructor. |
| 27 | */ |
| 28 | public function __construct() { |
| 29 | $this->id = 'emails'; |
| 30 | $this->label = esc_html__( 'Emails', 'give' ); |
| 31 | |
| 32 | $this->default_tab = 'donor-email'; |
| 33 | |
| 34 | parent::__construct(); |
| 35 | |
| 36 | $this->enable_save = ! ( Give_Admin_Settings::is_setting_page( 'emails', 'donor-email' ) || Give_Admin_Settings::is_setting_page( 'emails', 'admin-email' ) ); |
| 37 | |
| 38 | add_action( 'give_admin_field_email_notification', array( $this, 'email_notification_setting' ) ); |
| 39 | } |
| 40 | |
| 41 | /** |
| 42 | * Get settings array. |
| 43 | * |
| 44 | * @since 1.8 |
| 45 | * @return array |
| 46 | */ |
| 47 | public function get_settings() { |
| 48 | $settings = array(); |
| 49 | $current_section = give_get_current_setting_section(); |
| 50 | |
| 51 | switch ( $current_section ) { |
| 52 | case 'email-settings': |
| 53 | $settings = array( |
| 54 | |
| 55 | // Section 1: Email Sender Setting |
| 56 | array( |
| 57 | 'id' => 'give_title_email_settings_1', |
| 58 | 'type' => 'title', |
| 59 | ), |
| 60 | array( |
| 61 | 'id' => 'email_template', |
| 62 | 'name' => esc_html__( 'Email Template', 'give' ), |
| 63 | 'desc' => esc_html__( 'Choose your template from the available registered template types.', 'give' ), |
| 64 | 'type' => 'select', |
| 65 | 'options' => give_get_email_templates(), |
| 66 | ), |
| 67 | array( |
| 68 | 'id' => 'email_logo', |
| 69 | 'name' => esc_html__( 'Logo', 'give' ), |
| 70 | 'desc' => esc_html__( 'Upload or choose a logo to be displayed at the top of the donation receipt emails. Displayed on HTML emails only.', 'give' ), |
| 71 | 'type' => 'file', |
| 72 | ), |
| 73 | array( |
| 74 | 'id' => 'from_name', |
| 75 | 'name' => esc_html__( 'From Name', 'give' ), |
| 76 | 'desc' => esc_html__( 'The name which appears in the "From" field in all GiveWP donation emails.', 'give' ), |
| 77 | 'default' => get_bloginfo( 'name' ), |
| 78 | 'type' => 'text', |
| 79 | ), |
| 80 | array( |
| 81 | 'id' => 'from_email', |
| 82 | 'name' => esc_html__( 'From Email', 'give' ), |
| 83 | 'desc' => esc_html__( 'Email address from which all GiveWP emails are sent from. This will act as the "from" and "reply-to" email address.', 'give' ), |
| 84 | 'default' => get_bloginfo( 'admin_email' ), |
| 85 | 'type' => 'text', |
| 86 | ), |
| 87 | array( |
| 88 | 'name' => esc_html__( 'Donation Notification Settings Docs Link', 'give' ), |
| 89 | 'id' => 'donation_notification_settings_docs_link', |
| 90 | 'url' => esc_url( 'http://docs.givewp.com/settings-donation-notification' ), |
| 91 | 'title' => __( 'Donation Notification Settings', 'give' ), |
| 92 | 'type' => 'give_docs_link', |
| 93 | ), |
| 94 | array( |
| 95 | 'id' => 'give_title_email_settings_3', |
| 96 | 'type' => 'sectionend', |
| 97 | ), |
| 98 | ); |
| 99 | break; |
| 100 | |
| 101 | case 'donor-email': |
| 102 | $settings = array( |
| 103 | |
| 104 | // Section 1: Donor Email Notification Listing. |
| 105 | array( |
| 106 | 'desc' => __( 'Email notifications sent from GiveWP for donor are listed below. Click on an email to configure it.', 'give' ), |
| 107 | 'type' => 'title', |
| 108 | 'id' => 'give_donor_email_notification_settings', |
| 109 | 'table_html' => false, |
| 110 | ), |
| 111 | array( |
| 112 | 'type' => 'email_notification', |
| 113 | ), |
| 114 | array( |
| 115 | 'type' => 'sectionend', |
| 116 | 'id' => 'give_donor_email_notification_settings', |
| 117 | ), |
| 118 | |
| 119 | ); |
| 120 | break; |
| 121 | |
| 122 | case 'admin-email': |
| 123 | $settings = array( |
| 124 | |
| 125 | // Section 1: Admin Email Notification Listing. |
| 126 | array( |
| 127 | 'desc' => __( 'Email notifications sent from GiveWP for admin are listed below. Click on an email to configure it.', 'give' ), |
| 128 | 'type' => 'title', |
| 129 | 'id' => 'give_admin_email_notification_settings', |
| 130 | 'table_html' => false, |
| 131 | ), |
| 132 | array( |
| 133 | 'type' => 'email_notification', |
| 134 | ), |
| 135 | array( |
| 136 | 'type' => 'sectionend', |
| 137 | 'id' => 'give_admin_email_notification_settings', |
| 138 | ), |
| 139 | |
| 140 | ); |
| 141 | break; |
| 142 | |
| 143 | case 'contact': |
| 144 | $settings = array( |
| 145 | |
| 146 | array( |
| 147 | 'id' => 'give_title_general_settings_5', |
| 148 | 'type' => 'title', |
| 149 | ), |
| 150 | array( |
| 151 | 'name' => __( 'Admin Email Address', 'give' ), |
| 152 | 'id' => 'contact_admin_email', |
| 153 | 'desc' => sprintf( '%1$s <code>{admin_email}</code> %2$s', __( 'By default, the', 'give' ), __( 'tag will use your WordPress admin email. If you would like to customize this address you can do so in the field above.', 'give' ) ), |
| 154 | 'type' => 'text', |
| 155 | 'default' => give_email_admin_email(), |
| 156 | |
| 157 | ), |
| 158 | array( |
| 159 | 'name' => __( 'Offline Mailing Address', 'give' ), |
| 160 | 'id' => 'contact_offline_mailing_address', |
| 161 | 'desc' => sprintf( '%1$s <code>{offline_mailing_address}</code> %2$s', __( 'Set the mailing address to where you would like your donors to send their offline donations. This will customize the', 'give' ), __( 'email tag for the Offline Donations payment gateway.', 'give' ) ), |
| 162 | 'type' => 'wysiwyg', |
| 163 | 'default' => ' <em>' . get_bloginfo( 'sitename' ) . '</em><br> <em>111 Not A Real St.</em><br> <em>Anytown, CA 12345 </em><br>', |
| 164 | ), |
| 165 | array( |
| 166 | 'id' => 'give_title_general_settings_4', |
| 167 | 'type' => 'sectionend', |
| 168 | ), |
| 169 | ); |
| 170 | |
| 171 | break; |
| 172 | }// End switch(). |
| 173 | |
| 174 | /** |
| 175 | * Filter the emails settings. |
| 176 | * Backward compatibility: Please do not use this filter. This filter is deprecated in 1.8 |
| 177 | */ |
| 178 | $settings = apply_filters( 'give_settings_emails', $settings ); |
| 179 | |
| 180 | /** |
| 181 | * Filter the settings. |
| 182 | * |
| 183 | * @since 1.8 |
| 184 | * |
| 185 | * @param array $settings |
| 186 | */ |
| 187 | $settings = apply_filters( 'give_get_settings_' . $this->id, $settings ); |
| 188 | |
| 189 | // Output. |
| 190 | return $settings; |
| 191 | } |
| 192 | |
| 193 | /** |
| 194 | * Get sections. |
| 195 | * |
| 196 | * @since 1.8 |
| 197 | * @return array |
| 198 | */ |
| 199 | public function get_sections() { |
| 200 | $sections = array( |
| 201 | 'donor-email' => esc_html__( 'Donor Emails', 'give' ), |
| 202 | 'admin-email' => esc_html__( 'Admin Emails', 'give' ), |
| 203 | 'email-settings' => esc_html__( 'Email Settings', 'give' ), |
| 204 | 'contact' => esc_html__( 'Contact Information', 'give' ), |
| 205 | ); |
| 206 | |
| 207 | return apply_filters( 'give_get_sections_' . $this->id, $sections ); |
| 208 | } |
| 209 | |
| 210 | /** |
| 211 | * Render email_notification field type |
| 212 | * |
| 213 | * @since 2.0 |
| 214 | * @access public |
| 215 | */ |
| 216 | public function email_notification_setting() { |
| 217 | // Load email notification table. |
| 218 | require_once GIVE_PLUGIN_DIR . 'includes/admin/emails/class-email-notification-table.php'; |
| 219 | |
| 220 | // Init table. |
| 221 | $email_notifications_table = new Give_Email_Notification_Table(); |
| 222 | |
| 223 | // Print table. |
| 224 | $email_notifications_table->prepare_items(); |
| 225 | $email_notifications_table->display(); |
| 226 | } |
| 227 | |
| 228 | /** |
| 229 | * Output the settings. |
| 230 | * |
| 231 | * Note: if you want to overwrite this function then manage show/hide save button in your class. |
| 232 | * |
| 233 | * @since 1.8 |
| 234 | * @return void |
| 235 | */ |
| 236 | public function output() { |
| 237 | if ( $this->enable_save ) { |
| 238 | $GLOBALS['give_hide_save_button'] = apply_filters( 'give_hide_save_button_on_email_admin_setting_page', false ); |
| 239 | } |
| 240 | |
| 241 | $settings = $this->get_settings(); |
| 242 | |
| 243 | Give_Admin_Settings::output_fields( $settings, 'give_settings' ); |
| 244 | } |
| 245 | } |
| 246 | |
| 247 | endif; |
| 248 | |
| 249 | return new Give_Settings_Email(); |
| 250 |