do_enclose() │ WP 1.5.0

Проверяет указанную запись на наличие в её контенте ссылок на Видео и Аудио. Если ссылки найдены, то добавляет эти URL в мета-поля enclosure.

Перед добавлением очередного мета-поля enclosure проверяет нет ли уже таких же данных. Удаляет метаполе enclosure, которые были удалены из поста.

Это внутренняя функцию WP. Запускается в функции do_all_enclosures(), которая в свою очередь срабатывает по крону на хуке do_all_pings:

add_action( 'publish_post', '_publish_post_hook', 5, 1 ); // тут создается крон задача
	→ wp_schedule_single_event( time(), 'do_pings' );
		// это срабатывает по Крону
		→ add_action( 'do_pings', 'do_all_pings', 10, 0 );
			→ add_action( 'do_all_pings', 'do_all_enclosures', 10, 0 );

Как это работает подробнее читайте здесь.

Читайте также: WP Cron.

Работает на основе: get_enclosed(), wp_extract_urls()
Хуки из функции

Возвращает

null|false. Null при успехе и false, если пост не найден.

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

do_enclose( $content, $post );
$content(строка|null) (обязательный)
Обычно тут указываетcя null! Контент поста. Если null, используется поле post_content из $post.
$post(int|WP_Post) (обязательный)
ID поста или объект поста.

Примеры

0

#1 Использование в ядре WP

Смотрите код функции do_all_enclosures().

Заметки

  • Global. wpdb. $wpdb WordPress database abstraction object.

Список изменений

С версии 1.5.0 Введена.
С версии 5.3.0 The $content parameter was made optional, and the $post parameter was updated to accept a post ID or a WP_Post object.
С версии 5.6.0 The $content parameter is no longer optional, but passing null to skip it is still supported.

Код do_enclose() WP 6.2.2

wp-includes/functions.php 
function do_enclose( $content, $post ) {
	global $wpdb;

	// @todo Tidy this code and make the debug code optional.
	include_once ABSPATH . WPINC . '/class-IXR.php';

	$post = get_post( $post );
	if ( ! $post ) {
		return false;
	}

	if ( null === $content ) {
		$content = $post->post_content;
	}

	$post_links = array();

	$pung = get_enclosed( $post->ID );

	$post_links_temp = wp_extract_urls( $content );

	foreach ( $pung as $link_test ) {
		// Link is no longer in post.
		if ( ! in_array( $link_test, $post_links_temp, true ) ) {
			$mids = $wpdb->get_col( $wpdb->prepare( "SELECT meta_id FROM $wpdb->postmeta WHERE post_id = %d AND meta_key = 'enclosure' AND meta_value LIKE %s", $post->ID, $wpdb->esc_like( $link_test ) . '%' ) );
			foreach ( $mids as $mid ) {
				delete_metadata_by_mid( 'post', $mid );
			}
		}
	}

	foreach ( (array) $post_links_temp as $link_test ) {
		// If we haven't pung it already.
		if ( ! in_array( $link_test, $pung, true ) ) {
			$test = parse_url( $link_test );
			if ( false === $test ) {
				continue;
			}
			if ( isset( $test['query'] ) ) {
				$post_links[] = $link_test;
			} elseif ( isset( $test['path'] ) && ( '/' !== $test['path'] ) && ( '' !== $test['path'] ) ) {
				$post_links[] = $link_test;
			}
		}
	}

	/**
	 * Filters the list of enclosure links before querying the database.
	 *
	 * Allows for the addition and/or removal of potential enclosures to save
	 * to postmeta before checking the database for existing enclosures.
	 *
	 * @since 4.4.0
	 *
	 * @param string[] $post_links An array of enclosure links.
	 * @param int      $post_id    Post ID.
	 */
	$post_links = apply_filters( 'enclosure_links', $post_links, $post->ID );

	foreach ( (array) $post_links as $url ) {
		$url = strip_fragment_from_url( $url );

		if ( '' !== $url && ! $wpdb->get_var( $wpdb->prepare( "SELECT post_id FROM $wpdb->postmeta WHERE post_id = %d AND meta_key = 'enclosure' AND meta_value LIKE %s", $post->ID, $wpdb->esc_like( $url ) . '%' ) ) ) {

			$headers = wp_get_http_headers( $url );
			if ( $headers ) {
				$len           = isset( $headers['Content-Length'] ) ? (int) $headers['Content-Length'] : 0;
				$type          = isset( $headers['Content-Type'] ) ? $headers['Content-Type'] : '';
				$allowed_types = array( 'video', 'audio' );

				// Check to see if we can figure out the mime type from the extension.
				$url_parts = parse_url( $url );
				if ( false !== $url_parts && ! empty( $url_parts['path'] ) ) {
					$extension = pathinfo( $url_parts['path'], PATHINFO_EXTENSION );
					if ( ! empty( $extension ) ) {
						foreach ( wp_get_mime_types() as $exts => $mime ) {
							if ( preg_match( '!^(' . $exts . ')$!i', $extension ) ) {
								$type = $mime;
								break;
							}
						}
					}
				}

				if ( in_array( substr( $type, 0, strpos( $type, '/' ) ), $allowed_types, true ) ) {
					add_post_meta( $post->ID, 'enclosure', "$url\n$len\n$mime\n" );
				}
			}
		}
	}
}

Cron API