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. |