get_header_image() の説明と使用例

WordPressのget_header_image()関数は、現在のテーマで設定されているヘッダー画像のURLを取得するために使用されます。

構文

<?php get_header_image(); ?>

使用例 1: ヘッダー画像のURLを取得して表示

以下のコードは、テーマに設定されたヘッダー画像のURLを出力します。

<?php echo get_header_image(); ?>

使用例 2: ヘッダー画像をタグで表示

取得したURLを使用して、HTMLの<img>タグ内で画像を表示します。

<?php if ( get_header_image() ) : ?>
    <img src="<?php echo get_header_image(); ?>" alt="ヘッダー画像">
<?php endif; ?>

使用例 3: 条件付きでデフォルト画像を設定

ヘッダー画像が設定されていない場合に、デフォルト画像を表示します。

<?php
$header_image = get_header_image() ? get_header_image() : get_template_directory_uri() . '/images/default-header.jpg';
?>
<img src="<?php echo $header_image; ?>" alt="ヘッダー画像">

使用例 4: ヘッダー画像のスタイルを動的に適用

ヘッダー画像のURLを使用してインラインスタイルを適用します。

<?php if ( get_header_image() ) : ?>
    <style>
        .custom-header {
            background-image: url('<?php echo get_header_image(); ?>');
            background-size: cover;
        }
    </style>
<?php endif; ?>

使用例 5: JSON形式でヘッダー画像の情報を出力

ヘッダー画像のURLをJSON形式で出力します。

<?php
echo json_encode( array( 'header_image' => get_header_image() ) );
?>

注意事項

get_header_image()はURLを返しますが、画像自体を表示しません。表示するには<img>タグやCSSで明示的に指定する必要があります。
ヘッダー画像が設定されていない場合、返される値は空になります。その場合は条件分岐で対応してください。

構文