特集ページ / 更新ガイド
社内用・やさしい版 | 2026.09.15
商品番号の変更から、順番に。

特集ページの更新ガイド

「どこを変えるか」「何を残すか」を、
実際のコードを見ながら確認するための資料です。

01

最初に知っておくこと

仕組みを全部覚える必要はありません。まず「番号を書く場所」を見つけます。

特集ページは、「掲載したい商品の番号」と「商品の見せ方」を組み合わせて作られています。商品名や価格を、毎回手で入力する仕組みではありません。また、特集の商品掲載は基本的にこのテンプレートをベースに作成し、工数を削減するために使用します。

1 / 選ぶ載せたい商品の番号を書くcodes に、商品番号を並べます。
2 / ひもづけるどの商品かを指定するproduct_{{ code }} が、商品情報を取り出す目印になります。
3 / 表示する名前や価格が入る[=name=] などが、その商品の情報に置き換わります。

最初は、この3つの言葉だけ

コードに出てくる言葉日本語にすると覚え方
codes今回並べたい商品番号の一覧複数の商品をまとめたリスト
code今、表示しようとしている商品の番号一覧から1つずつ取り出した番号
dataその商品につけた追加設定星マークを付ける、などの設定。商品名や価格そのものではない

参照:添付コード 30–36行・145–158行・191–202行/商品情報の取得方法についてのユーザー補足

02

商品を入れ替える・追加する

「番号だけの一覧」を編集する手順です。数字以外は、なるべく触りません。

自分が編集する一覧を見て、次のどちらかを確認します。形に合わせて、セットで使う行が違います。

番号だけの一覧['3842', '726031', '8706']

番号だけを並べる書き方です。
この章の手順で変更します。

設定も付いている一覧{'726029': {'new': 1, ...}}

番号の横に new や flg があります。
03「商品ごとに目印を変える」へ進みます。

一覧の書き方セットで使う行data は?
番号だけ [ ... ]{% for code in codes %}不要
番号+追加設定 { ... }{% for code, data in codes %}追加設定を使うために受け取る

まずは「1商品を別の商品に替える」

  1. 変更する一覧を見つける

    例では、3842・726031・8706 の3商品が入っています。

  2. 替えたい番号だけ書き換える

    726031 を 3181 に替えるなら、下の黄色い部分だけを変更します。

  3. 表示を確認する

    商品名・画像が替わっているか、手書きのコピーが元の商品のままになっていないかを確認します。

変更前
{% set codes = ['3842', '726031', '8706'] %}
黄色:今回変更する部分
変更後:726031 を 3181 に変更
{% set codes = ['3842', '3181', '8706'] %}
黄色:今回変更する部分

以下の例は、それぞれ最初の3商品(3842・726031・8706)から変更する例です。順番に続けて適用するものではありません。

商品を1つ追加したい

最後に 3026 を追加する例です。隣の番号との間に、半角のカンマを入れます。

変更後:3026 を末尾に追加
{% set codes = ['3842', '726031', '8706', '3026'] %}
黄色:今回変更する部分

商品枠を自分で何個もコピーするのではなく、この一覧に番号を追加します。ただし、終売などの条件によって表示されない商品もあります。

商品の順番を替えたい

8706 を先頭にする例です。番号を書いた順番が、商品枠を作る順番になります。表示条件に合わない商品は出ない場合があります。

変更後:8706 → 3842 → 726031
{% set codes = ['8706', '3842', '726031'] %}
黄色:今回変更する部分
商品を1つ外したい

726031 を一覧から外す例です。番号と、その前後どちらかのカンマを一緒に消し、残った番号の間にカンマが1つある形にします。

変更後:726031 を一覧から削除
{% set codes = ['3842', '8706'] %}

これは特集の掲載対象から外す操作です。商品自体を削除したり、終売に設定したりする指示ではありません。

codes が見つからないとき(B・Cなど)

商品番号を一覧にせず、商品枠へ直接書いている例もあります。その場合は、始まりと終わりの2か所を同じ番号に変更します。

位置を説明する例・この3行で元の枠を置き換えない
<div class="pickupProduct" id="product_8400">
    <!-- この間に元の商品表示コードがあります -->
</div><!-- product_8400 -->

例えば 8400 を 3181 に替える場合、両方の product_8400 を product_3181 に変更します。中の商品表示コードは残します。

参照:添付コード:A 30–36行、B 276–366行、C 382–497行/変更例は同じ書き方を使った説明用の例

03

商品ごとに目印を変える

番号の横に new・flg などの設定がある場合だけ読みます。

番号の横に {'new': 1, 'flg': true} がある場合は、商品番号と、その商品用の設定が1セットになっています。

1商品の設定を取り出して見る例
'726029': {'new': 1, 'flg': true}
この部分意味このサンプルでの動き
'726029'どの商品か商品番号 726029
'new': 1星・月の目印の設定1 なら 🌟、2 なら 🌙、0 ならどちらも付けない
'flg': true犬の目印を付けるかtrue なら 🐶 を付ける。false なら付けない

設定を変える例:🌟と🐶をやめて、🌙にする

変更前:🌟 + 🐶
'726029': {'new': 1, 'flg': true}
黄色:今回変更する部分
変更後:🌙のみ。既存の該当部分を変更
'726029': {'new': 2, 'flg': false}
黄色:今回変更する部分

true は「付ける」、false は「付けない」と読み替えれば大丈夫です。ここでは小文字のまま、引用符を付けずに使います。

この一覧では、for の行に data が付く

{% for code, data in codes %}と書いて、商品番号と追加設定の両方を受け取ります。既存のこの行は、そのまま残します。

設定と商品表示の組み合わせ全体を見る(詳しい説明)
仕組みを見るための短い例・ページ全体の貼り替え用ではない
{% set codes = {
    '726029': {'new': 1, 'flg': true},
    '726031': {'new': 1, 'flg': true},
    '3181': {'new': 0, 'flg': true}
} %}

{% for code, data in codes %}
    <div id="product_{{ code }}" class="pickupProduct">
        <p>[=name=]</p>
        {% if data.new == 1 %}
            🌟
        {% elseif data.new == 2 %}
            🌙
        {% endif %}
        {% if data.flg %}
            🐶
        {% endif %}
    </div><!-- product_{{ code }} -->
{% endfor %}

code が商品番号、data がその横の設定です。data.new は「その商品の new の値を見る」、data.flg は「その商品の flg の値を見る」という意味です。

設定付きの一覧で、追加・削除・並び替えをしたい

商品番号だけでなく、横の設定まで1行まとめて扱います。追加する場合は1商品の行をコピーし、番号と設定値を変更します。

追加例:8706 は目印なし。必要な商品だけで一覧を作る
{% set codes = {
    '726029': {'new': 1, 'flg': true},
    '726031': {'new': 1, 'flg': true},
    '8706': {'new': 0, 'flg': false}
} %}
黄色:今回変更する部分

各商品の行と行の間にはカンマが必要です。削除するときも、カンマが重なったり、なくなったりしないよう確認します。並び替えるときは、その商品の設定を一緒に移動します。

番号の後ろに _a・_b・_detail などが付いている

元コードには 726029_a や product_726029_detail のように、商品番号へ追加の文字を付けた例があります。通常の品番だけの記述と同じように、末尾を削除しないでください。

開始の id と終了コメントは、追加の文字も含めて一致させます。移動先として使われている場合は、リンク側の指定も合わせて確認します。

参照:添付コード 145–158行・181–202行・255–259行・499–614行

04

消してはいけない「セット」

数字や文章を変える前に、残すべき部分を確認します。

このテンプレートには、「ここから始まり、ここで終わる」というセットがあります。片方だけを消さないことが重要です。

いちばん重要:1商品分の「始まり」と「終わり」

始まり
<div id="product_{{ code }}" class="pickupProduct">
どの商品の情報を使うかを示す目印。
商品情報
<p>[=name=]</p>
この間に、商品名・画像・価格などの表示を置く。
終わり
</div><!-- product_{{ code }} -->
閉じるタグだけでなく、その後ろのコメントまでセット。

始まりが product_726029_detail なら、終わりも product_726029_detail にします。div ではなく li を使う例でも、始まりと終わりをそろえる考え方は同じです。

ほかにも、セットで残すものがある

始まり終わり何をしている?
{% for code in codes %}{% endfor %}一覧の各商品について、中の表示を繰り返す
{% for code, data in codes %}{% endfor %}商品番号と追加設定を使って、中の表示を繰り返す
[=if is_login=][=endif=]ログインしている場合にだけ、中を表示する
{% if data.flg %}{% endif %}ページの追加設定が true の場合に、中を表示する

set は「一覧などを設定する行」です。for は「ここから繰り返す」、endfor は「繰り返しはここまで」と読みます。

{{ code }} と [=code=] は、何が違う?
書き方このページでの使い道変更する?
{{ code }}一覧から取り出した番号を、商品枠の目印などへ入れる通常はそのまま
[=code=]商品情報から取得した商品番号を表示する通常はそのまま
[=name=]商品情報から取得した商品名を表示する通常はそのまま

商品番号を替えるときは、これらを実際の番号へ一括置換するのではなく、02・03の一覧を変更します。番号が商品枠へ直接書かれている方式は、02の補足に従います。

参照:開始・終了をセットで残すルール:ユーザー補足/添付コード 30–40行・77–102行・131–132行・156–202行・639–655行

05

画像・文章・価格・ボタンを確認する

変更したい内容に合わせて、必要な説明だけ開きます。

画面に見えている情報には、商品情報から自動で入るものと、このページに直接書いてあるものがあります。

自動で入るもの

商品名・価格・規格など

[=name=]・[=unit_price=]・[=specification=] など。通常は、この記述を残します。

直接書いてあるもの

特集タイトル・紹介文・コピーなど

「いちご特集」などの文章。商品を替えても自動では替わらないため、内容を確認して書き換えます。

よく使う [= ... =] の意味を知りたい
書き方入る情報・部品
[=name=]商品名
[=code=]商品番号
[=link=]商品詳細ページへのリンク先
[=cooking_image=]台帳の調理画像
[=unit_price=]販売単価
[=specification=]規格
[=note=]商品説明
[=cart_nf=]カートに入れるボタン(お気に入りボタンなし)

例えば <p>[=name=]</p> は「ここに商品名を表示する」という意味です。商品名を替えるために、この文字列を手入力の商品名へ置き換えないようにします。

画像を替えたい:画像の種類を確認する

まず、いまの画像がどの書き方かを確認します。

画像の書き方何を使っている?変更するときの確認
[=cooking_image=]台帳の調理画像商品を替えると、その商品の情報を使う
[=product_image=]台帳の商品画像調理画像とは別の項目
[=image=]特集用の場所にある商品画像画像の保存場所を指定する path が必要
[=images('画像ファイル名')=]特集用の場所にある、指定した画像保存場所とファイル名を確認
src="/material/feature/..."ページへ直接指定した画像番号の変更だけで替わるとは限らない

path は「画像を探すフォルダ」の指定

添付コードのBパターンでは、次の組み合わせになっています。

添付コードからの抜粋・既存の保存先に合わせて使用
[=path('newproduct/2610/')=]
<img src="[=image=]" alt="商品画像" />

newproduct/2610/ は、/material/feature/ の下にある保存場所です。フォルダ名を替えるだけで画像が作られるわけではありません。その場所に必要な画像があるか確認します。

メイン画像は、幅によって使う画像が違う

添付コードの <picture> は、幅964px以上では slider.jpg、それ未満では thumbnails.jpg を使う指定です。紹介文にも pc_only と sp_only の別記述があります。片方だけ更新して終わらせず、両方を確認します。

画像の切り替え条件は添付コードで確認できます。各クラスの実際の見え方は、別ファイルのCSSにも依存します。

価格が出ない/カートやサンプルのボタンを確認したい

添付コードでは、価格をログインしている人にだけ表示するように書かれています。未ログインで金額が出ないだけなら、コードの誤りとは限りません。

読み方の例:元コードで使われている組み合わせ
[=if is_login=]
    [=cart_nf=]
[=else=]
    [=login=]
[=endif=]

上の例は「ログイン済みならカート、そうでなければログインボタンを表示する」という意味です。if は「もし〜なら」、else は「そうでなければ」、endif は「ここまで」と読みます。

ボタンの書き方仕様.xlsxでの説明
[=cart=]カートに入れるボタン
[=cart_ns=]カートに入れるボタン(サンプルなし)
[=cart_nf=]カートに入れるボタン(お気に入りボタンなし)
[=cart_ns_nf=]カートに入れるボタン(サンプル・お気に入りボタンなし)

価格や注文ボタンの外側にある [=if is_login=] を外す変更は、表示の小修正として扱わず、担当者へ確認します。

終売・欠品・SALEは、どう区別する?
書かれている条件意味
is_sold_out終売
is_out_of_stock欠品
is_sale_offセール商品
is_sale販売中

終売と欠品は別の項目です。また、is_sale は「SALE表示」ではなく「販売中」です。添付コードのAなどは、is_sold_out を見て商品を隠すように書かれています。

参照:仕様.xlsx「特集ページ用 パーツ」C3–D12・G3–H14・C20–H48/同「特集ページ用 サンプル1」J2/添付コード 9–19行・77–102行・278–284行・418–425行

06

タブと「商品一覧に戻る」

タブを使うページや、一覧と詳細を行き来するページだけ確認します。

タブ:そのタブに載せるかを true / false で決める

tab_codes は、商品ごとに「どのタブへ載せるか」をまとめた一覧です。タブは、ページ内の「タブ1」「タブ2」のような切り替えボタンです。

読み方の例:726029 の表示先
'726029': {'tab1': true, 'tab2': true, 'tab3': false}
設定読み方
'tab1': trueタブ1に載せる
'tab2': trueタブ2にも載せる
'tab3': falseタブ3には載せない

タブ用の true は「そのタブに載せる」、false は「そのタブには載せない」です。03の flg と同じ単語でも、何を切り替えるかは設定名によって違います。

タブを表示している部分を見分けたい
タブ1の外側の形・中の商品枠は省略した説明用の例
{% for code, data in tab_codes|filter(v => v.tab1) %}
    <!-- この間に元の商品枠があります -->
{% endfor %}

filter(...tab1) は「タブ1に載せる設定の商品だけ選ぶ」という部分です。この行や中の商品枠は残して、通常は上の tab_codes の設定を変更します。

切り替えボタン側の目印表示エリア側の目印
data-tab-target="tab1"data-tab-panel="tab1"
data-tab-target="tab2"data-tab-panel="tab2"

それぞれの tab1・tab2 は対応しています。ボタンの名前だけでなく、こうした目印もあるため、タブ追加は設定一覧の変更だけでは完了しません。

「商品一覧に戻る」:最後に押した商品へ戻る

添付コードの説明では、対象の商品一覧の中で「商品の魅力をチェック」を押すと、その位置を覚える仕様になっています。

  1. 「商品の魅力をチェック」を押す

    対象の一覧内にあるボタンなら、押した位置を記憶します。

  2. 「商品一覧に戻る」を1回押す

    最後に記憶した商品の位置へ戻ります。

  3. もう1回「商品一覧に戻る」を押す

    商品一覧の先頭へ戻ります。

「商品の魅力をチェック」を一度も押していない場合は、一覧の先頭へ戻ると説明されています。

戻るボタンに関係する、触らず残す目印
目印役割
id="returnPoint"位置を記憶する対象の一覧。添付例ではA_aに付いている
class="productSpecDetailBoxBtn"「商品の魅力をチェック」ボタンの目印
class="returnPositionBtn"戻るボタンの目印
data-return-target="returnPoint"戻り先の一覧を指定する記述

例えば href="#product_726029_detail" は、その名前が付いた場所への移動先です。商品を入れ替えたときは、移動先の枠もページ内にあるかを確認します。

参照:添付コード 665–684行・775–785行・887–906行/戻る位置記憶の対象:153行

07

変更後に、ここを確認する

更新のたびに使えるチェックです。確認できないことは、無理に判断しません。

編集前のコードを残し、変更後に画面を確認するのがおすすめです。以下は、このガイドで提案する確認手順です。

チェックはこの画面上の確認用です。記録としては保存されません。

困ったとき:症状から確認する場所を探す
起きていることまず見るところ
商品が出ない品番の入力、対象の一覧、終売の条件、タブの true / false を確認する。
名前や画像が別の商品になった商品番号と、始まり・終わりの目印が対応しているか確認する。手書きの文章・固定画像も確認する。
価格が出ないログイン状態を確認する。添付コードの価格はログイン条件の中にある。
星や犬の目印が想定と違う03の new / flg と、その値を見ている部分を確認する。新商品状態の is_new とは分けて考える。
画像が出ない画像の種類、path の保存場所、画像ファイル名、先頭の path 指定を消していないかを確認する。
商品を足した後、表示が崩れたカンマ・引用符・括弧や、始まりと終わりのセットを確認する。直前の変更と比較する。
「商品の魅力をチェック」で移動できないリンクの # の後ろの名前と、移動先の id が対応しているか確認する。
目印や条件が複雑で、どこを直すか決められない無理に消したり置換したりせず、変更前のコードと症状を担当者へ渡す。

原因を断定する表ではありません。添付コードの構造から、最初に確認しやすい場所をまとめたものです。

普段の更新で変更する場所の目安

このガイドを見ながら変更する部分担当者へ確認してから変更する部分
掲載商品番号、掲載順、手書きのタイトルや紹介文商品枠の目印、終了コメント、商品枠どうしの参照関係
既存の仕組みで使われている new / flg / tab の値新しい設定名・条件、新しいタブ、ログインや終売の表示ルール
保存先が確認できている固定画像の指定CSS・JavaScript、画像取得の仕組み、同じ商品の複数箇所掲載
08

調べたいときだけ開く一覧

パターンの違い・Excelの全項目・サンプルをまとめています。

ここから先は、必要になった項目を探すための一覧です。初めて読むときに、すべて覚える必要はありません。

A・A_a・B・C・Dは、何が違う?

これらは、添付コード内の商品表示パターンの名前です。下の表は書かれているコードの違いをまとめたもので、実画面の動作確認結果ではありません。

パターン掲載商品の指定方法コードで確認できる主な違い
A番号だけの一覧SALE用の表示あり。終売の場合は商品を隠す記述がある。
A_a番号+追加設定の一覧Aの派生。星・月・犬の追加設定と「商品の魅力をチェック」がある。終売を隠す記述もある。
B商品番号を枠へ直接記述path と image を使用。終売時は画像のリンクを外す分岐がある。
C商品番号を枠へ直接記述手書きのキャッチコピーと、規格・主原料・調理方法などを表示する。終売時は画像のリンクを外す分岐がある。
D番号だけの一覧+番号付けお品書き形式。count を使って番号を付ける。終売を隠す記述がある。
タブ表示先の設定付き一覧tab1・tab2 の設定を見て掲載対象を選ぶ。使用例の見た目のクラスはA・A_aを利用。

参照:添付コード:A 24–135行、A_a 139–263行、B 266–369行、C 372–617行、D 620–660行、タブ 663–884行

仕様.xlsxの項目一覧

Excelの「状態を確認する」「コマンド」「値の表示」の分類・順番をそのまま残しています。日付例はExcelのセル表示形式に合わせています。原文に確認が必要な箇所は、下に注記しています。

状態を確認する:ログイン・終売・SALEなど(10項目)

商品やお客さんが、どんな状態かを確認する項目です。例えば [=if is_login=] のように使います。

タグ名(原文)意味(原文)Excelの参照位置
is_loginログイン状態パーツ C3–D3
is_originalオリジナル商品パーツ C4–D4
is_renewalリニューアル商品パーツ C5–D5
is_new新着商品パーツ C6–D6
is_sale_offセール商品パーツ C7–D7
is_sale販売中パーツ C8–D8
is_out_of_stock欠品パーツ C9–D9
is_sold_out終売パーツ C10–D10
is_price_cut値下げパーツ C11–D11
is_price_increase値上げパーツ C12–D12
コマンド:ボタン・条件・画像の場所など(14項目)

「ボタンを出す」「条件に合うときだけ表示する」などの指示です。cart_ns(cart_nosample) の括弧内は、原資料に併記されている別名です。

タグ名(原文)意味・記述例(原文)補足・参照位置
cartカートに入れるボタン
パーツ G3–I3
cart_ns(cart_nosample)カートに入れるボタン(サンプル無し)
パーツ G4–I4
cart_nf(cart_nofavorite)カートに入れるボタン(お気に入りボタン無し)
パーツ G5–I5
cart_ns_nf(cart_nosample_nofavorite)カートに入れるボタン(サンプル・お気に入りボタン無し)
パーツ G6–I6
loginログインボタン
パーツ G7–I7
favoriteお気に入りマーク
パーツ G8–I8
nutrition栄養成分表ダウンロード2609の修正で詳細ページからPDFダウンロードボタンを非表示にしたので、今後は不要と判断し同ページで2回出し分けするケースには未対応。ただ、情報比較コンテンツとの使い分けは様子見。
上記は原資料の注記。新たな利用は担当者へ確認してください。
パーツ G9–I9
if条件分岐
パーツ G10–I10
if not条件分岐(否定)
パーツ G11–I11
else条件分岐(ではない)
パーツ G12–I12
endif条件分岐終了
パーツ G13–I13
path/material/feature以下のパスを指定する
パーツ G14–I14
field:after('search', 'tag')filedで指定した値から、searchの文字を探し、その後ろにtagを入れる
※記述例:[=note:after('。', '<br class="pc_only">'=]
※searchは複数文字を指定可能(例:'でした。')
要確認:記述例の括弧の閉じ方は、使用前に担当者へ確認。原文のまま転記。
パーツ G15–I15
field:width(width, 'tag')filedで指定した値から、width文字で分割し、分割部分にtagを入れる
※記述例:[=note:width(20, '<br class="pc_only">'=]
要確認:記述例の括弧の閉じ方は、使用前に担当者へ確認。原文のまま転記。
パーツ G16–I16
値の表示:商品名・価格・画像・調理方法など(36項目)

実際の商品情報を入れる項目です。例えば name は [=name=] と書きます。1~4 の表記は、1・2・3・4を使い分ける項目のまとめです。

タグ名(原文)意味(原文)表示例(原資料)補足・参照位置
id商品ID3413EC側の商品ID。基本は使用することはないが念の為用意。
パーツ C19–H19
name商品名海老と銀杏のかぶら蒸し
パーツ C20–H20
code商品コード8719
パーツ C21–H21
unit_price_before_discount値引き前単価84
パーツ C22–H22
unit_price販売単価80.5
パーツ C23–H23
lot_priceロット価格7080
パーツ C24–H24
unit単位個
パーツ C25–H25
lotロット60
パーツ C26–H26
specification規格目安重量:約40g 約4.5cm
パーツ C27–H27
note商品説明おろしたかぶとすり身をあわせたふわふわの生地に、エビと銀杏、木耳を入れて彩りよく仕上げました。餡をかけてお召し上がりください。
パーツ C28–H28
remarks商品備考※まれに小骨が入る場合があります。
パーツ C29–H29
material商品原料鶏もも肉(ブラジル産)、塩麹、にんにく、生姜
パーツ C30–H30
package商品包装袋
パーツ C31–H31
box_size商品箱サイズW390×D285×H125(mm)
パーツ C32–H32
display_quantity入数12個×8袋
パーツ C33–H33
final_processing_country商品最終加工国中国
パーツ C34–H34
expiration_date賞味期限(Y.m.d)2026.04.20
パーツ C35–H35
expiration_date_ja賞味期限(Y年m月d日)2026年04月20日
パーツ C36–H36
expiration_date_slash賞味期限(Y/m/d)2026/04/20
パーツ C37–H37
product_image台帳商品画像/material/product/924045/Img/9240452.webp?q=20240605130004
パーツ C38–H38
cooking_image台帳調理画像/material/product/924045/Img/9240451.webp?q=20240605130004
パーツ C39–H39
sub_images('nn')台帳イメージ画像/material/product/924045/Img/924045i01.webp?q=202406
※記述例:[=image_image('01')=]
要確認:タグ名は sub_images、記述例は image_image で一致していない。
パーツ C40–H40
image商品画像/material/feature/newproduct/2510/3120.webp?q=202509
※記述例:[=image=](要path指定)
パーツ C41–H41
image('path')商品画像/material/feature/newproduct/2510/3120.webp?q=202509
※記述例:[=image('newproduct/2510/')=]
パーツ C42–H42
images('src')他画像/material/feature/osechitanpin/pc_925001img.png
※記述例:[=images('pc_[=code=]img.png')=](要path指定)
パーツ C43–H43
images('path', 'src')他画像/material/feature/osechitanpin/pc_925001img.png
※記述例:[=images('osechitanpin/', 'pc_925001img.png')=]
パーツ C44–H44
link商品詳細ページへのリンク/products/detail/3210
パーツ C45–H45
discount_rate割引率12.5
パーツ C46–H46
cooking_method_name1~4調理方法名1~4揚げる
パーツ C47–H47
cooking_method1~4調理方法1~4170~180℃えび、かぼちゃ約3分
パーツ C48–H48
delivery_periodお届け期間(Y.m.d)2026.04.20
パーツ C49–H49
delivery_period_jaお届け期間(Y年m月d日)2026年04月20日
パーツ C50–H50
delivery_period_slashお届け期間(Y/m/d)2026/04/20
パーツ C51–H51
next_restock_date入荷予定日(Y.m.d)2026.04.20
パーツ C52–H52
next_restock_date_ja入荷予定日(Y年m月d日)2026年04月20日
パーツ C53–H53
next_restock_date_slash入荷予定日(Y/m/d)2026/04/20
パーツ C54–H54

表示例は各項目の説明用です。ここに並ぶ価格・ロットなどを、現在の販売条件や、1商品の整合したデータとして使用しないでください。

元のExcelにある、商品枠のコードと画面例を見る

次は、仕様.xlsxの「特集ページ用 サンプル1」にある例です。始まりと終わりの目印、自動で入る商品名、ログイン時のボタンを、実際の見た目と見比べられます。

原資料のサンプル・使用するページへそのまま追加するための例ではない
<li class="premiumProductBox" id="product_724029">
    [=path('premium_index')=]
    <div class="premiumProductImg">
        <a href="/feature/premium_brownebifurai"><img src="[=images('thumbnail_brown_ebifurai.jpg')=]"></a>
    </div>
    <div class="premiumProductCopy">
        <p>濃厚でまろやかな味わい<br class="pc_only">天然ブラウン海老フライ。</p>
    </div>
    <a href="/feature/premium_brownebifurai">
        <dl class="productCodeBoxNmaeBox">
            <dt class="productCodeBox">
            [=if is_original=]
                <p class="productStatus">オリジナル</p>
            [=endif=]
                <p class="productCode">[=code=]</p>
            </dt>
            <dd class="productName">[=name=]</dd>
        </dl>
    </a>
    [=if is_login=]
        [=cart_nf=]
    [=endif=]
</li><!-- product_724029 -->
元資料に添付された商品表示例。商品画像、手書きコピー、商品番号・商品名、カートと有償サンプルのボタンが並んでいる。
仕様.xlsx「特集ページ用 サンプル1」の掲載画像。価格などは元資料の表示例で、現在の情報ではありません。

参照:仕様.xlsx「特集ページ用 サンプル1」A1–E23・J2・添付画像

見た目や動きに関係するファイル名を知りたい

CSSは見た目、JavaScriptはクリックなどの動きに関係するファイルです。添付コードには、次の読み込みがあります。実ファイルの中身は添付されていないため、担当者向けの確認先として記載しています。

区分添付コードにあるファイル
CSS/material/feature/reset.css
/material/feature/common.css
/material/feature/featurebase/featurebase.css
特集専用CSSの追加位置/material/feature/特集名/style.css
元コードではコメント内の案内として記載。
JavaScript/material/feature/featurebase/featurebase.js
/html/user_data/assets/js/feature_cart.js

alwaysAccordion・productSpecToggle・reverseLayout などのクラスも使われています。商品番号の更新ではこれらを変更せず、折りたたみ方や並び方の調整はCSS・JavaScriptと合わせて確認します。

参照:添付コード 1–6行・234–254行・499行・905–906行

言葉がわからないときのミニ辞典
言葉この資料では、こう読めば大丈夫
テンプレート商品ごとに使い回す、表示のひな形。
配列商品番号などを順に並べた一覧。02の「番号だけの一覧」。
辞書型・連想配列番号などの名前に、設定をひもづけた一覧。03の「番号+追加設定」。
繰り返し・ループ一覧にある商品について、同じ商品枠を順に作ること。for から endfor まで。
条件分岐「ログイン済みならカート、そうでなければログイン案内」のような出し分け。
フラグ付ける/付けない、対象/対象外を決める設定。何を切り替えるかは、その設定を使うコードによる。
タグこの資料では [=name=] などの表示用の記述や、HTMLの記述を指す。
商品ブロック1商品分の表示を囲んだ範囲。このガイドでは「商品枠」と呼んでいる。
コメント通常の画面には出ない記述。ただし、この仕組みの product_... の終了コメントは削除しない。
id・識別名ページ内の場所を指定する目印。商品情報や、詳細への移動先に関係する。
クラス・class見た目や動きの指定に使われる名前。pickupProduct など。
パス・pathファイルやフォルダの場所を表す文字列。
アコーディオン「もっと見る」などで開閉する、折りたたみ表示。

一般用語の網羅的な定義ではなく、添付コードを読むための言い換えです。

09

担当者に確認すること

正式な仕様が決まっていない部分や、添付資料だけでは判断できない部分です。

以下は、更新担当のスタッフが自分で仕様を決めるための項目ではありません。判断が必要になったとき、制作・システム担当者へ渡す確認メモです。

説明文とコードが合っていない・意図を確認したい箇所

A_a:終売を表示するか

説明文には「終売も表示」とある一方、コードには終売時の非表示指定と、終売でない場合だけ中身を出す記述があります。どちらを正式な扱いにするか確認が必要です。

参照:添付コード 139–162行

B:終売になったときに何を残すか

説明文には「未確認」「終売になると非表示」とあります。コード上は、画像のリンクを外して画像を残す分岐です。商品番号・商品名のリンクには、同じ終売条件が付いていません。商品枠全体を隠す意図なのか確認します。

参照:添付コード 266–284行・305–308行

C:SALE商品をどう扱うか

説明文には「SALE商品を表示しない想定」とありますが、コードにはSALEのラベルや割引価格の分岐があります。掲載対象にSALE商品を選ばない運用なのか、コードで除外したいのかを確認します。

参照:添付コード 372–411行・469–478行

D:終売表示と、お品書きの番号

説明文には「終売になっても表示」とありますが、コードには終売商品の非表示指定があります。また count は各商品で加算されるため、非表示の商品があると番号が飛ぶ可能性があります。これはコードから考えられる注意点で、実画面では未確認です。

参照:添付コード 620–654行

同じ商品の複数掲載・詳細への移動・タブの確認
確認したいこと添付資料からわかること・足りないこと
同じ商品を複数箇所に載せるA_aとタブなど、複数の枠で同じ product_... が生成される記述がある。追加文字付きの番号もあるが、重複や追加文字を処理する仕組みまでは添付されていない。
追加文字付きの商品の非表示枠は product_{{ code }}、終売時の非表示指定は #product_[=code=]。_a などが付く場合にどの文字列が実際に出るか、対象が合うかは実出力を確認する。
「商品の魅力をチェック」の行き先A_aは #product_{{ code }}_detail を指定するが、添付コードに見える該当する詳細枠は product_726029_detail。ほかの商品は行き先を確認する必要がある。
タブ内の詳細ボタンタブ例では #product_{{ code }} が指定され、商品枠自身の識別名と同じ。別の詳細エリアに移動したい意図かどうか確認する。
タブ2の商品表示コードを省略する運用元の説明には省略可能とあるが、添付例は商品表示コードも記載。省略した最小例と、参照処理の確認が必要。
タブ3の追加設定値はあるが、切り替えボタン・表示エリアはタブ1とタブ2のみ。true にするだけでは追加にならない。

参照:添付コード 145–160行・255行・499–614行・665–688行・775–789行・876行

仕様.xlsxの記載で確認したい箇所
項目元資料の記載確認すること
sub_images('nn')タグ名は sub_images だが、例は [=image_image('01')=]どちらの記述を使うか。原資料のC40・E40を確認。
field:after('search', 'tag')例:[=note:after('。', '<br class="pc_only">'=]記述例の括弧の閉じ方。原資料のG15・H15を確認。
field:width(width, 'tag')例:[=note:width(20, '<br class="pc_only">'=]記述例の括弧の閉じ方。原資料のG16・H16を確認。
nutrition「2609の修正」でPDFボタンを非表示にしたため、同一ページで2回出し分けるケースには未対応との注記。今後利用するか、利用する場合の対応範囲。原資料のG9–I9を確認。

上記の記述は、原文を勝手に正しい形へ書き換えず残しています。確認前の例を、そのまま本番ページへ追加しないでください。