事前準備
セットアップを始める前に、以下の情報をご準備ください。
MySQL 5.7以上
Apache + mod_rewrite
（Stripe決済に必要）
DB名・ユーザー名
パスワード
秘密キー (sk_)
Webhookシークレット (whsec_)
ポート（465推奨）
ユーザー名・パスワード
（購入時にメールで届きます）
受信したZIPファイルを展開し、中身をサーバーのWebルート（public_html等）にFTPでアップロードしてください。アップロード後、ブラウザで https://あなたのドメイン/setup.php にアクセスするとウィザードが開始します。
ウェルカム画面
setup.php にアクセスすると、最初にこの画面が表示されます。「セットアップを開始」をクリックしてください。
データベース接続
MySQLデータベースの接続情報を入力します。レンタルサーバーのコントロールパネルで確認できます。「接続テスト」をクリックすると自動的に接続確認が行われます。
ホスト名は「localhost」ではなく、コントロールパネルに記載のMySQLサーバー名（例: mysql123.xserver.jp）を入力してください。文字コードは「utf8mb4」のまま変更不要です。
データベーステーブル作成
「テーブルを作成」をクリックすると、ECサイトに必要なテーブルが自動的に作成されます。全て「成功」と表示されれば完了です。
| テーブル名 | ステータス |
|---|---|
| ec_products | ✓ 成功 |
| ec_orders | ✓ 成功 |
| ec_order_items | ✓ 成功 |
| users | ✓ 成功 |
| ec_coupons | ✓ 成功 |
| ec_reviews | ✓ 成功 |
| ec_wishlist | ✓ 成功 |
| ec_abandoned_carts | ✓ 成功 |
管理者アカウント
管理画面にログインするためのメールアドレスとパスワードを設定します。パスワードは8文字以上で設定してください。
管理者パスワードは推測されにくいものを設定してください。英数字・記号を含む12文字以上を推奨します。このパスワードはセットアップ完了後、.envファイルにハッシュ化されて保存されます。
ASPライセンスキー
購入時にメールで届いたライセンスキーを入力します。後から .env ファイルに手動で設定することも可能なので、スキップもできます。
キーは
VTO-XXXX-XXXX-XXXX-XXXX の形式です。Stripe 決済設定
Stripeダッシュボード（stripe.com）からAPIキーを取得して入力します。まずはテストモードで動作確認し、準備ができたら本番キーに切り替えてください。
以下のURLからStripeダッシュボードにログインし、各キーを取得してください。
| APIキー （Secret Key / Publishable Key） |
https://dashboard.stripe.com/apikeys テストモード切替は右上の「テストモード」トグルで行えます |
| Webhook Secret （whsec_...） |
https://dashboard.stripe.com/webhooks 「エンドポイントを追加」→ URL入力 → 「Signing secret」をコピー |
| テスト用APIキー |
https://dashboard.stripe.com/test/apikeys テストモード専用の直リンク（sk_test_ / pk_test_ が表示されます） |
Stripeダッシュボードの Webhooks ページ で、以下の設定を行ってください。
エンドポイントURL：https://あなたのドメイン/api/webhook.php
リッスンするイベント：checkout.session.completed
登録後に表示される「Signing secret」（whsec_ で始まる文字列）をStep 6のWebhook Secretに入力します。
SMTP メール設定
注文確認メールや発送通知メールの送信に使用するSMTPサーバーの情報を入力します。レンタルサーバーのメール設定を確認してください。
ショップ・ブランド設定
ショップ名やブランドカラーを設定します。カラーはカラーピッカーで直感的に選択できます。LINE公式アカウントをお持ちの場合は、友だち追加URLも設定できます。
確認・完了
全ての設定内容を確認して「セットアップを完了する」をクリックします。.envファイルとテーマ設定ファイルが自動生成され、管理画面にログインできるようになります。
- 📊 データベース
- ホスト：localhost
- データベース名：myshop_db
- ユーザー名：db_user
- 👤 管理者アカウント
- メール：admin@your-shop.com
- パスワード：ad****rd
- 🔑 ライセンス
- ライセンスキー：VTO-AB12-CD34-EF56-GH78
- 💳 Stripe
- 環境：テストモード
- Secret Key：sk_t****...
- 📧 SMTP
- ホスト：mail.your-shop.com
- ポート：465
- 🎨 ショップ
- ショップ名：My Fashion Shop
- キャッチフレーズ：バーチャル試着で販売革新
完了後に表示される画面：
下のボタンをクリックして、管理画面にログインしてください。
セットアップ完了後、setup.lock ファイルが自動生成されます。このファイルが存在する間は setup.php に再アクセスできなくなります。再セットアップが必要な場合は、FTPで setup.lock を削除してください。