FTPサーバから商品画像・商品グループ画像・アイテムをアップロード

商品画像・商品グループ画像・アイテムはFTPサーバからアップロードして登録できます。

※FTPサーバ情報はフューチャーショップサポートよりご案内いたします。
※FTP専用のサーバとなりますので、いわゆるWebサーバ領域としてはご利用いただけません。

＜目次＞

• 画像アップロードの仕様について
• 商品画像の一括アップロード
• 商品グループ画像の一括アップロード
• 商品画像・商品グループ画像の取得方法
• 商品画像・商品グループ画像のFTPサーバのディレクトリと画像URL
• アイテム（デザイン画像・JavaScriptファイル・CSSファイルなど）のアップロード
  • FTPサーバのディレクトリ（アイテム）
• ご注意事項

商品画像・商品グループ画像・FTPでのアップロード画像（/products/内の画像のみ）については、以下の仕様となっています。

• JPEG（.jpg）形式でアップロードすれば、画像表示時に、ブラウザに応じて最適な画像フォーマット（Jpeg/webp/avif）が自動選択されます。
• 1つの画像につき1ファイル（オリジナル画像のみ）アップロードすれば、画像表示時に自動で設定サイズにリサイズされ表示されます（リサイズ不要）。

FTPにてアップロードされた商品画像・商品グループ画像は、アイテムボックス機能で管理・表示されます。
アイテムボックスについて詳しくは、アイテムボックスの仕様と特長についてをご覧ください。

基本仕様

• 対応ファイル形式は、JPEG（.jpg）のみになります。JPEG（.JPG）・JPEG（.jpeg）・PNG・GIFなどはご利用できません。
• 使用可能な商品画像ファイルの最大容量は1MBまでです。
• 登録可能な画像ファイルは縦・横とも9,999ピクセルまでとなります。

アップロード手順

商品情報が登録されている場合、以下の手順で商品画像を登録できます。
登録されていない商品の画像は登録できません。

画像をアップロードすると、商品画像登録用ファイル（CSVファイル）アップロードなしで、商品画像として掲載されます。

＜手順＞

画像ファイル名について

アップロードするオリジナル画像のファイル名は以下としてください。

商品URLコード-画像No(01-40).jpg

基本仕様

• 対応ファイル形式は、JPEG（.jpg）のみになります。JPEG（.JPG）・JPEG（.jpeg）・PNG・GIFなどはご利用できません。
• 使用可能な商品画像ファイルの最大容量は1MBまでです。
• 登録可能な画像ファイルは縦・横とも9,999ピクセルまでとなります。

アップロード手順

商品グループ情報が登録されている場合、以下の手順で商品画像を登録できます。
登録されていない商品グループの画像は登録できません。

＜手順＞

アップロード作業前に、アップロードにあたっての注意事項をご確認ください。

画像ファイル名について

アップロードするオリジナル画像のファイル名は以下としてください。

商品グループURLコード.jpg

バックアップなどのために、登録されている商品画像・商品グループ画像をFTPから取得できます。
商品画像はFTPサーバの /itembox/product/、商品グループ画像は /itembox/category/ から取得できます。

商品画像・商品グループ画像のアップロードディレクトリとURLは以下となります。

商品IDは商品情報登録時にシステムから自動発番されるIDです。
商品グループIDは商品グループ登録時にシステムから自動発番されるIDです。

コマースクリエイター＞アイテムに登録するファイルを、FTPサーバーからアップロード/ダウンロードできます。

基本仕様

• FTPサーバの /itembox/item/ ディレクトリにファイルを配置します。
• /itembox/item/ ディレクトリ配下に直接、またはディレクトリを作成し、その配下にファイルをアップロードできます。
• ディレクトリ名・ファイル名には、半角英数字と記号「.」「_」「-」「/」を利用できます。
• 同じディレクトリ、同じファイル名でアップロードすれば、上書きは可能です。

＜アイテムに関する基本仕様＞

• 対応ファイル形式は、 JPEG（.jpg）、GIF（.gif）、PNG（.png）、SVG（.svg） になります。
• アイテムにアップロードできるファイルの最大容量は、1ファイルあたり30MBまでです。（管理画面・FTPサーバ共通）
• 登録可能な画像ファイルは縦・横とも9,999ピクセルまでとなります。
• 動画ファイルについては、1ファイルで30MBを超える場合がございます。
  外部の動画配信サービス（【参考】虎の巻）をご利用ください。CMSサーバー（VPS）への配置もお控えください。
• パターンパーツなどで、画像として取り扱うファイル形式はJPEG（ jpeg / jpg ）、GIF（gif）、PNG（png）、SVG（svg）となります。

アイテムについて詳しくはコマースクリエイター＞アイテム一覧をご覧ください。

コマースクリエイター＞アイテムとの関係性

• /itembox/item/ディレクトリは、コマースクリエイター＞アイテムと同期しています。
• アップロードしたファイルは、コマースクリエイター＞アイテムに表示されます。
  アイテム名は（/itembox/item/以下の）ファイルパス」となります。
• FTPでアップロードした場合、管理タグは設定できません。
  管理タグを設定したい場合は、コマースクリエイター＞アイテムから行ってください。一括で設定する方法はありません。
• FTPサーバから削除すると、コマースクリエイター＞アイテムからも削除されます。

URLについて

• アップロードしたファイルは、 https://{店舗key}.itembox.cloud/item/ファイルパス（アイテムのパス） のURLで表示できます。
  （例）「/item/sample.png」のURLは、「https://{店舗key}.itembox.cloud/item/sample.png」となります。

ご注意事項

• 初期配置されているディレクトリ /itembox/item/s/ 配下には、htmlファイルおよびJavaScriptファイルのみ配置できます。
  htmlファイル・JavaScriptファイル以外をアップロードすると正しく読み込めなくなる場合があります。
  その他の形式のファイルは、パスに「/s」以外を指定してください。
• /itembox/item/s/ ・ /itembox/item/top/ は用途が固定された既定のディレクトリ名です。削除しないでください。
• ZIPファイルでの一括アップロードはできません。
• アイテムにアップロードした画像はキャッシュ機構により一時的に保存されていますので、アイテムをURLにて直接指定して表示した場合、上書きしてもすぐには更新されません。（1分程度）
  ただし、パターンパーツ（カルーセル・コラム）の画像表示機能を使用している場合や、フリーパーツやフリーページ本文にて「アイテム置換文字」を使用して表示している場合は、すぐに更新されます。

FTPサーバのディレクトリ（アイテム）

初期は下記のようなディレクトリ構成となっています。

＜ご注意事項＞

FTPサーバはコマースクリエイター＞アイテムのファイルを登録・更新・削除する仕組みですので、いわゆるサーバサイドプログラム（PHPやPerlなど）を実行することはできません。必要な場合は「CMSサーバー（VPS）オプション」をご利用ください。

最新ファイルを読み込ませる記載方法

CSSに画像ファイルなどのURLを直接記載する場合は、以下のように 「タイムスタンプ」を記載してください 。
「最新ファイルに変更したにもかかわらず表示が変わらない（キャッシュをクリアしなくてはならない）」などを防げます。

https://{店舗key}.itembox.cloud/{各画像のパス}?t=[タイムスタンプ]

タイムスタンプは、「年月日秒」単位まで指定可能です。（秒数はアップロード時以前の秒であれば、おおよそで構いません。）

＜例＞
2020年7月9日5時00分30秒に更新したファイルを読み込ませたい場合

https://{店舗key}.itembox.cloud/item/sample.jpg?t=20200709050030

＜画像パスに関する補足＞

• コマースクリエイター＞アイテムにアップロードした画像の場合は、/item/ディレクトリ内のパスとなります。
• 管理画面やFTPにてアップロードした画像の場合は、それぞれ以下のディレクトリ内となります・
  • 商品画像の場合は、/product/ディレクトリ内のパスとなります。
  • 商品グループ画像の場合は、/category/ディレクトリ内のパスとなります。

＜ご注意事項＞

• 更新したファイルを即時反映したい場合には、タイムスタンプも更新してください。
• ファイルをアップロードする前にファイルのパスを記述したページを公開した場合にも、キャッシュが発生（ファイルがない状態をキャッシュ）する場合がありますので、その際には同様にタイムスタンプを記述してください。

アップロードにあたっての注意事項

複数ファイルを続けてアップロードする際、処理エラーとなり、一括登録が停止してしまう場合があります。

＜ご注意事項＞

• 商品情報およびバリエーションなどの情報を登録後に（商品画像を登録する）ZIPファイルをアップロードしてください。
  画像登録処理と同時に、商品やバリエーションを登録することはできません。
• ZIPファイルの処理中に、対象の商品情報を管理画面で変更・追加されますと、ファイル登録処理に影響がでる場合があります。
  商品情報変更作業をされない時間に、ZIPファイルアップロードを行うことを推奨いたします。
• 画像ファイルの容量、混雑状況により処理時間がかかる場合があります。
  余裕を持った作業スケジュールをご計画いただくことをおすすめします。
• 空のディレクトリをアップロードすることはできません。