インストール手順［WooCommerce］

始める前に

ストアが次の最小要件を満たしていることを確認してください：

  • WordPress：6.4+
  • WooCommerce：6.0+（インストール・有効化済み）
  • PHP：8.0+
  • セキュリティ上、HTTPS / SSLが有効なサーバーが必要です
  • Alter Productアカウントが必要です（Access Key＋Access Tokenを使用します）

重要：プラグインは分離されたiframe内でCustomizer、Configurator、Viewerを実行するため、WooCommerce本体のチェックアウト動作は変更しません。

インストール・設定手順

  1. WordPress管理画面にログインします。
  2. WordPress管理画面でプラグイン → 新規追加を開き、Alter Product – 3D Configurator for WooCommerceを検索してインストールし、有効化します。* 任意：ZIPファイルを手動でアップロードして有効化することもできます。
  3. WordPress管理画面でAlter Productを開き、Auto Connectの接続をクリックします。* 手動設定の場合：Alter ProductのAPI設定ページでAPIキーを作成し、Access KeyとAccess Tokenをコピーしてから、埋め込み設定にストアのドメインを追加します。
  4. 表示されるインストール手順に沿って、設定を完了してください。
  5. 最初のデザインを作成 – WooCommerceの商品編集ページを開き、Alter Productタブで新規デザインを作成するか既存のものを選びます。デザインが商品に紐付きます。WooCommerce商品に合ったバリエーションを定義し、必要に応じてCustomizerを有効にして、プロジェクトを保存してください。

設定後にできること

設定が完了すると、次のことができます：

  • 商品、バリエーション、モックアップ、グラフィックライブラリ、ロゴ、デザインテンプレート、背景、環境、フォントなどのアセットを管理
  • Alter Productストレージからプロジェクトをインポート
  • 商品デザインを作成・管理
  • 選択したECツールのボタンを公開WooCommerceストアページや商品ページに表示
  • WooCommerce商品ページやWordPressページにViewer / Configurator / Customizerを埋め込み
  • WooCommerce商品とAlter Productデザインを紐付け
  • お客様による商品カスタマイズ（文字、画像、レイアウト、QRコードなど）
  • 選択した構成をWooCommerceカートに同期

トラブルシューティング

  • APIテストに失敗する：Alter Product → ステータスでAccess Key / Access Tokenと、サーバーからhttps://alterproduct.com/public-apiへの接続を確認してください。
  • アセットをダウンロードできない：Alter Product → ステータスを開き、サーバーがサーバーリソース表の要件を満たしているか確認してください。
  • iframeが空白/通信できない：Alter ProductのEC設定 → 連携にストアのドメインが追加されていること、またはサーバーが有効なSSL証明書でHTTPSを使用していることを確認してください。
  • パーマリンクの問題：Customizer、Configurator、Viewerのページで見つかりませんと表示された場合、設定 → パーマリンクを開いて変更を保存をクリックし、リライトルールを更新します。
  • カートに追加できない：商品の紐付けが完了し、埋め込まれたツールのEC操作が有効になっているか確認してください。