wp_embed_handler_youtube() — описание функции WordPress на русском

Сигнатура

wp_embed_handler_youtube( array $matches, array $attr, string $url, array $rawattr ): string

Описание

Перехватывает URL-адреса встраивания iframe YouTube, которые не распознаются oEmbed, но могут быть преобразованы в распознаваемый URL.

Оригинал (английский)

Catches YouTube iframe embed URLs that are not parsable by oEmbed but can be translated into a URL that is.

Параметры

$matches array обязательный

Совпадения регулярного выражения, полученные при вызове wp_embed_register_handler() .

$attr array обязательный

Атрибуты встраивания.

$url string обязательный

Исходный URL, совпавший с регулярным выражением.

$rawattr array обязательный

Исходные неизменённые атрибуты.

Возвращаемое значение

string

Исходный код

wp-includes/embed.php:242

function wp_embed_handler_youtube( $matches, $attr, $url, $rawattr ) {
	global $wp_embed;
	$embed = $wp_embed->autoembed( sprintf( 'https://youtube.com/watch?v=%s', urlencode( $matches[2] ) ) );

	/**
	 * Filters the YouTube embed output.
	 *
	 * @since 4.0.0
	 *
	 * @see wp_embed_handler_youtube()
	 *
	 * @param string $embed   YouTube embed output.
	 * @param array  $attr    An array of embed attributes.
	 * @param string $url     The original URL that was matched by the regex.
	 * @param array  $rawattr The original unmodified attributes.
	 */
	return apply_filters( 'wp_embed_handler_youtube', $embed, $attr, $url, $rawattr );
}

История изменений

Версия	Описание
4.0.0	Introduced.