get_enclosed() WordPress Function
The get_enclosed() WordPress function retrieves the first enclosed item in a post. This function is useful for getting the first link or audio file from a post.
get_enclosed( int $post_id ) #
Retrieve enclosures already enclosed for a post.
Parameters
- $post_id
(int)(Required)Post ID.
Return
(string[]) Array of enclosures for the given post.
Source
File: wp-includes/post.php
function get_enclosed( $post_id ) { $custom_fields = get_post_custom( $post_id ); $pung = array(); if ( ! is_array( $custom_fields ) ) { return $pung; } foreach ( $custom_fields as $key => $val ) { if ( 'enclosure' !== $key || ! is_array( $val ) ) { continue; } foreach ( $val as $enc ) { $enclosure = explode( "\n", $enc ); $pung[] = trim( $enclosure[0] ); } } /** * Filters the list of enclosures already enclosed for the given post. * * @since 2.0.0 * * @param string[] $pung Array of enclosures for the given post. * @param int $post_id Post ID. */ return apply_filters( 'get_enclosed', $pung, $post_id ); }
Expand full source codeCollapse full source codeView on TracView on GitHub
Changelog
Version | Description |
---|---|
1.5.0 | Introduced. |