WooCommerce 10.9、バリエーションギャラリーがコアに統合。追加プラグイン不要へ

WooCommerce 10.9、バリエーションギャラリーがコアに統合。追加プラグイン不要へ

WooCommerce 10.9で「バリエーションギャラリー」機能がコアに統合される。これまで有料の追加プラグイン「Additional Variation Images」で提供されていた機能が、標準で無料利用できるようになる。

WooCommerceチームの「More in Core」構想の一環だ。既存のブランド機能統合に続き、マーチャントが本当に必要とする機能をデフォルトで提供し、開発者はより価値の高い差別化に集中できる環境を整えている。

Daniele氏の公式ブログ記事によると、この変更は段階的にロールアウトされ、10.9ではオプトインによるテストが可能になる。最終的には全ストアで有効化される予定だ。

バリエーションギャラリーがストアにもたらす変化

バリエーションギャラリーとは、ひとつの可変商品の中にある各バリエーション（色違いやサイズ違い）ごとに、複数の商品画像を紐づけられる仕組みだ。従来のWooCommerceでは、バリエーションに設定できる画像は「おもな画像」として1枚だけだった。これがギャラリーとして複数枚扱えるようになる。

購入者がストアフロントでバリエーション（たとえば「色：青」）を選択すると、ギャラリー全体がそのバリエーションの画像セットに切り替わる。管理画面では、バリエーションの「おもな画像」と「ギャラリー」をひとつの統合フィールドで管理し、1枚目が自動的におもな画像として扱われる設計だ。

有効化の手順と段階的ロールアウト

この機能はWooCommerce 10.9で導入されるが、初期状態では全ユーザーに対して無効化されている。利用を開始するには、明示的な有効化操作が必要だ。

管理画面からの有効化

最も簡単なのは、WooCommerceの設定画面からチェックボックスをオンにする方法だ。

コードスニペットでの有効化

よりプログラム的な制御を好む場合は、テーマのfunctions.phpまたはCode Snippetsプラグインなどを通じて以下のコードを追加する。

add_action( 'init', function() {
    update_option( 'wc_feature_woocommerce_additional_variation_images_enabled', 'yes' );
} );

WP-CLIでの有効化

WP-CLIが利用できる環境なら、以下のコマンドを実行するだけだ。

wp option update wc_feature_woocommerce_additional_variation_images_enabled 'yes'

段階的ロールアウトの計画

この機能は3段階で展開される。まず10.9で手動テスト用に提供され、次に後続リリースで5%のストアに対して自動的に有効化される「カナリアリリース」が実施される。カナリアフェーズで問題がなければ、最終的に100%のストアで有効化される計画だ。

カナリアとは、新しい変更を一部のユーザーに先行適用して問題の有無を確認するソフトウェアリリース手法を指す。本番環境全体に影響が及ぶ前に、不具合を検知できる利点がある。

技術的な実装と移行のポイント

今回のコア統合は、既存ユーザーがスムーズに移行できるように慎重に設計されている。技術的な要点を整理しよう。

データの保存場所と後方互換性

バリエーションギャラリーのデータは_product_image_galleryというメタキーに保存される。これはWooCommerceが従来から親商品のギャラリーに使っているキーと同じだ。既存の仕組みを再利用することで、テーマの互換性を保っている。

REST APIでも初日からサポートされ、バリエーションエンドポイントのgallery_image_idsプロパティを通じてギャラリーにアクセスできる。このペイロードは、従来のストアフロント経路でもブロックベースの商品ギャラリーでも内部的に利用されている。

旧プラグインからのデータ移行

現在「Additional Variation Images」拡張機能を使っているストアでは、コア機能の有効化時に自動移行が走る。WooCommerceはAction Schedulerを用いたバックグラウンドジョブをスケジュールし、1回あたり250バリエーションずつレガシーデータを正規の場所にコピーする。全件が完了するまでジョブは自動的に再キューイングされる。

移行はべき等性を持っている。つまり、既に移行済みのバリエーションに対して再実行されても何も変更されず、安全だ。レガシーメタデータ（_wc_additional_variation_images）は意図的にディスク上に保持されるため、サードパーティコードが従来のキーを直接読み取っていても動作し続ける。

ストアフロントの互換性

バリエーションギャラリーは、従来のシングル商品テンプレートとブロックベースの商品ギャラリーの両方で動作する。新旧のブロックが混在する環境でも問題ない。テーマがsingle-product/add-to-cart/variable.phpを上書きしている場合もサポート対象だ。

テストとフィードバックの方法

この機能は6月8日予定のWooCommerce 10.9ベータ版に含まれる。上記のスニペットまたはWP-CLIコマンドで有効化してテストできる。今すぐ試したい場合は、GitHub上のナイトリービルドでも利用可能だ。

本番環境への適用前に、必ずステージング環境でのテストを推奨する。WooCommerceチームはGitHub Discussionを開設しており、フィードバックや使用感の報告を求めている。

スタンドアロン拡張機能の提供終了について

コア統合が100%ロールアウトされた後、スタンドアロンの「Additional Variation Images」拡張機能はWooCommerceマーケットプレイスから提供終了となる。これは先のBrands拡張機能の終了時と同じ手順だ。

現在のサブスクリプションユーザーは、コア機能がストアで有効化されるまで既存プラグインをそのまま使える。有効化時には競合を防ぐため、スタンドアロンプラグインは自動的に無効化される。マーケットプレイスからの提供終了時にはアクティブなサブスクリプションがキャンセルされ、影響を受けるユーザーはサポートチームに返金またはクレジットを申請できる。該当ユーザーにはロールアウトの重要な節目でメール通知が届く予定だ。

この記事のポイント

• WooCommerce 10.9でバリエーションギャラリーがコア機能として無料利用可能になる
• 初期は無効化されており、管理画面・コード・WP-CLIのいずれかで手動有効化が必要
• 既存の「Additional Variation Images」ユーザーは自動移行でデータが引き継がれる
• 段階的ロールアウトで慎重に展開され、最終的には全ストアで有効化される予定
• REST APIも初日から対応、開発者にとって扱いやすい設計になっている

海田 洋祐

・ 複数業界における17年間のデジタルビジネス開発経験
・ ウェブサイト開発のためのHTML、PHP、CSS、Java等の実用的知識
・ 15ヶ国語対応の多言語SaaSの開発経験
・ 17年間にも及ぶ、Eコマース長期運営経験
・ 幅広い業界でのSEO最適化の豊富な経験