comments-plus / libs / factory / core / includes / functions.php

functions.php in Disable Comments & Delete All Comments trunk, at libs/factory/core/includes/functions.php

206 lines 6.8 KB

Raw Download Zip

1	<?php
2	/**
3	* Factory Function Library
4	*
5	* @author Alex Kovalev <alex.kovalevv@gmail.com>, repo: https://github.com/alexkovalevv
6	* @author Webcraftic <wordpress.webraftic@gmail.com>, site: https://webcraftic.com
7	*
8	* @package factory-core
9	* @since 1.0.0
10	*/
11
12	// Exit if accessed directly
13	if ( ! defined( 'ABSPATH' ) ) {
14	exit;
15	}
16
17	if ( ! function_exists( 'get_user_locale' ) ) {
18	function get_user_locale( $user_id = 0 ) {
19	$user = false;
20	if ( 0 === $user_id && function_exists( 'wp_get_current_user' ) ) {
21	$user = wp_get_current_user();
22	} else if ( $user_id instanceof WP_User ) {
23	$user = $user_id;
24	} else if ( $user_id && is_numeric( $user_id ) ) {
25	$user = get_user_by( 'id', $user_id );
26	}
27
28	if ( ! $user ) {
29	return get_locale();
30	}
31
32	$locale = $user->locale;
33
34	return $locale ? $locale : get_locale();
35	}
36	}
37
38	/**
39	* Fires functions attached to a deprecated filter hook.
40	*
41	* When a filter hook is deprecated, the apply_filters() call is replaced with
42	* apply_filters_deprecated(), which triggers a deprecation notice and then fires
43	* the original filter hook.
44	*
45	* This is a copy of `apply_filters_deprecated` introduced in WP 4.6.
46	*
47	* @since 1.0.0
48	*
49	* @param string $tag The name of the filter hook.
50	* @param array $args Array of additional function arguments to be passed to apply_filters().
51	* @param string $version The version of BP Block Users that deprecated the hook.
52	* @param string $replacement Optional. The hook that should have been used.
53	* @param string $message Optional. A message regarding the change.
54	*
55	* @return mixed
56	* @see wbcr_factory_480_deprecated_hook()
57	*
58	*/
59	function wbcr_factory_480_apply_filters_deprecated( $tag, $args, $version, $replacement = false, $message = null ) {
60	if ( function_exists( 'apply_filters_deprecated' ) ) {
61	return apply_filters_deprecated( $tag, $args, $version, $replacement, $message );
62	}
63	if ( ! has_filter( $tag ) ) {
64	return $args[0];
65	}
66	wbcr_factory_480_deprecated_hook( $tag, $version, $replacement, $message );
67
68	return apply_filters_ref_array( $tag, $args );
69	}
70
71	/**
72	* Fires functions attached to a deprecated action hook.
73	*
74	* When an action hook is deprecated, the do_action() call is replaced with
75	* do_action_deprecated(), which triggers a deprecation notice and then fires
76	* the original hook.
77	*
78	* This is a copy of `do_action_deprecated` introduced in WP 4.6.
79	*
80	* @since 1.0.0
81	*
82	* @param string $tag The name of the action hook.
83	* @param array $args Array of additional function arguments to be passed to do_action().
84	* @param string $version The version of BP Block Users that deprecated the hook.
85	* @param string $replacement Optional. The hook that should have been used.
86	* @param string $message Optional. A message regarding the change.
87	*
88	* @return void
89	* @see _deprecated_hook()
90	*
91	*/
92	function wbcr_factory_480_do_action_deprecated( $tag, $args, $version, $replacement = false, $message = null ) {
93	if ( function_exists( 'do_action_deprecated' ) ) {
94	do_action_deprecated( $tag, $args, $version, $replacement, $message );
95
96	return;
97	}
98	if ( ! has_action( $tag ) ) {
99	return;
100	}
101	wbcr_factory_480_deprecated_hook( $tag, $version, $replacement, $message );
102	do_action_ref_array( $tag, $args );
103	}
104
105	/**
106	* Marks a deprecated action or filter hook as deprecated and throws a notice.
107	*
108	* Use the 'wbcr_factory_480_deprecated_hook_run' action to get the backtrace describing where the
109	* deprecated hook was called.
110	*
111	* Default behavior is to trigger a user error if WP_DEBUG is true.
112	*
113	* This function is called by the do_action_deprecated() and apply_filters_deprecated()
114	* functions, and so generally does not need to be called directly.
115	*
116	* This is a copy of `_deprecated_hook` introduced in WP 4.6.
117	*
118	* @since 1.0.0
119	* @access private
120	*
121	* @param string $hook The hook that was used.
122	* @param string $version The version of WordPress that deprecated the hook.
123	* @param string $replacement Optional. The hook that should have been used.
124	* @param string $message Optional. A message regarding the change.
125	*/
126	function wbcr_factory_480_deprecated_hook( $hook, $version, $replacement = null, $message = null ) {
127	/**
128	* Fires when a deprecated hook is called.
129	*
130	* @since 1.0.0
131	*
132	* @param string $hook The hook that was called.
133	* @param string $replacement The hook that should be used as a replacement.
134	* @param string $version The version of BP Block Users that deprecated the argument used.
135	* @param string $message A message regarding the change.
136	*/
137	do_action( 'deprecated_hook_run', $hook, $replacement, $version, $message );
138
139	/**
140	* Filter whether to trigger deprecated hook errors.
141	*
142	* @since 1.0.0
143	*
144	* @param bool $trigger Whether to trigger deprecated hook errors. Requires
145	* `WP_DEBUG` to be defined true.
146	*/
147	if ( WP_DEBUG && apply_filters( 'deprecated_hook_trigger_error', true ) ) {
148	$message = empty( $message ) ? '' : ' ' . $message;
149	if ( ! is_null( $replacement ) ) {
150	trigger_error( sprintf( __( '%1$s is <strong>deprecated</strong> since version %2$s! Use %3$s instead.' ), $hook, $version, $replacement ) . $message );
151	} else {
152	trigger_error( sprintf( __( '%1$s is <strong>deprecated</strong> since version %2$s with no alternative available.' ), $hook, $version ) . $message );
153	}
154	}
155	}
156
157	if ( ! function_exists( '_sanitize_text_fields' ) ) {
158	function _sanitize_text_fields( $str, $keep_newlines = false ) {
159	$filtered = wp_check_invalid_utf8( $str );
160
161	if ( strpos( $filtered, '<' ) !== false ) {
162	$filtered = wp_pre_kses_less_than( $filtered );
163	// This will strip extra whitespace for us.
164	$filtered = wp_strip_all_tags( $filtered, false );
165
166	// Use html entities in a special case to make sure no later
167	// newline stripping stage could lead to a functional tag
168	$filtered = str_replace( "<\n", "<\n", $filtered );
169	}
170
171	if ( ! $keep_newlines ) {
172	$filtered = preg_replace( '/[\r\n\t ]+/', ' ', $filtered );
173	}
174	$filtered = trim( $filtered );
175
176	$found = false;
177	while( preg_match( '/%[a-f0-9]{2}/i', $filtered, $match ) ) {
178	$filtered = str_replace( $match[0], '', $filtered );
179	$found = true;
180	}
181
182	if ( $found ) {
183	// Strip out the whitespace that may now exist after removing the octets.
184	$filtered = trim( preg_replace( '/ +/', ' ', $filtered ) );
185	}
186
187	return $filtered;
188	}
189	}
190
191	if ( ! function_exists( 'sanitize_textarea_field' ) ) {
192	function sanitize_textarea_field( $str ) {
193	$filtered = _sanitize_text_fields( $str, true );
194
195	/**
196	* Filters a sanitized textarea field string.
197	*
198	* @since 4.7.0
199	*
200	* @param string $filtered The sanitized string.
201	* @param string $str The string prior to being sanitized.
202	*/
203	return apply_filters( 'sanitize_textarea_field', $filtered, $str );
204	}
205	}
206