= self::check_task_completion( 'tax' ); $settings['shippingZonesCount'] = count( \WC_Shipping_Zones::get_zones() ); $settings['stripeSupportedCountries'] = self::get_stripe_supported_countries(); $settings['stylesheet'] = get_option( 'stylesheet' ); $settings['taxJarActivated'] = class_exists( 'WC_Taxjar' ); $settings['themeMods'] = get_theme_mods(); $settings['wcPayIsConnected'] = $wc_pay_is_connected; return $settings; } /** * Add task items to component settings. * * @param array $settings Component settings. * @return array */ public function component_settings( $settings ) { // Bail early if not on a wc-admin powered page, or task list shouldn't be shown. if ( ! \Automattic\WooCommerce\Admin\Loader::is_admin_page() || ! \Automattic\WooCommerce\Admin\Features\Onboarding::should_show_tasks() ) { return $settings; } // If onboarding isn't enabled this will throw warnings. if ( ! isset( $settings['onboarding'] ) ) { $settings['onboarding'] = array(); } $settings['onboarding'] = array_merge( $settings['onboarding'], array( 'tasksStatus' => self::get_settings(), ) ); return $settings; } /** * Temporarily store the active task to persist across page loads when neccessary (such as publishing a product). Most tasks do not need to do this. */ public static function set_active_task() { if ( isset( $_GET[ self::ACTIVE_TASK_TRANSIENT ] ) ) { // phpcs:ignore csrf ok. $task = sanitize_title_with_dashes( wp_unslash( $_GET[ self::ACTIVE_TASK_TRANSIENT ] ) ); // phpcs:ignore csrf ok. if ( self::check_task_completion( $task ) ) { return; } set_transient( self::ACTIVE_TASK_TRANSIENT, $task, DAY_IN_SECONDS ); } } /** * Get the name of the active task. * * @return string */ public static function get_active_task() { return get_transient( self::ACTIVE_TASK_TRANSIENT ); } /** * Check for active task completion, and clears the transient. * * @return bool */ public static function is_active_task_complete() { $active_task = self::get_active_task(); if ( ! $active_task ) { return false; } if ( self::check_task_completion( $active_task ) ) { delete_transient( self::ACTIVE_TASK_TRANSIENT ); return true; } return false; } /** * Check for task completion of a given task. * * @param string $task Name of task. * @return bool */ public static function check_task_completion( $task ) { switch ( $task ) { case 'products': $products = wp_count_posts( 'product' ); return (int) $products->publish > 0; case 'homepage': $homepage_id = get_option( 'woocommerce_onboarding_homepage_post_id', false ); if ( ! $homepage_id ) { return false; } $post = get_post( $homepage_id ); $completed = $post && 'publish' === $post->post_status; return $completed; case 'tax': return 'yes' === get_option( 'wc_connect_taxes_enabled' ) || count( DataStore::get_taxes( array() ) ) > 0 || false !== get_option( 'woocommerce_no_sales_tax' ); } return false; } /** * Hooks into the product page to add a notice to return to the task list if a product was added. * * @param string $hook Page hook. */ public static function add_onboarding_product_notice_admin_script( $hook ) { global $post; if ( 'post.php' !== $hook || 'product' !== $post->post_type || 'products' !== self::get_active_task() || ! self::is_active_task_complete() ) { return; } wp_enqueue_script( 'onboarding-product-notice', Loader::get_url( 'wp-admin-scripts/onboarding-product-notice', 'js' ), array( 'wp-i18n', 'wp-data' ), WC_ADMIN_VERSION_NUMBER, true ); } /** * Hooks into the post page to display a different success notice and sets the active page as the site's home page if visted from onboarding. * * @param string $hook Page hook. */ public static function add_onboarding_homepage_notice_admin_script( $hook ) { global $post; if ( 'post.php' === $hook && 'page' === $post->post_type && isset( $_GET[ self::ACTIVE_TASK_TRANSIENT ] ) && 'homepage' === $_GET[ self::ACTIVE_TASK_TRANSIENT ] ) { // phpcs:ignore csrf ok. wp_enqueue_script( 'onboarding-homepage-notice', Loader::get_url( 'wp-admin-scripts/onboarding-homepage-notice', 'js' ), array( 'wc-navigation', 'wp-i18n', 'wp-data', 'wc-tracks' ), WC_ADMIN_VERSION_NUMBER, true ); } } /** * Adds a notice to return to the task list when the save button is clicked on tax settings pages. */ public static function add_onboarding_tax_notice_admin_script() { $page = isset( $_GET['page'] ) ? $_GET['page'] : ''; // phpcs:ignore csrf ok, sanitization ok. $tab = isset( $_GET['tab'] ) ? $_GET['tab'] : ''; // phpcs:ignore csrf ok, sanitization ok. if ( 'wc-settings' === $page && 'tax' === $tab && 'tax' === self::get_active_task() && ! self::is_active_task_complete() ) { wp_enqueue_script( 'onboarding-tax-notice', Loader::get_url( 'wp-admin-scripts/onboarding-tax-notice', 'js' ), array( 'wc-navigation', 'wp-i18n', 'wp-data' ), WC_ADMIN_VERSION_NUMBER, true ); } } /** * Adds a notice to return to the task list when the product importeris done running. * * @param string $hook Page hook. */ public function add_onboarding_product_import_notice_admin_script( $hook ) { $step = isset( $_GET['step'] ) ? $_GET['step'] : ''; // phpcs:ignore csrf ok, sanitization ok. if ( 'product_page_product_importer' === $hook && 'done' === $step && 'product-import' === self::get_active_task() ) { delete_transient( self::ACTIVE_TASK_TRANSIENT ); wp_enqueue_script( 'onboarding-product-import-notice', Loader::get_url( 'wp-admin-scripts/onboarding-product-import-notice', 'js' ), array( 'wc-navigation', 'wp-i18n', 'wp-data' ), WC_ADMIN_VERSION_NUMBER, true ); } } /** * Get an array of countries that support automated tax. * * @return array */ public static function get_automated_tax_supported_countries() { // https://developers.taxjar.com/api/reference/#countries . $tax_supported_countries = array_merge( array( 'US', 'CA', 'AU' ), WC()->countries->get_european_union_countries() ); return $tax_supported_countries; } /** * Returns a list of Stripe supported countries. This method can be removed once merged to core. * * @return array */ private static function get_stripe_supported_countries() { // https://stripe.com/global. return array( 'AU', 'AT', 'BE', 'BG', 'BR', 'CA', 'CY', 'CZ', 'DK', 'EE', 'FI', 'FR', 'DE', 'GR', 'HK', 'IN', 'IE', 'IT', 'JP', 'LV', 'LT', 'LU', 'MY', 'MT', 'MX', 'NL', 'NZ', 'NO', 'PL', 'PT', 'RO', 'SG', 'SK', 'SI', 'ES', 'SE', 'CH', 'GB', 'US', 'PR', ); } /** * Records an event when all tasks are completed in the task list. * * @param mixed $old_value Old value. * @param mixed $new_value New value. */ public static function track_completion( $old_value, $new_value ) { if ( $new_value ) { wc_admin_record_tracks_event( 'tasklist_tasks_completed' ); } } /** * Records an event when all tasks are completed in the extended task list. * * @param mixed $old_value Old value. * @param mixed $new_value New value. */ public static function track_extended_completion( $old_value, $new_value ) { if ( $new_value ) { wc_admin_record_tracks_event( 'extended_tasklist_tasks_completed' ); } } /** * Adds item to the extended task list. * * @param mixed $new_task_name New task name. */ public static function add_extended_task_list_item( $new_task_name ) { if ( $new_task_name ) { $extended_tasks_list_items = get_option( 'woocommerce_extended_task_list_items', array() ); if ( ! in_array( $new_task_name, $extended_tasks_list_items, true ) ) { array_push( $extended_tasks_list_items, $new_task_name ); update_option( 'woocommerce_extended_task_list_items', $extended_tasks_list_items ); update_option( 'woocommerce_extended_task_list_hidden', 'no' ); } } } /** * Removes an item from the extended task list. * * @param mixed $task_name Task name to remove. */ public static function remove_extended_task_list_item( $task_name ) { if ( $task_name ) { $extended_tasks_list_items = get_option( 'woocommerce_extended_task_list_items', array() ); if ( in_array( $task_name, $extended_tasks_list_items, true ) ) { array_push( $extended_tasks_list_items, $task_name ); $tasks_list_items = array_diff( $extended_tasks_list_items, array( $task_name ) ); update_option( 'woocommerce_extended_task_list_items', $tasks_list_items ); } } } /** * Records an event for individual task completion. * * @param mixed $old_value Old value. * @param mixed $new_value New value. */ public static function track_task_completion( $old_value, $new_value ) { $old_value = is_array( $old_value ) ? $old_value : array(); $untracked_tasks = array_diff( $new_value, $old_value ); foreach ( $untracked_tasks as $task ) { wc_admin_record_tracks_event( 'tasklist_task_completed', array( 'task_name' => $task ) ); } } }