woocommerce/plugins/woocommerce-admin/includes/features/onboarding/class-wc-admin-onboarding.php

151 lines
5.4 KiB
PHP

<?php
/**
* WooCommerce Onboarding
* NOTE: DO NOT edit this file in WooCommerce core, this is generated from woocommerce-admin.
*
* @package Woocommerce Admin
*/
/**
* Contains backend logic for the onboarding profile and checklist feature.
*/
class WC_Admin_Onboarding {
/**
* Class instance.
*
* @var WC_Admin_Onboarding instance
*/
protected static $instance = null;
/**
* Get class instance.
*/
public static function get_instance() {
if ( ! self::$instance ) {
self::$instance = new self();
}
return self::$instance;
}
/**
* Hook into WooCommerce.
*/
public function __construct() {
add_action( 'woocommerce_components_settings', array( $this, 'component_settings' ), 20 ); // Run after WC_Admin_Loader.
add_filter( 'woocommerce_admin_is_loading', array( $this, 'is_loading' ) );
}
/**
* Returns true if the profiler should be displayed (not completed and not skipped).
*
* @return bool
*/
public function should_show_profiler() {
$onboarding_data = get_option( 'wc_onboarding_profile', array() );
$is_completed = isset( $onboarding_data['completed'] ) && true === $onboarding_data['completed'];
$is_skipped = isset( $onboarding_data['skipped'] ) && true === $onboarding_data['skipped'];
// @todo When merging to WooCommerce Core, we should set the `completed` flag to true during the upgrade progress.
// https://github.com/woocommerce/woocommerce-admin/pull/2300#discussion_r287237498.
return $is_completed || $is_skipped ? false : true;
}
/**
* Get a list of allowed industries for the onboarding wizard.
*
* @return array
*/
public static function get_allowed_industries() {
return apply_filters(
'woocommerce_admin_onboarding_industries',
array(
'fashion-apparel-accessories' => __( 'Fashion, apparel & accessories', 'woocommerce-admin' ),
'health-beauty' => __( 'Health & beauty', 'woocommerce-admin' ),
'art-music-photography' => __( 'Art, music, & photography', 'woocommerce-admin' ),
'electronics-computers' => __( 'Electronics & computers', 'woocommerce-admin' ),
'food-drink' => __( 'Food & drink', 'woocommerce-admin' ),
'home-furniture-garden' => __( 'Home, furniture & garden', 'woocommerce-admin' ),
'other' => __( 'Other', 'woocommerce-admin' ),
)
);
}
/**
* Get a list of allowed product types for the onboarding wizard.
*
* @todo Prices for products should be pulled dynamically.
* @return array
*/
public static function get_allowed_product_types() {
return apply_filters(
'woocommerce_admin_onboarding_product_types',
array(
'physical' => array(
'label' => __( 'Physical products', 'woocommerce-admin' ),
'description' => __( 'Products you ship to customers.', 'woocommerce-admin' ),
),
'downloads' => array(
'label' => __( 'Downloads', 'woocommerce-admin' ),
'description' => __( 'Virtual products that customers download.', 'woocommerce-admin' ),
),
'subscriptions' => array(
'label' => __( 'Subscriptions — $199 per year', 'woocommerce-admin' ),
'description' => __( 'Products with recurring payment.', 'woocommerce-admin' ),
'more_url' => __( 'https://woocommerce.com/products/woocommerce-subscriptions/', 'woocommerce-admin' ),
),
'memberships' => array(
'label' => __( 'Memberships — $149 per year', 'woocommerce-admin' ),
'description' => __( 'Restrict content to customer groups.', 'woocommerce-admin' ),
'more_url' => __( 'https://woocommerce.com/products/woocommerce-memberships/', 'woocommerce-admin' ),
),
'composite' => array(
'label' => __( 'Composite Products — $79 per year', 'woocommerce-admin' ),
'description' => __( 'Kits with configurable components.', 'woocommerce-admin' ),
'more_url' => __( 'https://woocommerce.com/products/composite-products/', 'woocommerce-admin' ),
),
'spaces' => array(
'label' => __( 'Spaces — $249 per year', 'woocommerce-admin' ),
'description' => __( 'Sell access to spaces, e.g. hotel rooms.', 'woocommerce-admin' ),
'more_url' => __( 'https://woocommerce.com/products/woocommerce-accommodation-bookings/', 'woocommerce-admin' ),
),
'rentals' => array(
'label' => __( 'Rentals — $249 per year', 'woocommerce-admin' ),
'description' => __( 'Sell access to rental items, e.g. cars.', 'woocommerce-admin' ),
'more_url' => __( 'https://woocommerce.com/products/woocommerce-bookings/', 'woocommerce-admin' ),
),
)
);
}
/**
* Add profiler items to component settings.
*
* @param array $settings Component settings.
*/
public function component_settings( $settings ) {
$settings['onboarding'] = array(
'industries' => self::get_allowed_industries(),
'productTypes' => self::get_allowed_product_types(),
'profile' => get_option( 'wc_onboarding_profile', array() ),
);
return $settings;
}
/**
* Let the app know that we will be showing the onboarding route, so wp-admin elements should be hidden while loading.
*
* @param bool $is_loading Indicates if the `woocommerce-admin-is-loading` should be appended or not.
* @return bool
*/
public function is_loading( $is_loading ) {
$show_profiler = $this->should_show_profiler();
if ( ! $show_profiler ) {
return $is_loading;
}
return true;
}
}
new WC_Admin_Onboarding();