class-email-access-email.php — GiveWP – Donation Plugin and Fundraising Platform 2.1.5

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

give / includes / admin / emails Last commit date

class-email-access-email.php

307 lines

1	<?php
2	/**
3	* Email access notification
4	*
5	*
6	* @package Give
7	* @subpackage Classes/Emails
8	* @copyright Copyright (c) 2016, WordImpress
9	* @license https://opensource.org/licenses/gpl-license GNU Public License
10	* @since 2.0
11	*/
12
13	// Exit if access directly.
14	if ( ! defined( 'ABSPATH' ) ) {
15	exit;
16	}
17
18	if ( ! class_exists( 'Give_Email_Access_Email' ) ) :
19
20	/**
21	* Give_Email_Access_Email
22	*
23	* @abstract
24	* @since 2.0
25	*/
26	class Give_Email_Access_Email extends Give_Email_Notification {
27	/**
28	* Create a class instance.
29	*
30	* @access public
31	* @since 2.0
32	*/
33	public function init() {
34	$this->load( array(
35	'id' => 'email-access',
36	'label' => __( 'Email access', 'give' ),
37	'description' => __( 'Sent when donors request access to their donation history using only their email as verification. (See Settings > General > Access Control)', 'give' ),
38	'notification_status' => give_get_option( 'email_access', 'disabled' ),
39	'form_metabox_setting' => false,
40	'notification_status_editable' => false,
41	'email_tag_context' => 'donor',
42	'recipient_group_name' => __( 'Donor', 'give' ),
43	'default_email_subject' => sprintf( __( 'Please confirm your email for %s', 'give' ), get_bloginfo( 'url' ) ),
44	'default_email_message' => $this->get_default_email_message(),
45	'default_email_header' => __( 'Confirm Email', 'give' ),
46	'notices' => array(
47	'non-notification-status-editable' => sprintf(
48	'%1$s <a href="%2$s">%3$s »</a>',
49	__( 'This notification is automatically toggled based on whether the email access is enabled or not.', 'give' ),
50	esc_url( admin_url('edit.php?post_type=give_forms&page=give-settings&tab=general&section=access-control') ),
51	__( 'Edit Setting', 'give' )
52	)
53	),
54	) );
55
56	add_filter( "give_{$this->config['id']}_email_notification", array( $this, 'setup_email_notification' ), 10, 2 );
57	add_action( 'give_save_settings_give_settings', array( $this, 'set_notification_status' ), 10, 2 );
58	add_filter( 'give_email_preview_header', array( $this, 'email_preview_header' ), 10, 2 );
59	}
60
61	/**
62	* Get email subject.
63	*
64	* @since 2.0
65	* @access public
66	*
67	* @param int $form_id
68	*
69	* @return string
70	*/
71	public function get_email_subject( $form_id = null ) {
72	$subject = wp_strip_all_tags(
73	Give_Email_Notification_Util::get_value(
74	$this,
75	Give_Email_Setting_Field::get_prefix( $this, $form_id ) . 'email_subject',
76	$form_id,
77	$this->config['default_email_subject']
78	)
79	);
80
81	/**
82	* Filters the donation notification subject.
83	* Note: This filter will deprecate soon.
84	*
85	* @since 1.0
86	*/
87	$subject = apply_filters( 'give_email_access_token_subject', $subject );
88
89	/**
90	* Filters the donation notification subject.
91	*
92	* @since 2.0
93	*/
94	$subject = apply_filters( "give_{$this->config['id']}_get_email_subject", $subject, $this, $form_id );
95
96	return $subject;
97	}
98
99
100	/**
101	* Get email attachment.
102	*
103	* @since 2.0
104	* @access public
105	*
106	* @param int $form_id
107	*
108	* @return string
109	*/
110	public function get_email_message( $form_id = null ) {
111	$message = Give_Email_Notification_Util::get_value(
112	$this,
113	Give_Email_Setting_Field::get_prefix( $this, $form_id ) . 'email_message',
114	$form_id,
115	$this->config['default_email_message']
116	);
117
118	/**
119	* Filter the email message
120	* Note: This filter will deprecate soon.
121	*
122	* @since 1.0
123	*/
124	$message = apply_filters( 'give_email_access_token_message', $message );
125
126	/**
127	* Filter the email message
128	*
129	* @since 2.0
130	*/
131	$message = apply_filters( "give_{$this->config['id']}_get_default_email_message", $message, $this, $form_id );
132
133	return $message;
134	}
135
136
137	/**
138	* Get email attachment.
139	*
140	* @since 2.0
141	* @access public
142	*
143	* @param int $form_id
144	* @return array
145	*/
146	public function get_email_attachments( $form_id = null ) {
147	/**
148	* Filters the donation notification email attachments.
149	* By default, there is no attachment but plugins can hook in to provide one more multiple.
150	* Note: This filter will deprecate soon.
151	*
152	* @since 1.0
153	*/
154	$attachments = apply_filters( 'give_admin_donation_notification_attachments', array() );
155
156	/**
157	* Filters the donation notification email attachments.
158	* By default, there is no attachment but plugins can hook in to provide one more multiple.
159	*
160	* @since 2.0
161	*/
162	$attachments = apply_filters( "give_{$this->config['id']}_get_email_attachments", $attachments, $this, $form_id );
163
164	return $attachments;
165	}
166
167
168	/**
169	* Get default email message.
170	*
171	* @since 2.0
172	* @access public
173	*
174	* @return string
175	*/
176	public function get_default_email_message() {
177	$message = sprintf(
178	__( 'Please click the link to access your donation history on <a target="_blank" href="%1$s">%1$s</a>. If you did not request this email, please contact <a href="mailto:%2$s">%2$s</a>.', 'give' ),
179	get_bloginfo( 'url' ),
180	get_bloginfo( 'admin_email' )
181	) . "\n\n";
182	$message .= '{email_access_link}' . "\n\n";
183	$message .= "\n\n";
184	$message .= __( 'Sincerely,', 'give' ) . "\n";
185	$message .= get_bloginfo( 'name' ) . "\n";
186
187	/**
188	* Filter the new donation email message
189	*
190	* @since 2.0
191	*
192	* @param string $message
193	*/
194	return apply_filters( "give_{$this->config['id']}_get_default_email_message", $message, $this );
195	}
196
197
198	/**
199	* Set email data
200	*
201	* @since 2.0
202	*/
203	public function setup_email_data() {
204	/**
205	* Filters the from name.
206	* Note: This filter will deprecate soon.
207	*
208	* @since 1.0
209	*/
210	$from_name = apply_filters( 'give_donation_from_name', Give()->emails->get_from_name() );
211
212	/**
213	* Filters the from email.
214	* Note: This filter will deprecate soon.
215	*
216	* @since 1.0
217	*/
218	$from_email = apply_filters( 'give_donation_from_address', Give()->emails->get_from_address() );
219
220	Give()->emails->__set( 'from_name', $from_name );
221	Give()->emails->__set( 'from_email', $from_email );
222	Give()->emails->__set( 'heading', apply_filters( 'give_email_access_token_heading', $this->get_email_header() ) );
223	/**
224	* Filters the donation notification email headers.
225	*
226	* @since 1.0
227	*/
228	$headers = apply_filters( 'give_admin_donation_notification_headers', Give()->emails->get_headers() );
229
230	Give()->emails->__set( 'headers', $headers );
231	}
232
233	/**
234	* Setup email notification.
235	*
236	* @param int $donor_id Donor ID.
237	* @param string $email Donor Email.
238	*
239	* @since 2.0
240	* @access public
241	*
242	* @return bool
243	*/
244	public function setup_email_notification( $donor_id, $email ) {
245	$donor = Give()->donors->get_donor_by( 'email', $email );
246	$this->recipient_email = $email;
247
248	// Set email data.
249	$this->setup_email_data();
250
251	// Send email.
252	return $this->send_email_notification(
253	array(
254	'donor_id' => $donor_id,
255	'user_id' => $donor->user_id
256	)
257	);
258	}
259
260
261	/**
262	* Set notification status
263	*
264	* @since 2.0
265	* @access public
266	*
267	* @param $update_options
268	* @param $option_name
269	*/
270	public function set_notification_status( $update_options, $option_name ) {
271	// Get updated settings.
272	$update_options = give_get_settings();
273
274	if (
275	! empty( $update_options['email_access'] )
276	&& ! empty( $update_options[ "{$this->config['id']}_notification" ] )
277	&& $update_options['email_access'] !== $update_options[ "{$this->config['id']}_notification" ]
278	) {
279	$update_options[ "{$this->config['id']}_notification" ] = $update_options['email_access'];
280	update_option( $option_name, $update_options );
281	}
282	}
283
284
285	/**
286	* email preview header.
287	*
288	* @since 2.0
289	* @access public
290	*
291	* @param string $email_preview_header
292	* @param Give_Email_Access_Email $email
293	* @return string
294	*/
295	public function email_preview_header( $email_preview_header, $email ) {
296	if( $this->config['id'] === $email->config['id'] ) {
297	$email_preview_header = '';
298	}
299
300	return $email_preview_header;
301	}
302	}
303
304	endif; // End class_exists check
305
306	return Give_Email_Access_Email::get_instance();
307