class-evf-emails.php — Everest Forms – Contact Form, Payment Form, Quiz, Survey & Custom Form Builder with AI 3.0.6

everest-forms / includes / class-evf-emails.php

everest-forms / includes Last commit date

class-evf-emails.php

671 lines

1	<?php
2	/**
3	* This class handles all (notification) emails sent by Everest Forms.
4	*
5	* Heavily influenced by the great AffiliateWP plugin by Pippin Williamson.
6	* https://github.com/AffiliateWP/AffiliateWP/blob/master/includes/emails/class-affwp-emails.php
7	*
8	* @package EverestForms\Classes\Emails
9	* @version 1.2.0
10	* @since 1.0.0
11	*/
12
13	defined( 'ABSPATH' ) \|\| exit;
14
15	/**
16	* Email class.
17	*/
18	class EVF_Emails {
19
20	/**
21	* Holds the from address.
22	*
23	* @var string
24	*/
25	private $from_address;
26
27	/**
28	* Holds the from name.
29	*
30	* @var string
31	*/
32	private $from_name;
33
34	/**
35	* Holds the reply-to address.
36	*
37	* @var string
38	*/
39	private $reply_to = false;
40
41	/**
42	* Holds the carbon copy addresses.
43	*
44	* @var string
45	*/
46	private $cc = false;
47
48	/**
49	* Holds the blind carbon copy addresses.
50	*
51	* @var string
52	*/
53	private $bcc = false;
54
55	/**
56	* Holds the email content type.
57	*
58	* @var string
59	*/
60	private $content_type;
61
62	/**
63	* Holds the email headers.
64	*
65	* @var string
66	*/
67	private $headers;
68
69	/**
70	* Holds the email attachments.
71	*
72	* @var string
73	*/
74	public $attachments = '';
75
76	/**
77	* Whether to send email in HTML.
78	*
79	* @var bool
80	*/
81	private $html = true;
82
83	/**
84	* The email template to use.
85	*
86	* @var string
87	*/
88	private $template;
89
90	/**
91	* Form data.
92	*
93	* @var array
94	*/
95	public $form_data = array();
96
97	/**
98	* Fields, formatted, and sanitized.
99	*
100	* @var array
101	*/
102	public $fields = array();
103
104	/**
105	* Entry ID.
106	*
107	* @var int
108	*/
109	public $entry_id = '';
110
111	/**
112	* Constructor.
113	*/
114	public function __construct() {
115	if ( 'none' === $this->get_template() ) {
116	$this->html = false;
117	}
118
119	// Hooks.
120	add_action( 'everest_forms_email_send_before', array( $this, 'send_before' ) );
121	add_action( 'everest_forms_email_send_after', array( $this, 'send_after' ) );
122	}
123
124	/**
125	* Set a property.
126	*
127	* @param string $key Object property key.
128	* @param mixed $value Object property value.
129	*/
130	public function __set( $key, $value ) {
131	$this->$key = $value;
132	}
133
134	/**
135	* Get the email from name.
136	*
137	* @return string The email from name.
138	*/
139	public function get_from_name() {
140	if ( ! empty( $this->from_name ) ) {
141	$this->from_name = $this->process_tag( $this->from_name );
142	} else {
143	$this->from_name = get_bloginfo( 'name' );
144	}
145
146	return apply_filters( 'everest_forms_email_from_name', wp_specialchars_decode( $this->from_name ), $this );
147	}
148
149	/**
150	* Get the email from address.
151	*
152	* @return string The email from address.
153	*/
154	public function get_from_address() {
155	if ( ! empty( $this->from_address ) ) {
156	$this->from_address = $this->process_tag( $this->from_address );
157	} else {
158	$this->from_address = get_option( 'admin_email' );
159	}
160
161	return apply_filters( 'everest_forms_email_from_address', $this->from_address, $this );
162	}
163
164	/**
165	* Get the email reply-to.
166	*
167	* @return string The email reply-to address.
168	*/
169	public function get_reply_to() {
170	if ( ! empty( $this->reply_to ) ) {
171	$this->reply_to = $this->process_tag( $this->reply_to );
172
173	if ( ! is_email( $this->reply_to ) ) {
174	$this->reply_to = false;
175	}
176	}
177
178	return apply_filters( 'everest_forms_email_reply_to', $this->reply_to, $this );
179	}
180
181	/**
182	* Get the email carbon copy addresses.
183	*
184	* @return string The email carbon copy addresses.
185	*/
186	public function get_cc() {
187	if ( ! empty( $this->cc ) ) {
188	$this->cc = $this->process_tag( $this->cc );
189	$addresses = array_map( 'trim', explode( ',', $this->cc ) );
190
191	foreach ( $addresses as $key => $address ) {
192	if ( ! is_email( $address ) ) {
193	unset( $addresses[ $key ] );
194	}
195	}
196
197	$this->cc = implode( ',', $addresses );
198	}
199
200	return apply_filters( 'everest_forms_email_cc', $this->cc, $this );
201	}
202
203	/**
204	* Get the email blind carbon copy addresses.
205	*
206	* @return string The email blind carbon copy addresses.
207	*/
208	public function get_bcc() {
209	if ( ! empty( $this->bcc ) ) {
210	$this->bcc = $this->process_tag( $this->bcc );
211	$addresses = array_map( 'trim', explode( ',', $this->bcc ) );
212
213	foreach ( $addresses as $key => $address ) {
214	if ( ! is_email( $address ) ) {
215	unset( $addresses[ $key ] );
216	}
217	}
218
219	$this->bcc = implode( ',', $addresses );
220	}
221
222	return apply_filters( 'everest_forms_email_bcc', $this->bcc, $this );
223	}
224
225	/**
226	* Get the email content type.
227	*
228	* @return string The email content type.
229	*/
230	public function get_content_type() {
231	if ( ! $this->content_type && $this->html ) {
232	$this->content_type = apply_filters( 'everest_forms_email_default_content_type', 'text/html', $this );
233	} elseif ( ! $this->html ) {
234	$this->content_type = 'text/plain';
235	}
236
237	return apply_filters( 'everest_forms_email_content_type', $this->content_type, $this );
238	}
239
240	/**
241	* Get the email headers.
242	*
243	* @return string The email headers.
244	*/
245	public function get_headers() {
246	if ( ! $this->headers ) {
247	$this->headers = "From: {$this->get_from_name()} <{$this->get_from_address()}>\r\n";
248	if ( $this->get_reply_to() ) {
249	$this->headers .= "Reply-To: {$this->get_reply_to()}\r\n";
250	}
251	if ( $this->get_cc() ) {
252	$this->headers .= "Cc: {$this->get_cc()}\r\n";
253	}
254	if ( $this->get_bcc() ) {
255	$this->headers .= "Bcc: {$this->get_bcc()}\r\n";
256	}
257	$this->headers .= "Content-Type: {$this->get_content_type()}; charset=utf-8\r\n";
258	}
259
260	return apply_filters( 'everest_forms_email_headers', $this->headers, $this );
261	}
262
263	/**
264	* Build the email.
265	*
266	* @param string $message The email message.
267	* @return string
268	*/
269	public function build_email( $message ) {
270	if ( false === $this->html ) {
271	$message = $this->process_tag( $message, false, true );
272	$message = str_replace( '{all_fields}', $this->everest_forms_html_field_value( false ), $message );
273
274	return apply_filters( 'everest_forms_email_message', $message, $this );
275	}
276
277	ob_start();
278
279	if ( defined( 'DOING_CRON' ) ) {
280	evf_get_template( 'emails/summary-email-header-' . $this->get_template() . '.php' );
281
282	// Hooks into the summary email header.
283	do_action( 'everest_forms_summary_email_header', $this );
284
285	evf_get_template( 'emails/summary-email-body-' . $this->get_template() . '.php' );
286	// Hooks into the summary email body.
287	do_action( 'everest_forms_summary_email_body', $this );
288
289	evf_get_template( 'emails/summary-email-footer-' . $this->get_template() . '.php' );
290	// Hooks inot the summary email footer.
291	do_action( 'everest_forms_summary_email_footer', $this );
292	} else {
293	evf_get_template( 'emails/header-' . $this->get_template() . '.php' );
294
295	// Hooks into the email header.
296	do_action( 'everest_forms_email_header', $this );
297
298	evf_get_template( 'emails/body-' . $this->get_template() . '.php' );
299
300	// Hooks into the email body.
301	do_action( 'everest_forms_email_body', $this );
302
303	evf_get_template( 'emails/footer-' . $this->get_template() . '.php' );
304
305	// Hooks into the email footer.
306	do_action( 'everest_forms_email_footer', $this );
307	}
308
309	$message = $this->process_tag( $message, false );
310	$message = nl2br( $message );
311
312	$body = ob_get_clean();
313	$message = str_replace( '{email}', $message, $body );
314	$message = str_replace( '{all_fields}', $this->everest_forms_html_field_value( true ), $message );
315	$message = make_clickable( $message );
316
317	return apply_filters( 'everest_forms_email_message', $message, $this );
318	}
319
320	/**
321	* Send the email.
322	*
323	* @param string $to The To address.
324	* @param string $subject The subject line of the email.
325	* @param string $message The body of the email.
326	* @param array $attachments Attachments to the email.
327	* @param string $connection_id Connection ID of the email.
328	*
329	* @return bool
330	*/
331	public function send( $to, $subject, $message, $attachments = '', $connection_id = '' ) {
332	if ( ! did_action( 'init' ) && ! did_action( 'admin_init' ) ) {
333	evf_doing_it_wrong( __FUNCTION__, __( 'You cannot send emails with EVF_Emails until init/admin_init has been reached', 'everest-forms' ), null );
334	return false;
335	}
336
337	// Don't send anything if emails have been disabled.
338	if ( $this->is_email_disabled() ) {
339	return false;
340	}
341
342	// Don't send if email address is invalid.
343	if ( ! is_email( $to ) ) {
344	return false;
345	}
346
347	// Hooks before email is sent.
348	do_action( 'everest_forms_email_send_before', $this );
349
350	$message = apply_filters( 'everest_forms_entry_email__message', str_replace( '{entry_id}', absint( $this->entry_id ), $message ), $this );
351
352	// Email Template Enabled or not checked.
353	$email_template_included = ! empty( $this->form_data['settings']['email'][ $connection_id ]['choose_template'] ) ? true : false;
354	$save_and_continue_email_template_included = ! empty( $this->form_data['settings']['email']['connection_save_and_continue']['choose_template'] ) ? true : false;
355	$save_and_continue_enabled = ! empty( $this->form_data['settings']['email']['connection_save_and_continue']['enable_email_notification'] ) ? true : false;
356
357	if ( $email_template_included && true === $this->html ) {
358	$message = apply_filters( 'everest_forms_email_template_message', $message, $this, $connection_id );
359	} elseif ( ( $save_and_continue_email_template_included && true === $this->html ) && ( true === $save_and_continue_enabled ) ) {
360	$message = apply_filters( 'everest_forms_email_template_message', $message, $this, 'connection_save_and_continue' );
361	} else {
362	$message = $this->build_email( $message );
363	}
364	$this->attachments = apply_filters( 'everest_forms_email_attachments', $this->attachments, $this );
365	$subject = evf_decode_string( $this->process_tag( $subject ) );
366
367	// Let's do this.
368	$sent = wp_mail( $to, $subject, $message, $this->get_headers(), $this->attachments );
369
370	if ( ! $sent ) {
371	$error_message = apply_filters( 'everest_forms_email_send_failed_message', '' );
372	$failed_data = get_transient( 'everest_forms_mail_send_failed_count' );
373	$failed_count = $failed_data && isset( $failed_data['failed_count'] ) ? $failed_data['failed_count'] : 0;
374	++$failed_count;
375	set_transient(
376	'everest_forms_mail_send_failed_count',
377	array(
378	'failed_count' => $failed_count,
379	'error_message' => $error_message,
380	)
381	);
382	}
383	// Hooks after the email is sent.
384	do_action( 'everest_forms_email_send_after', $this );
385
386	return $sent;
387	}
388
389	/**
390	* Add filters/actions before the email is sent.
391	*/
392	public function send_before() {
393	add_filter( 'wp_mail_from', array( $this, 'get_from_address' ) );
394	add_filter( 'wp_mail_from_name', array( $this, 'get_from_name' ) );
395	add_filter( 'wp_mail_content_type', array( $this, 'get_content_type' ) );
396	}
397
398	/**
399	* Remove filters/actions after the email is sent.
400	*/
401	public function send_after() {
402	remove_filter( 'wp_mail_from', array( $this, 'get_from_address' ) );
403	remove_filter( 'wp_mail_from_name', array( $this, 'get_from_name' ) );
404	remove_filter( 'wp_mail_content_type', array( $this, 'get_content_type' ) );
405	}
406
407	/**
408	* Converts text formatted HTML. This is primarily for turning line breaks
409	* into <p> and <br/> tags.
410	*
411	* @param string $message Text to convert.
412	* @return string
413	*/
414	public function text_to_html( $message ) {
415	if ( 'text/html' === $this->content_type \|\| true === $this->html ) {
416	$message = wpautop( $message );
417	}
418
419	return $message;
420	}
421
422	/**
423	* Processes a smart tag.
424	*
425	* @param string $string String that may contain tags.
426	* @param bool $sanitize Toggle to maybe sanitize.
427	* @param bool $linebreaks Toggle to process linebreaks.
428	*
429	* @return string
430	*/
431	public function process_tag( $string = '', $sanitize = true, $linebreaks = false ) {
432	$tag = apply_filters( 'everest_forms_process_smart_tags', $string, $this->form_data, $this->fields, $this->entry_id );
433	$tag = evf_decode_string( $tag );
434
435	if ( $sanitize ) {
436	if ( $linebreaks ) {
437	$tag = evf_sanitize_textarea_field( $tag );
438	} else {
439	$tag = sanitize_text_field( $tag );
440	}
441	}
442
443	return $tag;
444	}
445
446	/**
447	* Process the all fields smart tag if present.
448	*
449	* @param bool $html Toggle to use HTML or plaintext.
450	* @return string
451	*/
452	public function everest_forms_html_field_value( $html = true ) {
453	if ( empty( $this->fields ) ) {
454	return '';
455	}
456
457	// Make sure we have an entry id.
458	if ( ! empty( $this->entry_id ) ) {
459	$this->form_data['entry_id'] = (int) $this->entry_id;
460	}
461
462	$message = '';
463
464	if ( $html ) {
465
466	/*
467	* HTML emails.
468	*/
469	ob_start();
470
471	// Hooks into the email field.
472	do_action( 'everest_forms_email_field', $this );
473
474	evf_get_template( 'emails/field-' . $this->get_template() . '.php' );
475
476	$field_template = ob_get_clean();
477	$empty_message = '<em>' . __( '(empty)', 'everest-forms' ) . '</em>';
478
479	$field_iterator = 1;
480	foreach ( $this->fields as $meta_id => $field ) {
481
482	if ( isset( $this->form_data['settings']['disabled_entries'] ) && '1' === $this->form_data['settings']['disabled_entries'] ) {
483	$types_to_remove = array( 'image-upload', 'file-upload', 'signature' );
484	if ( isset( $field['type'] ) && in_array( $field['type'], $types_to_remove, true ) ) {
485	continue;
486	}
487	}
488	if (
489	! apply_filters( 'everest_forms_email_display_empty_fields', false ) &&
490	( empty( $field['value'] ) && '0' !== $field['value'] )
491	) {
492	continue;
493	}
494
495	// If empty value is provided for select field, don't send email.
496	if ( 'select' === $field['type'] && empty( $field['value'][0] ) ) {
497	continue;
498	}
499
500	if ( ( 'radio' === $field['type'] && empty( $field['value']['label'] ) ) \|\| ( 'payment-multiple' === $field['type'] && empty( $field['value']['label'] ) ) ) {
501	continue;
502	}
503
504	if ( ( 'checkbox' === $field['type'] && empty( $field['value']['label'][0] ) ) \|\| ( 'payment-checkbox' === $field['type'] && empty( $field['value']['label'] ) ) ) {
505	continue;
506	}
507
508	// If there's the export data filter, utilize that and re-loop promptly.
509	if ( has_filter( "everest_forms_field_exporter_{$field['type']}" ) ) {
510	$formatted_string = apply_filters( "everest_forms_field_exporter_{$field['type']}", $field, 'email-html', 2 );
511	$formatted_string['value'] = false === $formatted_string['value'] ? $empty_message : $formatted_string['value'];
512
513	$field_item = $field_template;
514	if ( 1 === $field_iterator ) {
515	$field_item = str_replace( 'border-top:1px solid #dddddd;', '', $field_item );
516	}
517
518	// Inject the label and value into the email template.
519	$field_item = str_replace( '{field_name}', $formatted_string['label'], $field_item );
520	$field_item = str_replace( '{field_value}', $formatted_string['value'], $field_item );
521
522	$message .= wpautop( $field_item );
523
524	// For BW compatibility reasons.
525	++$field_iterator;
526	continue;
527	}
528
529	$field_val = empty( $field['value'] ) && '0' !== $field['value'] ? $empty_message : $field['value'];
530	$field_name = isset( $field_val['name'] ) ? $field_val['name'] : $field['name'];
531	$field_label = ! empty( $field_val['label'] ) ? $field_val['label'] : $field_val;
532	$field_type = $field['type'];
533
534	// If empty label is provided for choice field, don't store their data nor send email.
535	if ( in_array( $field_type, array( 'radio', 'payment-multiple' ), true ) ) {
536	if ( isset( $field_val['label'] ) && '' === $field_val['label'] ) {
537	continue;
538	}
539	} elseif ( in_array( $field_type, array( 'checkbox', 'payment-checkbox' ), true ) ) {
540	if ( isset( $field_val['label'] ) && ( empty( $field_val['label'] ) \|\| '' === current( $field_val['label'] ) ) ) {
541	continue;
542	}
543	}
544
545	if ( isset( $field['value'], $field['value_raw'] ) && is_string( $field['value'] ) && in_array( $field_type, array( 'image-upload', 'file-upload' ), true ) ) {
546	$field['value'] = $field;
547	}
548
549	if ( isset( $field_val['type'] ) && in_array( $field['type'], array( 'image-upload', 'file-upload', 'rating' ), true ) ) {
550	if ( 'rating' === $field_val['type'] ) {
551	$value = ! empty( $field_val['value'] ) ? $field_val['value'] : 0;
552	$number_of_stars = ! empty( $field_val['number_of_rating'] ) ? $field_val['number_of_rating'] : 5;
553	$field_val = $value . '/' . $number_of_stars;
554	} else {
555	$field_val = empty( $field_val['file_url'] ) ? $empty_message : $field_val;
556	}
557	}
558
559	if ( 'rating' !== $field_type ) {
560	if ( is_array( $field_label ) ) {
561	$field_html = array();
562	foreach ( $field_label as $meta_val ) {
563	$field_html[] = esc_html( $meta_val );
564	}
565	$field_val = implode( ', ', $field_html );
566	} else {
567	$field_val = esc_html( $field_label );
568	}
569	}
570
571	if ( empty( $field_name ) ) {
572	$field_name = sprintf(
573	/* translators: %d - field ID. */
574	esc_html__( 'Field ID #%d', 'everest-forms' ),
575	absint( $field['id'] )
576	);
577	}
578
579	$field_item = $field_template;
580	if ( 1 === $field_iterator ) {
581	$field_item = str_replace( 'border-top:1px solid #dddddd;', '', $field_item );
582	}
583
584	$field_item = str_replace( '{field_name}', $field_name, $field_item );
585	$field_value = apply_filters( 'everest_forms_html_field_value', evf_decode_string( $field_val ), $field['value'], $this->form_data, 'email-html', $field );
586	$field_item = str_replace( '{field_value}', $field_value, $field_item );
587
588	$message .= wpautop( $field_item );
589	++$field_iterator;
590	}
591	} else {
592	/*
593	* Plain Text emails.
594	*/
595	foreach ( $this->fields as $field ) {
596
597	if ( isset( $this->form_data['settings']['disabled_entries'] ) && '1' === $this->form_data['settings']['disabled_entries'] ) {
598	$types_to_remove = array( 'image-upload', 'file-upload', 'signature' );
599	if ( isset( $field['type'] ) && in_array( $field['type'], $types_to_remove, true ) ) {
600	continue;
601	}
602	}
603
604	if ( ! apply_filters( 'everest_forms_email_display_empty_fields', false ) && ( empty( $field['value'] ) && '0' !== $field['value'] ) ) {
605	continue;
606	}
607
608	$field_val = empty( $field['value'] ) && '0' !== $field['value'] ? esc_html__( '(empty)', 'everest-forms' ) : $field['value'];
609	$field_name = isset( $field['name'] ) ? $field['name'] : '';
610
611	if ( is_array( $field_val ) ) {
612	$field_html = array();
613
614	foreach ( $field_val as $meta_val ) {
615	$field_html[] = $meta_val;
616	}
617
618	if ( ! empty( $field_html ) && is_array( $field_html ) ) {
619	$field_val = implode( ', ', $field_html );
620	} else {
621	$field_val = '';
622	}
623	}
624
625	if ( empty( $field_name ) ) {
626	$field_name = sprintf(
627	/* translators: %d - field ID. */
628	esc_html__( 'Field ID #%d', 'everest-forms' ),
629	absint( $field['id'] )
630	);
631	}
632
633	$message .= '--- ' . evf_decode_string( $field_name ) . " ---\r\n\r\n";
634	$field_value = evf_decode_string( $field_val ) . "\r\n\r\n";
635	$message .= apply_filters( 'everest_forms_plaintext_field_value', $field_value, $field['value'], $this->form_data, 'email-plain' );
636	}
637	}
638
639	if ( empty( $message ) ) {
640	$empty_message = esc_html__( 'An empty form was submitted.', 'everest-forms' );
641	$message = $html ? wpautop( $empty_message ) : $empty_message;
642	}
643
644	return $message;
645	}
646
647	/**
648	* Email kill switch if needed.
649	*
650	* @return bool
651	*/
652	public function is_email_disabled() {
653	return (bool) apply_filters( 'everest_forms_disable_all_emails', false, $this );
654	}
655
656	/**
657	* Get the enabled email template.
658	*
659	* @todo Email template.
660	*
661	* @return string When filtering return 'none' to switch to text/plain email.
662	*/
663	public function get_template() {
664	if ( ! $this->template ) {
665	$this->template = get_option( 'everest_forms_email_template', 'default' );
666	}
667
668	return apply_filters( 'everest_forms_email_template', $this->template );
669	}
670	}
671