テーマ翻訳可能コンテンツキーの変更について

1. 技術的課題の定義と現状分析

Shopifyではテーマ作成時に、JSONテンプレート内のコンテンツに対する翻訳可能なコンテンツキーを生成することができます。しかし、2022年2月17日以降に作成された新規テーマでは、これらのキーの形式が変更されることになりました。この変更はJSONテンプレート外からの翻訳、例えばテーマのlocales/フォルダに保存された翻訳には影響を及ぼしません。

2. 具体的な技術的ソリューションの提案

これまでの形式はsection.Template—123456__section_id.block_id.setting_idでしたが、新しい形式はsection.product.ext.json.section_id.block_id.setting_id:abc123となります。

3. 実装手順とコード例

このキーの形式は実装の詳細とみなされており、リソースに対して一貫性を保つよう努力されています。したがって、新しいキーは2022年2月17日12:00 EST以降にアップロードまたは複製されたテーマに対してのみ生成されます。

4. パフォーマンス・コスト分析

この変更は新規テーマの翻訳キー生成にのみ影響を与えるため、既存テーマのパフォーマンスや費用には影響を及ぼしません。

5. 実装時の注意点・ベストプラクティス

新規テーマを作成する際は、新しい翻訳キー形式を適用することを念頭に置いてください。また、既存テーマを複製またはアップロードする際にも新しいキー形式が適用されるため、その点を注意してください。

6. 次のステップ・発展案

この変更に対応するには、新しいキー形式を理解し、それに基づいてテーマのローカライゼーションを行う必要があります。詳細な情報はAPIドキュメンテーションでご確認いただけます。

参考記事: Changes to Theme Translatable Content Keys