従来のプラグインからの移行

従来の Orbitvu SELF HOSTED プラグイン（Orbitvu_SelfHosted）のプレゼンテーション、商品とのリンク、設定を、1 つのコマンドで Orbitvu SELF HOSTED V2 に移行します。

ショップで従来の Orbitvu SELF HOSTED プラグイン（モジュール Orbitvu_SelfHosted）を使用している場合は、この手順に従ってください。移行コマンドは、従来のプラグインのプレゼンテーション、商品とのリンク、設定を Orbitvu SELF HOSTED V2 にコピーします。従来のプラグインは変更されず、そのファイルは移動ではなくコピーされます。

開始する前に

ショップのデータベースとファイルをバックアップしてください。本番環境のショップでは、メンテナンスモード（bin/magento maintenance:enable）で移行を実行してください。

Orbitvu SELF HOSTED V2 を従来のプラグインと並行してインストールします。詳しくはインストールをご参照ください。この時点ではまだ従来のプラグインを削除しないでください。
以下のコマンドは、Magento ファイルの所有者として（root ではなく）実行してください。このユーザーが pub/media/orbitvu に書き込めることが必要です。

従来のプラグインが有効な間は、商品ページでは引き続き従来のプラグインのギャラリーが使用され、バックオフィスには移行を促すメッセージが表示されます。

従来のプラグインは、プレゼンテーションを Magento のルートディレクトリにある _orbitvu_presentations、または Legacy Mode 設定が無効の場合は pub/_orbitvu_presentations に保存していました。移行コマンドは両方の場所からプレゼンテーションを検出します。別の場所に保存されている場合は、コマンドに --legacy-path=<absolute path> を追加してください。

ステップ 1：移行のプレビュー

bin/magento orbitvu:selfhostedv2:migrate-from-legacy --copy-files --dry-run

何も変更されません。出力には、コピーおよび同期されるプレゼンテーションと、見つからないプレゼンテーションが一覧表示されます。

ステップ 2：移行の実行

bin/magento orbitvu:selfhostedv2:migrate-from-legacy --copy-files
bin/magento cache:flush

移行では次の処理が行われます。

従来のプラグインの設定をコピーします（V2 ですでに変更した設定は、--overwrite-config を追加しない限り保持されます）。
プレゼンテーションのフォルダーを pub/media/orbitvu/presentations にコピーします。
プレゼンテーションを同じ商品にリンクし、アイテムの並び順と表示設定も引き継ぎます。
リンク解除の履歴を保持するため、手動でリンク解除したものが自動リンクで再びリンクされることはありません。
存在しなくなった商品へのリンクはスキップし、それらを報告します。

このコマンドは安全に再実行できます。すでに移行されたものはそのまま保持されます。

移行されないもの：シークレット URL と、アップロードした Viewer のバージョン。移行後は、新しい Remote Upload URL を Orbitvu Station に貼り付け、従来のプラグインの URL を呼び出していた cron ジョブをコマンドに置き換え（バッチ操作をご参照ください）、カスタムの Viewer バージョンを再度アップロードしてください。

ステップ 3：従来のプラグインの無効化

bin/magento module:disable Orbitvu_SelfHosted
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento setup:static-content:deploy
bin/magento cache:flush

これで商品ページでは Orbitvu SELF HOSTED V2 のギャラリーが使用されます。プレゼンテーションがリンクされている商品をいくつか確認してください。すべて正常に動作していれば、古い _orbitvu_presentations ディレクトリと _orbitvu_viewer ディレクトリは削除してかまいません（バックアップは残しておいてください）。

コマンドのオプション

オプション	説明
`--dry-run`	プレビューのみで、何も変更されません。
`--copy-files`	従来のプラグインのプレゼンテーションフォルダーを Orbitvu SELF HOSTED V2 にコピーします。
`--legacy-path=PATH`	従来のプラグインの `_orbitvu_presentations` ディレクトリの絶対パス（Magento のルートディレクトリや `pub/` 以外にある場合）。
`--skip-config`	設定をコピーしません。
`--overwrite-config`	V2 ですでに変更した設定を、従来のプラグインの設定で上書きします。
`--batch-size=N`	一度に処理するレコード数（デフォルトは 100）。