Passed
Push — 122-star-email-log ( 0e8628...f6bca9 )
by Sudar
20:10 queued 14:52
created

render_auto_delete_logs_next_run_schedule()   A

Complexity

Conditions 2
Paths 2

Size

Total Lines 10
Code Lines 9

Duplication

Lines 0
Ratio 0 %

Code Coverage

Tests 0
CRAP Score 6

Importance

Changes 0
Metric Value
cc 2
eloc 9
nc 2
nop 0
dl 0
loc 10
ccs 0
cts 1
cp 0
crap 6
rs 9.9666
c 0
b 0
f 0

1 Method

Rating   Name   Duplication   Size   Complexity  
A el_array_get() 0 2 2
1
<?php namespace EmailLog\Util;
2
3
/**
4
 * Email Log Helper functions.
5
 * Some of these functions would be used the addons.
6
 */
7
defined( 'ABSPATH' ) || exit; // Exit if accessed directly.
8
9
/**
10
 * Perform additional sanitation of emails.
11
 *
12
 * @since 1.9
13
 *
14
 * @param string $email    Email string to be sanitized.
15
 * @param bool   $multiple (Optional) Should multiple emails be allowed. True by default.
16
 *
17
 * @return string Sanitized email.
18
 */
19
function sanitize_email( $email, $multiple = true ) {
20 13
	$emails = explode( ',', $email );
21 13
	if ( ! $multiple ) {
22 3
		$emails = array_slice( $emails, 0, 1 );
23
	}
24
25 13
	$cleaned_emails = array_map( __NAMESPACE__ . '\\sanitize_email_with_name', $emails );
26
27 13
	return implode( ', ', $cleaned_emails );
28
}
29
30
/**
31
 * Sanitize email with name.
32
 *
33
 * @since 1.9
34
 *
35
 * @param string $string Email string to be sanitized.
36
 *
37
 * @return string Sanitized email.
38
 */
39
function sanitize_email_with_name( $string ) {
40 13
	$string = trim( $string );
41
42 13
	$bracket_pos = strpos( $string, '<' );
43 13
	if ( false !== $bracket_pos ) {
44 5
		if ( $bracket_pos > 0 ) {
45 5
			$name = substr( $string, 0, $bracket_pos );
46 5
			$name = trim( $name );
47
48 5
			$email = substr( $string, $bracket_pos + 1 );
49 5
			$email = str_replace( '>', '', $email );
50
51 5
			return sanitize_text_field( $name ) . ' <' . \sanitize_email( $email ) . '>';
52
		}
53
	}
54
55 8
	return \sanitize_email( $string );
56
}
57
58
/**
59
 * Gets the columns to export logs.
60
 *
61
 * If the More Fields add-on is active, additional columns are returned.
62
 *
63
 * @since 2.0.0
64
 *
65
 * @return string[] List of Columns to export.
66
 */
67
function get_log_columns_to_export() {
68
69
	if ( is_plugin_active( 'email-log-more-fields/email-log-more-fields.php' ) ) {
70
		return array(
71
			'id',
72
			'sent_date',
73
			'to_email',
74
			'subject',
75
			'from',
76
			'cc',
77
			'bcc',
78
			'reply-to',
79
			'attachment',
80
		);
81
	}
82
83
	return array( 'id', 'sent_date', 'to_email', 'subject' );
84
}
85
86
/**
87
 * Is it an admin request and not an ajax request.
88
 *
89
 * @since 2.1
90
 *
91
 * @return bool True if admin non ajax request, False otherwise.
92
 */
93
function is_admin_non_ajax_request() {
94
	if ( function_exists( 'wp_doing_ajax' ) && wp_doing_ajax() ) {
95
		return false;
96
	}
97
98
	if ( defined( 'DOING_AJAX' ) && DOING_AJAX ) {
99
		return false;
100
	}
101
102
	return is_admin();
103
}
104
105
/**
106
 * Checks the Checkbox when values are present in a given array.
107
 *
108
 * Use this function in Checkbox fields.
109
 *
110
 * @since 2.1.0
111
 *
112
 * @param array  $values  List of all possible values.
113
 * @param string $current The current value to be checked.
114
 */
115
function checked_array( $values, $current ) {
116 2
	if ( ! is_array( $values ) ) {
117 1
		return;
118
	}
119
120 1
	if ( in_array( $current, $values, true ) ) {
121 1
		echo "checked='checked'";
122
	}
123 1
}
124
125
/**
126
 * Return failure icon.
127
 *
128
 * @since 2.3.2
129
 *
130
 * @return string Failure icon markup.
131
 */
132
function get_failure_icon() {
133
	return <<<EOT
134
<span class="dashicons dashicons-dismiss"></span>
135
EOT;
136
}
137
138
/**
139
 * Return success icon.
140
 *
141
 * @since 2.3.2
142
 *
143
 * @return string Success icon markup.
144
 */
145
function get_success_icon() {
146
	return <<<EOT
147
<span class="dashicons dashicons-yes-alt"></span>
148
EOT;
149
150
}
151
152
/**
153
 * Stringify arrays.
154
 *
155
 * If the parameter is an array, then return delimiter separated values of the array.
156
 * Otherwise return the parameter.
157
 *
158
 * @since 2.3.0
159
 * @since 2.3.2 Renamed name to `Stringify`.
160
 *
161
 * @param array|string $may_be_array The array whose values are to be converted to string.
162
 * @param string       $delimiter    Optional. Default is `,`.
163
 *
164
 * @return string Stringified value.
165
 */
166
function stringify( $may_be_array, $delimiter = ',' ) {
167 1
	if ( ! is_array( $may_be_array ) ) {
168
		return (string) $may_be_array;
169
	}
170
171 1
	return implode( $delimiter, $may_be_array );
172
}
173
174
/**
175
 * Gets the User defined Date time format.
176
 *
177
 * @used-by \EmailLog\Core\UI\Setting\CoreSetting
178
 *
179
 * @since   2.3.0
180
 *
181
 * @return string
182
 */
183
function get_user_defined_date_time_format() {
184
	return sprintf( '%1$s %2$s', get_option( 'date_format', 'Y-m-d' ), get_option( 'time_format', 'g:i a' ) );
0 ignored issues
show
Bug introduced by
It seems like get_option('date_format', 'Y-m-d') can also be of type false; however, parameter $args of sprintf() does only seem to accept string, maybe add an additional type check? ( Ignorable by Annotation )

If this is a false-positive, you can also ignore this issue in your code via the ignore-type  annotation

184
	return sprintf( '%1$s %2$s', /** @scrutinizer ignore-type */ get_option( 'date_format', 'Y-m-d' ), get_option( 'time_format', 'g:i a' ) );
Loading history...
185
}
186
187
/**
188
 * Gets the value by key from the array.
189
 *
190
 * If the key isn't found, then null is returned.
191
 *
192
 * @since 2.3.0
193
 *
194
 * @param array  $array   The actual array.
195
 * @param string $key     The key whose value is to be retrieved.
196
 * @param string $default Optional.
197
 *
198
 * @return mixed|null
199
 */
200
function el_array_get( $array, $key, $default = null ) {
201 1
	return isset( $array[ $key ] ) ? $array[ $key ] : $default;
202
}
203
204
/**
205
 * Returns TRUE if the given search term is Advanced Search Term.
206
 *
207
 * @param string $term Search Term.
208
 *
209
 * @return bool
210
 */
211
function is_advanced_search_term( $term ) {
212
	if ( ! is_string( $term ) ) {
0 ignored issues
show
introduced by
The condition is_string($term) is always true.
Loading history...
213
		return false;
214
	}
215
216
	$predicates = get_advanced_search_term_predicates( $term );
217
218
	return ! empty( $predicates );
219
}
220
221
/**
222
 * Gets the Search Term Predicates.
223
 *
224
 * Example:
225
 *
226
 * If $term = to:[email protected] then,
227
 *
228
 * the output would be
229
 *
230
 * $output = array(
231
 *      'to' => [email protected]
232
 * )
233
 *
234
 * @since 2.3.0
235
 *
236
 * @param string $term Search Term.
237
 *
238
 * @return array
239
 */
240
function get_advanced_search_term_predicates( $term ) {
241
	if ( ! is_string( $term ) ) {
0 ignored issues
show
introduced by
The condition is_string($term) is always true.
Loading history...
242
		return array();
243
	}
244
245
	$predicates           = explode( ' ', $term );
246
	$predicates_organized = array();
247
248
	foreach ( $predicates as $predicate ) {
249
		$is_match = preg_match( '/(id|email|to|cc|bcc|reply-to):(.*)$/', $predicate, $matches );
250
		if ( 1 === $is_match ) {
251
			$predicates_organized[ $matches[1] ] = $matches[2];
252
		}
253
	}
254
255
	return $predicates_organized;
256
}
257
258
/**
259
 * Gets the Advanced Search URL.
260
 *
261
 * @since 2.3.0
262
 *
263
 * @return string
264
 */
265
function get_advanced_search_url() {
266
	$admin_url = get_admin_url( null, 'admin.php?page=email-log' );
267
268
	return add_query_arg( 'el_as', 1, $admin_url );
269
}
270
271
/**
272
 * Gets the Column labels to be used in LogList table.
273
 *
274
 * Deprecated. This is currently used by Email Log - Export Logs add-on v1.2.1 and will eventually be removed.
275
 *
276
 * @since 2.3.0
277
 * @since 2.3.2 Deprecated.
278
 *
279
 * @param string $db_column Column ID.
280
 *
281
 * @return string Column label.
282
 */
283
function get_column_label_by_db_column( $db_column ) {
284
	return get_column_label( $db_column );
285
}
286
287
/**
288
 * Get Column label based on column name.
289
 *
290
 * @since 2.3.2
291
 *
292
 * @param string $column_name Column name.
293
 *
294
 * @return string Column label.
295
 */
296
function get_column_label( $column_name ) {
297 1
	$labels = get_column_label_map();
298
299 1
	if ( ! array_key_exists( $column_name, $labels ) ) {
300
		return $column_name;
301
	}
302
303 1
	return $labels[ $column_name ];
304
}
305
306
/**
307
 * Returns an array of Email Log columns.
308
 *
309
 * Keys are the column names in the DB.
310
 * This holds true except for CC, BCC & Reply To as they are put under one column `headers`.
311
 *
312
 * @since 2.3.2
313
 *
314
 * @return array Key value pair of Email Log columns.
315
 */
316
function get_column_label_map() {
317
	$labels = array(
318 1
		'id'          => __( 'ID', 'email-log' ),
319 1
		'to_email'    => __( 'To', 'email-log' ),
320 1
		'subject'     => __( 'Subject', 'email-log' ),
321 1
		'message'     => __( 'Message', 'email-log' ),
322 1
		'attachments' => __( 'Attachment', 'email-log' ),
323 1
		'sent_date'   => __( 'Sent at', 'email-log' ),
324 1
		'from'        => __( 'From', 'email-log' ),
325 1
		'cc'          => __( 'CC', 'email-log' ),
326 1
		'bcc'         => __( 'BCC', 'email-log' ),
327 1
		'reply_to'    => __( 'Reply To', 'email-log' ),
328 1
		'ip_address'  => __( 'IP Address', 'email-log' ),
329 1
		'result'      => __( 'Sent Status', 'email-log' ),
330 1
		'star'        => __( 'Star', 'email-log' ),
331
	);
332
333
	/**
334
	 * Filters the Labels used through out the Email Log plugin.
335
	 *
336
	 * @since 2.3.2
337
	 *
338
	 * @param array $labels List of DB Columns and its respective labels which are internationalized string.
339
	 *                      Example: 'id' => __( 'ID', 'email-log' ),
340
	 */
341 1
	return apply_filters( 'el_db_column_labels', $labels );
342
}
343