functions.compat.php — Jetpack – WP Security, Backup, Speed, & Growth 13.0.2

jetpack / functions.compat.php

jetpack Last commit date

functions.compat.php

155 lines

1	<?php // phpcs:ignore WordPress.Files.FileName.NotHyphenatedLowercase
2	/**
3	* Compatibility functions for YouTube URLs and WP.com helper functions.
4	*
5	* @package automattic/jetpack
6	*/
7
8	use Automattic\Jetpack\Connection\Manager as Connection_Manager;
9
10	/**
11	* Required for class.media-extractor.php to match expected function naming convention.
12	*
13	* @param $url Can be just the $url or the whole $atts array.
14	* @return bool\|mixed The Youtube video ID via jetpack_get_youtube_id
15	*/
16	function jetpack_shortcode_get_youtube_id( $url ) {
17	return jetpack_get_youtube_id( $url );
18	}
19
20	/**
21	* Extract video ID from a YouTube url.
22	*
23	* @param string $url YouTube URL.
24	* @return bool\|mixed The Youtube video ID
25	*/
26	function jetpack_get_youtube_id( $url ) {
27	// Do we have an $atts array? Get first att
28	if ( is_array( $url ) ) {
29	$url = reset( $url );
30	}
31
32	$url = youtube_sanitize_url( $url );
33	$url = wp_parse_url( $url );
34	$id = false;
35
36	if ( ! isset( $url['query'] ) ) {
37	return false;
38	}
39
40	parse_str( $url['query'], $qargs );
41
42	if ( ! isset( $qargs['v'] ) && ! isset( $qargs['list'] ) ) {
43	return false;
44	}
45
46	if ( isset( $qargs['list'] ) ) {
47	$id = preg_replace( '\|[^_a-z0-9-]\|i', '', $qargs['list'] );
48	}
49
50	if ( empty( $id ) ) {
51	$id = preg_replace( '\|[^_a-z0-9-]\|i', '', $qargs['v'] );
52	}
53
54	return $id;
55	}
56
57	if ( ! function_exists( 'youtube_sanitize_url' ) ) :
58	/**
59	* Normalizes a YouTube URL to include a v= parameter and a query string free of encoded ampersands.
60	*
61	* @param string $url YouTube URL.
62	* @return string The normalized URL
63	*/
64	function youtube_sanitize_url( $url ) {
65	$url = trim( $url, ' "' );
66	$url = trim( $url );
67	$url = str_replace( array( 'youtu.be/', '/v/', '#!v=', '&', '&', 'playlist' ), array( 'youtu.be/?v=', '/?v=', '?v=', '&', '&', 'videoseries' ), $url );
68
69	// Replace any extra question marks with ampersands - the result of a URL like "https://www.youtube.com/v/9FhMMmqzbD8?fs=1&hl=en_US" being passed in.
70	$query_string_start = strpos( $url, '?' );
71
72	if ( false !== $query_string_start ) {
73	$url = substr( $url, 0, $query_string_start + 1 ) . str_replace( '?', '&', substr( $url, $query_string_start + 1 ) );
74	}
75
76	return $url;
77	}
78	endif;
79
80	/**
81	* Merge in three string helper functions from WPCOM to make working with strings easier.
82	*
83	* @see WPCOM/wp-content/mu-plugins/string-helpers.php
84	*/
85	if ( ! function_exists( 'wp_startswith' ) ) :
86	/**
87	* Check whether a string starts with a specific substring.
88	*
89	* @param string $haystack String we are filtering.
90	* @param string $needle The substring we are looking for.
91	* @return bool
92	*/
93	function wp_startswith( $haystack, $needle ) {
94	if ( ! $haystack \|\| ! $needle \|\| ! is_scalar( $haystack ) \|\| ! is_scalar( $needle ) ) {
95	return false;
96	}
97
98	$haystack = (string) $haystack;
99	$needle = (string) $needle;
100
101	return str_starts_with( $haystack, $needle );
102	}
103	endif;
104
105	if ( ! function_exists( 'wp_endswith' ) ) :
106	/**
107	* Check whether a string ends with a specific substring.
108	*
109	* @param string $haystack String we are filtering.
110	* @param string $needle The substring we are looking for.
111	* @return bool
112	*/
113	function wp_endswith( $haystack, $needle ) {
114	if ( ! $haystack \|\| ! $needle \|\| ! is_scalar( $haystack ) \|\| ! is_scalar( $needle ) ) {
115	return false;
116	}
117
118	$haystack = (string) $haystack;
119	$needle = (string) $needle;
120
121	return str_ends_with( $haystack, $needle );
122	}
123	endif;
124
125	if ( ! function_exists( 'wp_in' ) ) :
126	/**
127	* Checks whether a string contains a specific substring.
128	*
129	* @param string $needle The substring we are looking for.
130	* @param string $haystack String we are filtering.
131	* @return bool
132	*/
133	function wp_in( $needle, $haystack ) {
134	if ( ! $haystack \|\| ! $needle \|\| ! is_scalar( $haystack ) \|\| ! is_scalar( $needle ) ) {
135	return false;
136	}
137
138	$haystack = (string) $haystack;
139	$needle = (string) $needle;
140
141	return str_contains( $haystack, $needle );
142	}
143	endif;
144
145	/**
146	* Deprecated connection function.
147	*
148	* @param string $text Deprecated.
149	* @deprecated 7.5 Use Connection_Manager instead.
150	*/
151	function jetpack_sha1_base64( $text ) {
152	$connection = new Connection_Manager();
153	return $connection->sha1_base64( $text );
154	}
155