General PHPDoc improvements in wp-includes/media.php for 3.9 functionality.
See #27700. Built from https://develop.svn.wordpress.org/trunk@28004 git-svn-id: http://core.svn.wordpress.org/trunk@27834 1a063a9b-81f0-0310-95a4-ce76da25c4cd
This commit is contained in:
parent
c2e0a4bf46
commit
eebf49c180
|
@ -1009,7 +1009,7 @@ function gallery_shortcode( $attr ) {
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Output the templates used by playlists
|
* Output the templates used by playlists.
|
||||||
*
|
*
|
||||||
* @since 3.9.0
|
* @since 3.9.0
|
||||||
*/
|
*/
|
||||||
|
@ -1051,7 +1051,7 @@ function wp_underscore_playlist_templates() {
|
||||||
*
|
*
|
||||||
* @since 3.9.0
|
* @since 3.9.0
|
||||||
*
|
*
|
||||||
* @param string $type Type of playlist: "audio" or "video."
|
* @param string $type Type of playlist. Accepts 'audio' or 'video'.
|
||||||
*/
|
*/
|
||||||
function wp_playlist_scripts( $type ) {
|
function wp_playlist_scripts( $type ) {
|
||||||
wp_enqueue_style( 'wp-mediaelement' );
|
wp_enqueue_style( 'wp-mediaelement' );
|
||||||
|
@ -1064,14 +1064,14 @@ function wp_playlist_scripts( $type ) {
|
||||||
add_action( 'wp_playlist_scripts', 'wp_playlist_scripts' );
|
add_action( 'wp_playlist_scripts', 'wp_playlist_scripts' );
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* The Playlist shortcode.
|
* The playlist shortcode.
|
||||||
*
|
*
|
||||||
* This implements the functionality of the Playlist Shortcode for displaying
|
* This implements the functionality of the playlist shortcode for displaying
|
||||||
* a collection of WordPress audio or video files in a post.
|
* a collection of WordPress audio or video files in a post.
|
||||||
*
|
*
|
||||||
* @since 3.9.0
|
* @since 3.9.0
|
||||||
*
|
*
|
||||||
* @param array $attr Attributes of the shortcode.
|
* @param array $attr Playlist shortcode attributes.
|
||||||
* @return string Playlist output. Empty string if the passed type is unsupported.
|
* @return string Playlist output. Empty string if the passed type is unsupported.
|
||||||
*/
|
*/
|
||||||
function wp_playlist_shortcode( $attr ) {
|
function wp_playlist_shortcode( $attr ) {
|
||||||
|
@ -1260,8 +1260,8 @@ function wp_playlist_shortcode( $attr ) {
|
||||||
*
|
*
|
||||||
* @since 3.9.0
|
* @since 3.9.0
|
||||||
*
|
*
|
||||||
* @param string $type Type of playlist: "audio" or "video."
|
* @param string $type Type of playlist. Possible values are 'audio' or 'video'.
|
||||||
* @param string $style The "theme" for the playlist. Core provides "light" and "dark."
|
* @param string $style The 'theme' for the playlist. Core provides 'light' and 'dark'.
|
||||||
*/
|
*/
|
||||||
do_action( 'wp_playlist_scripts', $type, $style );
|
do_action( 'wp_playlist_scripts', $type, $style );
|
||||||
} ?>
|
} ?>
|
||||||
|
@ -1317,9 +1317,9 @@ function wp_get_audio_extensions() {
|
||||||
*
|
*
|
||||||
* @since 3.9.0
|
* @since 3.9.0
|
||||||
*
|
*
|
||||||
* @param WP_Post $attachment The attachment in question, provided for context.
|
* @param WP_Post $attachment The current attachment, provided for context.
|
||||||
* @param string $context The context. Accepts 'edit', 'display'. Default 'display'.
|
* @param string $context The context. Accepts 'edit', 'display'. Default 'display'.
|
||||||
* @return array
|
* @return array Key/value pairs of field keys to labels.
|
||||||
*/
|
*/
|
||||||
function wp_get_attachment_id3_keys( $attachment, $context = 'display' ) {
|
function wp_get_attachment_id3_keys( $attachment, $context = 'display' ) {
|
||||||
$fields = array(
|
$fields = array(
|
||||||
|
@ -2734,11 +2734,11 @@ function get_post_gallery_images( $post = 0 ) {
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* If an attachment is missing its metadata, try to generate it.
|
* Maybe attempt to generate attachment metadata, if missing.
|
||||||
*
|
*
|
||||||
* @since 3.9.0
|
* @since 3.9.0
|
||||||
*
|
*
|
||||||
* @param post $attachment Post object.
|
* @param WP_Post $attachment Attachment object.
|
||||||
*/
|
*/
|
||||||
function wp_maybe_generate_attachment_metadata( $attachment ) {
|
function wp_maybe_generate_attachment_metadata( $attachment ) {
|
||||||
if ( empty( $attachment ) || ( empty( $attachment->ID ) || ! $attachment_id = (int) $attachment->ID ) ) {
|
if ( empty( $attachment ) || ( empty( $attachment->ID ) || ! $attachment_id = (int) $attachment->ID ) ) {
|
||||||
|
@ -2759,13 +2759,13 @@ function wp_maybe_generate_attachment_metadata( $attachment ) {
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Determine if a post supports thumbnails based on the passed $post
|
* Determine if a post supports thumbnails based on the passed post object.
|
||||||
*
|
*
|
||||||
* @since 3.9.0
|
* @since 3.9.0
|
||||||
*
|
*
|
||||||
* @param WP_Post $post
|
* @param WP_Post $post Post object.
|
||||||
*
|
*
|
||||||
* @return boolean
|
* @return bool Whether the post type supports thumbnails.
|
||||||
*/
|
*/
|
||||||
function post_supports_thumbnails( $post ) {
|
function post_supports_thumbnails( $post ) {
|
||||||
if ( 'attachment' === $post->post_type ) {
|
if ( 'attachment' === $post->post_type ) {
|
||||||
|
@ -2780,13 +2780,13 @@ function post_supports_thumbnails( $post ) {
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Determine if a theme supports thumbnails based on the passed $post
|
* Determine if a theme supports thumbnails based on the passed post object.
|
||||||
*
|
*
|
||||||
* @since 3.9.0
|
* @since 3.9.0
|
||||||
*
|
*
|
||||||
* @param WP_Post $post
|
* @param WP_Post $post Post object.
|
||||||
*
|
*
|
||||||
* @return boolean
|
* @return bool Whether the current theme supports thumbnails.
|
||||||
*/
|
*/
|
||||||
function theme_supports_thumbnails( $post ) {
|
function theme_supports_thumbnails( $post ) {
|
||||||
if ( 'attachment' === $post->post_type ) {
|
if ( 'attachment' === $post->post_type ) {
|
||||||
|
|
Loading…
Reference in New Issue