namespace Automattic\WooCommerce\Blocks\Domain;
use Automattic\WooCommerce\Blocks\Options;
use Automattic\WooCommerce\Blocks\Domain\Services\FeatureGating;
* Returns information about the package and handles init.
* Holds the current version of the blocks plugin.
* Holds the main path to the blocks plugin directory.
* Holds locally the plugin_dir_url to avoid recomputing it.
* Holds the feature gating class instance.
* @param string $version Version of the plugin.
* @param string $plugin_path Path to the main plugin file.
* @param FeatureGating $deprecated Deprecated Feature gating class.
public function __construct( $version, $plugin_path, $deprecated = null ) {
if ( null !== $deprecated ) {
wc_deprecated_argument( 'FeatureGating', '9.6', 'FeatureGating class is deprecated, please use wp_get_environment_type() instead.' );
$this->feature_gating = new FeatureGating();
$this->version = $version;
$this->path = $plugin_path;
* Returns the version of WooCommerce Blocks.
* Note: since Blocks was merged into WooCommerce Core, the version of
* WC Blocks doesn't update anymore. Use
* `Constants::get_constant( 'WC_VERSION' )` when possible to get the
* WooCommerce Core version.
public function get_version() {
* Returns the version of WooCommerce Blocks stored in the database.
public function get_version_stored_on_db() {
return get_option( Options::WC_BLOCK_VERSION, '' );
* Sets the version of WooCommerce Blocks in the database.
* This is useful during the first installation or after the upgrade process.
public function set_version_stored_on_db() {
update_option( Options::WC_BLOCK_VERSION, $this->get_version() );
* Returns the path to the plugin directory.
* @param string $relative_path If provided, the relative path will be
* appended to the plugin path.
public function get_path( $relative_path = '' ) {
return trailingslashit( $this->path ) . $relative_path;
* Returns the url to the blocks plugin directory.
* @param string $relative_url If provided, the relative url will be
* appended to the plugin url.
public function get_url( $relative_url = '' ) {
if ( ! $this->plugin_dir_url ) {
// Append index.php so WP does not return the parent directory.
$this->plugin_dir_url = plugin_dir_url( $this->path . '/index.php' );
return $this->plugin_dir_url . $relative_url;
* Returns an instance of the FeatureGating class.
public function feature() {
return $this->feature_gating;