| 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|array $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|array $url YouTube URL. |
| 62 |
* @return string|array The normalized URL or false if input is invalid. |
| 63 |
*/ |
| 64 |
function youtube_sanitize_url( $url ) { |
| 65 |
if ( is_array( $url ) && isset( $url['url'] ) ) { |
| 66 |
$url = $url['url']; |
| 67 |
} |
| 68 |
if ( ! is_string( $url ) ) { |
| 69 |
return false; |
| 70 |
} |
| 71 |
|
| 72 |
$url = trim( $url, ' "' ); |
| 73 |
$url = trim( $url ); |
| 74 |
$url = str_replace( array( 'youtu.be/', '/v/', '#!v=', '&', '&', 'playlist' ), array( 'youtu.be/?v=', '/?v=', '?v=', '&', '&', 'videoseries' ), $url ); |
| 75 |
|
| 76 |
// 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. |
| 77 |
$query_string_start = strpos( $url, '?' ); |
| 78 |
|
| 79 |
if ( false !== $query_string_start ) { |
| 80 |
$url = substr( $url, 0, $query_string_start + 1 ) . str_replace( '?', '&', substr( $url, $query_string_start + 1 ) ); |
| 81 |
} |
| 82 |
|
| 83 |
return $url; |
| 84 |
} |
| 85 |
endif; |
| 86 |
|
| 87 |
/** |
| 88 |
* Merge in three string helper functions from WPCOM to make working with strings easier. |
| 89 |
* |
| 90 |
* @see WPCOM/wp-content/mu-plugins/string-helpers.php |
| 91 |
*/ |
| 92 |
if ( ! function_exists( 'wp_startswith' ) ) : |
| 93 |
/** |
| 94 |
* Check whether a string starts with a specific substring. |
| 95 |
* |
| 96 |
* @param string $haystack String we are filtering. |
| 97 |
* @param string $needle The substring we are looking for. |
| 98 |
* @return bool |
| 99 |
*/ |
| 100 |
function wp_startswith( $haystack, $needle ) { |
| 101 |
if ( ! $haystack || ! $needle || ! is_scalar( $haystack ) || ! is_scalar( $needle ) ) { |
| 102 |
return false; |
| 103 |
} |
| 104 |
|
| 105 |
$haystack = (string) $haystack; |
| 106 |
$needle = (string) $needle; |
| 107 |
|
| 108 |
return str_starts_with( $haystack, $needle ); |
| 109 |
} |
| 110 |
endif; |
| 111 |
|
| 112 |
if ( ! function_exists( 'wp_endswith' ) ) : |
| 113 |
/** |
| 114 |
* Check whether a string ends with a specific substring. |
| 115 |
* |
| 116 |
* @param string $haystack String we are filtering. |
| 117 |
* @param string $needle The substring we are looking for. |
| 118 |
* @return bool |
| 119 |
*/ |
| 120 |
function wp_endswith( $haystack, $needle ) { |
| 121 |
if ( ! $haystack || ! $needle || ! is_scalar( $haystack ) || ! is_scalar( $needle ) ) { |
| 122 |
return false; |
| 123 |
} |
| 124 |
|
| 125 |
$haystack = (string) $haystack; |
| 126 |
$needle = (string) $needle; |
| 127 |
|
| 128 |
return str_ends_with( $haystack, $needle ); |
| 129 |
} |
| 130 |
endif; |
| 131 |
|
| 132 |
if ( ! function_exists( 'wp_in' ) ) : |
| 133 |
/** |
| 134 |
* Checks whether a string contains a specific substring. |
| 135 |
* |
| 136 |
* @param string $needle The substring we are looking for. |
| 137 |
* @param string $haystack String we are filtering. |
| 138 |
* @return bool |
| 139 |
*/ |
| 140 |
function wp_in( $needle, $haystack ) { |
| 141 |
if ( ! $haystack || ! $needle || ! is_scalar( $haystack ) || ! is_scalar( $needle ) ) { |
| 142 |
return false; |
| 143 |
} |
| 144 |
|
| 145 |
$haystack = (string) $haystack; |
| 146 |
$needle = (string) $needle; |
| 147 |
|
| 148 |
return str_contains( $haystack, $needle ); |
| 149 |
} |
| 150 |
endif; |
| 151 |
|
| 152 |
/** |
| 153 |
* Deprecated connection function. |
| 154 |
* |
| 155 |
* @param string $text Deprecated. |
| 156 |
* @deprecated 7.5 Use Connection_Manager instead. |
| 157 |
*/ |
| 158 |
function jetpack_sha1_base64( $text ) { |
| 159 |
$connection = new Connection_Manager(); |
| 160 |
return $connection->sha1_base64( $text ); |
| 161 |
} |
| 162 |
|
