スキーマ設定によってカスタマイズ画面で入力・指定したものを表示させるためのHTMLとLiquidの書き方についてご紹介
-本文中

(最終更新 2024年11月06日)

Shopify 自作でコレクションの「商品一覧」を作る!②HTMLとLiquid編

Shopify自作で「商品一覧」を作る!カスタマイズ画面で簡単に指定できるスキーマ設定の後編、TMLとLiquidの書き方について解説します。

前の記事Shopify自作で「商品一覧」を作る!カスタマイズ画面で簡単に指定できるスキーマ設定の後編になります。

この記事では、スキーマ設定によってカスタマイズ画面で入力・指定したものを表示させるためのHTMLとLiquidの書き方についてご紹介します。

※カスタマイズ画面とは、Shopifyテーマで用意されているビジュアルエディタ、ビルダーのような画面。テーマエディタともいう。

HTMLとLiquid

簡単に言うと、

Shopify自作で「商品一覧」を作る!カスタマイズ画面で簡単に指定できるスキーマ設定によって、カスタマイズ画面で各種「値」設定できるようになる。

②HTMLとLiquidコードで、設定済みの「値」を取得・表示させる。

になります。

スキーマ設定が「器」を作る作業であれば、カスタマイズ画面で器に盛った「料理(値)」をお客様に出す作業が、HTMLとLiquidのコードになります。

{%- assign collection = collections[section.settings.collection_handle] -%}

<div id="section-collection-products" data-aos="fade-up" data-aos-duration="1100">
<div class="container productBox">
<div class="collection-products-heading">
<h2>{{ section.settings.title | escape }}</h2>
</div>
<ul class="collection-products">
{% assign sorted_products = collection.all_products | sort: 'published_at' %}
{% for product in sorted_products reversed limit: section.settings.product_limit %}
<li class="collection-product-item">
<a href="{{ product.url }}"> //商品URL
<div class="collection-product-image">
<img src="{{ product.featured_image.src | img_url: 'large' }}" alt="{{ product.featured_image.alt | escape }} //サムネイル">
</div>
<div class="collection-product-info">
<div class="collection-product-title"><p>{{ product.title }}</p></div> //商品名
<div class="collection-product-price">{{ product.price | money }}</div> //価格
</div>
</a>
</li>
{% endfor %}
</ul>
<p class="viewall"><a href="{{ collection.url }}" class="viewall">VIEW ALL</a></p>
</div>
</div>

では、1つずつ解説してまいります。

{%- assign collection = collections[section.settings.collection_handle] -%}

まず「collection」という変数を定義します。「collections」はLiqudオブジェクトで、後ろの[section.settings.news_list]news_listは、ブログ選択のスキーマID。

これにより、カスタマイズ画面で指定したコレクションを「collection」という変数に格納できます。後述する、ループを作成する「for文」の「対象」となるコレクションを指定する事前作業になります。

次は、商品一覧のタイトル{{ section.settings.title | escape }}。こちらもスキーマIDのsettings.titleを取得・表示します。

公開順でソートしたループを作る

<ul class="collection-products">
{% assign sorted_products = collection.all_products | sort: 'published_at' %}
{% for product in sorted_products reversed limit: section.settings.product_limit %}
<li class="collection-product-item">
...
</li>
</ul>

まず、ここでもう1度、変数格納を行います。すでに作成した変数collectionの後ろに.all_productというプロパティを付けて、「すでに指定されたコレクションのすべての商品」という変数オブジェクトを作ります。

| sort: 'published_at'は、公開日でソートするという役割を果たします。

これらがsorted_productsという変数に格納し、次に続く「for文」で作るループの対象になるのです。

{% for product in sorted_products reversed limit: section.settings.product_limit %}

reversedは「逆順」という意味。「公開日が新しいものが一番先頭に来るように」という役割を持ちます。

limit: section.settings.product_limitは、カスタマイズ画面で指定した「表示件数」である、スキーマIDproduct_limitを用いて「表示件数」を制御する役割を持ちます。

商品情報の取得・表示

「li」と「/li」の間には、商品のタイトルやサムネイル、値段などの情報を取得・表示されます。

例えば、

  • {{ product.title }}は、商品タイトル
  • {{ product.url }}は、商品ページのURL
  • {{ product.featured_image.src | img_url: 'large' }}は、商品のサムネイル(画像のURL)

など。ちなみにproductを「オブジェクト」といい、「.」の後ろに続くurlなどは「プロパティ」といいます。

最後の<p class="viewall"><a href="{{ collection.url }}" class="viewall">VIEW ALL</a></p>は、コレクションページへのリンクになります。

「ディスカウント前後の価格」「割引率」を表示させたい

もし、ディスカウントがなされた場合、ディスカウント前後の価格と割引率を表示させ、顧客にお得感を際立たせたいものです。

商品一覧に「ディスカウント前後の価格」と「割引率」を表示させる手法については、以下の記事をご確認ください。

【Shopify小技】商品一覧に「ディスカウント前後の価格」「割引率」を表示させたい

スライドショーにしたい

作成した一覧をより見栄えよくスライドショーにしたいと思う方も以下の記事をご一読ください。

【Shopify小技】スライドショーjQueryプラグイン「slick」を実装したい

以上「Shopify自作で「商品一覧」を作る!」後編となるHTMLとLiquidの書き方について解説しました。

初めまして。運営者ホリと申します。

当ブログは「Shopifyを一緒に悩んで楽しむ仲間」に向けて情報を発信するブログです。

ここで扱うテーマは、構築やカスタマイズにとどまらず、SEOマーケティングやロジスティクスといった運営全般に広がります。

中でも最も重要視するのは、Shopifyを使った構築や運営に携わる中で「大掛かりな開発と投資に頼らなくても目的を達成できる工夫」。

確かな知識と経験を土台にしながら、日々の学びを記事にまとめて、同じように試行錯誤している方々とシェアしています。 日々の実践から得た知見を記事にまとめることで、Shopifyを使う仲間たちの小さなヒントや発想のきっかけになればうれしいです。

「ちょっと聞いてみたい」「これで大丈夫?」といった気軽な相談も大歓迎です。 Shopifyを通じて一緒に試行錯誤しながら、学び合える場として、このサイトを活用していただければ幸いです。

このブログと運営者について

お問い合わせ

BLOG More

Js

2日前

【第1回目】Shopify「cart.js」のトリセツ・まずざっくり全体像を掴もう!

① onChange() → ② updateQuantity() → ③ publish → ④ connectedCallback > onCartUpdate()という順番で動いています。..

Liquid

2週間前

【Shopify小技】折りたたみブロック(collapsible_tab)にアイコンを追加したい!

「少し見た目をユニークにしたい」「renderスニペットの動きを深く理解したい」..

Liquid

3週間前

【Shopify小技】タグで絞り込むコレクションページを実装!基本となるオブジェクト「current_tags」とは

Shopifyのコレクションページでは 複数タグの「AND」条件による絞り込みが自然に実現されており‥..

設定

3週間前

【Shopifyレポート】毎月の在庫と販売数を一目で確認したい!「商品別の毎日販売された在庫最」とは

おかげで、数字に超厳しい経理担当からもめちゃくちゃ褒められたほどです。..

Liquid

3週間前

【Shopify小技】パスワードをお忘れですか?を押しても遷移しない‥エラーのシンプルな解決方法

厳密にいえば、新しいページへ遷移しているわけではなく、同じページ内でJavaScriptとCSSを使い、二つのフォームを切り替えて見せているだけ..

Flow

4週間前

【Shopify小技】Cart attributesの内容は注文一覧で確認とれない‥その対策を考えてみた

残念ながら、注文一覧の「列」にCart attributesの値を直接取得・表示する機能が用意されていません。..

Js

4週間前

【Shopify小技】購入時ログイン必須の導線改善に役立つ「最近見た商品」一覧を作成

商品数が多かったり、購入までの導線が複雑なショップでは、ユーザーが途中で迷子になってしまうこともあります。..

設定

4週間前

Shopifyを使うなら検討してみたい発送代行システム「ロジレス」使い勝手と感想

「次回のレクチャーまでにこの動画を数本観ておいてくださいね」といった“宿題(?)”も出されます。..

Liquid

1か月前

【Shopify小技】PCとスマホで違うメニュー構成にする簡単な方法

「linklists.mobile-menu.links」ではなく「linklists['mobile-menu'].links」のようにブラケット記法で記述するのが安全..

Liquid

2か月前

【Shopify小技】メタフィールドで解決!商品ごとに手動でおすすめ一覧を作成

メタフィールドでは「.value」を使って直接オブジェクト配列を扱うのが正しい方法です。..

Liquid

2か月前

【Shopify小技】関連・おすすめ商品(recommendations)から特定の商品を手動で除外する

テーマエディタで選んだ商品(除外対象)のIDを配列にまとめ、その配列に含まれていない商品だけを「unless」を使って表示する..

設定

2か月前

【Shopify豆知識】テーマレイアウトをカスタマイズしたい?なら「grid-template」を知っておくべき

「スマホではロゴを左側に、PCではロゴを中央に」といった調整も、「grid-template」の設定次第で柔軟に実現できます。..

Liquid

3か月前

【Shopify小技】PC版に左のサイドバーを設置!まず「theme.liquid」の構造を知ろう

もし「type」を設定しなかったり、誤って設定したりしてしまうと、Shopifyはそのセクションをどの領域に表示すべきか判断できません。..

設定

3か月前

【Shopify小技】商品ページごとのFAQをメタオブジェクトで実装してみた

実際には「ピックアップ可能な店舗情報」や「割れやすい商品の配送注意点」など、商品ごとに異なる補足情報‥..

Liquid

3か月前

【Shopify Liquid】テーマで実際使用される「render」の引数と渡り値 その役割を解説

それぞれの変数の意味を押さえておけば、ある程度は読み解くことができると思います。..

アプリ

3か月前

【Shopifyアプリ】シンプル&レスポンシブ!直感的に使えるカレンダー「The Shop Calendar」でイベント・営業日を表示

The Shop Calendarは、カレンダー形式・一覧形式に加え、現在(2025年9月時点)β版としてアコーディオン形式にも対応しています。..

アプリ

4か月前

写真ギャラリーが複数作成できる!Shopify無料アプリ「GA Image Gallery」

ただし、「Advanced Setup」の方は動画を見ても最初はすんなり理解しづらいかもしれません。..

SEO

4か月前

【Shopify豆知識】だからSEOに強いのか!構造化データ(JSON-LD)について解説

しかし実際には、検索結果やGoogleショッピングにおいて、価格や在庫、バリエーション情報を正しく表示するための大事な役割を担っています。..

Liquid

4か月前

【Shopify豆知識】スキーマ設定(JSON)「t:」から始まる文字列とは‥実は変数パスではない?

Shopifyは「"t:"」以下のパスをたどって "label" の値(ここでは「クマさんのお顔」)を取得し、テーマエディタ上で表示します。..

Liquid

4か月前

【Shopify Liquid】スニペットファイルを呼び出す「render」引数と渡り値とは?

この仕組みによって、スニペットは渡されたデータに基づき、表示ロジックに沿って商品画像や商品名、価格などを表示できるようになります。..

制作アイディア

4か月前

Shopify構築をフリーランスへ代行依頼する手順(1~6)と選ぶポイント

私自身の体験としておすすめしたいのが「電話対応ができるフリーランス」を選ぶことです。..

Liquid

4か月前

【Shopify Liquid】オブジェクトの絞り込みに用いる「where」フィルタとは

たとえば、「販売元(vendor)」が「Nintendo」の商品だけを抽出したい場合は、以下のように書きます。..

制作アイディア

4か月前

Shopify構築をフリーランスへ依頼するメリットは費用だけではない!課題点も紹介

その「必死さ」や「ファイティングスピリット」は、柔軟かつ誠実な対応として依頼主にとって大きな安心材料となることも..

制作アイディア

4か月前

【リアルレポート】Shopify構築をフリーランスに依頼する際の相場と費用内訳

ECストアは今や単なる販売ツールではなく、実店舗と同じ、あるいはそれ以上に重要性と存在感を持つものとなっています。..

Js

5か月前

Shopifyにおける「カート追加」の仕組みを理解する!form送信 vs fetch API活用

fetch APIに用いられる「/cart/add.js」は、form送信の「/cart/add」と同様、「仮想的なエンドポイント」になります。..

Js

5か月前

【JavaScript】Shopify「cart.js」を読み解くための「Webコンポーネントメソッド」一覧

商品数や金額といった情報は、HTMLの「data-attribute」を使って要素ごとに管理されており、JavaScript側でそれを読み取って処理‥..

Js

6か月前

Shopifyのカスタマイズに役立つJavaScript「配列メゾット」11選を初心者向けに解説

「2005年新着!夏の水着一覧」という配列があるとします。最安値順に並び替えたいとき、「.sort()」というメソッドを使えば‥..

Js

6か月前

ShopifyではLiquidがあるのになぜJavaScriptが多用されるの?

その理由を一言で言えば、「Liquidは表示前、JavaScriptは表示後に働くから」です。..

Liquid

6か月前

Shopify 関連やおすすめ商品リストが自動生成「recommendations」活用・応用シーン

しかしカートページには、そもそも表示中の商品が存在しないため、このレコメンドの仕組みが機能しないのです。..

Liquid

6か月前

【Shopify Liquid】関連商品・おすすめ商品作成に用いられるオブジェクト「recommendations」について

このオブジェクトは、顧客の行動やストア内でのさまざまなデータを基に、自動的に関連商品を選出します。..