Automattic\WooCommerce\Internal\VariationGallery

Package{} │ WC 1.0

Variation gallery package entry point.

Registered in \Automattic\WooCommerce\Packages::$merged_packages against the woocommerce-additional-variation-images slug, so this class is the single bootstrap surface for the merged variation gallery feature.

No Hooks.

Usage

$Package = new Package();
// use class methods

Methods

1. public get_option( self::ENABLE_OPTION_NAME, 'no' )
2. ERROR: no method name found on line `public const FEATURE_ID = 'variation_gallery';`
3. public static prepare()
4. public get( LegacyVariationGalleryCompatibility::class )->register()
5. ERROR: no method name found on line `public const ENABLE_OPTION_NAME = 'wc_feature_woocommerce_additional_variation_images_enabled';`
6. public init()
7. ERROR: no method name found on line `public const FEATURE_ID = 'variation_gallery';`
8. public if ( ! self::is_enabled() )
9. public static is_enabled()
10. public static maybe_schedule_migration()
11. ERROR: no method name found on line `* Schedule the legacy variation gallery migration if it hasn't already`
12. ERROR: no method name found on line `);`
13. ERROR: no method name found on line `return;`
14. ERROR: no method name found on line `*`
15. ERROR: no method name found on line `);`
16. ERROR: no method name found on line `self::UPDATE_CALLBACK_HOOK,`
17. ERROR: no method name found on line `*`
18. ERROR: no method name found on line `* Early bootstrap hook fired by `Packages::prepare_packages` at`
19. private static has_pending_or_running_migration( array $args )
20. ERROR: no method name found on line `return;`
21. ERROR: no method name found on line `* Reads the same option as the Features toggles, so the `FeaturesController``
22. ERROR: no method name found on line `}`
23. ERROR: no method name found on line ``
24. ERROR: no method name found on line `* @return bool`
25. ERROR: no method name found on line `* request.`
26. ERROR: no method name found on line ``
27. ERROR: no method name found on line `* @return bool`
28. ERROR: no method name found on line ``

Package{} Package{} code ^{WC 10.9.4}

class Package {

	/**
	 * Action Scheduler hook for DB update callbacks.
	 */
	private const UPDATE_CALLBACK_HOOK = 'woocommerce_run_update_callback';

	/**
	 * Action Scheduler group for DB update callbacks.
	 */
	private const UPDATE_CALLBACK_GROUP = 'woocommerce-db-updates';

	/**
	 * The feature id used by `FeaturesController` (Settings → Advanced → Features).
	 */
	public const FEATURE_ID = 'variation_gallery';

	/**
	 * Option backing the variation gallery feature toggle.
	 */
	public const ENABLE_OPTION_NAME = 'wc_feature_woocommerce_additional_variation_images_enabled';

	/**
	 * Whether the merged variation gallery feature is enabled for the current
	 * request.
	 *
	 * Reads the same option as the Features toggles, so the `FeaturesController`
	 * and the merged-package machinery share a single source of truth. Defaults
	 * to off for the 10.9 canary period.
	 *
	 * @return bool
	 */
	public static function is_enabled() {
		return 'yes' === get_option( self::ENABLE_OPTION_NAME, 'no' );
	}

	/**
	 * Early bootstrap hook fired by `Packages::prepare_packages` at
	 * plugins_loaded priority -100. No-op for the variation gallery feature.
	 *
	 * @internal
	 */
	public static function prepare(): void {
	}

	/**
	 * Initialize the merged variation gallery feature.
	 *
	 * @internal
	 */
	final public static function init(): void {
		if ( ! self::is_enabled() ) {
			return;
		}

		$container = wc_get_container();
		$container->get( ClassicVariationGalleryAdmin::class )->register();
		$container->get( LegacyVariationGalleryCompatibility::class )->register();

		// Action Scheduler initializes on `init`, not `plugins_loaded`.
		add_action( 'init', array( __CLASS__, 'maybe_schedule_migration' ), 20 );
	}

	/**
	 * Schedule the legacy variation gallery migration if it hasn't already
	 * completed and isn't already pending or running.
	 *
	 * @internal
	 */
	public static function maybe_schedule_migration(): void {
		if ( get_option( Migration::COMPLETED_OPTION ) ) {
			return;
		}

		$args = array( 'update_callback' => array( Migration::class, 'run' ) );

		if ( self::has_pending_or_running_migration( $args ) ) {
			return;
		}

		WC()->queue()->add(
			self::UPDATE_CALLBACK_HOOK,
			$args,
			self::UPDATE_CALLBACK_GROUP
		);
	}

	/**
	 * Determine whether the migration is already pending or running.
	 *
	 * @param array<string, array<int, string>> $args Exact callback args for the migration action.
	 * @return bool
	 */
	private static function has_pending_or_running_migration( array $args ): bool {
		if ( null !== WC()->queue()->get_next( self::UPDATE_CALLBACK_HOOK, $args, self::UPDATE_CALLBACK_GROUP ) ) {
			return true;
		}

		$running_actions = WC()->queue()->search(
			array(
				'hook'     => self::UPDATE_CALLBACK_HOOK,
				'args'     => $args,
				'status'   => \ActionScheduler_Store::STATUS_RUNNING,
				'per_page' => 1,
				'group'    => self::UPDATE_CALLBACK_GROUP,
			),
			'ids'
		);

		return ! empty( $running_actions );
	}
}