jetpack / jetpack_vendor / automattic / jetpack-videopress / src / class-utils.php

class-utils.php in Jetpack – WP Security, Backup, Speed, & Growth 16.3-a.5, at jetpack_vendor/automattic/jetpack-videopress/src/class-utils.php

102 lines 3.3 KB

Raw Download Zip

1	<?php
2	/**
3	* The Utils class.
4	*
5	* @package automattic/jetpack-videopress
6	*/
7
8	namespace Automattic\Jetpack\VideoPress;
9
10	/**
11	* The Utils class.
12	*/
13	class Utils {
14	/**
15	* Build a VideoPress video URL based on the guid and block attributes.
16	*
17	* @param string\|null $guid - Video GUID; null returns null.
18	* @param array $attributes - Video block attributes. Default is an empty array.
19	*
20	* @return string\|null VideoPress video URL with the specified attributes, or null without a guid.
21	*/
22	public static function get_video_press_url( $guid, $attributes = array() ) {
23	if ( ! $guid ) {
24	return null;
25	}
26
27	$video_press_url_options = wp_parse_args(
28	$attributes,
29	array(
30	'autoplay' => false,
31	'controls' => true,
32	'loop' => false,
33	'muted' => false,
34	'playsinline' => false,
35	'poster' => '',
36	'preload' => 'metadata',
37	'seekbarColor' => '',
38	'seekbarPlayedColor' => '',
39	'seekbarLoadingColor' => '',
40	'useAverageColor' => true,
41	)
42	);
43
44	// The site-wide opt-out wins over the block's own preload attribute.
45	if ( Data::get_videopress_player_preload_disabled() ) {
46	$video_press_url_options['preload'] = 'none';
47	}
48
49	$query_args = array(
50	'resizeToParent' => 1,
51	'cover' => 1,
52	'autoPlay' => (int) $video_press_url_options['autoplay'],
53	'controls' => (int) $video_press_url_options['controls'],
54	'loop' => (int) $video_press_url_options['loop'],
55	'muted' => (int) $video_press_url_options['muted'],
56	'persistVolume' => $video_press_url_options['muted'] ? 0 : 1,
57	'playsinline' => (int) $video_press_url_options['playsinline'],
58	'preloadContent' => $video_press_url_options['preload'],
59	'sbc' => $video_press_url_options['seekbarColor'],
60	'sbpc' => $video_press_url_options['seekbarPlayedColor'],
61	'sblc' => $video_press_url_options['seekbarLoadingColor'],
62	'useAverageColor' => (int) $video_press_url_options['useAverageColor'],
63	);
64
65	if ( ! empty( $video_press_url_options['poster'] ) ) {
66	$query_args['posterUrl'] = rawurlencode( $video_press_url_options['poster'] );
67	}
68
69	$url = 'https://videopress.com/v/' . $guid;
70	return add_query_arg( $query_args, $url );
71	}
72
73	/**
74	* Determines if a given URL is a VideoPress URL.
75	*
76	* @since x.x.x
77	*
78	* @param mixed $url The URL to check. Non-strings return false.
79	* @return bool True if the URL is a VideoPress URL, false otherwise.
80	*/
81	public static function is_videopress_url( $url ) {
82	return null !== self::extract_videopress_guid_from_url( $url );
83	}
84
85	/**
86	* Extract the VideoPress guid from a recognised VideoPress URL.
87	*
88	* @param mixed $url The URL to inspect. Non-strings return null.
89	* @return string\|null The 8-character guid, or null if the URL is not a recognised VideoPress URL.
90	*/
91	public static function extract_videopress_guid_from_url( $url ) {
92	if ( ! is_string( $url ) ) {
93	return null;
94	}
95	$pattern = '/^https?:\/\/(?:(?:v(?:ideo)?\.wordpress\.com\|videopress\.com)\/(?:v\|embed)\|v\.wordpress\.com\|videos\.(?:videopress\.com\|files\.wordpress\.com))\/([a-z\d]{8})(\/\|\b)/i'; // phpcs:ignore WordPress.WP.CapitalPDangit.MisspelledInText
96	if ( preg_match( $pattern, $url, $matches ) ) {
97	return $matches[1];
98	}
99	return null;
100	}
101	}
102