|
1
|
|
|
<?php |
|
2
|
|
|
|
|
3
|
|
|
class TimberURLHelper { |
|
4
|
|
|
|
|
5
|
|
|
/** |
|
6
|
|
|
* |
|
7
|
|
|
* |
|
8
|
|
|
* @return string |
|
9
|
|
|
*/ |
|
10
|
|
|
public static function get_current_url() { |
|
11
|
|
|
$pageURL = "http://"; |
|
12
|
|
|
if ( isset( $_SERVER['HTTPS'] ) && $_SERVER["HTTPS"] == "on" ) { |
|
13
|
|
|
$pageURL = "https://";; |
|
14
|
|
|
} |
|
15
|
|
|
if ( isset($_SERVER["SERVER_PORT"]) && $_SERVER["SERVER_PORT"] && $_SERVER["SERVER_PORT"] != "80" ) { |
|
16
|
|
|
$pageURL .= self::get_host() . ":" . $_SERVER["SERVER_PORT"] . $_SERVER["REQUEST_URI"]; |
|
17
|
|
|
} else { |
|
18
|
|
|
$pageURL .= self::get_host() . $_SERVER["REQUEST_URI"]; |
|
19
|
|
|
} |
|
20
|
|
|
return $pageURL; |
|
21
|
|
|
} |
|
22
|
|
|
|
|
23
|
|
|
/** |
|
24
|
|
|
* |
|
25
|
|
|
* |
|
26
|
|
|
* @param string $url |
|
27
|
|
|
* @return bool |
|
28
|
|
|
*/ |
|
29
|
|
|
public static function is_url( $url ) { |
|
30
|
|
|
if ( !is_string( $url ) ) { |
|
31
|
|
|
return false; |
|
32
|
|
|
} |
|
33
|
|
|
$url = strtolower( $url ); |
|
34
|
|
|
if ( strstr( $url, '://' ) ) { |
|
35
|
|
|
return true; |
|
36
|
|
|
} |
|
37
|
|
|
return false; |
|
38
|
|
|
} |
|
39
|
|
|
|
|
40
|
|
|
/** |
|
41
|
|
|
* |
|
42
|
|
|
* |
|
43
|
|
|
* @return string |
|
44
|
|
|
*/ |
|
45
|
|
|
public static function get_path_base() { |
|
46
|
|
|
$struc = get_option( 'permalink_structure' ); |
|
47
|
|
|
$struc = explode( '/', $struc ); |
|
48
|
|
|
$p = '/'; |
|
49
|
|
|
foreach ( $struc as $s ) { |
|
50
|
|
|
if ( !strstr( $s, '%' ) && strlen( $s ) ) { |
|
51
|
|
|
$p .= $s . '/'; |
|
52
|
|
|
} |
|
53
|
|
|
} |
|
54
|
|
|
return $p; |
|
55
|
|
|
} |
|
56
|
|
|
|
|
57
|
|
|
/** |
|
58
|
|
|
* |
|
59
|
|
|
* |
|
60
|
|
|
* @param string $url |
|
61
|
|
|
* @param bool $force |
|
62
|
|
|
* @return string |
|
63
|
|
|
*/ |
|
64
|
|
|
public static function get_rel_url( $url, $force = false ) { |
|
65
|
|
|
$url_info = parse_url( $url ); |
|
66
|
|
|
if ( isset( $url_info['host'] ) && $url_info['host'] != self::get_host() && !$force ) { |
|
67
|
|
|
return $url; |
|
68
|
|
|
} |
|
69
|
|
|
$link = ''; |
|
70
|
|
|
if ( isset( $url_info['path'] ) ) { |
|
71
|
|
|
$link = $url_info['path']; |
|
72
|
|
|
} |
|
73
|
|
|
if ( isset( $url_info['query'] ) && strlen( $url_info['query'] ) ) { |
|
74
|
|
|
$link .= '?' . $url_info['query']; |
|
75
|
|
|
} |
|
76
|
|
|
if ( isset( $url_info['fragment'] ) && strlen( $url_info['fragment'] ) ) { |
|
77
|
|
|
$link .= '#' . $url_info['fragment']; |
|
78
|
|
|
} |
|
79
|
|
|
$link = TimberURLHelper::remove_double_slashes( $link ); |
|
80
|
|
|
return $link; |
|
81
|
|
|
} |
|
82
|
|
|
|
|
83
|
|
|
/** |
|
84
|
|
|
* Some setups like HTTP_HOST, some like SERVER_NAME, it's complicated |
|
85
|
|
|
* @link http://stackoverflow.com/questions/2297403/http-host-vs-server-name |
|
86
|
|
|
* @return string the HTTP_HOST or SERVER_NAME |
|
87
|
|
|
*/ |
|
88
|
|
|
public static function get_host() { |
|
89
|
|
|
if (isset($_SERVER['HTTP_HOST'])) { |
|
90
|
|
|
return $_SERVER['HTTP_HOST']; |
|
91
|
|
|
} |
|
92
|
|
|
if (isset($_SERVER['SERVER_NAME'])) { |
|
93
|
|
|
return $_SERVER['SERVER_NAME']; |
|
94
|
|
|
} |
|
95
|
|
|
return ''; |
|
96
|
|
|
} |
|
97
|
|
|
|
|
98
|
|
|
/** |
|
99
|
|
|
* |
|
100
|
|
|
* |
|
101
|
|
|
* @param string $url |
|
102
|
|
|
* @return bool |
|
103
|
|
|
*/ |
|
104
|
|
|
public static function is_local( $url ) { |
|
105
|
|
|
if ( strstr( $url, self::get_host() ) ) { |
|
106
|
|
|
return true; |
|
107
|
|
|
} |
|
108
|
|
|
return false; |
|
109
|
|
|
} |
|
110
|
|
|
|
|
111
|
|
|
/** |
|
112
|
|
|
* |
|
113
|
|
|
* |
|
114
|
|
|
* @param string $src |
|
115
|
|
|
* @return string |
|
116
|
|
|
*/ |
|
117
|
|
|
public static function get_full_path( $src ) { |
|
118
|
|
|
$root = ABSPATH; |
|
119
|
|
|
$old_root_path = $root . $src; |
|
120
|
|
|
$old_root_path = str_replace( '//', '/', $old_root_path ); |
|
121
|
|
|
return $old_root_path; |
|
122
|
|
|
} |
|
123
|
|
|
|
|
124
|
|
|
/** |
|
125
|
|
|
* Takes a url and figures out its place based in the file system based on path |
|
126
|
|
|
* NOTE: Not fool-proof, makes a lot of assumptions about the file path |
|
127
|
|
|
* matching the URL path |
|
128
|
|
|
* |
|
129
|
|
|
* @param string $url |
|
130
|
|
|
* @return string |
|
131
|
|
|
*/ |
|
132
|
|
|
public static function url_to_file_system( $url ) { |
|
133
|
|
|
$url_parts = parse_url( $url ); |
|
134
|
|
|
$path = ABSPATH . $url_parts['path']; |
|
135
|
|
|
$path = str_replace( '//', '/', $path ); |
|
136
|
|
|
return $path; |
|
137
|
|
|
} |
|
138
|
|
|
|
|
139
|
|
|
public static function file_system_to_url( $fs ) { |
|
140
|
|
|
$relative_path = self::get_rel_path( $fs ); |
|
141
|
|
|
$home = home_url( '/'.$relative_path ); |
|
142
|
|
|
return $home; |
|
143
|
|
|
} |
|
144
|
|
|
|
|
145
|
|
|
/** |
|
146
|
|
|
* |
|
147
|
|
|
* |
|
148
|
|
|
* @param string $src |
|
149
|
|
|
* @return string |
|
150
|
|
|
*/ |
|
151
|
|
|
public static function get_rel_path( $src ) { |
|
152
|
|
|
if ( strstr( $src, ABSPATH ) ) { |
|
153
|
|
|
return str_replace( ABSPATH, '', $src ); |
|
154
|
|
|
} |
|
155
|
|
|
//its outside the wordpress directory, alternate setups: |
|
156
|
|
|
$src = str_replace( WP_CONTENT_DIR, '', $src ); |
|
157
|
|
|
return WP_CONTENT_SUBDIR . $src; |
|
158
|
|
|
} |
|
159
|
|
|
|
|
160
|
|
|
/** |
|
161
|
|
|
* |
|
162
|
|
|
* |
|
163
|
|
|
* @param string $url |
|
164
|
|
|
* @return string |
|
165
|
|
|
*/ |
|
166
|
|
|
public static function remove_double_slashes( $url ) { |
|
167
|
|
|
$url = str_replace( '//', '/', $url ); |
|
168
|
|
|
if ( strstr( $url, 'http:' ) && !strstr( $url, 'http://' ) ) { |
|
169
|
|
|
$url = str_replace( 'http:/', 'http://', $url ); |
|
170
|
|
|
} |
|
171
|
|
|
return $url; |
|
172
|
|
|
} |
|
173
|
|
|
|
|
174
|
|
|
/** |
|
175
|
|
|
* |
|
176
|
|
|
* |
|
177
|
|
|
* @param string $url |
|
178
|
|
|
* @param string $path |
|
179
|
|
|
* @return string |
|
180
|
|
|
*/ |
|
181
|
|
|
public static function prepend_to_url( $url, $path ) { |
|
182
|
|
|
if ( strstr( strtolower( $url ), 'http' ) ) { |
|
183
|
|
|
$url_parts = parse_url( $url ); |
|
184
|
|
|
$url = $url_parts['scheme'] . '://' . $url_parts['host'] . $path . $url_parts['path']; |
|
185
|
|
|
if ( isset( $url_parts['query'] ) ) { |
|
186
|
|
|
$url .= $url_parts['query']; |
|
187
|
|
|
} |
|
188
|
|
|
if ( isset( $url_parts['fragment'] ) ) { |
|
189
|
|
|
$url .= $url_parts['fragment']; |
|
190
|
|
|
} |
|
191
|
|
|
} else { |
|
192
|
|
|
$url = $url . $path; |
|
193
|
|
|
} |
|
194
|
|
|
return self::remove_double_slashes( $url ); |
|
195
|
|
|
} |
|
196
|
|
|
|
|
197
|
|
|
/** |
|
198
|
|
|
* |
|
199
|
|
|
* |
|
200
|
|
|
* @param string $path |
|
201
|
|
|
* @return string |
|
202
|
|
|
*/ |
|
203
|
|
|
public static function preslashit( $path ) { |
|
204
|
|
|
if ( strpos( $path, '/' ) != 0 ) { |
|
205
|
|
|
$path = '/' . $path; |
|
206
|
|
|
} |
|
207
|
|
|
return $path; |
|
208
|
|
|
} |
|
209
|
|
|
|
|
210
|
|
|
/** |
|
211
|
|
|
* This will evaluate wheter a URL is at an aboslute location (like http://example.org/whatever) |
|
212
|
|
|
* |
|
213
|
|
|
* @return boolean true if $path is an absolute url, false if relative. |
|
214
|
|
|
*/ |
|
215
|
|
|
public static function is_absolute( $path ) { |
|
216
|
|
|
return (boolean) ( strstr( $path, 'http' ) ); |
|
217
|
|
|
} |
|
218
|
|
|
|
|
219
|
|
|
/** |
|
220
|
|
|
* This function is slightly different from the one below in the case of: |
|
221
|
|
|
* an image hosted on the same domain BUT on a different site than the |
|
222
|
|
|
* Wordpress install will be reported as external content. |
|
223
|
|
|
* |
|
224
|
|
|
* @param string $url a URL to evaluate against |
|
225
|
|
|
* @return boolean if $url points to an external location returns true |
|
226
|
|
|
*/ |
|
227
|
|
|
public static function is_external_content( $url ) { |
|
228
|
|
|
$is_external = TimberURLHelper::is_absolute( $url ) && ! TimberURLHelper::is_internal_content( $url ); |
|
229
|
|
|
|
|
230
|
|
|
return $is_external; |
|
231
|
|
|
} |
|
232
|
|
|
|
|
233
|
|
|
private static function is_internal_content($url) { |
|
234
|
|
|
// using content_url() instead of site_url or home_url is IMPORTANT |
|
235
|
|
|
// otherwise you run into errors with sites that: |
|
236
|
|
|
// 1. use WPML plugin |
|
237
|
|
|
// 2. or redefine content directory |
|
238
|
|
|
$is_content_url = strstr( $url, content_url() ); |
|
239
|
|
|
|
|
240
|
|
|
// this case covers when the upload directory has been redefined |
|
241
|
|
|
$upload_dir = wp_upload_dir(); |
|
242
|
|
|
$is_upload_url = strstr( $url, $upload_dir['baseurl'] ); |
|
243
|
|
|
|
|
244
|
|
|
return $is_content_url || $is_upload_url; |
|
245
|
|
|
} |
|
246
|
|
|
|
|
247
|
|
|
/** |
|
248
|
|
|
* |
|
249
|
|
|
* |
|
250
|
|
|
* @param string $url |
|
251
|
|
|
* @return bool true if $path is an external url, false if relative or local. |
|
252
|
|
|
* true if it's a subdomain (http://cdn.example.org = true) |
|
253
|
|
|
*/ |
|
254
|
|
|
public static function is_external( $url ) { |
|
255
|
|
|
$has_http = strstr( strtolower( $url ), 'http' ); |
|
256
|
|
|
$on_domain = strstr( $url, self::get_host() ); |
|
257
|
|
|
if ( $has_http && !$on_domain ) { |
|
258
|
|
|
return true; |
|
259
|
|
|
} |
|
260
|
|
|
return false; |
|
261
|
|
|
} |
|
262
|
|
|
|
|
263
|
|
|
/** |
|
264
|
|
|
* Pass links through untrailingslashit unless they are a single / |
|
265
|
|
|
* |
|
266
|
|
|
* @param string $link |
|
267
|
|
|
* @return string |
|
268
|
|
|
*/ |
|
269
|
|
|
public static function remove_trailing_slash( $link ) { |
|
270
|
|
|
if ( $link != "/" ) |
|
271
|
|
|
$link = untrailingslashit( $link ); |
|
272
|
|
|
return $link; |
|
273
|
|
|
} |
|
274
|
|
|
|
|
275
|
|
|
/** |
|
276
|
|
|
* Download an external file via a URL |
|
277
|
|
|
* |
|
278
|
|
|
* @param string $url |
|
279
|
|
|
* @param int $timeout |
|
280
|
|
|
* @return string|WP_Error the location of the temporay file name or an error |
|
281
|
|
|
* @deprecated since 0.20.0 |
|
282
|
|
|
*/ |
|
283
|
|
|
static function download_url( $url, $timeout = 300 ) { |
|
|
|
|
|
|
284
|
|
|
if ( !$url ) { |
|
285
|
|
|
return new WP_Error( 'http_no_url', __( 'Invalid URL Provided.' ) ); |
|
286
|
|
|
} |
|
287
|
|
|
|
|
288
|
|
|
$tmpfname = wp_tempnam( $url ); |
|
289
|
|
|
if ( !$tmpfname ) { |
|
290
|
|
|
return new WP_Error( 'http_no_file', __( 'Could not create Temporary file.' ) ); |
|
291
|
|
|
} |
|
292
|
|
|
|
|
293
|
|
|
$response = wp_remote_get( $url, array( 'timeout' => $timeout, 'stream' => true, 'filename' => $tmpfname ) ); |
|
294
|
|
|
|
|
295
|
|
|
if ( is_wp_error( $response ) ) { |
|
296
|
|
|
unlink( $tmpfname ); |
|
297
|
|
|
return $response; |
|
298
|
|
|
} |
|
299
|
|
|
if ( 200 != wp_remote_retrieve_response_code( $response ) ) { |
|
300
|
|
|
unlink( $tmpfname ); |
|
301
|
|
|
return new WP_Error( 'http_404', trim( wp_remote_retrieve_response_message( $response ) ) ); |
|
302
|
|
|
} |
|
303
|
|
|
return $tmpfname; |
|
304
|
|
|
} |
|
305
|
|
|
|
|
306
|
|
|
/** |
|
307
|
|
|
* Returns the url parameters, for example for url http://example.org/blog/post/news/2014/whatever |
|
308
|
|
|
* this will return array('blog', 'post', 'news', '2014', 'whatever'); |
|
309
|
|
|
* OR if sent an integer like: TimberUrlHelper::get_params(2); this will return 'news'; |
|
310
|
|
|
* |
|
311
|
|
|
* @param int $i the position of the parameter to grab. |
|
|
|
|
|
|
312
|
|
|
* @return array|string |
|
313
|
|
|
*/ |
|
314
|
|
|
public static function get_params( $i = false ) { |
|
315
|
|
|
$args = explode( '/', trim( strtolower( $_SERVER['REQUEST_URI'] ) ) ); |
|
316
|
|
|
$newargs = array(); |
|
317
|
|
|
foreach ( $args as $arg ) { |
|
318
|
|
|
if ( strlen( $arg ) ) { |
|
319
|
|
|
$newargs[] = $arg; |
|
320
|
|
|
} |
|
321
|
|
|
} |
|
322
|
|
|
if ( $i === false ) { |
|
323
|
|
|
return $newargs; |
|
324
|
|
|
} |
|
325
|
|
|
if ( $i < 0 ) { |
|
326
|
|
|
//count from end |
|
327
|
|
|
$i = count( $newargs ) + $i; |
|
328
|
|
|
} |
|
329
|
|
|
if ( isset( $newargs[$i] ) ) { |
|
330
|
|
|
return $newargs[$i]; |
|
331
|
|
|
} |
|
332
|
|
|
} |
|
333
|
|
|
|
|
334
|
|
|
} |
|
335
|
|
|
|
Adding explicit visibility (
private,protected, orpublic) is generally recommend to communicate to other developers how, and from where this method is intended to be used.