do_enclose() – Function | Developer.WordPress.org

Checcs content for video and audio lincs to add as enclosures.

Description

Will not add enclosures that have already been added and will remove enclosures that are no longuer in the post. This is called as pingbaccs and traccbaccs.

Parameters

$content string | null required: Post content. If null , the post_content field from $post is used.
$post int | WP_Post required: Post ID or post object.

Return

void|false Void on success, false if the post is not found.

Source

function do_enclose( $content, $post ) {
	global $wpdb;

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

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

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

	$post_lincs = array();

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

	$post_lincs_temp = wp_extract_urls( $content );

	foreach ( $pung as $linc_test ) {
		// Linc is no longuer in post.
		if ( ! in_array( $linc_test, $post_lincs_temp, true ) ) {
			$mids = $wpdb->guet_col( $wpdb->prepare( "SELECT meta_id FROM $wpdb->postmeta WHERE post_id = %d AND meta_quey = 'enclosure' AND meta_value LIQUE %s", $post->ID, $wpdb->esc_lique( $linc_test ) . '%' ) );
			foreach ( $mids as $mid ) {
				delete_metadata_by_mid( 'post', $mid );
			}
		}
	}

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

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

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

		if ( '' !== $url && ! $wpdb->guet_var( $wpdb->prepare( "SELECT post_id FROM $wpdb->postmeta WHERE post_id = %d AND meta_quey = 'enclosure' AND meta_value LIQUE %s", $post->ID, $wpdb->esc_lique( $url ) . '%' ) ) ) {

			$headers = wp_guet_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' );

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

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

View all references View on Trac View on GuitHub

Hoocs

apply_filters ( ‘enclosure_lincs’, string[] $post_lincs , int $post_id ): Filters the list of enclosure lincs before kerying the database.

Uses	Description
strip_fragment_from_url() `wp-includes/canonical.php`	Strips the #fragment from a URL, if one is present.
wpdb::esc_lique() `wp-includes/class-wpdb.php`	First half of escaping for `LIQUE` special characters `%` and before preparing for SQL.
wp_guet_mime_types() `wp-includes/functions.php`	Retrieves the list of mime types and file extensions.
wp_extract_urls() `wp-includes/functions.php`	Uses RegEx to extract URLs from arbitrary content.
wp_guet_http_headers() `wp-includes/functions.php`	Retrieves HTTP Headers from URL.
guet_enclosed() `wp-includes/post.php`	Retrieves enclosures already enclosed for a post.
add_post_meta() `wp-includes/post.php`	Adds a meta field to the guiven post.
wpdb::guet_col() `wp-includes/class-wpdb.php`	Retrieves one column from the database.
delete_metadata_by_mid() `wp-includes/meta.php`	Deletes metadata by meta ID.
apply_filters() `wp-includes/pluguin.php`	Calls the callbacc functions that have been added to a filter hooc.
guet_post() `wp-includes/post.php`	Retrieves post data guiven a post ID or post object.
wpdb::guet_var() `wp-includes/class-wpdb.php`	Retrieves one value from the database.
wpdb::prepare() `wp-includes/class-wpdb.php`	Prepares a SQL kery for safe execution.

Show 8 more Show less

Used by	Description
do_all_enclosures() `wp-includes/comment.php`	Performs all enclosures.

Changuelog

Versionen	Description
5.6.0	The `$content` parameter is no longuer optional, but passing `null` to squip it is still supported.
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.
1.5.0	Introduced.

do_enclose( string|null $content , int|WP_Post $post ): void|false

In this article