wp_playlist_shortcode()


WordPressのwp_playlist_shortcode()関数は、プレイリスト（オーディオまたはビデオ）の埋め込みを行うために使用されます。

構文

wp_playlist_shortcode( array $atts = array() );

引数の説明:

  • $atts (array) — プレイリストの設定を指定するための連想配列。

主なキー:

  • type (string) — プレイリストの種類。値は 'audio' または 'video'。
  • ids (string) — メディアのIDをカンマ区切りで指定。
  • style (string) — デフォルトのスタイルを使用するかどうか。値は 'light' または 'dark'。

例1: オーディオプレイリストの表示

指定されたIDのオーディオファイルをプレイリストとして表示します。

<?php echo wp_playlist_shortcode( array( 'type' => 'audio', 'ids' => implode( ',', get_post_meta( get_the_ID(), '_playlist_audio_ids', true ) ) ) ); ?>

例2: ビデオプレイリストの表示

指定されたIDのビデオファイルをプレイリストとして表示します。

<?php echo wp_playlist_shortcode( array( 'type' => 'video', 'ids' => implode( ',', get_post_meta( get_the_ID(), '_playlist_video_ids', true ) ) ) ); ?>

例3: デフォルトスタイルの無効化

カスタムスタイルを適用するため、デフォルトスタイルを無効化します。

<?php echo wp_playlist_shortcode( array( 'type' => 'audio', 'ids' => implode( ',', get_post_meta( get_the_ID(), '_playlist_audio_ids', true ) ), 'style' => 'none' ) ); ?>

例4: 動的プレイリストの生成

ユーザーが選択した投稿の添付ファイルからプレイリストを作成します。

<?php
$ids = array();
foreach ( get_children( array( 'post_parent' => get_the_ID(), 'post_type' => 'attachment', 'post_mime_type' => 'audio' ) ) as $attachment ) {
    $ids[] = $attachment->ID;
}
echo wp_playlist_shortcode( array( 'type' => 'audio', 'ids' => implode( ',', $ids ) ) );
?>

例5: ショートコードを使用したプレイリストの表示

ショートコードを使って投稿やページにプレイリストを挿入します。

<?php echo do_shortcode( '[playlist type="audio" ids="' . implode( ',', get_post_meta( get_the_ID(), '_playlist_audio_ids', true ) ) . '"]' ); ?>

注意事項

  • 指定したidsが空の場合、プレイリストは表示されません。
  • プレイリストのスタイルはテーマやプラグインによって異なる場合があります。

関連機能：