get_background_image()


WordPressのget_background_image()関数は、テーマの背景画像のURLを取得するために使用されます。この関数は、カスタマイザーやテーマ設定で設定された背景画像のURLを返します。

構文

get_background_image();
  • string — 背景画像のURL。背景画像が設定されていない場合は空文字列を返します。

例1: 背景画像のURLを取得する

この例では、背景画像のURLを取得し、それを表示します。

<?php echo get_background_image(); ?>

例2: 背景画像が設定されているか確認する

背景画像が設定されているかどうかを確認し、設定されている場合は画像を表示します。

<?php if (get_background_image()) { echo '<img src="' . get_background_image() . '" alt="Background Image">'; } ?>

例3: 背景画像をCSSで使用する

背景画像のURLをCSSの背景画像として使用します。

<style> body { background-image: url('<?php echo get_background_image(); ?>'); } </style>

例4: 背景画像を特定のページでのみ表示する

特定のページでのみ背景画像を表示する例です。

<?php if (is_page('about')) { echo '<style> body { background-image: url("' . get_background_image() . '"); } </style>'; } ?>

例5: 背景画像をカスタム投稿タイプで使用する

カスタム投稿タイプで背景画像を使用する例です。

<?php if (is_singular('portfolio')) { echo '<style> body { background-image: url("' . get_background_image() . '"); } </style>'; } ?>

例6: 背景画像を条件付きで変更する

特定の条件に基づいて背景画像を変更する例です。

<?php $background_image = (is_front_page()) ? get_background_image() : 'https://example.com/default-image.jpg'; echo '<style> body { background-image: url("' . $background_image . '"); } </style>'; ?>

例7: 背景画像をショートコードで表示する

ショートコードを使用して背景画像を表示する例です。

function display_background_image_shortcode() { return '<img src="' . get_background_image() . '" alt="Background Image">'; } add_shortcode('background_image', 'display_background_image_shortcode');

例8: 背景画像をフィルターフックで変更する

フィルターフックを使用して背景画像を変更する例です。

function custom_background_image($url) { return 'https://example.com/custom-image.jpg'; } add_filter('theme_mod_background_image', 'custom_background_image');

注意点

  • 背景画像が設定されていない場合、get_background_image()は空文字列を返します。
  • 背景画像のURLは、カスタマイザーやテーマ設定で設定された値に依存します。
  • CSSで背景画像を使用する場合、適切なフォールバックを設定することを推奨します。

関連機能：