🌐 言語: 🇻🇳 Tiếng Việt · 🇬🇧 English · 🇯🇵 日本語（現在）

MKP — S-Cart 向けマーケットプレイステンプレート（GP247 3.x）

はじめに

MKP は S-Cart 3.x 向けのマーケットプレイス型ストアフロントテーマです。有料テンプレートであり、GP247 があなたのドメインに対して 発行するライセンスに基づいて使用します。マーケットプレイスのお客様が 見たいものがあらかじめ揃っています：複数のショップ、各商品の販売者、レビュー、そしてスマートフォンでのすっきりした購入フロー。本書は S-Cart Web サイトのオーナー向けに、MKP でできること、既定テンプレートとの違い、インストール方法とカスタマイズ方法を説明します。

バージョン 1.0.5 · gp247/core 3.0 または 3.1 と gp247/front が必要です。gp247/shop の導入を推奨します（商品ページのお気に入り・比較ボタン、追加済みの状態表示、「もう一度クリックで解除」には 3.1 より新しい gp247/shop が必要です — それより古いバージョンでは 1.0.1 の動作のままです）。

🔗 デモを見る： m-vendor.s-cart.org · ライセンスの購入と紹介： gp247.net — Template Marketplace MKP

テンプレートでできること

お客様が商品をより早く見つけられます。 バナーのすぐ下で、トップページはフラッシュセール（プラグイン導入時）、信頼性ストリップ、セール商品を 先に表示し、続いてカテゴリグリッド、新着ショップ（プラグイン導入時）、新着商品を表示します。スマートフォンでは、商品一覧ページの最初の画面に商品が表示され、フィルターは折りたたまれます。

お客様が販売者をより信頼できます。 各商品には販売者が明示されます：商品カードのショップ名、商品詳細ページの販売者ブロック（ロゴ、 評価、ショップを見るボタン）、商品名の横の星評価。トップページの信頼性ストリップは、マーケットプレイスが実際に提供していることだけを伝えます。

スマートフォンでの購入は手順が少なく、間違いも少なくなります。 商品ページの下部に固定される購入バー、ショップごとに分かれ、各ショップで 個別に決済することを明示するカート、そして住所入力のステップから注文の概要（どのショップか、商品数、金額）を表示する決済画面。

機能を失わずにデザインを変更できます。 MKP は既定テンプレートと同じプラグインで動作し、ストアに割り当てると、有効なプラグインの トップページ用ブロックを自動的に配置し直します。

詳細

トップページと商品検索

• 最上部バー（ホットライン、言語、通貨、ショップ一覧と出店のご案内への入口）、カテゴリメニュー付きの検索欄、 件数表示付きのアカウント / お気に入り / カート。
• レイアウトブロックで構成するトップページ：大きなスライダー + 右側バナー 2 つ、信頼性ストリップ、セール商品、サブカテゴリ付きのカテゴリグリッド、 新着商品、小バナー、ニュース、ブランド（ロゴと名前）、ニュースレター登録。
• 広い画面では 5 列の商品グリッド。スマートフォンではサブカテゴリのストリップと折りたたみ式フィルター。

商品ページと販売者

• 販売者ブロック：ロゴ、名前、ショップの評価、ショップを見るボタン。販売者名は 1 回だけ表示します。
• 値引き時は価格に -x% ラベルを表示。グループ商品では、画像・名前・価格付きで子商品の一覧を表示します。
• −/+ ボタン付きの数量欄。スマートフォンでは「カートに追加」ボタンが隠れると下部固定の購入バーを表示します。
• 商品ページと各商品カードにお気に入りと比較ボタン。追加済みの商品はボタンが赤色で表示され（一覧上ですぐにわかります）、もう一度クリックすると解除されます。
• 実際に機能する共有：Facebook、X、リンクのコピー、ブラウザが対応していればスマートフォンの共有ボタン。
• 長い説明文は「もっと見る / 閉じる」ボタンで折りたたまれます。

カートと決済

• カートはショップごとに分かれ、各ショップに小計と個別の決済ボタンがあります。カートを空にするボタンは 1 か所だけです（すべての ショップの商品を削除するため）。
• 空のカートには買い物に戻るボタンがあります。
• 複数ステップの決済。確認前の各ステップには、開くと各行を確認できる注文の概要があります。

スマートフォンとアクセシビリティ

• 下部ナビゲーションバー：ホーム、カテゴリ、ショップ一覧、カート、アカウント。
• 文字色は WCAG AA のコントラスト基準を満たします。スマートフォンのボタンとアイコンは最小 44px です。
• 右から左に書く言語（RTL）に対応しています。

互換性

• 既定テンプレートと同じプラグインで動作します：商品レビュー（ProductRating）、クーポン（ShopDiscount）、キャプチャ（GoogleCaptcha）、 ソーシャルログイン（LoginSocial）、フラッシュセール（ProductFlashSale）、ニュース（News）、決済 / 配送。
• マルチベンダー（MultiVendor）とマルチストア（MultiStore）：商品カードのショップ名、新着ショップブロック、プラグインのショップページが MKP のスタイルで表示されます。
• カート、フィルター、商品カード、決済は gp247/shop の Livewire で動作します — カートへの追加、数量変更、絞り込み・並べ替えを ページの再読み込みなしで行えます。
• jQuery / Bootstrap は使用しません：コンパイル済みの Tailwind CSS、インタラクションは Alpine（Livewire に同梱）で実現しています。
• 一般的な共有ホスティングで動作します：利用に Node、cron、キューワーカーは不要です。
• gp247/shop の標準配送（新しい配送レイヤーを備えたバージョン以降）：配送選択ステップに各配送会社のすべてのサービス（例：GHTK 陸送 / 空輸）を料金とお届け予定とともに表示し、その住所に対応するサービスがない場合は明示します。ショップが有効にしている場合、決済、会員登録、住所録、注文詳細に**区・町域（坊・社）**欄を表示します。古い gp247/shop では、すべて従来どおり表示されます。

MKP と既定テンプレート（GP247Front）の違い

ストア管理画面で、いつでも 2 つのテンプレートを切り替えられます。商品、注文、顧客のデータは変わりません。

テンプレートをストアに割り当てる

flowchart LR
    A[MKP をインストール] --> B[MKP をストアに割り当て]
    B --> C[旧テンプレートのブロックを削除<br/>プラグインのブロックも含む]
    C --> D[MKP がトップページ、<br/>左カラムのブロックとサンプルバナーを配置]
    D --> E{有効なプラグインは？}
    E -->|ProductFlashSale| F[フラッシュセールブロックを再配置]
    E -->|MultiVendor| G[新着ショップブロックを再配置]
    E -->|なし| H[完了]
    F --> H
    G --> H

MKP を何度割り当て直しても、ブロックが重複することはありません。MKP を割り当てた後にインストールしたプラグインは、通常どおり自身のブロックを配置します。

マーケットプレイスでのお客様の購入

flowchart LR
    A[お客様が複数ショップの<br/>商品を追加] --> B[カートを<br/>ショップごとに分割]
    B --> C[1 つのショップの<br/>決済をクリック]
    C --> D[住所を入力<br/>+ そのショップの注文概要]
    D --> E[配送 / 決済<br/>ストアが有効にしている場合]
    E --> F[確認して注文]
    F --> G{カートに他のショップの<br/>商品が残っている？}
    G -->|はい| C
    G -->|いいえ| H[完了]

要件

• gp247/core 3.0 と gp247/front を備えた S-Cart 3.x。
• カート、商品、決済には gp247/shop が必要です（なくてもページとニュースの部分は動作します）。
• 一般的な共有ホスティングで動作します。

License

• 購入後、GP247 は Web サイトのドメインに紐付いた MKP のライセンスを発行します（.env の APP_URL にあるドメイン）。
• このライセンスは、GP247 ライブラリへの接続に使う無料の API License（gp247:ext-register-license）とは異なります。API License は 接続を開くだけで、テンプレートのダウンロードと更新を可能にするのは MKP のライセンスです。
• 新しいバージョンのダウンロード（更新）には、そのドメインに対して有効なライセンスが必要です。ライセンスの期限が切れているか、ドメインが一致しない場合、 インストーラーは停止して理由を表示します。
• ライセンス、更新、サポートは、テンプレートをお届けした GP247 の有料チャネルを通じて提供されます。

インストール

1. Admin → Extensions → Templates：購入時に受け取った zip ファイルをアップロードするか、あなたのライセンスで GP247 ライブラリからインストールし、 Install をクリックします。
2. ストア管理画面でテンプレートをストアに割り当てます。MKP はレイアウトブロックとサンプルバナー（名前の末尾に (MKP) が付きます）を自動的に作成します。

手動インストール：MKP フォルダを app/GP247/Templates/ にコピーし、app/GP247/Templates/MKP/public/ を public/GP247/Templates/MKP/ にコピーしてから、手順 1〜2 を行います。

Bootstrap を使用した旧版の MKP（GP247 1.x 向け）は、本バージョンにその場でアップグレードできません — 旧版をアンインストールしてから新しくインストールしてください。

コマンドラインでのインストール（CLI、gp247 3.x）

Web サイトのルートフォルダでターミナルを開き、次を実行します。

# 1) ウェブサイトごとに 1 回だけ：GP247 ライブラリに接続するための API License（無料）を登録
php artisan gp247:ext-register-license

# 2) ライブラリから MKP をダウンロードし、購入時に受け取ったライセンスでインストール
php artisan gp247:ext-install --type=template --key=MKP --paid --license=<your-license>

• <your-license> は、購入後に GP247 があなたのドメインに対して発行する MKP のライセンスです — 手順 1 の無料の API License とは異なります。
• 手順 1 の前に、.env の APP_URL が Web サイトの実際のドメインになっていること（http://localhost のままでないこと）を確認してください。両方のライセンスが このドメインに紐付けられます。
• 有料版は 1 キーずつインストールします：1 つの --paid コマンドで MKP と他のキーをまとめないでください。
• app/GP247/Templates/MKP フォルダがすでにある場合（購入した zip ファイルから展開した場合）、コマンドはその場でインストールし、再ダウンロードせず、 --paid も不要です。
• 新しいバージョンへの更新：php artisan gp247:ext-update --type=template --key=MKP（有効なライセンスが必要です — License の項を参照）。
• --json を付けると、機械可読形式で結果を受け取れます（スクリプト・CI 向け）。
• インストール後も、テンプレートをストアに割り当てる必要があります。

カスタマイズ

MKP を更新すると、テンプレートのファイルは上書きされます。 更新前に app/GP247/Templates/MKP フォルダをバックアップし、 変更したファイルを記録して、更新後に再適用できるようにしてください。

CSS/JS を変更した場合や、Blade に新しい Tailwind クラスを追加した場合は、再ビルドします（Web サイトのルートフォルダで実行、Node が必要です）。

npx tailwindcss@3 -c app/GP247/Templates/MKP/resources/assets/tailwind.config.js -i app/GP247/Templates/MKP/resources/assets/css/app.css -o app/GP247/Templates/MKP/public/css/app.css --minify

cp app/GP247/Templates/MKP/resources/assets/js/app.js app/GP247/Templates/MKP/public/js/app.js

その後、public/css と public/js を public/GP247/Templates/MKP/ にコピーします。

ビルド時にどこにも存在しなかった Tailwind クラスは、再ビルドするまで効果がありません。

ストアへの割り当て時に MKP が作成するレイアウトブロック

category_store_left ブロック（ショップのカテゴリ）は、ショップページに専用のカテゴリストリップがあるため、既定では配置されません。必要であれば Admin → Layout blocks で手動で割り当てられます。

使用するバナーの種類：banner-left（スライダー）、banner-right、banner-mini、banner-special。

ドキュメント

よくある質問（Q&A）

質問 1：私の Web サイトはオーナーが 1 人だけですが、MKP を使えますか？

→ 使えます。マーケットプレイス向けの部分（販売者ブロック、ショップ一覧への入口、新着ショップブロック）は、MultiVendor または MultiStore プラグインがある場合にのみ表示されます。プラグインがなければ、MKP は通常のストアフロントとして動作します。

質問 2：既定テンプレートから MKP に切り替えると、データは失われますか？

→ いいえ。商品、注文、顧客、バナーはそのまま保持されます。旧テンプレートのレイアウトブロックだけが MKP のブロックに置き換えられます。

質問 3：ブロックの位置を並べ替えましたが、MKP を割り当て直すと上書きされますか？

→ いいえ。MKP は不足しているブロックを追加するだけで、重複して作成したり、既存のブロックを変更したりしません。

質問 4：Blade ファイルに Tailwind クラスを追加したのに、デザインが変わりません。

→ MKP の CSS はコンパイル済みです。新しいクラスは再ビルドした後にのみ効果があります（カスタマイズの項を参照）。

質問 5：MKP のライセンスと API License はどう違いますか？

→ API License（無料、gp247:ext-register-license）は、Web サイトを GP247 ライブラリに接続するためだけのものです。MKP のライセンスはあなたが購入する使用権で、 ドメインに紐付けられ、--paid --license=… でのインストール時と更新時に使用します。

質問 6：更新時にライセンスエラーが表示されます。

→ APP_URL がライセンスを購入したドメインと一致していること、そしてライセンスが有効であることを確認してください。ライセンスの延長やドメインの変更が必要な場合は、 テンプレートをお届けした GP247 の有料チャネルにお問い合わせください。

質問 7：画面上の文言を変更したいです。

→ ショップ共通の文言は管理画面の言語管理画面で編集します。MKP 独自の文言は、テンプレートの Lang/<language>/lang.php にあります。