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

従来の Orbitvu SUN プラグイン（Orbitvu_Sun）の商品とのリンク、リンク解除の履歴、設定を、1 つのコマンドで Orbitvu Cloud (v2) に移行します。

ショップで従来の Orbitvu SUN プラグイン（モジュール Orbitvu_Sun）を使用している場合は、この手順に従ってください。移行コマンドは、従来のプラグインの商品とのリンク、プレゼンテーションアイテム、リンク解除の履歴、設定（ライセンスキーを含む）を Orbitvu Cloud (v2) にコピーします。従来のプラグインとそのデータは変更されません。

開始する前に

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

従来のプラグインは Magento 2.4.9 では動作しません。PHP エラーにより bin/magento が停止します。Magento を 2.4.9 に更新する前に移行してください。

Orbitvu Cloud (v2) を従来のプラグインと並行してインストールします。詳しくはインストールをご参照ください。この時点ではまだ従来のプラグインを削除しないでください。
以下のコマンドは、Magento のルートディレクトリで、Magento ファイルの所有者として（root ではなく）実行してください。

従来のプラグインが有効な間は、商品ページでは引き続き従来のプラグインのギャラリーが使用されます。従来のプラグインが対応していない Hyvä テーマのストアビューでは、テーマのギャラリーが表示されます。Orbitvu Cloud のギャラリーは、ステップ 3 で従来のプラグインを無効にすると表示されます。

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

bin/magento orbitvu:cloud:migrate-from-sun --dry-run

何も変更されません。出力には、コピーされる設定、商品とのリンク、リンク解除の履歴レコードの件数が表示されます。コンテンツアイテムの件数は 0 と表示されます。アイテムは、すでにコピーされた商品とのリンクについてのみカウントされるためです。

ステップ 2：移行の実行

bin/magento orbitvu:cloud:migrate-from-sun
bin/magento cache:flush

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

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

このコマンドは安全に再実行できます。すでに移行されたものはそのまま保持され、二重にコピーされることはありません。

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

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

これで商品ページでは Orbitvu Cloud のギャラリーが使用されます。プレゼンテーションがリンクされている商品をいくつか確認してください。Hyvä テーマを使用するストアビューには、Hyvä 互換モジュールも必要です。詳しくはインストールをご参照ください。

Orbitvu Cloud (v2) には Auto Synchronizing URL と Auto Linking URL はありません。従来のプラグインの URL を呼び出していた cron ジョブは、コマンドに置き換えてください。詳しくはバッチ操作をご参照ください。

コマンドのオプション

オプション	説明
`--dry-run`	プレビューのみで、何も変更されません。
`--skip-settings`	設定をコピーしません。
`--batch-size=N`	一度に処理するレコード数（デフォルトは 100）。