インストール

パッケージの内容

ORBITVU CLOUD アカウントからプラグインパッケージ OrbitvuShM2-<version>.zip をダウンロードします。Marketplace → Web Integrations（marketplace.orbitvu.io/my-products/plugins）の Self hosted plugins セクションで、Magento 2 の横にある Download をクリックしてください。Orbitvu SELF HOSTED V2 のバージョンは 2.0.0 以上です。バージョン 1.x のパッケージ（例：OrbitvuShM2-1.2.1.zip）は従来のプラグインです。パッケージには次のものが含まれています。

• app/code/Orbitvu/SelfHostedV2 – デフォルトの Orbitvu Viewer を含むプラグイン本体
• hyva/app/code/Orbitvu/SelfHostedV2Hyva – Hyvä テーマ用の互換モジュール（Hyvä テーマを使用するストアでのみ必要）

プラグインのインストール

サーバーのコマンドラインを開き、Magento のルートディレクトリに移動して、次のコマンドを実行します（<magento_root> と <version> は置き換えてください）。

unzip OrbitvuShM2-<version>.zip -d orbitvu-package
cp -r orbitvu-package/app <magento_root>/
cd <magento_root>
bin/magento module:enable Orbitvu_SelfHostedV2
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento setup:static-content:deploy
bin/magento cache:flush

setup:upgrade はプラグインのテーブルを作成し、デフォルトの Orbitvu Viewer を pub/media/orbitvu/viewer にコピーします。デベロッパーモードでは、setup:di:compile と setup:static-content:deploy は省略できます。

Web サーバーのユーザーが pub/media/orbitvu に書き込めることを確認してください。書き込めない場合はプレゼンテーションのアップロードに失敗し、商品編集ページの Orbitvu タブに警告が表示されます。

Hyvä テーマ

Hyvä テーマを使用するストアビューには、パッケージの hyva/ ディレクトリにある互換モジュールも必要です。Luma ベースのストアビューには必要ありません。

cp -r orbitvu-package/hyva/app <magento_root>/
cd <magento_root>
bin/magento module:enable Orbitvu_SelfHostedV2Hyva
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento setup:static-content:deploy
bin/magento cache:flush

Adobe Commerce Cloud

Adobe Commerce Cloud では、サーバーにファイルを直接コピーすることはできません。コードはプロジェクトの Git リポジトリからデプロイされます。プラグイン（必要に応じて Hyvä モジュールも）をプロジェクトのローカルコピーの app/code にコピーし、そこで有効化してから、コミットしてプッシュします。

cp -r orbitvu-package/app/code/Orbitvu/SelfHostedV2 <project>/app/code/Orbitvu/
cd <project>
bin/magento module:enable Orbitvu_SelfHostedV2
git add app/code/Orbitvu app/etc/config.php
git commit -m "Add Orbitvu SELF HOSTED V2"
git push

デプロイ時に setup:upgrade が実行され、Orbitvu Viewer も pub/media にインストールされます。pub/media に手動でアップロードする必要はありません。

インストール後の作業

1. Remote Upload URL を Orbitvu Station にコピーします。詳しくはOrbitvu プレゼンテーションをショップにアップロードをご参照ください。
2. Stores → Configuration → Orbitvu Self Hosted V2 で設定を確認します。詳しくはプラグインの設定をご参照ください。