get_oembed_response_data_for_url() │ WP 5.0.0

Отримує oEmbed дані для URL поточного сайту.

Завдання цієї функції спробувати знайти запис на поточному сайті відповідного переданого URL. Якщо такий запис знайдено, то для нього буде створено відповідь вбудовування (якби ми отримали відповідь з маршурту для вбудовування контенту).

За промовчанням ця функція повішена на хук pre_oembed_result :

add_filter( 'pre_oembed_result', 'wp_filter_pre_oembed_result', 10, 3);

Завдання цього хука обробити URL в контенті в процесі вбудовування, і якщо це URL на запис поточного сайту, сформувати відповідь вбудовування без додаткових HTTP discover запитів.

Працює на основі:
url_to_postid()

Хуки з функції

oembed_request_post_id

Повертає

Объект|false. oEmbed дані (такі як HTTP відповідь для oEmbed маршруту), якщо URL належить поточному сайту. False інакше.

Використання

get_oembed_response_data_for_url( $url, $args );

$url (рядок) (обов’язковий): URL, який потрібно перевірити, чи є він посиланням на запис поточного сайту.
$args (масив) (обов’язковий): Параметри відповіді oEmbed. Підтримується один параметр
width– ширина iframe.

Приклади

#1 Демонстрація роботи фукнції

$url = 'https://wp-doc.com/id_5875/30-css-selektorov.html';

$data = get_oembed_response_data_for_url( $url, [ 'width' => 400 ] );

print_r ($ data);

Отримаємо:

stdClass Object
(
	[version] => 1.0
	[provider_name] => WordPress як на долоні
	[provider_url] => https://wp-doc.com
	[author_name] => Kama
	[author_url] => https://wp-doc.com/id_author/kama-2-2
	[title] => Селектори в CSS
	[type] => rich
	[width] => 400
	[height] => 225
	[html] => <blockquote class="wp-embedded-content"><a href="/id_5875/30-css-selektorov.html"
		>Селектори в CSS</a></blockquote>
		<script type='text/javascript'>
		<!--//--><![CDATA[//><!--
				/*! Цей файл є auto-generated */
				!function(c,d){"use strict";var e=!1,n=!1;if(d.querySelector)if(c.addEventListener)e=!0;if(c.wp=c.wp ||
				{},!c.wp.receiveEmbedMessage)if(c.wp.receiveEmbedMessage=function(e){var t = e.data; if (t)
				if(!/[^a-zA-Z0-9]/.test(t.secret)){for(var r,a,i,s=d.querySelectorAll('iframe[data-secret="'+t .secret+'"]'),
				n=d.querySelectorAll('blockquote[data-secret="'+t.secret+'"]'),o=0;o<n.length;o++)n[o].style.display="none";
				for(o=0;o<s.length;o++)if(r=s[o],e.source===r.contentWindow){if(r.removeAttribute("style"),"height"== = t.message) {
				if(1e3<(i=parseInt(t.value,10)))i=1e3;else if(~~i<200)i=200;r.height=i}if("link"===t. message)
				if(a=d.createElement("a"),i=d.createElement("a"),a.href=r.getAttribute("src"),i.href=t.value,i.host== =a.host)
				if(d.activeElement===r)c.top.location.href=t.value}}},e)c.addEventListener("message",c.wp.receiveEmbedMessage,!1),
				d.addEventListener("DOMContentLoaded",t,!1),c.addEventListener("load",t,!1);function t(){if(!n){n=!0;
				for(var e,t,r=-1!==navigator.appVersion.indexOf("MSIE 10"),a=!!navigator.userAgent.match(/Trident.*rv:11./),
				i=d.querySelectorAll("iframe.wp-embedded-content"),s=0;s<i.length;s++){
				if(!(e=i[s]).getAttribute("data-secret"))t=Math.random().toString(36).substr(2,10),
				e.src+="#?secret="+t,e.setAttribute("data-secret",t);if(r||a)(t=e.cloneNode(!0)).removeAttribute("security" ),
				e.parentNode.replaceChild(t,e)}}}}(window,document);
		//--><!]]>
		</script><iframe sandbox="allow-scripts" security="restricted"
		src="/id_5875/30-css-selektorov.html/embed" width="400" height="225"
		title=""Селектори в CSS" — WordPress як на долоні" frameborder="0"
		marginwidth="0" marginheight="0" scrolling="no" class="wp-embedded-content"></iframe>
	[thumbnail_url] => https://wp-doc.com/wp-content/uploads/2015/06/selektory-css.png
	[thumbnail_width] => 400
	[thumbnail_height] => 376
)

#2 Видалимо oEmbed вбудовування для внутрішніх посилань сайту (URL поточного сайту)

Наприклад. Нам потрібно, щоб вбудовування не працювало, коли ми вказуємо у пості посилання на поточний сайт на окремому рядку. Для цього потрібно вимкнути цей хук:

// Remove filter of the oEmbed result before any HTTP requests are made.
remove_filter( 'pre_oembed_result', 'wp_filter_pre_oembed_result', 10);

список змін

З версії 5.0.0

Введено.

get oembed response data for url ^{WP 6.0.2}

wp-includes/embed.php

function get_oembed_response_data_for_url( $url, $args ) {
	$ switched_blog = false;

	if ( is_multisite() ) {
		$url_parts = wp_parse_args(
			wp_parse_url( $url ),
			array(
				'host' => '',
				'path' => '/',
			)
		);

		$qv = array(
			'domain' => $url_parts['host'],
			'path' => '/',
			'update_site_meta_cache' => false,
		);

		// У випадку з subdirectory configs, set the path.
		if ( ! is_subdomain_install() ) {
			$path = explode( '/', ltrim( $url_parts['path'], '/' ) );
			$ path = reset ($ path);

			if ($ path) {
				$qv['path'] = get_network()->path . $ path . '/';
			}
		}

		$ Sites = get_sites ($ QV);
		$ Site = reset ($ Sites);

		// Do not allow embeds for deleted/archived/spam sites.
		if ( ! empty( $site->deleted ) || ! empty( $site->spam ) || ! empty( $site->archived ) ) {
			return false;
		}

		if ( $site && get_current_blog_id() !== (int) $site->blog_id ) {
			switch_to_blog($site->blog_id);
			$ switched_blog = true;
		}
	}

	$post_id = url_to_postid($url);

	/** Цей filter is documented в wp-includes/class-wp-oembed-controller.php */
	$post_id = apply_filters( 'oembed_request_post_id', $post_id, $url );

	if (! $post_id) {
		if ( $switched_blog ) {
			restore_current_blog();
		}

		return false;
	}

	$ width = isset ($ args ['width'])? $args['width'] : 0;

	$ data = get_oembed_response_data ($ post_id, $ width);

	if ( $switched_blog ) {
		restore_current_blog();
	}

	return $data ? (object) $ data : false;
}

get_oembed_response_data_for_url() │ WP 5.0.0

Хуки з функції

Повертає

Використання

Приклади

#1 Демонстрація роботи фукнції

#2 Видалимо oEmbed вбудовування для внутрішніх посилань сайту (URL поточного сайту)

список змін

get oembed response data for url WP 6.0.2

Зв’язані функції

WP Embeds (oEmbed) (вбудовування URL у контент) (відповідь WP на запит вбудовування)

Залишити відповідь Скасувати коментар

get oembed response data for url ^{WP 6.0.2}