get_theme_mod()


WordPressのget_theme_mod()関数は、テーマカスタマイザーで設定されたオプションの値を取得するために使用されます。この関数は、テーマの設定を柔軟に管理するために役立ちます。

構文

get_theme_mod( string $name, mixed $default = false );

引数の説明:

  • $name (string) — 取得したい設定値の名前（オプションID）。
  • $default (mixed) — 設定値が存在しない場合に返されるデフォルト値。

例1: 基本的な使用法

テーマカスタマイザーで設定された背景色を取得します。

<?php $background_color = get_theme_mod('background_color', '#ffffff'); ?>

例2: デフォルト値の使用

設定値が存在しない場合、デフォルト値を使用してフォントサイズを取得します。

<?php $font_size = get_theme_mod('font_size', '16px'); ?>

例3: ロゴ画像の取得

テーマカスタマイザーで設定されたロゴ画像のURLを取得します。

<?php $logo_url = get_theme_mod('custom_logo'); ?>

例4: ヘッダーテキストカラーの取得

ヘッダーテキストの色を取得します。設定されていない場合はデフォルトの色を使用します。

<?php $header_text_color = get_theme_mod('header_textcolor', '#000000'); ?>

例5: カスタムCSSの取得

テーマカスタマイザーで追加されたカスタムCSSを取得します。

<?php $custom_css = get_theme_mod('custom_css'); ?>

例6: フッターテキストの取得

フッターに表示するテキストを取得します。設定されていない場合はデフォルトのテキストを使用します。

<?php $footer_text = get_theme_mod('footer_text', 'Powered by WordPress'); ?>

注意点

  • get_theme_mod()は、テーマカスタマイザーで設定された値のみを取得します。データベースに保存されていない場合はデフォルト値が返されます。
  • オプションIDが正しく設定されていることを確認してください。誤ったIDを使用すると、意図しない結果が返される可能性があります。

関連機能：