WordPressを読む　65-3 /blog/wp-includes/media.php 3

2014/12/04 2015/03/09

1 /blog/wp-includes/media.php 3
2 関数　wp_underscore_playlist_templates()
3 関数　wp_playlist_scripts()
4 関数間の処理　wp_playlist_scripts
5 関数　wp_playlist_shortcode()
6 関数間の処理　フックポイント
7 関数　wp_mediaelement_fallback()
8 関数　wp_get_audio_extensions()
9 関数　wp_get_attachment_id3_keys()
10 関数　wp_audio_shortcode()
11 関数間の処理　フックポイント　wp_audio_shortcode

/blog/wp-includes/media.php 3

関数　wp_underscore_playlist_templates()

/**
 * Output the templates used by playlists.
 *
 * @since 3.9.0
 */
function wp_underscore_playlist_templates() {
?>
<script type="text/html" id="tmpl-wp-playlist-current-item">
	<# if ( data.image ) { #>
	<img src="{{ data.thumb.src }}"/>
	<# } #>
	<div class="wp-playlist-caption">
		<span class="wp-playlist-item-meta wp-playlist-item-title">&#8220;{{ data.title }}&#8221;</span>
		<# if ( data.meta.album ) { #><span class="wp-playlist-item-meta wp-playlist-item-album">{{ data.meta.album }}</span><# } #>
		<# if ( data.meta.artist ) { #><span class="wp-playlist-item-meta wp-playlist-item-artist">{{ data.meta.artist }}</span><# } #>
	</div>
</script>
<script type="text/html" id="tmpl-wp-playlist-item">
	<div class="wp-playlist-item">
		<a class="wp-playlist-caption" href="{{ data.src }}">
			{{ data.index ? ( data.index + '. ' ) : '' }}
			<# if ( data.caption ) { #>
				{{ data.caption }}
			<# } else { #>
				<span class="wp-playlist-item-title">&#8220;{{{ data.title }}}&#8221;</span>
				<# if ( data.artists && data.meta.artist ) { #>
				<span class="wp-playlist-item-artist"> &mdash; {{ data.meta.artist }}</span>
				<# } #>
			<# } #>
		</a>
		<# if ( data.meta.length_formatted ) { #>
		<div class="wp-playlist-item-length">{{ data.meta.length_formatted }}</div>
		<# } #>
	</div>
</script>
<?php
}

/**

* Output the templates used by playlists.

* @since 3.9.0

function wp_underscore_playlist_templates() {

<# if ( data.image ) { #>

<# } #>

<span class="wp-playlist-item-meta wp-playlist-item-title">“{{ data.title }}”</span>

<# if ( data.meta.album ) { #><span class="wp-playlist-item-meta wp-playlist-item-album">{{ data.meta.album }}</span><# } #>

<# if ( data.meta.artist ) { #><span class="wp-playlist-item-meta wp-playlist-item-artist">{{ data.meta.artist }}</span><# } #>

</div>

</script>

<# if ( data.caption ) { #>

<# } else { #>

<span class="wp-playlist-item-title">“{{{ data.title }}}”</span>

<# if ( data.artists && data.meta.artist ) { #>

<span class="wp-playlist-item-artist"> — {{ data.meta.artist }}</span>

<# } #>

</a>

<# if ( data.meta.length_formatted ) { #>

<div class="wp-playlist-item-length">{{ data.meta.length_formatted }}</div>

<# } #>

</div>

</script>

<?php

}

関数　wp_playlist_scripts()

/**
 * Output and enqueue default scripts and styles for playlists.
 *
 * @since 3.9.0
 *
 * @param string $type Type of playlist. Accepts 'audio' or 'video'.
 */
function wp_playlist_scripts( $type ) {
	wp_enqueue_style( 'wp-mediaelement' );
	wp_enqueue_script( 'wp-playlist' );
?>
<!--[if lt IE 9]><script>document.createElement('<?php echo esc_js( $type ) ?>');</script><![endif]-->
<?php
	add_action( 'wp_footer', 'wp_underscore_playlist_templates', 0 );
	add_action( 'admin_footer', 'wp_underscore_playlist_templates', 0 );
}

/**

* Output and enqueue default scripts and styles for playlists.

* @since 3.9.0

* @param string $type Type of playlist. Accepts 'audio' or 'video'.

function wp_playlist_scripts( $type ) {

wp_enqueue_style( 'wp-mediaelement' );

wp_enqueue_script( 'wp-playlist' );

<?php

add_action( 'wp_footer', 'wp_underscore_playlist_templates', 0 );

add_action( 'admin_footer', 'wp_underscore_playlist_templates', 0 );

}

関数間の処理　wp_playlist_scripts

add_action( 'wp_playlist_scripts', 'wp_playlist_scripts' );

1	add_action( 'wp_playlist_scripts', 'wp_playlist_scripts' );

関数　wp_playlist_shortcode()

/**
 * The playlist shortcode.
 *
 * This implements the functionality of the playlist shortcode for displaying
 * a collection of WordPress audio or video files in a post.
 *
 * @since 3.9.0
 *
 * @param array $attr {
 *     Array of default playlist attributes.
 *
 *     @type string  $type         Type of playlist to display. Accepts 'audio' or 'video'. Default 'audio'.
 *     @type string  $order        Designates ascending or descending order of items in the playlist.
 *                                 Accepts 'ASC', 'DESC', or 'RAND'. Default 'ASC'.
 *     @type string  $orderby      Any column, or columns, to sort the playlist. If $ids are
 *                                 passed, this defaults to the order of the $ids array ('post__in').
 *                                 Otherwise default is 'menu_order ID'.
 *     @type int     $id           If an explicit $ids array is not present, this parameter
 *                                 will determine which attachments are used for the playlist.
 *                                 Default is the current post ID.
 *     @type array   $ids          Create a playlist out of these explicit attachment IDs. If empty,
 *                                 a playlist will be created from all $type attachments of $id.
 *                                 Default empty.
 *     @type array   $exclude      List of specific attachment IDs to exclude from the playlist. Default empty.
 *     @type string  $style        Playlist style to use. Accepts 'light' or 'dark'. Default 'light'.
 *     @type bool    $tracklist    Whether to show or hide the playlist. Default true.
 *     @type bool    $tracknumbers Whether to show or hide the numbers next to entries in the playlist. Default true.
 *     @type bool    $images       Show or hide the video or audio thumbnail (Featured Image/post
 *                                 thumbnail). Default true.
 *     @type bool    $artists      Whether to show or hide artist name in the playlist. Default true.
 * }
 *
 * @return string Playlist output. Empty string if the passed type is unsupported.
 */
function wp_playlist_shortcode( $attr ) {
	global $content_width;
	$post = get_post();

	static $instance = 0;
	$instance++;

	if ( ! empty( $attr['ids'] ) ) {
		// 'ids' is explicitly ordered, unless you specify otherwise.
		if ( empty( $attr['orderby'] ) ) {
			$attr['orderby'] = 'post__in';
		}
		$attr['include'] = $attr['ids'];
	}

	/**
	 * Filter the playlist output.
	 *
	 * Passing a non-empty value to the filter will short-circuit generation
	 * of the default playlist output, returning the passed value instead.
	 *
	 * @since 3.9.0
	 *
	 * @param string $output Playlist output. Default empty.
	 * @param array  $attr   An array of shortcode attributes.
	 */
	$output = apply_filters( 'post_playlist', '', $attr );
	if ( $output != '' ) {
		return $output;
	}

	/*
	 * We're trusting author input, so let's at least make sure it looks
	 * like a valid orderby statement.
	 */
	if ( isset( $attr['orderby'] ) ) {
		$attr['orderby'] = sanitize_sql_orderby( $attr['orderby'] );
		if ( ! $attr['orderby'] )
			unset( $attr['orderby'] );
	}

	$atts = shortcode_atts( array(
		'type'		=> 'audio',
		'order'		=> 'ASC',
		'orderby'	=> 'menu_order ID',
		'id'		=> $post ? $post->ID : 0,
		'include'	=> '',
		'exclude'   => '',
		'style'		=> 'light',
		'tracklist' => true,
		'tracknumbers' => true,
		'images'	=> true,
		'artists'	=> true
	), $attr, 'playlist' );

	$id = intval( $atts['id'] );
	if ( 'RAND' == $atts['order'] ) {
		$atts['orderby'] = 'none';
	}

	$args = array(
		'post_status' => 'inherit',
		'post_type' => 'attachment',
		'post_mime_type' => $atts['type'],
		'order' => $atts['order'],
		'orderby' => $atts['orderby']
	);

	if ( ! empty( $atts['include'] ) ) {
		$args['include'] = $atts['include'];
		$_attachments = get_posts( $args );

		$attachments = array();
		foreach ( $_attachments as $key => $val ) {
			$attachments[$val->ID] = $_attachments[$key];
		}
	} elseif ( ! empty( $atts['exclude'] ) ) {
		$args['post_parent'] = $id;
		$args['exclude'] = $atts['exclude'];
		$attachments = get_children( $args );
	} else {
		$args['post_parent'] = $id;
		$attachments = get_children( $args );
	}

	if ( empty( $attachments ) ) {
		return '';
	}

	if ( is_feed() ) {
		$output = "\n";
		foreach ( $attachments as $att_id => $attachment ) {
			$output .= wp_get_attachment_link( $att_id ) . "\n";
		}
		return $output;
	}

	$outer = 22; // default padding and border of wrapper

	$default_width = 640;
	$default_height = 360;

	$theme_width = empty( $content_width ) ? $default_width : ( $content_width - $outer );
	$theme_height = empty( $content_width ) ? $default_height : round( ( $default_height * $theme_width ) / $default_width );

	$data = array(
		'type' => $atts['type'],
		// don't pass strings to JSON, will be truthy in JS
		'tracklist' => wp_validate_boolean( $atts['tracklist'] ),
		'tracknumbers' => wp_validate_boolean( $atts['tracknumbers'] ),
		'images' => wp_validate_boolean( $atts['images'] ),
		'artists' => wp_validate_boolean( $atts['artists'] ),
	);

	$tracks = array();
	foreach ( $attachments as $attachment ) {
		$url = wp_get_attachment_url( $attachment->ID );
		$ftype = wp_check_filetype( $url, wp_get_mime_types() );
		$track = array(
			'src' => $url,
			'type' => $ftype['type'],
			'title' => $attachment->post_title,
			'caption' => $attachment->post_excerpt,
			'description' => $attachment->post_content
		);

		$track['meta'] = array();
		$meta = wp_get_attachment_metadata( $attachment->ID );
		if ( ! empty( $meta ) ) {

			foreach ( wp_get_attachment_id3_keys( $attachment ) as $key => $label ) {
				if ( ! empty( $meta[ $key ] ) ) {
					$track['meta'][ $key ] = $meta[ $key ];
				}
			}

			if ( 'video' === $atts['type'] ) {
				if ( ! empty( $meta['width'] ) && ! empty( $meta['height'] ) ) {
					$width = $meta['width'];
					$height = $meta['height'];
					$theme_height = round( ( $height * $theme_width ) / $width );
				} else {
					$width = $default_width;
					$height = $default_height;
				}

				$track['dimensions'] = array(
					'original' => compact( 'width', 'height' ),
					'resized' => array(
						'width' => $theme_width,
						'height' => $theme_height
					)
				);
			}
		}

		if ( $atts['images'] ) {
			$thumb_id = get_post_thumbnail_id( $attachment->ID );
			if ( ! empty( $thumb_id ) ) {
				list( $src, $width, $height ) = wp_get_attachment_image_src( $thumb_id, 'full' );
				$track['image'] = compact( 'src', 'width', 'height' );
				list( $src, $width, $height ) = wp_get_attachment_image_src( $thumb_id, 'thumbnail' );
				$track['thumb'] = compact( 'src', 'width', 'height' );
			} else {
				$src = wp_mime_type_icon( $attachment->ID );
				$width = 48;
				$height = 64;
				$track['image'] = compact( 'src', 'width', 'height' );
				$track['thumb'] = compact( 'src', 'width', 'height' );
			}
		}

		$tracks[] = $track;
	}
	$data['tracks'] = $tracks;

	$safe_type = esc_attr( $atts['type'] );
	$safe_style = esc_attr( $atts['style'] );

	ob_start();

	if ( 1 === $instance ) {
		/**
		 * Print and enqueue playlist scripts, styles, and JavaScript templates.
		 *
		 * @since 3.9.0
		 *
		 * @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'.
		 */
		do_action( 'wp_playlist_scripts', $atts['type'], $atts['style'] );
	} ?>
<div class="wp-playlist wp-<?php echo $safe_type ?>-playlist wp-playlist-<?php echo $safe_style ?>">
	<?php if ( 'audio' === $atts['type'] ): ?>
	<div class="wp-playlist-current-item"></div>
	<?php endif ?>
	<<?php echo $safe_type ?> controls="controls" preload="none" width="<?php
		echo (int) $theme_width;
	?>"<?php if ( 'video' === $safe_type ):
		echo ' height="', (int) $theme_height, '"';
	else:
		echo ' style="visibility: hidden"';
	endif; ?>></<?php echo $safe_type ?>>
	<div class="wp-playlist-next"></div>
	<div class="wp-playlist-prev"></div>
	<noscript>
	<ol><?php
	foreach ( $attachments as $att_id => $attachment ) {
		printf( '<li>%s</li>', wp_get_attachment_link( $att_id ) );
	}
	?></ol>
	</noscript>
	<script type="application/json" class="wp-playlist-script"><?php echo json_encode( $data ) ?></script>
</div>
	<?php
	return ob_get_clean();
}

100

101

102

103

104

105

106

107

108

109

110

111

112

113

114

115

116

117

118

119

120

121

122

123

124

125

126

127

128

129

130

131

132

133

134

135

136

137

138

139

140

141

142

143

144

145

146

147

148

149

150

151

152

153

154

155

156

157

158

159

160

161

162

163

164

165

166

167

168

169

170

171

172

173

174

175

176

177

178

179

180

181

182

183

184

185

186

187

188

189

190

191

192

193

194

195

196

197

198

199

200

201

202

203

204

205

206

207

208

209

210

211

212

213

214

215

216

217

218

219

220

221

222

223

224

225

226

227

228

229

230

231

232

233

234

235

236

237

238

239

240

241

242

243

244

245

246

247

248

249

250

251

/**

* The playlist shortcode.

* This implements the functionality of the playlist shortcode for displaying

* a collection of WordPress audio or video files in a post.

* @since 3.9.0

* @param array $attr {

* Array of default playlist attributes.

* @type string $type Type of playlist to display. Accepts 'audio' or 'video'. Default 'audio'.

* @type string $order Designates ascending or descending order of items in the playlist.

* Accepts 'ASC', 'DESC', or 'RAND'. Default 'ASC'.

* @type string $orderby Any column, or columns, to sort the playlist. If $ids are

* passed, this defaults to the order of the $ids array ('post__in').

* Otherwise default is 'menu_order ID'.

* @type int $id If an explicit $ids array is not present, this parameter

* will determine which attachments are used for the playlist.

* Default is the current post ID.

* @type array $ids Create a playlist out of these explicit attachment IDs. If empty,

* a playlist will be created from all $type attachments of $id.

* Default empty.

* @type array $exclude List of specific attachment IDs to exclude from the playlist. Default empty.

* @type string $style Playlist style to use. Accepts 'light' or 'dark'. Default 'light'.

* @type bool $tracklist Whether to show or hide the playlist. Default true.

* @type bool $tracknumbers Whether to show or hide the numbers next to entries in the playlist. Default true.

* @type bool $images Show or hide the video or audio thumbnail (Featured Image/post

* thumbnail). Default true.

* @type bool $artists Whether to show or hide artist name in the playlist. Default true.

* }

* @return string Playlist output. Empty string if the passed type is unsupported.

function wp_playlist_shortcode( $attr ) {

global $content_width;

$post = get_post();

static $instance = 0;

$instance++;

if ( ! empty( $attr['ids'] ) ) {

// 'ids' is explicitly ordered, unless you specify otherwise.

if ( empty( $attr['orderby'] ) ) {

$attr['orderby'] = 'post__in';

}

$attr['include'] = $attr['ids'];

}

/**

* Filter the playlist output.

* Passing a non-empty value to the filter will short-circuit generation

* of the default playlist output, returning the passed value instead.

* @since 3.9.0

* @param string $output Playlist output. Default empty.

* @param array $attr An array of shortcode attributes.

$output = apply_filters( 'post_playlist', '', $attr );

if ( $output != '' ) {

return $output;

}

* We're trusting author input, so let's at least make sure it looks

* like a valid orderby statement.

if ( isset( $attr['orderby'] ) ) {

$attr['orderby'] = sanitize_sql_orderby( $attr['orderby'] );

if ( ! $attr['orderby'] )

unset( $attr['orderby'] );

}

$atts = shortcode_atts( array(

'type' => 'audio',

'order' => 'ASC',

'orderby' => 'menu_order ID',

'id' => $post ? $post->ID : 0,

'include' => '',

'exclude' => '',

'style' => 'light',

'tracklist' => true,

'tracknumbers' => true,

'images' => true,

'artists' => true

), $attr, 'playlist' );

$id = intval( $atts['id'] );

if ( 'RAND' == $atts['order'] ) {

$atts['orderby'] = 'none';

}

$args = array(

'post_status' => 'inherit',

'post_type' => 'attachment',

'post_mime_type' => $atts['type'],

'order' => $atts['order'],

'orderby' => $atts['orderby']

);

if ( ! empty( $atts['include'] ) ) {

$args['include'] = $atts['include'];

$_attachments = get_posts( $args );

$attachments = array();

foreach ( $_attachments as $key => $val ) {

$attachments[$val->ID] = $_attachments[$key];

}

} elseif ( ! empty( $atts['exclude'] ) ) {

$args['post_parent'] = $id;

$args['exclude'] = $atts['exclude'];

$attachments = get_children( $args );

} else {

$args['post_parent'] = $id;

$attachments = get_children( $args );

}

if ( empty( $attachments ) ) {

return '';

}

if ( is_feed() ) {

$output = "\n";

foreach ( $attachments as $att_id => $attachment ) {

$output .= wp_get_attachment_link( $att_id ) . "\n";

}

return $output;

}

$outer = 22; // default padding and border of wrapper

$default_width = 640;

$default_height = 360;

$theme_width = empty( $content_width ) ? $default_width : ( $content_width - $outer );

$theme_height = empty( $content_width ) ? $default_height : round( ( $default_height * $theme_width ) / $default_width );

$data = array(

'type' => $atts['type'],

// don't pass strings to JSON, will be truthy in JS

'tracklist' => wp_validate_boolean( $atts['tracklist'] ),

'tracknumbers' => wp_validate_boolean( $atts['tracknumbers'] ),

'images' => wp_validate_boolean( $atts['images'] ),

'artists' => wp_validate_boolean( $atts['artists'] ),

);

$tracks = array();

foreach ( $attachments as $attachment ) {

$url = wp_get_attachment_url( $attachment->ID );

$ftype = wp_check_filetype( $url, wp_get_mime_types() );

$track = array(

'src' => $url,

'type' => $ftype['type'],

'title' => $attachment->post_title,

'caption' => $attachment->post_excerpt,

'description' => $attachment->post_content

);

$track['meta'] = array();

$meta = wp_get_attachment_metadata( $attachment->ID );

if ( ! empty( $meta ) ) {

foreach ( wp_get_attachment_id3_keys( $attachment ) as $key => $label ) {

if ( ! empty( $meta[ $key ] ) ) {

$track['meta'][ $key ] = $meta[ $key ];

}

if ( 'video' === $atts['type'] ) {

if ( ! empty( $meta['width'] ) && ! empty( $meta['height'] ) ) {

$width = $meta['width'];

$height = $meta['height'];

$theme_height = round( ( $height * $theme_width ) / $width );

} else {

$width = $default_width;

$height = $default_height;

}

$track['dimensions'] = array(

'original' => compact( 'width', 'height' ),

'resized' => array(

'width' => $theme_width,

'height' => $theme_height

)

);

}

if ( $atts['images'] ) {

$thumb_id = get_post_thumbnail_id( $attachment->ID );

if ( ! empty( $thumb_id ) ) {

list( $src, $width, $height ) = wp_get_attachment_image_src( $thumb_id, 'full' );

$track['image'] = compact( 'src', 'width', 'height' );

list( $src, $width, $height ) = wp_get_attachment_image_src( $thumb_id, 'thumbnail' );

$track['thumb'] = compact( 'src', 'width', 'height' );

} else {

$src = wp_mime_type_icon( $attachment->ID );

$width = 48;

$height = 64;

$track['image'] = compact( 'src', 'width', 'height' );

$track['thumb'] = compact( 'src', 'width', 'height' );

}

$tracks[] = $track;

}

$data['tracks'] = $tracks;

$safe_type = esc_attr( $atts['type'] );

$safe_style = esc_attr( $atts['style'] );

ob_start();

if ( 1 === $instance ) {

/**

* Print and enqueue playlist scripts, styles, and JavaScript templates.

* @since 3.9.0

* @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'.

do_action( 'wp_playlist_scripts', $atts['type'], $atts['style'] );

} ?>

<div class="wp-playlist wp-<?php echo $safe_type ?>-playlist wp-playlist-<?php echo $safe_style ?>">

<?php if ( 'audio' === $atts['type'] ): ?>

<?php endif ?>

<<?php echo $safe_type ?> controls="controls" preload="none" width="<?php

echo (int) $theme_width;

?>"<?php if ( 'video' === $safe_type ):

echo ' height="', (int) $theme_height, '"';

else:

echo ' style="visibility: hidden"';

endif; ?>></<?php echo $safe_type ?>>

<ol><?php

foreach ( $attachments as $att_id => $attachment ) {

printf( '<li>%s</li>', wp_get_attachment_link( $att_id ) );

}

?></ol>

</noscript>

</div>

<?php

return ob_get_clean();

}

関数間の処理　フックポイント

add_shortcode( 'playlist', 'wp_playlist_shortcode' );

1	add_shortcode( 'playlist', 'wp_playlist_shortcode' );

関数　wp_mediaelement_fallback()

/**
 * Provide a No-JS Flash fallback as a last resort for audio / video
 *
 * @since 3.6.0
 *
 * @param string $url
 * @return string Fallback HTML
 */
function wp_mediaelement_fallback( $url ) {
	/**
	 * Filter the Mediaelement fallback output for no-JS.
	 *
	 * @since 3.6.0
	 *
	 * @param string $output Fallback output for no-JS.
	 * @param string $url    Media file URL.
	 */
	return apply_filters( 'wp_mediaelement_fallback', sprintf( '<a href="%1$s">%1$s</a>', esc_url( $url ) ), $url );
}

/**

* Provide a No-JS Flash fallback as a last resort for audio / video

* @since 3.6.0

* @param string $url

* @return string Fallback HTML

function wp_mediaelement_fallback( $url ) {

/**

* Filter the Mediaelement fallback output for no-JS.

* @since 3.6.0

* @param string $output Fallback output for no-JS.

* @param string $url Media file URL.

return apply_filters( 'wp_mediaelement_fallback', sprintf( '<a href="%1$s">%1$s</a>', esc_url( $url ) ), $url );

}

関数　wp_get_audio_extensions()

/**
 * Return a filtered list of WP-supported audio formats.
 *
 * @since 3.6.0
 * @return array
 */
function wp_get_audio_extensions() {
	/**
	 * Filter the list of supported audio formats.
	 *
	 * @since 3.6.0
	 *
	 * @param array $extensions An array of support audio formats. Defaults are
	 *                          'mp3', 'ogg', 'wma', 'm4a', 'wav'.
	 */
	return apply_filters( 'wp_audio_extensions', array( 'mp3', 'ogg', 'wma', 'm4a', 'wav' ) );
}

/**

* Return a filtered list of WP-supported audio formats.

* @since 3.6.0

* @return array

function wp_get_audio_extensions() {

/**

* Filter the list of supported audio formats.

* @since 3.6.0

* @param array $extensions An array of support audio formats. Defaults are

* 'mp3', 'ogg', 'wma', 'm4a', 'wav'.

return apply_filters( 'wp_audio_extensions', array( 'mp3', 'ogg', 'wma', 'm4a', 'wav' ) );

}

関数　wp_get_attachment_id3_keys()

/**
 * Return useful keys to use to lookup data from an attachment's stored metadata.
 *
 * @since 3.9.0
 *
 * @param WP_Post $attachment The current attachment, provided for context.
 * @param string  $context    The context. Accepts 'edit', 'display'. Default 'display'.
 * @return array Key/value pairs of field keys to labels.
 */
function wp_get_attachment_id3_keys( $attachment, $context = 'display' ) {
	$fields = array(
		'artist' => __( 'Artist' ),
		'album' => __( 'Album' ),
	);

	if ( 'display' === $context ) {
		$fields['genre']            = __( 'Genre' );
		$fields['year']             = __( 'Year' );
		$fields['length_formatted'] = _x( 'Length', 'video or audio' );
	} elseif ( 'js' === $context ) {
		$fields['bitrate']          = __( 'Bitrate' );
		$fields['bitrate_mode']     = __( 'Bitrate Mode' );
	}

	/**
	 * Filter the editable list of keys to look up data from an attachment's metadata.
	 *
	 * @since 3.9.0
	 *
	 * @param array   $fields     Key/value pairs of field keys to labels.
	 * @param WP_Post $attachment Attachment object.
	 * @param string  $context    The context. Accepts 'edit', 'display'. Default 'display'.
	 */
	return apply_filters( 'wp_get_attachment_id3_keys', $fields, $attachment, $context );
}

/**

* Return useful keys to use to lookup data from an attachment's stored metadata.

* @since 3.9.0

* @param WP_Post $attachment The current attachment, provided for context.

* @param string $context The context. Accepts 'edit', 'display'. Default 'display'.

* @return array Key/value pairs of field keys to labels.

function wp_get_attachment_id3_keys( $attachment, $context = 'display' ) {

$fields = array(

'artist' => __( 'Artist' ),

'album' => __( 'Album' ),

);

if ( 'display' === $context ) {

$fields['genre'] = __( 'Genre' );

$fields['year'] = __( 'Year' );

$fields['length_formatted'] = _x( 'Length', 'video or audio' );

} elseif ( 'js' === $context ) {

$fields['bitrate'] = __( 'Bitrate' );

$fields['bitrate_mode'] = __( 'Bitrate Mode' );

}

/**

* Filter the editable list of keys to look up data from an attachment's metadata.

* @since 3.9.0

* @param array $fields Key/value pairs of field keys to labels.

* @param WP_Post $attachment Attachment object.

* @param string $context The context. Accepts 'edit', 'display'. Default 'display'.

return apply_filters( 'wp_get_attachment_id3_keys', $fields, $attachment, $context );

}

関数　wp_audio_shortcode()

/**
 * The Audio shortcode.
 *
 * This implements the functionality of the Audio Shortcode for displaying
 * WordPress mp3s in a post.
 *
 * @since 3.6.0
 *
 * @param array $attr {
 *     Attributes of the audio shortcode.
 *
 *     @type string $src      URL to the source of the audio file. Default empty.
 *     @type string $loop     The 'loop' attribute for the `<audio>` element. Default empty.
 *     @type string $autoplay The 'autoplay' attribute for the `<audio>` element. Default empty.
 *     @type string $preload  The 'preload' attribute for the `<audio>` element. Default empty.
 *     @type string $class    The 'class' attribute for the `<audio>` element. Default 'wp-audio-shortcode'.
 *     @type string $id       The 'id' attribute for the `<audio>` element. Default 'audio-{$post_id}-{$instances}'.
 *     @type string $style    The 'style' attribute for the `<audio>` element. Default 'width: 100%'.
 * }
 * @param string $content Optional. Shortcode content.
 * @return string HTML content to display audio.
 */
function wp_audio_shortcode( $attr, $content = '' ) {
	$post_id = get_post() ? get_the_ID() : 0;

	static $instances = 0;
	$instances++;

	/**
	 * Filter the default audio shortcode output.
	 *
	 * If the filtered output isn't empty, it will be used instead of generating the default audio template.
	 *
	 * @since 3.6.0
	 *
	 * @param string $html      Empty variable to be replaced with shortcode markup.
	 * @param array  $attr      Attributes of the shortcode. @see wp_audio_shortcode()
	 * @param string $content   Shortcode content.
	 * @param int    $instances Unique numeric ID of this audio shortcode instance.
	 */
	$override = apply_filters( 'wp_audio_shortcode_override', '', $attr, $content, $instances );
	if ( '' !== $override ) {
		return $override;
	}

	$audio = null;

	$default_types = wp_get_audio_extensions();
	$defaults_atts = array(
		'src'      => '',
		'loop'     => '',
		'autoplay' => '',
		'preload'  => 'none'
	);
	foreach ( $default_types as $type ) {
		$defaults_atts[$type] = '';
	}

	$atts = shortcode_atts( $defaults_atts, $attr, 'audio' );

	$primary = false;
	if ( ! empty( $atts['src'] ) ) {
		$type = wp_check_filetype( $atts['src'], wp_get_mime_types() );
		if ( ! in_array( strtolower( $type['ext'] ), $default_types ) ) {
			return sprintf( '<a class="wp-embedded-audio" href="%s">%s</a>', esc_url( $atts['src'] ), esc_html( $atts['src'] ) );
		}
		$primary = true;
		array_unshift( $default_types, 'src' );
	} else {
		foreach ( $default_types as $ext ) {
			if ( ! empty( $atts[ $ext ] ) ) {
				$type = wp_check_filetype( $atts[ $ext ], wp_get_mime_types() );
				if ( strtolower( $type['ext'] ) === $ext ) {
					$primary = true;
				}
			}
		}
	}

	if ( ! $primary ) {
		$audios = get_attached_media( 'audio', $post_id );
		if ( empty( $audios ) ) {
			return;
		}

		$audio = reset( $audios );
		$atts['src'] = wp_get_attachment_url( $audio->ID );
		if ( empty( $atts['src'] ) ) {
			return;
		}

		array_unshift( $default_types, 'src' );
	}

	/**
	 * Filter the media library used for the audio shortcode.
	 *
	 * @since 3.6.0
	 *
	 * @param string $library Media library used for the audio shortcode.
	 */
	$library = apply_filters( 'wp_audio_shortcode_library', 'mediaelement' );
	if ( 'mediaelement' === $library && did_action( 'init' ) ) {
		wp_enqueue_style( 'wp-mediaelement' );
		wp_enqueue_script( 'wp-mediaelement' );
	}

	/**
	 * Filter the class attribute for the audio shortcode output container.
	 *
	 * @since 3.6.0
	 *
	 * @param string $class CSS class or list of space-separated classes.
	 */
	$html_atts = array(
		'class'    => apply_filters( 'wp_audio_shortcode_class', 'wp-audio-shortcode' ),
		'id'       => sprintf( 'audio-%d-%d', $post_id, $instances ),
		'loop'     => $atts['loop'],
		'autoplay' => $atts['autoplay'],
		'preload'  => $atts['preload'],
		'style'    => 'width: 100%; visibility: hidden;',
	);

	// These ones should just be omitted altogether if they are blank
	foreach ( array( 'loop', 'autoplay', 'preload' ) as $a ) {
		if ( empty( $html_atts[$a] ) ) {
			unset( $html_atts[$a] );
		}
	}

	$attr_strings = array();
	foreach ( $html_atts as $k => $v ) {
		$attr_strings[] = $k . '="' . esc_attr( $v ) . '"';
	}

	$html = '';
	if ( 'mediaelement' === $library && 1 === $instances ) {
		$html .= "<!--[if lt IE 9]><script>document.createElement('audio');</script><![endif]-->\n";
	}
	$html .= sprintf( '<audio %s controls="controls">', join( ' ', $attr_strings ) );

	$fileurl = '';
	$source = '<source type="%s" src="%s" />';
	foreach ( $default_types as $fallback ) {
		if ( ! empty( $atts[ $fallback ] ) ) {
			if ( empty( $fileurl ) ) {
				$fileurl = $atts[ $fallback ];
			}
			$type = wp_check_filetype( $atts[ $fallback ], wp_get_mime_types() );
			$url = add_query_arg( '_', $instances, $atts[ $fallback ] );
			$html .= sprintf( $source, $type['type'], esc_url( $url ) );
		}
	}

	if ( 'mediaelement' === $library ) {
		$html .= wp_mediaelement_fallback( $fileurl );
	}
	$html .= '</audio>';

	/**
	 * Filter the audio shortcode output.
	 *
	 * @since 3.6.0
	 *
	 * @param string $html    Audio shortcode HTML output.
	 * @param array  $atts    Array of audio shortcode attributes.
	 * @param string $audio   Audio file.
	 * @param int    $post_id Post ID.
	 * @param string $library Media library used for the audio shortcode.
	 */
	return apply_filters( 'wp_audio_shortcode', $html, $atts, $audio, $post_id, $library );
}

100

101

102

103

104

105

106

107

108

109

110

111

112

113

114

115

116

117

118

119

120

121

122

123

124

125

126

127

128

129

130

131

132

133

134

135

136

137

138

139

140

141

142

143

144

145

146

147

148

149

150

151

152

153

154

155

156

157

158

159

160

161

162

163

164

165

166

167

168

169

170

171

172

/**

* The Audio shortcode.

* This implements the functionality of the Audio Shortcode for displaying

* WordPress mp3s in a post.

* @since 3.6.0

* @param array $attr {

* Attributes of the audio shortcode.

* @type string $src URL to the source of the audio file. Default empty.

* @type string $loop The 'loop' attribute for the `<audio>` element. Default empty.

* @type string $autoplay The 'autoplay' attribute for the `<audio>` element. Default empty.

* @type string $preload The 'preload' attribute for the `<audio>` element. Default empty.

* @type string $class The 'class' attribute for the `<audio>` element. Default 'wp-audio-shortcode'.

* @type string $id The 'id' attribute for the `<audio>` element. Default 'audio-{$post_id}-{$instances}'.

* @type string $style The 'style' attribute for the `<audio>` element. Default 'width: 100%'.

* }

* @param string $content Optional. Shortcode content.

* @return string HTML content to display audio.

function wp_audio_shortcode( $attr, $content = '' ) {

$post_id = get_post() ? get_the_ID() : 0;

static $instances = 0;

$instances++;

/**

* Filter the default audio shortcode output.

* If the filtered output isn't empty, it will be used instead of generating the default audio template.

* @since 3.6.0

* @param string $html Empty variable to be replaced with shortcode markup.

* @param array $attr Attributes of the shortcode. @see wp_audio_shortcode()

* @param string $content Shortcode content.

* @param int $instances Unique numeric ID of this audio shortcode instance.

$override = apply_filters( 'wp_audio_shortcode_override', '', $attr, $content, $instances );

if ( '' !== $override ) {

return $override;

}

$audio = null;

$default_types = wp_get_audio_extensions();

$defaults_atts = array(

'src' => '',

'loop' => '',

'autoplay' => '',

'preload' => 'none'

);

foreach ( $default_types as $type ) {

$defaults_atts[$type] = '';

}

$atts = shortcode_atts( $defaults_atts, $attr, 'audio' );

$primary = false;

if ( ! empty( $atts['src'] ) ) {

$type = wp_check_filetype( $atts['src'], wp_get_mime_types() );

if ( ! in_array( strtolower( $type['ext'] ), $default_types ) ) {

return sprintf( '<a class="wp-embedded-audio" href="%s">%s</a>', esc_url( $atts['src'] ), esc_html( $atts['src'] ) );

}

$primary = true;

array_unshift( $default_types, 'src' );

} else {

foreach ( $default_types as $ext ) {

if ( ! empty( $atts[ $ext ] ) ) {

$type = wp_check_filetype( $atts[ $ext ], wp_get_mime_types() );

if ( strtolower( $type['ext'] ) === $ext ) {

$primary = true;

}

if ( ! $primary ) {

$audios = get_attached_media( 'audio', $post_id );

if ( empty( $audios ) ) {

return;

}

$audio = reset( $audios );

$atts['src'] = wp_get_attachment_url( $audio->ID );

if ( empty( $atts['src'] ) ) {

return;

}

array_unshift( $default_types, 'src' );

}

/**

* Filter the media library used for the audio shortcode.

* @since 3.6.0

* @param string $library Media library used for the audio shortcode.

$library = apply_filters( 'wp_audio_shortcode_library', 'mediaelement' );

if ( 'mediaelement' === $library && did_action( 'init' ) ) {

wp_enqueue_style( 'wp-mediaelement' );

wp_enqueue_script( 'wp-mediaelement' );

}

/**

* Filter the class attribute for the audio shortcode output container.

* @since 3.6.0

* @param string $class CSS class or list of space-separated classes.

$html_atts = array(

'class' => apply_filters( 'wp_audio_shortcode_class', 'wp-audio-shortcode' ),

'id' => sprintf( 'audio-%d-%d', $post_id, $instances ),

'loop' => $atts['loop'],

'autoplay' => $atts['autoplay'],

'preload' => $atts['preload'],

'style' => 'width: 100%; visibility: hidden;',

);

// These ones should just be omitted altogether if they are blank

foreach ( array( 'loop', 'autoplay', 'preload' ) as $a ) {

if ( empty( $html_atts[$a] ) ) {

unset( $html_atts[$a] );

}

$attr_strings = array();

foreach ( $html_atts as $k => $v ) {

$attr_strings[] = $k . '="' . esc_attr( $v ) . '"';

}

$html = '';

if ( 'mediaelement' === $library && 1 === $instances ) {

$html .= "\n";

}

$html .= sprintf( '<audio %s controls="controls">', join( ' ', $attr_strings ) );

$fileurl = '';

$source = '<source type="%s" src="%s" />';

foreach ( $default_types as $fallback ) {

if ( ! empty( $atts[ $fallback ] ) ) {

if ( empty( $fileurl ) ) {

$fileurl = $atts[ $fallback ];

}

$type = wp_check_filetype( $atts[ $fallback ], wp_get_mime_types() );

$url = add_query_arg( '_', $instances, $atts[ $fallback ] );

$html .= sprintf( $source, $type['type'], esc_url( $url ) );

}

if ( 'mediaelement' === $library ) {

$html .= wp_mediaelement_fallback( $fileurl );

}

$html .= '</audio>';

/**

* Filter the audio shortcode output.

* @since 3.6.0

* @param string $html Audio shortcode HTML output.

* @param array $atts Array of audio shortcode attributes.

* @param string $audio Audio file.

* @param int $post_id Post ID.

* @param string $library Media library used for the audio shortcode.

return apply_filters( 'wp_audio_shortcode', $html, $atts, $audio, $post_id, $library );

}

関数間の処理　フックポイント　wp_audio_shortcode

add_shortcode( 'audio', 'wp_audio_shortcode' );

1	add_shortcode( 'audio', 'wp_audio_shortcode' );

- Wordpress

2024年4月
月	火	水	木	金	土	日
« 4月
1	2	3	4	5	6	7
8	9	10	11	12	13	14
15	16	17	18	19	20	21
22	23	24	25	26	27	28
29	30

WordPressを読む 65-3 /blog/wp-includes/media.php 3

/blog/wp-includes/media.php 3

WordPressを読む　65-3 /blog/wp-includes/media.php 3