📘 公式リファレンス📦 リファレンス/オブジェクト初級

settings オブジェクト

テーマの settings_schema.json で定義されたすべての設定値にアクセスするオブジェクト。管理画面のカスタマイズ画面で設定した値を Liquid テンプレート内で参照する。

用途

テーマカスタマイザーで入力されたロゴ、色、テキスト、フォント等の設定値を各 Liquid テンプレートやセクションで使い分ける。例えば favicon の設定値があれば `settings.favicon` で呼び出せる。

設置場所

任意の Liquid テンプレート（layout、template、section、snippet）内で `{{ settings.設定キー名 }}` または `{% if settings.設定キー名 != blank %}` のように直接参照する。例：`{{ settings.logo }}` でロゴ画像を出力、`{{ settings.primary_color }}` で色コードを参照。

注意点

設定キー名は settings_schema.json の id フィールドと大文字小文字を含めて正確に一致させる必要がある。存在しないキーを参照すると nil が返される。画像や商品などの特殊型は対応するフィルター（`image_url`、`product_img_url` など）を組み合わせて出力する。

タグ:settingssettings-schemacustomizationtheme-configglobal

仕様

31 行 / json

{
  "access": {
    "global": true,
    "parents": [],
    "template": []
  },
  "deprecated": false,
  "deprecation_reason": "",
  "description": "&gt; Tip:\n&gt; To learn about the available setting types, refer to [Input settings](/themes/architecture/settings/input-settings).",
  "properties": [],
  "summary": "Allows you to access all of the theme's settings from the [`settings_schema.json` file](/themes/architecture/config/settings-schema-json).",
  "name": "settings",
  "examples": [
    {
      "name": "Reference a setting value",
      "description": "",
      "syntax": "",
      "path": "/",
      "raw_liquid": "{% if settings.favicon != blank %}\n  &lt;link rel=\"icon\" type=\"image/png\" href=\"{{ settings.favicon | image_url: width: 32, height: 32 }}\"&gt;\n{% endif %}",
      "parameter": false,
      "display_type": "text",
      "show_data_tab": true
    }
  ],
  "json_data": {
    "path": "",
    "handle": "",
    "data_from_file": ""
  },
  "return_type": []
}

出典・ライセンス

Source:: Shopify/theme-liquid-docs/data/objects.json
Repository:: https://github.com/Shopify/theme-liquid-docs
License:: MIT

このコードは Shopify 著作の MIT ライセンスソースです。原本の著作権は Shopify が保有します。日本語訳は ALSEL によるものです。

settings オブジェクト

仕様

出典・ライセンス

関連項目

content_for_header オブジェクト

metaobjects オブジェクト

additional_checkout_buttons オブジェクト

canonical_url オブジェクト

content_for_index オブジェクト

content_for_additional_checkout_buttons オブジェクト