2月 21, 2026

テーマ設定スキーマにおける翻訳可能なデフォルト値

2月 21, 2026

テーマ設定スキーマにおける翻訳可能なデフォルト値

テーマ開発者にとって、多言語対応は重要な課題の一つです。特に、初期設定時や新しいセクションの統合時に、複数の言語をサポートするテーマを構築することは、ユーザー体験の向上と国際的な展開を目指すEC事業にとって不可欠です。しかし、現状では、テーマ設定スキーマのデフォルト値を翻訳することは容易ではありません。

そこで今回、Shopifyではテーマ設定スキーマのデフォルト値を翻訳可能にする新機能が追加されました。これにより、テーマ開発者はスキーマの翻訳ファイルを利用して、テーマのデフォルト値を翻訳することが可能になります。その詳細な手順について解説します。

実装手順とコード例

スキーマの翻訳を参照するための詳細なガイドラインは開発者向けドキュメンテーションに記載されています。以下にその概要を示します。

まず、テーマのロケールフォルダ内にスキーマの翻訳ファイルを作成します。
次に、そのファイル内に、各デフォルト値の翻訳をキーと値の形式で記述します。キーはスキーマ内で定義した項目名、値はその項目の翻訳結果とします。
最後に、スキーマ内でデフォルト値を設定する際に、その値を翻訳ファイルから参照するようにします。具体的には、デフォルト値を設定する項目の値をキーとして指定します。

以下に、この手順を適用したコード例を示します。

  // スキーマの翻訳ファイル（例：en.default.schema.json）
  {
    "my_section": {
      "settings": {
        "my_setting": "My translated default value"
      }
    }
  }
  
  // スキーマ設定ファイル（例：settings_schema.json）
  {
    "name": "my_section",
    "settings": [
      {
        "id": "my_setting",
        "default": "t:my_section.settings.my_setting"
      }
    ]
  }