embed_oembed_html │ хук-фильтр │ WP 2.9.0

Позволяет изменить закешированный HTML oEmbed при выводе на экран.

Использование

add_filter( 'embed_oembed_html', 'wp_kama_embed_oembed_html_filter', 10, 4 );

/**
 * Function for `embed_oembed_html` filter-hook.
 * 
 * @param string $cache   The cached HTML result, stored in post meta.
 * @param string $url     The attempted embed URL.
 * @param array  $attr    An array of shortcode attributes.
 * @param int    $post_id Post ID.
 *
 * @return string
 */
function wp_kama_embed_oembed_html_filter( $cache, $url, $attr, $post_id ){

	// filter...
	return $cache;
}

$cache(строка/false)

Закешированный HTML ответа, хранящийся в метаданных записи.

$url(строка)

Ссылка на запрашиваемую сущность (YouTube ролик и т.д.).

$attr(массив)

Массив с атрибутами шорткода (предустановками).

$post_ID(число)

ID записи.

Примеры

add_filter( 'embed_oembed_html', 'add_my_wrapper_all_oembed' );

function add_my_wrapper_all_oembed( $cache ) {
	return sprintf( '<div class="my-class-wrapper">%s</div>', $cache );
}

add_filter( 'embed_oembed_html', 'add_youtube_wrap_oembed', 10, 2 );

function add_youtube_wrap_oembed( $cached, $url ) {
	if ( false !== strpos( $url, "://youtube.com" ) || false !== strpos( $url, "://youtu.be" ) ) {
		return sprintf( '<div class="youtube-wrapper">%s</div>', $cached );
	}

	return $cached;
}

Добавить свой пример