Test Failed
Push — issues/370 ( 90279e )
by Ravinder
05:35
created

functions.php ➔ give_email_donation_receipt()   A

Complexity

Conditions 3
Paths 2

Size

Total Lines 23
Code Lines 5

Duplication

Lines 0
Ratio 0 %

Importance

Changes 0
Metric Value
cc 3
eloc 5
nc 2
nop 2
dl 0
loc 23
rs 9.0856
c 0
b 0
f 0
1
<?php
2
/**
3
 * Email Functions
4
 *
5
 * @package     Give
6
 * @subpackage  Emails
7
 * @copyright   Copyright (c) 2016, WordImpress
8
 * @license     https://opensource.org/licenses/gpl-license GNU Public License
9
 * @since       1.0
10
 */
11
12
// Exit if accessed directly.
13
if ( ! defined( 'ABSPATH' ) ) {
14
	exit;
15
}
16
17
/**
18
 * Email Donation Receipt.
19
 *
20
 * Email the donation confirmation to the donor via the customizable "Donation Receipt" settings.
21
 *
22
 * @since 1.0
23
 *
24
 * @param int  $payment_id   Payment ID.
25
 * @param bool $admin_notice Whether to send the admin email notification or not (default: true).
26
 *
27
 * @return void
28
 */
29
function give_email_donation_receipt( $payment_id, $admin_notice = true ) {
30
	$payment = new Give_Payment( $payment_id );
31
32
	/**
33
	 * Fire the action
34
	 */
35
	do_action( 'give_donation-receipt_email_notification', $payment_id );
36
37
	// If admin notifications are on, send the admin notice.
38
	if ( $admin_notice && ! give_admin_notices_disabled( $payment_id ) ) {
39
		/**
40
		 * Fires in the donation email receipt.
41
		 *
42
		 * When admin email notices are not disabled, you can add new email notices.
43
		 *
44
		 * @since 1.0
45
		 *
46
		 * @param int   $payment_id   Payment id.
47
		 * @param mixed $payment_data Payment meta data.
48
		 */
49
		do_action( 'give_new-donation_email_notification', $payment_id, $payment->payment_meta );
50
	}
51
}
52
53
/**
54
 * Sends the Admin Sale Notification Email
55
 *
56
 * @since 1.0
57
 *
58
 * @param int $payment_id Payment ID (default: 0)
59
 *
60
 * @return void
61
 */
62
function give_admin_email_notice( $payment_id ) {
63
	/**
64
	 * Fires in the donation email receipt.
65
	 *
66
	 * When admin email notices are not disabled, you can add new email notices.
67
	 *
68
	 * @since 1.0
69
	 *
70
	 * @param int   $payment_id   Payment id.
71
	 * @param mixed $payment_data Payment meta data.
72
	 */
73
	do_action( 'give_new-donation_email_notification', $payment_id );
74
}
75
76
add_action( 'give_admin_donation_email', 'give_admin_email_notice' );
77
78
79
/**
80
 * Get default donation notification email text
81
 *
82
 * Returns the stored email text if available, the standard email text if not
83
 *
84
 * @since  1.0
85
 * @return string $message
86
 */
87
function give_get_default_donation_notification_email() {
88
89
	$default_email_body = esc_html__( 'Hi there,', 'give' ) . "\n\n";
90
	$default_email_body .= esc_html__( 'This email is to inform you that a new donation has been made on your website:', 'give' ) . ' <a href="' . get_bloginfo( 'url' ) . '" target="_blank">' . get_bloginfo( 'url' ) . '</a>' . ".\n\n";
91
	$default_email_body .= '<strong>' . esc_html__( 'Donor:', 'give' ) . '</strong> {name}' . "\n";
92
	$default_email_body .= '<strong>' . esc_html__( 'Donation:', 'give' ) . '</strong> {donation}' . "\n";
93
	$default_email_body .= '<strong>' . esc_html__( 'Amount:', 'give' ) . '</strong> {amount}' . "\n";
94
	$default_email_body .= '<strong>' . esc_html__( 'Payment Method:', 'give' ) . '</strong> {payment_method}' . "\n\n";
95
	$default_email_body .= esc_html__( 'Thank you,', 'give' ) . "\n\n";
96
	$default_email_body .= '{sitename}' . "\n";
97
98
	return apply_filters( 'give_default_donation_notification_email', $default_email_body );
99
}
100
101
102
/**
103
 * Get default donation receipt email text
104
 *
105
 * Returns the stored email text if available, the standard email text if not
106
 *
107
 * @since  1.3.7
108
 * @return string $message
109
 */
110
function give_get_default_donation_receipt_email() {
111
112
	$default_email_body = esc_html__( 'Dear', 'give' ) . " {name},\n\n";
113
	$default_email_body .= esc_html__( 'Thank you for your donation. Your generosity is appreciated! Here are the details of your donation:', 'give' ) . "\n\n";
114
	$default_email_body .= '<strong>' . esc_html__( 'Donor:', 'give' ) . '</strong> {fullname}' . "\n";
115
	$default_email_body .= '<strong>' . esc_html__( 'Donation:', 'give' ) . '</strong> {donation}' . "\n";
116
	$default_email_body .= '<strong>' . esc_html__( 'Donation Date:', 'give' ) . '</strong> {date}' . "\n";
117
	$default_email_body .= '<strong>' . esc_html__( 'Amount:', 'give' ) . '</strong> {amount}' . "\n";
118
	$default_email_body .= '<strong>' . esc_html__( 'Payment Method:', 'give' ) . '</strong> {payment_method}' . "\n";
119
	$default_email_body .= '<strong>' . esc_html__( 'Payment ID:', 'give' ) . '</strong> {payment_id}' . "\n";
120
	$default_email_body .= '<strong>' . esc_html__( 'Receipt ID:', 'give' ) . '</strong> {receipt_id}' . "\n\n";
121
	$default_email_body .= '{receipt_link}' . "\n\n";
122
	$default_email_body .= "\n\n";
123
	$default_email_body .= esc_html__( 'Sincerely,', 'give' ) . "\n";
124
	$default_email_body .= '{sitename}' . "\n";
125
126
	return apply_filters( 'give_default_donation_receipt_email', $default_email_body );
127
}
128
129
/**
130
 * Get various correctly formatted names used in emails
131
 *
132
 * @since 1.0
133
 *
134
 * @param $user_info
135
 * @param $payment Give_Payment|bool for getting the names.
136
 *
137
 * @return array $email_names
138
 */
139
function give_get_email_names( $user_info, $payment = false ) {
140
	$email_names = array();
141
142
	if ( is_a( $payment, 'Give_Payment' ) ) {
143
144
		if ( $payment->user_id > 0 ) {
145
146
			$user_data               = get_userdata( $payment->user_id );
147
			$email_names['name']     = $payment->first_name;
148
			$email_names['fullname'] = trim( $payment->first_name . ' ' . $payment->last_name );
149
			$email_names['username'] = $user_data->user_login;
150
151
		} elseif ( ! empty( $payment->first_name ) ) {
152
153
			$email_names['name']     = $payment->first_name;
154
			$email_names['fullname'] = trim( $payment->first_name . ' ' . $payment->last_name );
155
			$email_names['username'] = $payment->first_name;
156
157
		} else {
158
159
			$email_names['name']     = $payment->email;
160
			$email_names['username'] = $payment->email;
161
162
		}
0 ignored issues
show
introduced by
Blank line found after control structure
Loading history...
163
164
	} else {
165
166
		// Support for old serialized data
167
		if ( is_serialized( $user_info ) ) {
168
169
			// Security check.
170
			preg_match( '/[oO]\s*:\s*\d+\s*:\s*"\s*(?!(?i)(stdClass))/', $user_info, $matches );
171
			if ( ! empty( $matches ) ) {
172
				return array(
173
					'name'     => '',
174
					'fullname' => '',
175
					'username' => '',
176
				);
177
			} else {
178
				$user_info = maybe_unserialize( $user_info );
179
			}
0 ignored issues
show
introduced by
Blank line found after control structure
Loading history...
180
181
		}
182
183
		if ( isset( $user_info['id'] ) && $user_info['id'] > 0 && isset( $user_info['first_name'] ) ) {
184
			$user_data               = get_userdata( $user_info['id'] );
185
			$email_names['name']     = $user_info['first_name'];
186
			$email_names['fullname'] = $user_info['first_name'] . ' ' . $user_info['last_name'];
187
			$email_names['username'] = $user_data->user_login;
188
		} elseif ( isset( $user_info['first_name'] ) ) {
189
			$email_names['name']     = $user_info['first_name'];
190
			$email_names['fullname'] = $user_info['first_name'] . ' ' . $user_info['last_name'];
191
			$email_names['username'] = $user_info['first_name'];
192
		} else {
193
			$email_names['name']     = $user_info['email'];
194
			$email_names['username'] = $user_info['email'];
195
		}
0 ignored issues
show
introduced by
Blank line found after control structure
Loading history...
196
197
	}
198
199
	return $email_names;
200
}
201