wp_video_shortcode()


WordPressの関数wp_video_shortcode()は、投稿やページ内にビデオを埋め込むために使用されます。このショートコードはビデオプレーヤーを生成し、幅や高さなどのさまざまなパラメーターを指定できます。

構文

wp_video_shortcode( array $atts = array() );

引数の説明:

  • $atts (array) — ビデオプレーヤーの設定を指定する連想配列。以下のキーが利用可能です。
    • src (string) — 埋め込むビデオのURL。
    • width (int) — プレーヤーの幅。
    • height (int) — プレーヤーの高さ。
    • poster (string) — ビデオのサムネイル画像のURL。
    • loop (bool) — ループ再生を有効にするかどうか。
    • autoplay (bool) — 自動再生を有効にするかどうか。
    • preload (string) — ビデオのプリロード設定。'auto', 'metadata', 'none'のいずれか。

例 1: 基本的なビデオ埋め込み

以下は基本的なビデオ埋め込みの例です。

<?php echo wp_video_shortcode( array( 'src' => wp_upload_dir()['baseurl'] . '/video/sample.mp4' ) ); ?>

例 2: カスタム設定のビデオ埋め込み

幅、高さ、ポスター画像を指定してビデオを埋め込む例です。

<?php echo wp_video_shortcode( array( 
    'src' => wp_upload_dir()['baseurl'] . '/video/sample.mp4',
    'width' => 640,
    'height' => 360,
    'poster' => wp_upload_dir()['baseurl'] . '/images/poster.jpg' 
) ); ?>

例 3: 自動再生とループを有効にしたビデオ

以下の例では、自動再生とループ再生を有効にしています。

<?php echo wp_video_shortcode( array( 
    'src' => wp_upload_dir()['baseurl'] . '/video/sample.mp4',
    'autoplay' => true,
    'loop' => true
) ); ?>

例 4: プリロード設定を変更したビデオ

ビデオをプリロードしない設定を使用した例です。

<?php echo wp_video_shortcode( array( 
    'src' => wp_upload_dir()['baseurl'] . '/video/sample.mp4',
    'preload' => 'none' 
) ); ?>

関連機能: