give / includes / admin / settings / class-settings-email.php

class-settings-email.php in GiveWP – Donation Plugin and Fundraising Platform 2.12.0, at includes/admin/settings/class-settings-email.php

250 lines 7.4 KB

Raw Download Zip

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