class-email-notifications.php — GiveWP – Donation Plugin and Fundraising Platform 2.0.7

give / includes / admin / emails / class-email-notifications.php

give / includes / admin / emails Last commit date

class-email-notifications.php

448 lines

1	<?php
2	/**
3	* Email Notification
4	*
5	* This class handles all email notification settings.
6	*
7	* @package Give
8	* @subpackage Classes/Emails
9	* @copyright Copyright (c) 2016, WordImpress
10	* @license https://opensource.org/licenses/gpl-license GNU Public License
11	* @since 2.0
12	*/
13
14	/**
15	* Class Give_Email_Notifications
16	*/
17	class Give_Email_Notifications {
18	/**
19	* Instance.
20	*
21	* @since 2.0
22	* @access static
23	* @var
24	*/
25	static private $instance;
26
27	/**
28	* Array of email notifications.
29	*
30	* @since 2.0
31	* @access private
32	* @var array
33	*/
34	private $emails = array();
35
36	/**
37	* Singleton pattern.
38	*
39	* @since 2.0
40	* @access private
41	* Give_Payumoney_API constructor.
42	*/
43	private function __construct() {
44	}
45
46
47	/**
48	* Get instance.
49	*
50	* @since 2.0
51	* @access static
52	* @return static
53	*/
54	static function get_instance() {
55	if ( null === static::$instance ) {
56	self::$instance = new static();
57	}
58
59	return self::$instance;
60	}
61
62	/**
63	* Setup dependencies
64	*
65	* @since 2.0
66	*/
67	public function init() {
68	// Load files.
69	require_once GIVE_PLUGIN_DIR . 'includes/admin/emails/ajax-handler.php';
70	require_once GIVE_PLUGIN_DIR . 'includes/admin/emails/class-email-setting-field.php';
71	require_once GIVE_PLUGIN_DIR . 'includes/admin/emails/filters.php';
72
73	// Load email notifications.
74	$this->add_emails_notifications();
75
76	add_filter( 'give_metabox_form_data_settings', array( $this, 'add_metabox_setting_fields' ), 10, 2 );
77	add_action( 'init', array( $this, 'preview_email' ) );
78	add_action( 'init', array( $this, 'send_preview_email' ) );
79	add_action( 'init', array( $this, 'validate_settings' ) );
80
81	/* @var Give_Email_Notification $email */
82	foreach ( $this->get_email_notifications() as $email ) {
83	// Setup email section.
84	if( Give_Email_Notification_Util::is_show_on_emails_setting_page( $email ) ) {
85	add_filter( 'give_get_sections_emails', array( $email, 'add_section' ) );
86	add_filter( "give_hide_section_{$email->config['id']}_on_emails_page", array( $email, 'hide_section' ) );
87	}
88
89	// Setup email preview.
90	if ( Give_Email_Notification_Util::is_email_preview_has_header( $email ) ) {
91	add_action( "give_{$email->config['id']}_email_preview", array( $this, 'email_preview_header' ) );
92	add_filter( "give_{$email->config['id']}_email_preview_data", array( $this, 'email_preview_data' ) );
93	add_filter( "give_{$email->config['id']}_email_preview_message", array( $this, 'email_preview_message' ), 1, 2 );
94	}
95	}
96	}
97
98
99	/**
100	* Add setting to metabox.
101	*
102	* @since 2.0
103	* @access public
104	*
105	* @param array $settings
106	* @param int $post_id
107	*
108	* @return array
109	*/
110	public function add_metabox_setting_fields( $settings, $post_id ) {
111	$emails = $this->get_email_notifications();
112
113	// Bailout.
114	if ( empty( $emails ) ) {
115	return $settings;
116	}
117
118	// Email notification setting.
119	$settings['email_notification_options'] = array(
120	'id' => 'email_notification_options',
121	'title' => __( 'Email Notifications', 'give' ),
122	'icon-html' => '<span class="dashicons dashicons-email-alt"></span>',
123	'fields' => array(
124	array(
125	'name' => __( 'Email Options', 'give' ),
126	'description' => __( '', 'give' ),
127	'id' => '_give_email_options',
128	'type' => 'radio_inline',
129	'default' => 'global',
130	'options' => array(
131	'global' => __( 'Global Options' ),
132	'enabled' => __( 'Customize', 'give' ),
133	),
134	),
135	array(
136	'id' => '_give_email_template',
137	'name' => esc_html__( 'Email Template', 'give' ),
138	'desc' => esc_html__( 'Choose your template from the available registered template types.', 'give' ),
139	'type' => 'select',
140	'default' => 'default',
141	'options' => give_get_email_templates(),
142	),
143	array(
144	'id' => '_give_email_logo',
145	'name' => esc_html__( 'Logo', 'give' ),
146	'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' ),
147	'type' => 'file',
148	),
149	array(
150	'id' => '_give_from_name',
151	'name' => esc_html__( 'From Name', 'give' ),
152	'desc' => esc_html__( 'The name which appears in the "From" field in all Give donation emails.', 'give' ),
153	'default' => get_bloginfo( 'name' ),
154	'type' => 'text',
155	),
156	array(
157	'id' => '_give_from_email',
158	'name' => esc_html__( 'From Email', 'give' ),
159	'desc' => esc_html__( 'Email address from which all Give emails are sent from. This will act as the "from" and "reply-to" email address.', 'give' ),
160	'default' => get_bloginfo( 'admin_email' ),
161	'type' => 'text',
162	),
163	array(
164	'name' => 'email_notification_docs',
165	'type' => 'docs_link',
166	'url' => 'http://docs.givewp.com/email-notification',
167	'title' => __( 'Email Notification', 'give' ),
168	),
169	),
170
171	/**
172	* Filter the email notification settings.
173	*
174	* @since 2.0
175	*/
176	'sub-fields' => apply_filters( 'give_email_notification_options_metabox_fields', array(), $post_id ),
177	);
178
179	return $settings;
180	}
181
182	/**
183	* Add email notifications
184	*
185	* @since 2.0
186	* @access private
187	*/
188	private function add_emails_notifications() {
189	$this->emails = array(
190	include GIVE_PLUGIN_DIR . 'includes/admin/emails/class-new-donation-email.php',
191	include GIVE_PLUGIN_DIR . 'includes/admin/emails/class-donation-receipt-email.php',
192	include GIVE_PLUGIN_DIR . 'includes/admin/emails/class-new-offline-donation-email.php',
193	include GIVE_PLUGIN_DIR . 'includes/admin/emails/class-offline-donation-instruction-email.php',
194	include GIVE_PLUGIN_DIR . 'includes/admin/emails/class-new-donor-register-email.php',
195	include GIVE_PLUGIN_DIR . 'includes/admin/emails/class-donor-register-email.php',
196	include GIVE_PLUGIN_DIR . 'includes/admin/emails/class-email-access-email.php',
197	);
198
199	/**
200	* Filter the email notifications.
201	*
202	* @since 2.0
203	*/
204	$this->emails = apply_filters( 'give_email_notifications', $this->emails, $this );
205
206	// Bailout.
207	if ( empty( $this->emails ) ) {
208	return;
209	}
210
211	// Initiate email notifications.
212	foreach ( $this->emails as $email ) {
213	$email->init();
214	}
215	}
216
217
218	/**
219	* Get list of email notifications.
220	*
221	* @since 2.0
222	* @access public
223	* @return array
224	*/
225	public function get_email_notifications() {
226	return $this->emails;
227	}
228
229
230	/**
231	* Displays the email preview
232	*
233	* @since 2.0
234	* @access public
235	* @return bool\|null
236	*/
237	public function preview_email() {
238	// Bailout.
239	if ( ! Give_Email_Notification_Util::can_preview_email() ) {
240	return false;
241	}
242
243	// Security check.
244	give_validate_nonce( $_GET['_wpnonce'], 'give-preview-email' );
245
246	// Get email type.
247	$email_type = isset( $_GET['email_type'] ) ? esc_attr( $_GET['email_type'] ) : '';
248
249	/* @var Give_Email_Notification $email */
250	foreach ( $this->get_email_notifications() as $email ) {
251	if ( $email_type !== $email->config['id'] ) {
252	continue;
253	}
254
255	// Set form id.
256	$form_id = empty( $_GET['form_id'] ) ? null : absint( $_GET['form_id'] );
257
258	// Call setup email data to apply filter and other thing to email.
259	$email->setup_email_data();
260
261	// Decode message.
262	$email_message = $email->preview_email_template_tags( $email->get_email_message( $form_id ) );
263
264	// Set email template.
265	Give()->emails->html = true;
266	Give()->emails->__set( 'template', $email->get_email_template( $form_id ) );
267
268	if ( 'text/plain' === $email->config['content_type'] ) {
269	// Give()->emails->__set( 'html', false );
270	Give()->emails->__set( 'template', 'none' );
271	}
272
273	if ( $email_message = Give()->emails->build_email( $email_message ) ) {
274
275	/**
276	* Filter the email preview data
277	*
278	* @since 2.0
279	*
280	* @param array
281	*/
282	$email_preview_data = apply_filters( "give_{$email_type}_email_preview_data", array() );
283
284	/**
285	* Fire the give_{$email_type}_email_preview action
286	*
287	* @since 2.0
288	*/
289	do_action( "give_{$email_type}_email_preview", $email );
290
291	/**
292	* Filter the email message
293	*
294	* @since 2.0
295	*
296	* @param string $email_message
297	* @param array $email_preview_data
298	* @param Give_Email_Notification $email
299	*/
300	echo apply_filters( "give_{$email_type}_email_preview_message", $email_message, $email_preview_data, $email );
301
302	exit();
303	}
304	}// End foreach().
305	}
306
307
308	/**
309	* Add header to donation receipt email preview
310	*
311	* @since 2.0
312	* @access public
313	*
314	* @param Give_Email_Notification $email
315	*/
316	public function email_preview_header( $email ) {
317	/**
318	* Filter the all email preview headers.
319	*
320	* @since 2.0
321	*
322	* @param Give_Email_Notification $email
323	*/
324	$email_preview_header = apply_filters( 'give_email_preview_header', give_get_preview_email_header(), $email );
325
326	echo $email_preview_header;
327	}
328
329	/**
330	* Add email preview data
331	*
332	* @since 2.0
333	* @access public
334	*
335	* @param array $email_preview_data
336	*
337	* @return array
338	*/
339	public function email_preview_data( $email_preview_data ) {
340	$email_preview_data['payment_id'] = absint( give_check_variable( give_clean( $_GET ), 'isset', 0, 'preview_id' ) );
341	$email_preview_data['user_id'] = absint( give_check_variable( give_clean( $_GET ), 'isset', 0, 'user_id' ) );
342
343	return $email_preview_data;
344	}
345
346	/**
347	* Replace email template tags.
348	*
349	* @since 2.0
350	* @access public
351	*
352	* @param string $email_message
353	* @param array $email_preview_data
354	*
355	* @return string
356	*/
357	public function email_preview_message( $email_message, $email_preview_data ) {
358	if (
359	! empty( $email_preview_data['payment_id'] )
360	\|\| ! empty( $email_preview_data['user_id'] )
361	) {
362	$email_message = give_do_email_tags( $email_message, $email_preview_data );
363	}
364
365	return $email_message;
366	}
367
368	/**
369	* Displays the email preview
370	*
371	* @since 2.0
372	* @access public
373	* @return bool\|null
374	*/
375	public function send_preview_email() {
376	// Bailout.
377	if ( ! Give_Email_Notification_Util::can_send_preview_email() ) {
378	return false;
379	}
380
381	// Security check.
382	give_validate_nonce( $_GET['_wpnonce'], 'give-send-preview-email' );
383
384	// Get email type.
385	$email_type = give_check_variable( give_clean( $_GET ), 'isset', '', 'email_type' );
386
387	/* @var Give_Email_Notification $email */
388	foreach ( $this->get_email_notifications() as $email ) {
389	if ( $email_type === $email->config['id'] && Give_Email_Notification_Util::is_email_preview( $email ) ) {
390	$email->send_preview_email();
391	break;
392	}
393	}
394
395	// Remove the test email query arg.
396	wp_redirect( remove_query_arg( 'give_action' ) );
397	exit;
398	}
399
400
401	/**
402	* Load Give_Email_Notifications
403	*
404	* @since 2.0
405	* @access public
406	*/
407	public function load() {
408	add_action( 'init', array( $this, 'init' ), -1 );
409	}
410
411
412	/**
413	* Verify email setting before saving
414	*
415	* @since 2.0
416	* @access public
417	*/
418	public function validate_settings() {
419	// Bailout.
420	if (
421	! Give_Admin_Settings::is_saving_settings() \|\|
422	'emails' !== give_get_current_setting_tab() \|\|
423	! isset( $_GET['section'] )
424	) {
425	return;
426	}
427
428	// Get email type.
429	$email_type = give_get_current_setting_section();
430
431	if ( ! empty( $_POST["{$email_type}_recipient"] ) ) {
432	$_POST["{$email_type}_recipient"] = array_unique( array_filter( $_POST["{$email_type}_recipient"] ) );
433	}
434	}
435	}
436
437	// Helper class.
438	require_once GIVE_PLUGIN_DIR . 'includes/admin/emails/abstract-email-notification.php';
439	require_once GIVE_PLUGIN_DIR . 'includes/admin/emails/class-email-notification-util.php';
440
441	// Add backward compatibility.
442	require_once GIVE_PLUGIN_DIR . 'includes/admin/emails/backward-compatibility.php';
443
444	/**
445	* Initialize functionality.
446	*/
447	Give_Email_Notifications::get_instance()->load();
448