多くのカスタムShopifyテーマはDawnのコピーから始まります。無料で高速、しかもShopifyが保守しています。しかし、自社ショップで販売する園芸店・植物ショップ向けテーマLeafwiseでは、その出発点は使えませんでした。
ここではShopifyテーマをゼロから書いた方法を紹介します。Dawnをフォークしなかった理由、テーマの構成、そしてTheme Checkをクリーンにするまでに遭遇したツールの問題です。
この記事について:Leafwiseは当社の製品なので、すべて実際のプロジェクトの内容です。コード例は短くしてありますが、作り話ではありません。

なぜDawnをフォークしないのか
Dawnのライセンスでは、Dawnをもとに開発することはできますが、Dawnから派生したテーマはShopifyテーマストアでのみ配布できます。私たちはLeafwiseを独自の価格とライセンスで直接販売したかったので、セクション構成、JavaScript、CSSを含め、Dawnのコードは一切使えませんでした。
空のフォルダーから始めたことには利点もありました。すべてのセクションは植物ショップに必要だから存在し、ファッションストアの名残はありません。
構成をひと言で
LeafwiseはシンプルなOnline Store 2.0テーマです。JSONテンプレート、ヘッダーグループとフッターグループ、そしてどこでもブロックを使えるセクション。7つのカラースキームを1つのグループにまとめ、スニペットで各スキームをカスタムプロパティ付きのCSSクラスに変換するので、どのセクションも設定1つでスキームを切り替えられます。フレームワークもビルド手順もありません。インタラクティブな部分は、遅延読み込みされる4つのファイル内の小さなカスタム要素です。
side-drawerとcart-drawer:メニュー、検索、カートproduct-form、variant-picker、media-gallery、sticky-atc:商品ページfacets-area:再読み込みなしの絞り込み、predictive-search:検索候補plant-quizとfilter-tabs:トップページ
カート:1回のリクエストで全セクションを更新
カートに追加したら、ドロワー、ヘッダーの数、スマートフォンのナビゲーションを同時に更新する必要があります。Section Rendering APIなら同じリクエストで可能です。必要なセクションのレンダリングをShopifyに依頼し、そのHTMLを差し替えます。
formData.append('sections', 'cart-drawer,cart-count');
formData.append('sections_url', window.location.pathname);
const res = await fetch('/cart/add.js', { method: 'POST', body: formData });
const data = await res.json();
// data.sections['cart-drawer'] is fresh HTML for the drawer
カートの情報を表示する要素にはすべてdata-cart-section属性が付いているので、カートを表示する場所を増やすときも属性を付けるだけで、新しいJavaScriptは不要です。
Theme Checkが「0 files inspected」
Windowsでは、どのフォルダーから実行してもshopify theme checkがエラーなしで終了し、検査したファイルは0件と表示されました。何も検査していないクリーンな結果は、エラーより悪いものです。そこで同じチェッカーをNodeパッケージから直接呼び出しました。
const { themeCheckRun } = require('@shopify/theme-check-node');
const { offenses, theme } = await themeCheckRun(root, undefined, console.error);
console.log('Files inspected:', theme.length);
エラー1件と警告4件が見つかり、その中には長すぎるセクション名もありました。修正後は90ファイル、エラー0、警告0です。
Shopifyに拒否されかねないzip
PowerShellのCompress-Archiveは、パスにバックスラッシュを使ったzipを作りました。sections/header.liquidではなくsections\header.liquidです。これを受け付けない解凍ツールやアップロード検査もあります。そこで.NETのZipArchiveでzipを作り、すべてのパスをスラッシュで書き込んでいます。
$rel = $file.FullName.Substring($src.Length + 1).Replace('\', '/')
[IO.Compression.ZipFileExtensions]::CreateEntryFromFile($zip, $file.FullName, $rel)
次も同じようにすること
- フレームワークなし:小さな4つのスクリプトはどんなバンドルより速く読み込まれ、読みやすい
- カートに関わる処理はすべてSection Rendering APIで
- CIでNodeパッケージからTheme Checkを実行し、検査ファイルが0件ならビルドを失敗させる
- 早めに本物の開発ストアでテストする。Theme Checkは合格でも、ストアでは8つのバグが見つかりました。それが次の記事のテーマです
LeafwiseはCharming Themeで販売しています。ご自身のショップ向けにゼロから作るShopifyテーマが必要なら、Shopifyテーマ開発サービスをご覧ください。
よくある質問
Dawnベースのテーマをテーマストア以外で販売できますか?
Dawnのライセンスでは、派生テーマの配布はShopifyテーマストアに限られます。ほかで販売するなら、独自のコードを書く必要があります。
ゼロから作るとDawnのフォークよりどのくらい時間がかかりますか?
カート、絞り込み、バリエーションのロジックを自分で書くため、最初は時間がかかります。その代わり、すべてのコードが自分のものになり、使わないコードを抱えずに済みます。
最新のShopifyテーマにビルド手順は必要ですか?
いいえ。カスタムプロパティを使った普通のCSSと小さなカスタム要素で、Leafwiseに必要なことはすべてまかなえます。