first commit
This commit is contained in:
Rachit Bhargava
@@ -0,0 +1,67 @@
|
||||
<?php
|
||||
/**
|
||||
* WooCommerce Activity Panel.
|
||||
*/
|
||||
|
||||
namespace Automattic\WooCommerce\Internal\Admin;
|
||||
|
||||
use Automattic\WooCommerce\Admin\Notes\Notes;
|
||||
|
||||
/**
|
||||
* Contains backend logic for the activity panel feature.
|
||||
*/
|
||||
class ActivityPanels {
|
||||
/**
|
||||
* Class instance.
|
||||
*
|
||||
* @var ActivityPanels 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_filter( 'woocommerce_admin_get_user_data_fields', array( $this, 'add_user_data_fields' ) );
|
||||
// Run after Automattic\WooCommerce\Internal\Admin\Loader.
|
||||
add_filter( 'woocommerce_components_settings', array( $this, 'component_settings' ), 20 );
|
||||
// New settings injection.
|
||||
add_filter( 'woocommerce_admin_shared_settings', array( $this, 'component_settings' ), 20 );
|
||||
}
|
||||
|
||||
/**
|
||||
* Adds fields so that we can store activity panel last read and open times.
|
||||
*
|
||||
* @param array $user_data_fields User data fields.
|
||||
* @return array
|
||||
*/
|
||||
public function add_user_data_fields( $user_data_fields ) {
|
||||
return array_merge(
|
||||
$user_data_fields,
|
||||
array(
|
||||
'activity_panel_inbox_last_read',
|
||||
'activity_panel_reviews_last_read',
|
||||
)
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Add alert count to the component settings.
|
||||
*
|
||||
* @param array $settings Component settings.
|
||||
*/
|
||||
public function component_settings( $settings ) {
|
||||
$settings['alertCount'] = Notes::get_notes_count( array( 'error', 'update' ), array( 'unactioned' ) );
|
||||
return $settings;
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,331 @@
|
||||
<?php
|
||||
/**
|
||||
* WooCommerce Analytics.
|
||||
*/
|
||||
|
||||
namespace Automattic\WooCommerce\Internal\Admin;
|
||||
|
||||
use Automattic\WooCommerce\Admin\API\Reports\Cache;
|
||||
use Automattic\WooCommerce\Admin\Features\Features;
|
||||
|
||||
/**
|
||||
* Contains backend logic for the Analytics feature.
|
||||
*/
|
||||
class Analytics {
|
||||
/**
|
||||
* Option name used to toggle this feature.
|
||||
*/
|
||||
const TOGGLE_OPTION_NAME = 'woocommerce_analytics_enabled';
|
||||
/**
|
||||
* Clear cache tool identifier.
|
||||
*/
|
||||
const CACHE_TOOL_ID = 'clear_woocommerce_analytics_cache';
|
||||
|
||||
/**
|
||||
* Class instance.
|
||||
*
|
||||
* @var Analytics instance
|
||||
*/
|
||||
protected static $instance = null;
|
||||
|
||||
/**
|
||||
* Determines if the feature has been toggled on or off.
|
||||
*
|
||||
* @var boolean
|
||||
*/
|
||||
protected static $is_updated = false;
|
||||
|
||||
/**
|
||||
* 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( 'update_option_' . self::TOGGLE_OPTION_NAME, array( $this, 'reload_page_on_toggle' ), 10, 2 );
|
||||
add_action( 'woocommerce_settings_saved', array( $this, 'maybe_reload_page' ) );
|
||||
|
||||
if ( ! Features::is_enabled( 'analytics' ) ) {
|
||||
return;
|
||||
}
|
||||
|
||||
add_filter( 'woocommerce_component_settings_preload_endpoints', array( $this, 'add_preload_endpoints' ) );
|
||||
add_filter( 'woocommerce_admin_get_user_data_fields', array( $this, 'add_user_data_fields' ) );
|
||||
add_action( 'admin_menu', array( $this, 'register_pages' ) );
|
||||
add_filter( 'woocommerce_debug_tools', array( $this, 'register_cache_clear_tool' ) );
|
||||
}
|
||||
|
||||
/**
|
||||
* Add the feature toggle to the features settings.
|
||||
*
|
||||
* @deprecated 7.0 The WooCommerce Admin features are now handled by the WooCommerce features engine (see the FeaturesController class).
|
||||
*
|
||||
* @param array $features Feature sections.
|
||||
* @return array
|
||||
*/
|
||||
public static function add_feature_toggle( $features ) {
|
||||
return $features;
|
||||
}
|
||||
|
||||
/**
|
||||
* Reloads the page when the option is toggled to make sure all Analytics features are loaded.
|
||||
*
|
||||
* @param string $old_value Old value.
|
||||
* @param string $value New value.
|
||||
*/
|
||||
public static function reload_page_on_toggle( $old_value, $value ) {
|
||||
if ( $old_value === $value ) {
|
||||
return;
|
||||
}
|
||||
|
||||
self::$is_updated = true;
|
||||
}
|
||||
|
||||
/**
|
||||
* Reload the page if the setting has been updated.
|
||||
*/
|
||||
public static function maybe_reload_page() {
|
||||
if ( ! isset( $_SERVER['REQUEST_URI'] ) || ! self::$is_updated ) {
|
||||
return;
|
||||
}
|
||||
|
||||
wp_safe_redirect( wp_unslash( $_SERVER['REQUEST_URI'] ) );
|
||||
exit();
|
||||
}
|
||||
|
||||
/**
|
||||
* Preload data from the countries endpoint.
|
||||
*
|
||||
* @param array $endpoints Array of preloaded endpoints.
|
||||
* @return array
|
||||
*/
|
||||
public function add_preload_endpoints( $endpoints ) {
|
||||
$endpoints['performanceIndicators'] = '/wc-analytics/reports/performance-indicators/allowed';
|
||||
$endpoints['leaderboards'] = '/wc-analytics/leaderboards/allowed';
|
||||
return $endpoints;
|
||||
}
|
||||
|
||||
/**
|
||||
* Adds fields so that we can store user preferences for the columns to display on a report.
|
||||
*
|
||||
* @param array $user_data_fields User data fields.
|
||||
* @return array
|
||||
*/
|
||||
public function add_user_data_fields( $user_data_fields ) {
|
||||
return array_merge(
|
||||
$user_data_fields,
|
||||
array(
|
||||
'categories_report_columns',
|
||||
'coupons_report_columns',
|
||||
'customers_report_columns',
|
||||
'orders_report_columns',
|
||||
'products_report_columns',
|
||||
'revenue_report_columns',
|
||||
'taxes_report_columns',
|
||||
'variations_report_columns',
|
||||
'dashboard_sections',
|
||||
'dashboard_chart_type',
|
||||
'dashboard_chart_interval',
|
||||
'dashboard_leaderboard_rows',
|
||||
)
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Register the cache clearing tool on the WooCommerce > Status > Tools page.
|
||||
*
|
||||
* @param array $debug_tools Available debug tool registrations.
|
||||
* @return array Filtered debug tool registrations.
|
||||
*/
|
||||
public function register_cache_clear_tool( $debug_tools ) {
|
||||
$settings_url = add_query_arg(
|
||||
array(
|
||||
'page' => 'wc-admin',
|
||||
'path' => '/analytics/settings',
|
||||
),
|
||||
get_admin_url( null, 'admin.php' )
|
||||
);
|
||||
|
||||
$debug_tools[ self::CACHE_TOOL_ID ] = array(
|
||||
'name' => __( 'Clear analytics cache', 'woocommerce' ),
|
||||
'button' => __( 'Clear', 'woocommerce' ),
|
||||
'desc' => sprintf(
|
||||
/* translators: 1: opening link tag, 2: closing tag */
|
||||
__( 'This tool will reset the cached values used in WooCommerce Analytics. If numbers still look off, try %1$sReimporting Historical Data%2$s.', 'woocommerce' ),
|
||||
'<a href="' . esc_url( $settings_url ) . '">',
|
||||
'</a>'
|
||||
),
|
||||
'callback' => array( $this, 'run_clear_cache_tool' ),
|
||||
);
|
||||
|
||||
return $debug_tools;
|
||||
}
|
||||
|
||||
/**
|
||||
* Registers report pages.
|
||||
*/
|
||||
public function register_pages() {
|
||||
$report_pages = self::get_report_pages();
|
||||
foreach ( $report_pages as $report_page ) {
|
||||
if ( ! is_null( $report_page ) ) {
|
||||
wc_admin_register_page( $report_page );
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Get report pages.
|
||||
*/
|
||||
public static function get_report_pages() {
|
||||
$overview_page = array(
|
||||
'id' => 'woocommerce-analytics',
|
||||
'title' => __( 'Analytics', 'woocommerce' ),
|
||||
'path' => '/analytics/overview',
|
||||
'icon' => 'dashicons-chart-bar',
|
||||
'position' => 57, // After WooCommerce & Product menu items.
|
||||
);
|
||||
|
||||
$report_pages = array(
|
||||
$overview_page,
|
||||
array(
|
||||
'id' => 'woocommerce-analytics-overview',
|
||||
'title' => __( 'Overview', 'woocommerce' ),
|
||||
'parent' => 'woocommerce-analytics',
|
||||
'path' => '/analytics/overview',
|
||||
'nav_args' => array(
|
||||
'order' => 10,
|
||||
'parent' => 'woocommerce-analytics',
|
||||
),
|
||||
),
|
||||
array(
|
||||
'id' => 'woocommerce-analytics-products',
|
||||
'title' => __( 'Products', 'woocommerce' ),
|
||||
'parent' => 'woocommerce-analytics',
|
||||
'path' => '/analytics/products',
|
||||
'nav_args' => array(
|
||||
'order' => 20,
|
||||
'parent' => 'woocommerce-analytics',
|
||||
),
|
||||
),
|
||||
array(
|
||||
'id' => 'woocommerce-analytics-revenue',
|
||||
'title' => __( 'Revenue', 'woocommerce' ),
|
||||
'parent' => 'woocommerce-analytics',
|
||||
'path' => '/analytics/revenue',
|
||||
'nav_args' => array(
|
||||
'order' => 30,
|
||||
'parent' => 'woocommerce-analytics',
|
||||
),
|
||||
),
|
||||
array(
|
||||
'id' => 'woocommerce-analytics-orders',
|
||||
'title' => __( 'Orders', 'woocommerce' ),
|
||||
'parent' => 'woocommerce-analytics',
|
||||
'path' => '/analytics/orders',
|
||||
'nav_args' => array(
|
||||
'order' => 40,
|
||||
'parent' => 'woocommerce-analytics',
|
||||
),
|
||||
),
|
||||
array(
|
||||
'id' => 'woocommerce-analytics-variations',
|
||||
'title' => __( 'Variations', 'woocommerce' ),
|
||||
'parent' => 'woocommerce-analytics',
|
||||
'path' => '/analytics/variations',
|
||||
'nav_args' => array(
|
||||
'order' => 50,
|
||||
'parent' => 'woocommerce-analytics',
|
||||
),
|
||||
),
|
||||
array(
|
||||
'id' => 'woocommerce-analytics-categories',
|
||||
'title' => __( 'Categories', 'woocommerce' ),
|
||||
'parent' => 'woocommerce-analytics',
|
||||
'path' => '/analytics/categories',
|
||||
'nav_args' => array(
|
||||
'order' => 60,
|
||||
'parent' => 'woocommerce-analytics',
|
||||
),
|
||||
),
|
||||
array(
|
||||
'id' => 'woocommerce-analytics-coupons',
|
||||
'title' => __( 'Coupons', 'woocommerce' ),
|
||||
'parent' => 'woocommerce-analytics',
|
||||
'path' => '/analytics/coupons',
|
||||
'nav_args' => array(
|
||||
'order' => 70,
|
||||
'parent' => 'woocommerce-analytics',
|
||||
),
|
||||
),
|
||||
array(
|
||||
'id' => 'woocommerce-analytics-taxes',
|
||||
'title' => __( 'Taxes', 'woocommerce' ),
|
||||
'parent' => 'woocommerce-analytics',
|
||||
'path' => '/analytics/taxes',
|
||||
'nav_args' => array(
|
||||
'order' => 80,
|
||||
'parent' => 'woocommerce-analytics',
|
||||
),
|
||||
),
|
||||
array(
|
||||
'id' => 'woocommerce-analytics-downloads',
|
||||
'title' => __( 'Downloads', 'woocommerce' ),
|
||||
'parent' => 'woocommerce-analytics',
|
||||
'path' => '/analytics/downloads',
|
||||
'nav_args' => array(
|
||||
'order' => 90,
|
||||
'parent' => 'woocommerce-analytics',
|
||||
),
|
||||
),
|
||||
'yes' === get_option( 'woocommerce_manage_stock' ) ? array(
|
||||
'id' => 'woocommerce-analytics-stock',
|
||||
'title' => __( 'Stock', 'woocommerce' ),
|
||||
'parent' => 'woocommerce-analytics',
|
||||
'path' => '/analytics/stock',
|
||||
'nav_args' => array(
|
||||
'order' => 100,
|
||||
'parent' => 'woocommerce-analytics',
|
||||
),
|
||||
) : null,
|
||||
array(
|
||||
'id' => 'woocommerce-analytics-customers',
|
||||
'title' => __( 'Customers', 'woocommerce' ),
|
||||
'parent' => 'woocommerce',
|
||||
'path' => '/customers',
|
||||
),
|
||||
array(
|
||||
'id' => 'woocommerce-analytics-settings',
|
||||
'title' => __( 'Settings', 'woocommerce' ),
|
||||
'parent' => 'woocommerce-analytics',
|
||||
'path' => '/analytics/settings',
|
||||
'nav_args' => array(
|
||||
'title' => __( 'Analytics', 'woocommerce' ),
|
||||
'parent' => 'woocommerce-settings',
|
||||
),
|
||||
),
|
||||
);
|
||||
|
||||
/**
|
||||
* The analytics report items used in the menu.
|
||||
*
|
||||
* @since 6.4.0
|
||||
*/
|
||||
return apply_filters( 'woocommerce_analytics_report_menu_items', $report_pages );
|
||||
}
|
||||
|
||||
/**
|
||||
* "Clear" analytics cache by invalidating it.
|
||||
*/
|
||||
public function run_clear_cache_tool() {
|
||||
Cache::invalidate();
|
||||
|
||||
return __( 'Analytics cache cleared.', 'woocommerce' );
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,309 @@
|
||||
<?php
|
||||
/**
|
||||
* Keeps the product category lookup table in sync with live data.
|
||||
*/
|
||||
|
||||
namespace Automattic\WooCommerce\Internal\Admin;
|
||||
|
||||
defined( 'ABSPATH' ) || exit;
|
||||
|
||||
/**
|
||||
* \Automattic\WooCommerce\Internal\Admin\CategoryLookup class.
|
||||
*/
|
||||
class CategoryLookup {
|
||||
|
||||
/**
|
||||
* Stores changes to categories we need to sync.
|
||||
*
|
||||
* @var array
|
||||
*/
|
||||
protected $edited_product_cats = array();
|
||||
|
||||
/**
|
||||
* The single instance of the class.
|
||||
*
|
||||
* @var object
|
||||
*/
|
||||
protected static $instance = null;
|
||||
|
||||
/**
|
||||
* Constructor
|
||||
*
|
||||
* @return void
|
||||
*/
|
||||
protected function __construct() {}
|
||||
|
||||
/**
|
||||
* Get class instance.
|
||||
*
|
||||
* @return object Instance.
|
||||
*/
|
||||
final public static function instance() {
|
||||
if ( null === static::$instance ) {
|
||||
static::$instance = new static();
|
||||
}
|
||||
return static::$instance;
|
||||
}
|
||||
|
||||
/**
|
||||
* Init hooks.
|
||||
*/
|
||||
public function init() {
|
||||
add_action( 'generate_category_lookup_table', array( $this, 'regenerate' ) );
|
||||
add_action( 'edit_product_cat', array( $this, 'before_edit' ), 99 );
|
||||
add_action( 'edited_product_cat', array( $this, 'on_edit' ), 99 );
|
||||
add_action( 'created_product_cat', array( $this, 'on_create' ), 99 );
|
||||
add_action( 'init', array( $this, 'define_category_lookup_tables_in_wpdb' ) );
|
||||
}
|
||||
|
||||
/**
|
||||
* Regenerate all lookup table data.
|
||||
*/
|
||||
public function regenerate() {
|
||||
global $wpdb;
|
||||
|
||||
$wpdb->query( "TRUNCATE TABLE $wpdb->wc_category_lookup" );
|
||||
|
||||
$terms = get_terms(
|
||||
'product_cat',
|
||||
array(
|
||||
'hide_empty' => false,
|
||||
'fields' => 'id=>parent',
|
||||
)
|
||||
);
|
||||
|
||||
$hierarchy = array();
|
||||
$inserts = array();
|
||||
|
||||
$this->unflatten_terms( $hierarchy, $terms, 0 );
|
||||
$this->get_term_insert_values( $inserts, $hierarchy );
|
||||
|
||||
if ( ! $inserts ) {
|
||||
return;
|
||||
}
|
||||
|
||||
$insert_string = implode(
|
||||
'),(',
|
||||
array_map(
|
||||
function( $item ) {
|
||||
return implode( ',', $item );
|
||||
},
|
||||
$inserts
|
||||
)
|
||||
);
|
||||
|
||||
$wpdb->query( "INSERT IGNORE INTO $wpdb->wc_category_lookup (category_tree_id,category_id) VALUES ({$insert_string})" ); // phpcs:ignore WordPress.DB.DirectDatabaseQuery.DirectQuery, WordPress.DB.PreparedSQL.InterpolatedNotPrepared
|
||||
}
|
||||
|
||||
/**
|
||||
* Store edits so we know when the parent ID changes.
|
||||
*
|
||||
* @param int $category_id Term ID being edited.
|
||||
*/
|
||||
public function before_edit( $category_id ) {
|
||||
$category = get_term( $category_id, 'product_cat' );
|
||||
$this->edited_product_cats[ $category_id ] = $category->parent;
|
||||
}
|
||||
|
||||
/**
|
||||
* When a product category gets edited, see if we need to sync the table.
|
||||
*
|
||||
* @param int $category_id Term ID being edited.
|
||||
*/
|
||||
public function on_edit( $category_id ) {
|
||||
global $wpdb;
|
||||
|
||||
if ( ! isset( $this->edited_product_cats[ $category_id ] ) ) {
|
||||
return;
|
||||
}
|
||||
|
||||
$category_object = get_term( $category_id, 'product_cat' );
|
||||
$prev_parent = $this->edited_product_cats[ $category_id ];
|
||||
$new_parent = $category_object->parent;
|
||||
|
||||
// No edits - no need to modify relationships.
|
||||
if ( $prev_parent === $new_parent ) {
|
||||
return;
|
||||
}
|
||||
|
||||
$this->delete( $category_id, $prev_parent );
|
||||
$this->update( $category_id );
|
||||
}
|
||||
|
||||
/**
|
||||
* When a product category gets created, add a new lookup row.
|
||||
*
|
||||
* @param int $category_id Term ID being created.
|
||||
*/
|
||||
public function on_create( $category_id ) {
|
||||
// If WooCommerce is being installed on a multisite, lookup tables haven't been created yet.
|
||||
if ( 'yes' === get_transient( 'wc_installing' ) ) {
|
||||
return;
|
||||
}
|
||||
|
||||
$this->update( $category_id );
|
||||
}
|
||||
|
||||
/**
|
||||
* Delete lookup table data from a tree.
|
||||
*
|
||||
* @param int $category_id Category ID to delete.
|
||||
* @param int $category_tree_id Tree to delete from.
|
||||
* @return void
|
||||
*/
|
||||
protected function delete( $category_id, $category_tree_id ) {
|
||||
global $wpdb;
|
||||
|
||||
if ( ! $category_tree_id ) {
|
||||
return;
|
||||
}
|
||||
|
||||
$ancestors = get_ancestors( $category_tree_id, 'product_cat', 'taxonomy' );
|
||||
$ancestors[] = $category_tree_id;
|
||||
$children = get_term_children( $category_id, 'product_cat' );
|
||||
$children[] = $category_id;
|
||||
$id_list = implode( ',', array_map( 'intval', array_unique( array_filter( $children ) ) ) );
|
||||
|
||||
foreach ( $ancestors as $ancestor ) {
|
||||
$wpdb->query( $wpdb->prepare( "DELETE FROM $wpdb->wc_category_lookup WHERE category_tree_id = %d AND category_id IN ({$id_list})", $ancestor ) ); // phpcs:ignore WordPress.DB.DirectDatabaseQuery.DirectQuery, WordPress.DB.PreparedSQL.InterpolatedNotPrepared
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Updates lookup table data for a category by ID.
|
||||
*
|
||||
* @param int $category_id Category ID to update.
|
||||
*/
|
||||
protected function update( $category_id ) {
|
||||
global $wpdb;
|
||||
|
||||
$ancestors = get_ancestors( $category_id, 'product_cat', 'taxonomy' );
|
||||
$children = get_term_children( $category_id, 'product_cat' );
|
||||
$inserts = array();
|
||||
$inserts[] = $this->get_insert_sql( $category_id, $category_id );
|
||||
$children_ids = array_map( 'intval', array_unique( array_filter( $children ) ) );
|
||||
|
||||
foreach ( $ancestors as $ancestor ) {
|
||||
$inserts[] = $this->get_insert_sql( $category_id, $ancestor );
|
||||
|
||||
foreach ( $children_ids as $child_category_id ) {
|
||||
$inserts[] = $this->get_insert_sql( $child_category_id, $ancestor );
|
||||
}
|
||||
}
|
||||
|
||||
$insert_string = implode( ',', $inserts );
|
||||
|
||||
$wpdb->query( "INSERT IGNORE INTO $wpdb->wc_category_lookup (category_id, category_tree_id) VALUES {$insert_string}" ); // phpcs:ignore WordPress.DB.DirectDatabaseQuery.DirectQuery, WordPress.DB.PreparedSQL.InterpolatedNotPrepared
|
||||
}
|
||||
|
||||
/**
|
||||
* Get category lookup table values to insert.
|
||||
*
|
||||
* @param int $category_id Category ID to insert.
|
||||
* @param int $category_tree_id Tree to insert into.
|
||||
* @return string
|
||||
*/
|
||||
protected function get_insert_sql( $category_id, $category_tree_id ) {
|
||||
global $wpdb;
|
||||
return $wpdb->prepare( '(%d,%d)', $category_id, $category_tree_id );
|
||||
}
|
||||
|
||||
/**
|
||||
* Used to construct insert query recursively.
|
||||
*
|
||||
* @param array $inserts Array of data to insert.
|
||||
* @param array $terms Terms to insert.
|
||||
* @param array $parents Parent IDs the terms belong to.
|
||||
*/
|
||||
protected function get_term_insert_values( &$inserts, $terms, $parents = array() ) {
|
||||
foreach ( $terms as $term ) {
|
||||
$insert_parents = array_merge( array( $term['term_id'] ), $parents );
|
||||
|
||||
foreach ( $insert_parents as $parent ) {
|
||||
$inserts[] = array(
|
||||
$parent,
|
||||
$term['term_id'],
|
||||
);
|
||||
}
|
||||
|
||||
$this->get_term_insert_values( $inserts, $term['descendants'], $insert_parents );
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Convert flat terms array into nested array.
|
||||
*
|
||||
* @param array $hierarchy Array to put terms into.
|
||||
* @param array $terms Array of terms (id=>parent).
|
||||
* @param integer $parent Parent ID.
|
||||
*/
|
||||
protected function unflatten_terms( &$hierarchy, &$terms, $parent = 0 ) {
|
||||
foreach ( $terms as $term_id => $parent_id ) {
|
||||
if ( (int) $parent_id === $parent ) {
|
||||
$hierarchy[ $term_id ] = array(
|
||||
'term_id' => $term_id,
|
||||
'descendants' => array(),
|
||||
);
|
||||
unset( $terms[ $term_id ] );
|
||||
}
|
||||
}
|
||||
foreach ( $hierarchy as $term_id => $terms_array ) {
|
||||
$this->unflatten_terms( $hierarchy[ $term_id ]['descendants'], $terms, $term_id );
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Get category descendants.
|
||||
*
|
||||
* @param int $category_id The category ID to lookup.
|
||||
* @return array
|
||||
*/
|
||||
protected function get_descendants( $category_id ) {
|
||||
global $wpdb;
|
||||
|
||||
return wp_parse_id_list(
|
||||
$wpdb->get_col(
|
||||
$wpdb->prepare(
|
||||
"SELECT category_id FROM $wpdb->wc_category_lookup WHERE category_tree_id = %d",
|
||||
$category_id
|
||||
)
|
||||
)
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Return all ancestor category ids for a category.
|
||||
*
|
||||
* @param int $category_id The category ID to lookup.
|
||||
* @return array
|
||||
*/
|
||||
protected function get_ancestors( $category_id ) {
|
||||
global $wpdb;
|
||||
|
||||
return wp_parse_id_list(
|
||||
$wpdb->get_col(
|
||||
$wpdb->prepare(
|
||||
"SELECT category_tree_id FROM $wpdb->wc_category_lookup WHERE category_id = %d",
|
||||
$category_id
|
||||
)
|
||||
)
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Add category lookup table to $wpdb object.
|
||||
*/
|
||||
public static function define_category_lookup_tables_in_wpdb() {
|
||||
global $wpdb;
|
||||
|
||||
// List of tables without prefixes.
|
||||
$tables = array(
|
||||
'wc_category_lookup' => 'wc_category_lookup',
|
||||
);
|
||||
|
||||
foreach ( $tables as $name => $table ) {
|
||||
$wpdb->$name = $wpdb->prefix . $table;
|
||||
$wpdb->tables[] = $table;
|
||||
}
|
||||
}
|
||||
}
|
||||
131
wp/wp-content/plugins/woocommerce/src/Internal/Admin/Coupons.php
Normal file
131
wp/wp-content/plugins/woocommerce/src/Internal/Admin/Coupons.php
Normal file
@@ -0,0 +1,131 @@
|
||||
<?php
|
||||
/**
|
||||
* WooCommerce Marketing > Coupons.
|
||||
*/
|
||||
|
||||
namespace Automattic\WooCommerce\Internal\Admin;
|
||||
|
||||
use Automattic\WooCommerce\Admin\Features\Features;
|
||||
use Automattic\WooCommerce\Internal\Admin\Notes\CouponPageMoved;
|
||||
use Automattic\WooCommerce\Admin\PageController;
|
||||
|
||||
/**
|
||||
* Contains backend logic for the Coupons feature.
|
||||
*/
|
||||
class Coupons {
|
||||
|
||||
use CouponsMovedTrait;
|
||||
|
||||
/**
|
||||
* Class instance.
|
||||
*
|
||||
* @var Coupons 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() {
|
||||
if ( ! is_admin() ) {
|
||||
return;
|
||||
}
|
||||
|
||||
// If the main marketing feature is disabled, don't modify coupon behavior.
|
||||
if ( ! Features::is_enabled( 'marketing' ) ) {
|
||||
return;
|
||||
}
|
||||
|
||||
// Only support coupon modifications if coupons are enabled.
|
||||
if ( ! wc_coupons_enabled() ) {
|
||||
return;
|
||||
}
|
||||
|
||||
( new CouponPageMoved() )->init();
|
||||
|
||||
add_action( 'admin_enqueue_scripts', array( $this, 'maybe_add_marketing_coupon_script' ) );
|
||||
add_action( 'woocommerce_register_post_type_shop_coupon', array( $this, 'move_coupons' ) );
|
||||
add_action( 'admin_head', array( $this, 'fix_coupon_menu_highlight' ), 99 );
|
||||
add_action( 'admin_menu', array( $this, 'maybe_add_coupon_menu_redirect' ) );
|
||||
}
|
||||
|
||||
/**
|
||||
* Maybe add menu item back in original spot to help people transition
|
||||
*/
|
||||
public function maybe_add_coupon_menu_redirect() {
|
||||
if ( ! $this->should_display_legacy_menu() ) {
|
||||
return;
|
||||
}
|
||||
|
||||
add_submenu_page(
|
||||
'woocommerce',
|
||||
__( 'Coupons', 'woocommerce' ),
|
||||
__( 'Coupons', 'woocommerce' ),
|
||||
'manage_options',
|
||||
'coupons-moved',
|
||||
[ $this, 'coupon_menu_moved' ]
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Call back for transition menu item
|
||||
*/
|
||||
public function coupon_menu_moved() {
|
||||
wp_safe_redirect( $this->get_legacy_coupon_url(), 301 );
|
||||
exit();
|
||||
}
|
||||
|
||||
/**
|
||||
* Modify registered post type shop_coupon
|
||||
*
|
||||
* @param array $args Array of post type parameters.
|
||||
*
|
||||
* @return array the filtered parameters.
|
||||
*/
|
||||
public function move_coupons( $args ) {
|
||||
$args['show_in_menu'] = current_user_can( 'manage_woocommerce' ) ? 'woocommerce-marketing' : true;
|
||||
return $args;
|
||||
}
|
||||
|
||||
/**
|
||||
* Undo WC modifications to $parent_file for 'shop_coupon'
|
||||
*/
|
||||
public function fix_coupon_menu_highlight() {
|
||||
global $parent_file, $post_type;
|
||||
|
||||
if ( $post_type === 'shop_coupon' ) {
|
||||
$parent_file = 'woocommerce-marketing'; // phpcs:ignore WordPress.WP.GlobalVariablesOverride
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Maybe add our wc-admin coupon scripts if viewing coupon pages
|
||||
*/
|
||||
public function maybe_add_marketing_coupon_script() {
|
||||
$curent_screen = PageController::get_instance()->get_current_page();
|
||||
if ( ! isset( $curent_screen['id'] ) || $curent_screen['id'] !== 'woocommerce-coupons' ) {
|
||||
return;
|
||||
}
|
||||
|
||||
$rtl = is_rtl() ? '-rtl' : '';
|
||||
|
||||
wp_enqueue_style(
|
||||
'wc-admin-marketing-coupons',
|
||||
WCAdminAssets::get_url( "marketing-coupons/style{$rtl}", 'css' ),
|
||||
array(),
|
||||
WCAdminAssets::get_file_version( 'css' )
|
||||
);
|
||||
|
||||
WCAdminAssets::register_script( 'wp-admin-scripts', 'marketing-coupons', true );
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,104 @@
|
||||
<?php
|
||||
/**
|
||||
* A Trait to help with managing the legacy coupon menu.
|
||||
*/
|
||||
|
||||
namespace Automattic\WooCommerce\Internal\Admin;
|
||||
|
||||
use Automattic\WooCommerce\Admin\Features\Features;
|
||||
|
||||
/**
|
||||
* CouponsMovedTrait trait.
|
||||
*/
|
||||
trait CouponsMovedTrait {
|
||||
|
||||
/**
|
||||
* The GET query key for the legacy menu.
|
||||
*
|
||||
* @var string
|
||||
*/
|
||||
protected static $query_key = 'legacy_coupon_menu';
|
||||
|
||||
/**
|
||||
* The key for storing an option in the DB.
|
||||
*
|
||||
* @var string
|
||||
*/
|
||||
protected static $option_key = 'wc_admin_show_legacy_coupon_menu';
|
||||
|
||||
/**
|
||||
* Get the URL for the legacy coupon management.
|
||||
*
|
||||
* @return string The unescaped URL for the legacy coupon management page.
|
||||
*/
|
||||
protected static function get_legacy_coupon_url() {
|
||||
return self::get_coupon_url( [ self::$query_key => true ] );
|
||||
}
|
||||
|
||||
/**
|
||||
* Get the URL for the coupon management page.
|
||||
*
|
||||
* @param array $args Additional URL query arguments.
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
protected static function get_coupon_url( $args = [] ) {
|
||||
$args = array_merge(
|
||||
[
|
||||
'post_type' => 'shop_coupon',
|
||||
],
|
||||
$args
|
||||
);
|
||||
|
||||
return add_query_arg( $args, admin_url( 'edit.php' ) );
|
||||
}
|
||||
|
||||
/**
|
||||
* Get the new URL for managing coupons.
|
||||
*
|
||||
* @param string $page The management page.
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
protected static function get_management_url( $page ) {
|
||||
$path = '';
|
||||
switch ( $page ) {
|
||||
case 'coupon':
|
||||
case 'coupons':
|
||||
return self::get_coupon_url();
|
||||
|
||||
case 'marketing':
|
||||
$path = self::get_marketing_path();
|
||||
break;
|
||||
}
|
||||
|
||||
return "wc-admin&path={$path}";
|
||||
}
|
||||
|
||||
/**
|
||||
* Get the WC Admin path for the marking page.
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
protected static function get_marketing_path() {
|
||||
return '/marketing/overview';
|
||||
}
|
||||
|
||||
/**
|
||||
* Whether we should display the legacy coupon menu item.
|
||||
*
|
||||
* @return bool
|
||||
*/
|
||||
protected static function should_display_legacy_menu() {
|
||||
return ( get_option( self::$option_key, 1 ) && ! Features::is_enabled( 'navigation' ) );
|
||||
}
|
||||
|
||||
/**
|
||||
* Set whether we should display the legacy coupon menu item.
|
||||
*
|
||||
* @param bool $display Whether the menu should be displayed or not.
|
||||
*/
|
||||
protected static function display_legacy_menu( $display = false ) {
|
||||
update_option( self::$option_key, $display ? 1 : 0 );
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,641 @@
|
||||
<?php
|
||||
/**
|
||||
* WooCommerce Customer effort score tracks
|
||||
*
|
||||
* @package WooCommerce\Admin\Features
|
||||
*/
|
||||
|
||||
namespace Automattic\WooCommerce\Internal\Admin;
|
||||
|
||||
defined( 'ABSPATH' ) || exit;
|
||||
|
||||
/**
|
||||
* Triggers customer effort score on several different actions.
|
||||
*/
|
||||
class CustomerEffortScoreTracks {
|
||||
/**
|
||||
* Option name for the CES Tracks queue.
|
||||
*/
|
||||
const CES_TRACKS_QUEUE_OPTION_NAME = 'woocommerce_ces_tracks_queue';
|
||||
|
||||
/**
|
||||
* Option name for the clear CES Tracks queue for page.
|
||||
*/
|
||||
const CLEAR_CES_TRACKS_QUEUE_FOR_PAGE_OPTION_NAME =
|
||||
'woocommerce_clear_ces_tracks_queue_for_page';
|
||||
|
||||
/**
|
||||
* Option name for the set of actions that have been shown.
|
||||
*/
|
||||
const SHOWN_FOR_ACTIONS_OPTION_NAME = 'woocommerce_ces_shown_for_actions';
|
||||
|
||||
/**
|
||||
* Action name for product add/publish.
|
||||
*/
|
||||
const PRODUCT_ADD_PUBLISH_ACTION_NAME = 'product_add_publish';
|
||||
|
||||
/**
|
||||
* Action name for product update.
|
||||
*/
|
||||
const PRODUCT_UPDATE_ACTION_NAME = 'product_update';
|
||||
|
||||
/**
|
||||
* Action name for shop order update.
|
||||
*/
|
||||
const SHOP_ORDER_UPDATE_ACTION_NAME = 'shop_order_update';
|
||||
|
||||
/**
|
||||
* Action name for settings change.
|
||||
*/
|
||||
const SETTINGS_CHANGE_ACTION_NAME = 'settings_change';
|
||||
|
||||
/**
|
||||
* Action name for add product categories.
|
||||
*/
|
||||
const ADD_PRODUCT_CATEGORIES_ACTION_NAME = 'add_product_categories';
|
||||
|
||||
/**
|
||||
* Action name for add product tags.
|
||||
*/
|
||||
const ADD_PRODUCT_TAGS_ACTION_NAME = 'add_product_tags';
|
||||
|
||||
/*
|
||||
* Action name for add product attributes.
|
||||
*/
|
||||
const ADD_PRODUCT_ATTRIBUTES_ACTION_NAME = 'add_product_attributes';
|
||||
|
||||
/**
|
||||
* Action name for import products.
|
||||
*/
|
||||
const IMPORT_PRODUCTS_ACTION_NAME = 'import_products';
|
||||
|
||||
/**
|
||||
* Action name for search.
|
||||
*/
|
||||
const SEARCH_ACTION_NAME = 'ces_search';
|
||||
|
||||
/**
|
||||
* Label for the snackbar that appears when a user submits the survey.
|
||||
*
|
||||
* @var string
|
||||
*/
|
||||
private $onsubmit_label;
|
||||
|
||||
/**
|
||||
* Constructor. Sets up filters to hook into WooCommerce.
|
||||
*/
|
||||
public function __construct() {
|
||||
$this->enable_survey_enqueing_if_tracking_is_enabled();
|
||||
}
|
||||
|
||||
/**
|
||||
* Add actions that require woocommerce_allow_tracking.
|
||||
*/
|
||||
private function enable_survey_enqueing_if_tracking_is_enabled() {
|
||||
// Only hook up the action handlers if in wp-admin.
|
||||
if ( ! is_admin() ) {
|
||||
return;
|
||||
}
|
||||
|
||||
// Do not hook up the action handlers if a mobile device is used.
|
||||
if ( wp_is_mobile() ) {
|
||||
return;
|
||||
}
|
||||
|
||||
// Only enqueue a survey if tracking is allowed.
|
||||
$allow_tracking = 'yes' === get_option( 'woocommerce_allow_tracking', 'no' );
|
||||
if ( ! $allow_tracking ) {
|
||||
return;
|
||||
}
|
||||
|
||||
add_action( 'admin_init', array( $this, 'maybe_clear_ces_tracks_queue' ) );
|
||||
add_action( 'woocommerce_update_options', array( $this, 'run_on_update_options' ), 10, 3 );
|
||||
add_action( 'product_cat_add_form', array( $this, 'add_script_track_product_categories' ), 10, 3 );
|
||||
add_action( 'product_tag_add_form', array( $this, 'add_script_track_product_tags' ), 10, 3 );
|
||||
add_action( 'woocommerce_attribute_added', array( $this, 'run_on_add_product_attributes' ), 10, 3 );
|
||||
add_action( 'load-edit.php', array( $this, 'run_on_load_edit_php' ), 10, 3 );
|
||||
add_action( 'product_page_product_importer', array( $this, 'run_on_product_import' ), 10, 3 );
|
||||
// Only hook up the transition_post_status action handler
|
||||
// if on the edit page.
|
||||
global $pagenow;
|
||||
if ( 'post.php' === $pagenow ) {
|
||||
add_action(
|
||||
'transition_post_status',
|
||||
array(
|
||||
$this,
|
||||
'run_on_transition_post_status',
|
||||
),
|
||||
10,
|
||||
3
|
||||
);
|
||||
}
|
||||
$this->onsubmit_label = __( 'Thank you for your feedback!', 'woocommerce' );
|
||||
}
|
||||
|
||||
/**
|
||||
* Returns a generated script for tracking tags added on edit-tags.php page.
|
||||
* CES survey is triggered via direct access to wc/customer-effort-score store
|
||||
* via wp.data.dispatch method.
|
||||
*
|
||||
* Due to lack of options to directly hook ourselves into the ajax post request
|
||||
* initiated by edit-tags.php page, we infer a successful request by observing
|
||||
* an increase of the number of rows in tags table
|
||||
*
|
||||
* @param string $action Action name for the survey.
|
||||
* @param string $title Title for the snackbar.
|
||||
* @param string $first_question The text for the first question.
|
||||
* @param string $second_question The text for the second question.
|
||||
*
|
||||
* @return string Generated JavaScript to append to page.
|
||||
*/
|
||||
private function get_script_track_edit_php( $action, $title, $first_question, $second_question ) {
|
||||
return sprintf(
|
||||
"(function( $ ) {
|
||||
'use strict';
|
||||
// Hook on submit button and sets a 500ms interval function
|
||||
// to determine successful add tag or otherwise.
|
||||
$('#addtag #submit').on( 'click', function() {
|
||||
const initialCount = $('.tags tbody > tr').length;
|
||||
const interval = setInterval( function() {
|
||||
if ( $('.tags tbody > tr').length > initialCount ) {
|
||||
// New tag detected.
|
||||
clearInterval( interval );
|
||||
wp.data.dispatch('wc/customer-effort-score').addCesSurvey({ action: '%s', title: '%s', firstQuestion: '%s', secondQuestion: '%s', onsubmitLabel: '%s' });
|
||||
} else {
|
||||
// Form is no longer loading, most likely failed.
|
||||
if ( $( '#addtag .submit .spinner.is-active' ).length < 1 ) {
|
||||
clearInterval( interval );
|
||||
}
|
||||
}
|
||||
}, 500 );
|
||||
});
|
||||
})( jQuery );",
|
||||
esc_js( $action ),
|
||||
esc_js( $title ),
|
||||
esc_js( $first_question ),
|
||||
esc_js( $second_question ),
|
||||
esc_js( $this->onsubmit_label )
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Get the current published product count.
|
||||
*
|
||||
* @return integer The current published product count.
|
||||
*/
|
||||
private function get_product_count() {
|
||||
$query = new \WC_Product_Query(
|
||||
array(
|
||||
'limit' => 1,
|
||||
'paginate' => true,
|
||||
'return' => 'ids',
|
||||
'status' => array( 'publish' ),
|
||||
)
|
||||
);
|
||||
$products = $query->get_products();
|
||||
$product_count = intval( $products->total );
|
||||
|
||||
return $product_count;
|
||||
}
|
||||
|
||||
/**
|
||||
* Get the current shop order count.
|
||||
*
|
||||
* @return integer The current shop order count.
|
||||
*/
|
||||
private function get_shop_order_count() {
|
||||
$query = new \WC_Order_Query(
|
||||
array(
|
||||
'limit' => 1,
|
||||
'paginate' => true,
|
||||
'return' => 'ids',
|
||||
)
|
||||
);
|
||||
$shop_orders = $query->get_orders();
|
||||
$shop_order_count = intval( $shop_orders->total );
|
||||
|
||||
return $shop_order_count;
|
||||
}
|
||||
|
||||
/**
|
||||
* Return whether the action has already been shown.
|
||||
*
|
||||
* @param string $action The action to check.
|
||||
*
|
||||
* @return bool Whether the action has already been shown.
|
||||
*/
|
||||
private function has_been_shown( $action ) {
|
||||
$shown_for_features = get_option( self::SHOWN_FOR_ACTIONS_OPTION_NAME, array() );
|
||||
$has_been_shown = in_array( $action, $shown_for_features, true );
|
||||
|
||||
return $has_been_shown;
|
||||
}
|
||||
|
||||
/**
|
||||
* Enqueue the item to the CES tracks queue.
|
||||
*
|
||||
* @param array $item The item to enqueue.
|
||||
*/
|
||||
private function enqueue_to_ces_tracks( $item ) {
|
||||
$queue = get_option(
|
||||
self::CES_TRACKS_QUEUE_OPTION_NAME,
|
||||
array()
|
||||
);
|
||||
|
||||
$has_duplicate = array_filter(
|
||||
$queue,
|
||||
function ( $queue_item ) use ( $item ) {
|
||||
return $queue_item['action'] === $item['action'];
|
||||
}
|
||||
);
|
||||
if ( $has_duplicate ) {
|
||||
return;
|
||||
}
|
||||
|
||||
$queue[] = $item;
|
||||
|
||||
update_option(
|
||||
self::CES_TRACKS_QUEUE_OPTION_NAME,
|
||||
$queue
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Enqueue the CES survey on using search dynamically.
|
||||
*
|
||||
* @param string $search_area Search area such as "product" or "shop_order".
|
||||
* @param string $page_now Value of window.pagenow.
|
||||
* @param string $admin_page Value of window.adminpage.
|
||||
*/
|
||||
public function enqueue_ces_survey_for_search( $search_area, $page_now, $admin_page ) {
|
||||
if ( $this->has_been_shown( self::SEARCH_ACTION_NAME ) ) {
|
||||
return;
|
||||
}
|
||||
|
||||
$this->enqueue_to_ces_tracks(
|
||||
array(
|
||||
'action' => self::SEARCH_ACTION_NAME,
|
||||
'title' => __(
|
||||
'How easy was it to use search?',
|
||||
'woocommerce'
|
||||
),
|
||||
'firstQuestion' => __(
|
||||
'The search feature in WooCommerce is easy to use.',
|
||||
'woocommerce'
|
||||
),
|
||||
'secondQuestion' => __(
|
||||
'The search\'s functionality meets my needs.',
|
||||
'woocommerce'
|
||||
),
|
||||
'onsubmit_label' => $this->onsubmit_label,
|
||||
'pagenow' => $page_now,
|
||||
'adminpage' => $admin_page,
|
||||
'props' => (object) array(
|
||||
'search_area' => $search_area,
|
||||
),
|
||||
)
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Hook into the post status lifecycle, to detect relevant user actions
|
||||
* that we want to survey about.
|
||||
*
|
||||
* @param string $new_status The new status.
|
||||
* @param string $old_status The old status.
|
||||
* @param Post $post The post.
|
||||
*/
|
||||
public function run_on_transition_post_status(
|
||||
$new_status,
|
||||
$old_status,
|
||||
$post
|
||||
) {
|
||||
if ( 'product' === $post->post_type ) {
|
||||
$this->maybe_enqueue_ces_survey_for_product( $new_status, $old_status );
|
||||
} elseif ( 'shop_order' === $post->post_type ) {
|
||||
$this->enqueue_ces_survey_for_edited_shop_order();
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Maybe enqueue the CES survey, if product is being added or edited.
|
||||
*
|
||||
* @param string $new_status The new status.
|
||||
* @param string $old_status The old status.
|
||||
*/
|
||||
private function maybe_enqueue_ces_survey_for_product(
|
||||
$new_status,
|
||||
$old_status
|
||||
) {
|
||||
if ( 'publish' !== $new_status ) {
|
||||
return;
|
||||
}
|
||||
|
||||
if ( 'publish' !== $old_status ) {
|
||||
$this->enqueue_ces_survey_for_new_product();
|
||||
} else {
|
||||
$this->enqueue_ces_survey_for_edited_product();
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Enqueue the CES survey trigger for a new product.
|
||||
*/
|
||||
private function enqueue_ces_survey_for_new_product() {
|
||||
if ( $this->has_been_shown( self::PRODUCT_ADD_PUBLISH_ACTION_NAME ) ) {
|
||||
return;
|
||||
}
|
||||
|
||||
$this->enqueue_to_ces_tracks(
|
||||
array(
|
||||
'action' => self::PRODUCT_ADD_PUBLISH_ACTION_NAME,
|
||||
'title' => __(
|
||||
'How easy was it to add a product?',
|
||||
'woocommerce'
|
||||
),
|
||||
'firstQuestion' => __(
|
||||
'The product creation screen is easy to use.',
|
||||
'woocommerce'
|
||||
),
|
||||
'secondQuestion' => __(
|
||||
'The product creation screen\'s functionality meets my needs.',
|
||||
'woocommerce'
|
||||
),
|
||||
'onsubmit_label' => $this->onsubmit_label,
|
||||
'pagenow' => 'product',
|
||||
'adminpage' => 'post-php',
|
||||
'props' => array(
|
||||
'product_count' => $this->get_product_count(),
|
||||
),
|
||||
)
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Enqueue the CES survey trigger for an existing product.
|
||||
*/
|
||||
private function enqueue_ces_survey_for_edited_product() {
|
||||
if ( $this->has_been_shown( self::PRODUCT_UPDATE_ACTION_NAME ) ) {
|
||||
return;
|
||||
}
|
||||
|
||||
$this->enqueue_to_ces_tracks(
|
||||
array(
|
||||
'action' => self::PRODUCT_UPDATE_ACTION_NAME,
|
||||
'title' => __(
|
||||
'How easy was it to edit your product?',
|
||||
'woocommerce'
|
||||
),
|
||||
'firstQuestion' => __(
|
||||
'The product update process is easy to complete.',
|
||||
'woocommerce'
|
||||
),
|
||||
'secondQuestion' => __(
|
||||
'The product update process meets my needs.',
|
||||
'woocommerce'
|
||||
),
|
||||
'onsubmit_label' => $this->onsubmit_label,
|
||||
'pagenow' => 'product',
|
||||
'adminpage' => 'post-php',
|
||||
'props' => array(
|
||||
'product_count' => $this->get_product_count(),
|
||||
),
|
||||
)
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Enqueue the CES survey trigger for an existing shop order.
|
||||
*/
|
||||
private function enqueue_ces_survey_for_edited_shop_order() {
|
||||
if ( $this->has_been_shown( self::SHOP_ORDER_UPDATE_ACTION_NAME ) ) {
|
||||
return;
|
||||
}
|
||||
|
||||
$this->enqueue_to_ces_tracks(
|
||||
array(
|
||||
'action' => self::SHOP_ORDER_UPDATE_ACTION_NAME,
|
||||
'title' => __(
|
||||
'How easy was it to update an order?',
|
||||
'woocommerce'
|
||||
),
|
||||
'firstQuestion' => __(
|
||||
'The order details screen is easy to use.',
|
||||
'woocommerce'
|
||||
),
|
||||
'secondQuestion' => __(
|
||||
'The order details screen\'s functionality meets my needs.',
|
||||
'woocommerce'
|
||||
),
|
||||
'onsubmit_label' => $this->onsubmit_label,
|
||||
'pagenow' => 'shop_order',
|
||||
'adminpage' => 'post-php',
|
||||
'props' => array(
|
||||
'order_count' => $this->get_shop_order_count(),
|
||||
),
|
||||
)
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Maybe clear the CES tracks queue, executed on every page load. If the
|
||||
* clear option is set it clears the queue. In practice, this executes a
|
||||
* page load after the queued CES tracks are displayed on the client, which
|
||||
* sets the clear option.
|
||||
*/
|
||||
public function maybe_clear_ces_tracks_queue() {
|
||||
$clear_ces_tracks_queue_for_page = get_option(
|
||||
self::CLEAR_CES_TRACKS_QUEUE_FOR_PAGE_OPTION_NAME,
|
||||
false
|
||||
);
|
||||
|
||||
if ( ! $clear_ces_tracks_queue_for_page ) {
|
||||
return;
|
||||
}
|
||||
|
||||
$queue = get_option(
|
||||
self::CES_TRACKS_QUEUE_OPTION_NAME,
|
||||
array()
|
||||
);
|
||||
$remaining_items = array_filter(
|
||||
$queue,
|
||||
function ( $item ) use ( $clear_ces_tracks_queue_for_page ) {
|
||||
return $clear_ces_tracks_queue_for_page['pagenow'] !== $item['pagenow']
|
||||
|| $clear_ces_tracks_queue_for_page['adminpage'] !== $item['adminpage'];
|
||||
}
|
||||
);
|
||||
|
||||
update_option(
|
||||
self::CES_TRACKS_QUEUE_OPTION_NAME,
|
||||
array_values( $remaining_items )
|
||||
);
|
||||
update_option( self::CLEAR_CES_TRACKS_QUEUE_FOR_PAGE_OPTION_NAME, false );
|
||||
}
|
||||
|
||||
/**
|
||||
* Appends a script to footer to trigger CES on adding product categories.
|
||||
*/
|
||||
public function add_script_track_product_categories() {
|
||||
if ( $this->has_been_shown( self::ADD_PRODUCT_CATEGORIES_ACTION_NAME ) ) {
|
||||
return;
|
||||
}
|
||||
|
||||
wc_enqueue_js(
|
||||
$this->get_script_track_edit_php(
|
||||
self::ADD_PRODUCT_CATEGORIES_ACTION_NAME,
|
||||
__( 'How easy was it to add product category?', 'woocommerce' ),
|
||||
__( 'The product category details screen is easy to use.', 'woocommerce' ),
|
||||
__( "The product category details screen's functionality meets my needs.", 'woocommerce' )
|
||||
)
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Appends a script to footer to trigger CES on adding product tags.
|
||||
*/
|
||||
public function add_script_track_product_tags() {
|
||||
if ( $this->has_been_shown( self::ADD_PRODUCT_TAGS_ACTION_NAME ) ) {
|
||||
return;
|
||||
}
|
||||
|
||||
wc_enqueue_js(
|
||||
$this->get_script_track_edit_php(
|
||||
self::ADD_PRODUCT_TAGS_ACTION_NAME,
|
||||
__( 'How easy was it to add a product tag?', 'woocommerce' ),
|
||||
__( 'The product tag details screen is easy to use.', 'woocommerce' ),
|
||||
__( "The product tag details screen's functionality meets my needs.", 'woocommerce' )
|
||||
)
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Maybe enqueue the CES survey on product import, if step is done.
|
||||
*/
|
||||
public function run_on_product_import() {
|
||||
// We're only interested in when the importer completes.
|
||||
if ( empty( $_GET['step'] ) || 'done' !== $_GET['step'] ) { // phpcs:ignore CSRF ok.
|
||||
return;
|
||||
}
|
||||
|
||||
if ( $this->has_been_shown( self::IMPORT_PRODUCTS_ACTION_NAME ) ) {
|
||||
return;
|
||||
}
|
||||
|
||||
$this->enqueue_to_ces_tracks(
|
||||
array(
|
||||
'action' => self::IMPORT_PRODUCTS_ACTION_NAME,
|
||||
'title' => __(
|
||||
'How easy was it to import products?',
|
||||
'woocommerce'
|
||||
),
|
||||
'firstQuestion' => __(
|
||||
'The product import process is easy to complete.',
|
||||
'woocommerce'
|
||||
),
|
||||
'secondQuestion' => __(
|
||||
'The product import process meets my needs.',
|
||||
'woocommerce'
|
||||
),
|
||||
'onsubmit_label' => $this->onsubmit_label,
|
||||
'pagenow' => 'product_page_product_importer',
|
||||
'adminpage' => 'product_page_product_importer',
|
||||
'props' => (object) array(),
|
||||
)
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Enqueue the CES survey trigger for setting changes.
|
||||
*/
|
||||
public function run_on_update_options() {
|
||||
// $current_tab is set when WC_Admin_Settings::save_settings is called.
|
||||
global $current_tab;
|
||||
global $current_section;
|
||||
|
||||
if ( $this->has_been_shown( self::SETTINGS_CHANGE_ACTION_NAME ) ) {
|
||||
return;
|
||||
}
|
||||
|
||||
$props = array(
|
||||
'settings_area' => $current_tab,
|
||||
);
|
||||
|
||||
if ( $current_section ) {
|
||||
$props['settings_section'] = $current_section;
|
||||
}
|
||||
|
||||
$this->enqueue_to_ces_tracks(
|
||||
array(
|
||||
'action' => self::SETTINGS_CHANGE_ACTION_NAME,
|
||||
'title' => __(
|
||||
'How easy was it to update your settings?',
|
||||
'woocommerce'
|
||||
),
|
||||
'firstQuestion' => __(
|
||||
'The settings screen is easy to use.',
|
||||
'woocommerce'
|
||||
),
|
||||
'secondQuestion' => __(
|
||||
'The settings screen\'s functionality meets my needs.',
|
||||
'woocommerce'
|
||||
),
|
||||
'onsubmit_label' => $this->onsubmit_label,
|
||||
'pagenow' => 'woocommerce_page_wc-settings',
|
||||
'adminpage' => 'woocommerce_page_wc-settings',
|
||||
'props' => (object) $props,
|
||||
)
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Enqueue the CES survey on adding new product attributes.
|
||||
*/
|
||||
public function run_on_add_product_attributes() {
|
||||
if ( $this->has_been_shown( self::ADD_PRODUCT_ATTRIBUTES_ACTION_NAME ) ) {
|
||||
return;
|
||||
}
|
||||
|
||||
$this->enqueue_to_ces_tracks(
|
||||
array(
|
||||
'action' => self::ADD_PRODUCT_ATTRIBUTES_ACTION_NAME,
|
||||
'title' => __(
|
||||
'How easy was it to add a product attribute?',
|
||||
'woocommerce'
|
||||
),
|
||||
'firstQuestion' => __(
|
||||
'Product attributes are easy to use.',
|
||||
'woocommerce'
|
||||
),
|
||||
'secondQuestion' => __(
|
||||
'Product attributes\' functionality meets my needs.',
|
||||
'woocommerce'
|
||||
),
|
||||
'onsubmit_label' => $this->onsubmit_label,
|
||||
'pagenow' => 'product_page_product_attributes',
|
||||
'adminpage' => 'product_page_product_attributes',
|
||||
'props' => (object) array(),
|
||||
)
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Determine on initiating CES survey on searching for product or orders.
|
||||
*/
|
||||
public function run_on_load_edit_php() {
|
||||
$allowed_types = array( 'product', 'shop_order' );
|
||||
$post_type = get_current_screen()->post_type;
|
||||
|
||||
// We're only interested for certain post types.
|
||||
if ( ! in_array( $post_type, $allowed_types, true ) ) {
|
||||
return;
|
||||
}
|
||||
|
||||
// Determine whether request is search by "s" GET parameter.
|
||||
if ( empty( $_GET['s'] ) ) { // phpcs:disable WordPress.Security.NonceVerification.Recommended
|
||||
return;
|
||||
}
|
||||
|
||||
$page_now = 'edit-' . $post_type;
|
||||
$this->enqueue_ces_survey_for_search( $post_type, $page_now, 'edit-php' );
|
||||
}
|
||||
}
|
||||
273
wp/wp-content/plugins/woocommerce/src/Internal/Admin/Events.php
Normal file
273
wp/wp-content/plugins/woocommerce/src/Internal/Admin/Events.php
Normal file
@@ -0,0 +1,273 @@
|
||||
<?php
|
||||
/**
|
||||
* Handle cron events.
|
||||
*/
|
||||
|
||||
namespace Automattic\WooCommerce\Internal\Admin;
|
||||
|
||||
defined( 'ABSPATH' ) || exit;
|
||||
|
||||
use Automattic\WooCommerce\Admin\Features\Features;
|
||||
use Automattic\WooCommerce\Admin\RemoteInboxNotifications\DataSourcePoller;
|
||||
use Automattic\WooCommerce\Admin\RemoteInboxNotifications\RemoteInboxNotificationsEngine;
|
||||
use Automattic\WooCommerce\Internal\Admin\Notes\AddFirstProduct;
|
||||
use Automattic\WooCommerce\Internal\Admin\Notes\ChoosingTheme;
|
||||
use Automattic\WooCommerce\Internal\Admin\Notes\CouponPageMoved;
|
||||
use Automattic\WooCommerce\Internal\Admin\Notes\CustomizeStoreWithBlocks;
|
||||
use Automattic\WooCommerce\Internal\Admin\Notes\CustomizingProductCatalog;
|
||||
use Automattic\WooCommerce\Internal\Admin\Notes\EditProductsOnTheMove;
|
||||
use Automattic\WooCommerce\Internal\Admin\Notes\EUVATNumber;
|
||||
use Automattic\WooCommerce\Internal\Admin\Notes\FirstProduct;
|
||||
use Automattic\WooCommerce\Internal\Admin\Notes\InstallJPAndWCSPlugins;
|
||||
use Automattic\WooCommerce\Internal\Admin\Notes\LaunchChecklist;
|
||||
use Automattic\WooCommerce\Internal\Admin\Notes\MagentoMigration;
|
||||
use Automattic\WooCommerce\Internal\Admin\Notes\ManageOrdersOnTheGo;
|
||||
use Automattic\WooCommerce\Internal\Admin\Notes\MarketingJetpack;
|
||||
use Automattic\WooCommerce\Internal\Admin\Notes\MerchantEmailNotifications;
|
||||
use Automattic\WooCommerce\Internal\Admin\Notes\MigrateFromShopify;
|
||||
use Automattic\WooCommerce\Internal\Admin\Notes\MobileApp;
|
||||
use Automattic\WooCommerce\Internal\Admin\Notes\NewSalesRecord;
|
||||
use Automattic\WooCommerce\Internal\Admin\Notes\OnboardingPayments;
|
||||
use Automattic\WooCommerce\Internal\Admin\Notes\OnlineClothingStore;
|
||||
use Automattic\WooCommerce\Internal\Admin\Notes\OrderMilestones;
|
||||
use Automattic\WooCommerce\Internal\Admin\Notes\PaymentsMoreInfoNeeded;
|
||||
use Automattic\WooCommerce\Internal\Admin\Notes\PaymentsRemindMeLater;
|
||||
use Automattic\WooCommerce\Internal\Admin\Notes\PerformanceOnMobile;
|
||||
use Automattic\WooCommerce\Internal\Admin\Notes\PersonalizeStore;
|
||||
use Automattic\WooCommerce\Internal\Admin\Notes\RealTimeOrderAlerts;
|
||||
use Automattic\WooCommerce\Internal\Admin\Notes\SellingOnlineCourses;
|
||||
use Automattic\WooCommerce\Internal\Admin\Notes\TestCheckout;
|
||||
use Automattic\WooCommerce\Internal\Admin\Notes\TrackingOptIn;
|
||||
use Automattic\WooCommerce\Internal\Admin\Notes\UnsecuredReportFiles;
|
||||
use Automattic\WooCommerce\Internal\Admin\Notes\WooCommercePayments;
|
||||
use Automattic\WooCommerce\Internal\Admin\Notes\WooCommerceSubscriptions;
|
||||
use Automattic\WooCommerce\Internal\Admin\Notes\WooSubscriptionsNotes;
|
||||
use Automattic\WooCommerce\Internal\Admin\Schedulers\MailchimpScheduler;
|
||||
use Automattic\WooCommerce\Admin\Notes\Note;
|
||||
use Automattic\WooCommerce\Admin\Features\PaymentGatewaySuggestions\PaymentGatewaySuggestionsDataSourcePoller;
|
||||
use Automattic\WooCommerce\Internal\Admin\RemoteFreeExtensions\RemoteFreeExtensionsDataSourcePoller;
|
||||
|
||||
/**
|
||||
* Events Class.
|
||||
*/
|
||||
class Events {
|
||||
/**
|
||||
* The single instance of the class.
|
||||
*
|
||||
* @var object
|
||||
*/
|
||||
protected static $instance = null;
|
||||
|
||||
/**
|
||||
* Constructor
|
||||
*
|
||||
* @return void
|
||||
*/
|
||||
protected function __construct() {}
|
||||
|
||||
/**
|
||||
* Array of note class to be added or updated.
|
||||
*
|
||||
* @var array
|
||||
*/
|
||||
private static $note_classes_to_added_or_updated = array(
|
||||
AddFirstProduct::class,
|
||||
ChoosingTheme::class,
|
||||
CustomizeStoreWithBlocks::class,
|
||||
CustomizingProductCatalog::class,
|
||||
EditProductsOnTheMove::class,
|
||||
EUVATNumber::class,
|
||||
FirstProduct::class,
|
||||
LaunchChecklist::class,
|
||||
MagentoMigration::class,
|
||||
ManageOrdersOnTheGo::class,
|
||||
MarketingJetpack::class,
|
||||
MigrateFromShopify::class,
|
||||
MobileApp::class,
|
||||
NewSalesRecord::class,
|
||||
OnboardingPayments::class,
|
||||
OnlineClothingStore::class,
|
||||
PaymentsMoreInfoNeeded::class,
|
||||
PaymentsRemindMeLater::class,
|
||||
PerformanceOnMobile::class,
|
||||
PersonalizeStore::class,
|
||||
RealTimeOrderAlerts::class,
|
||||
TestCheckout::class,
|
||||
TrackingOptIn::class,
|
||||
WooCommercePayments::class,
|
||||
WooCommerceSubscriptions::class,
|
||||
);
|
||||
|
||||
/**
|
||||
* The other note classes that are added in other places.
|
||||
*
|
||||
* @var array
|
||||
*/
|
||||
private static $other_note_classes = array(
|
||||
CouponPageMoved::class,
|
||||
InstallJPAndWCSPlugins::class,
|
||||
OrderMilestones::class,
|
||||
SellingOnlineCourses::class,
|
||||
UnsecuredReportFiles::class,
|
||||
WooSubscriptionsNotes::class,
|
||||
);
|
||||
|
||||
|
||||
/**
|
||||
* Get class instance.
|
||||
*
|
||||
* @return object Instance.
|
||||
*/
|
||||
final public static function instance() {
|
||||
if ( null === static::$instance ) {
|
||||
static::$instance = new static();
|
||||
}
|
||||
return static::$instance;
|
||||
}
|
||||
|
||||
/**
|
||||
* Cron event handlers.
|
||||
*/
|
||||
public function init() {
|
||||
add_action( 'wc_admin_daily', array( $this, 'do_wc_admin_daily' ) );
|
||||
add_filter( 'woocommerce_get_note_from_db', array( $this, 'get_note_from_db' ), 10, 1 );
|
||||
|
||||
// Initialize the WC_Notes_Refund_Returns Note to attach hook.
|
||||
\WC_Notes_Refund_Returns::init();
|
||||
}
|
||||
|
||||
/**
|
||||
* Daily events to run.
|
||||
*
|
||||
* Note: Order_Milestones::possibly_add_note is hooked to this as well.
|
||||
*/
|
||||
public function do_wc_admin_daily() {
|
||||
$this->possibly_add_notes();
|
||||
$this->possibly_delete_notes();
|
||||
$this->possibly_update_notes();
|
||||
$this->possibly_refresh_data_source_pollers();
|
||||
|
||||
if ( $this->is_remote_inbox_notifications_enabled() ) {
|
||||
DataSourcePoller::get_instance()->read_specs_from_data_sources();
|
||||
RemoteInboxNotificationsEngine::run();
|
||||
}
|
||||
|
||||
if ( $this->is_merchant_email_notifications_enabled() ) {
|
||||
MerchantEmailNotifications::run();
|
||||
}
|
||||
|
||||
if ( Features::is_enabled( 'onboarding' ) ) {
|
||||
( new MailchimpScheduler() )->run();
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Get note.
|
||||
*
|
||||
* @param Note $note_from_db The note object from the database.
|
||||
*/
|
||||
public function get_note_from_db( $note_from_db ) {
|
||||
if ( ! $note_from_db instanceof Note || get_user_locale() === $note_from_db->get_locale() ) {
|
||||
return $note_from_db;
|
||||
}
|
||||
|
||||
$note_classes = array_merge( self::$note_classes_to_added_or_updated, self::$other_note_classes );
|
||||
foreach ( $note_classes as $note_class ) {
|
||||
if ( defined( "$note_class::NOTE_NAME" ) && $note_class::NOTE_NAME === $note_from_db->get_name() ) {
|
||||
$note_from_class = method_exists( $note_class, 'get_note' ) ? $note_class::get_note() : null;
|
||||
|
||||
if ( $note_from_class instanceof Note ) {
|
||||
$note = clone $note_from_db;
|
||||
$note->set_title( $note_from_class->get_title() );
|
||||
$note->set_content( $note_from_class->get_content() );
|
||||
$note->set_actions( $note_from_class->get_actions() );
|
||||
return $note;
|
||||
}
|
||||
break;
|
||||
}
|
||||
}
|
||||
return $note_from_db;
|
||||
}
|
||||
|
||||
/**
|
||||
* Adds notes that should be added.
|
||||
*/
|
||||
protected function possibly_add_notes() {
|
||||
foreach ( self::$note_classes_to_added_or_updated as $note_class ) {
|
||||
if ( method_exists( $note_class, 'possibly_add_note' ) ) {
|
||||
$note_class::possibly_add_note();
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Deletes notes that should be deleted.
|
||||
*/
|
||||
protected function possibly_delete_notes() {
|
||||
PaymentsRemindMeLater::delete_if_not_applicable();
|
||||
PaymentsMoreInfoNeeded::delete_if_not_applicable();
|
||||
}
|
||||
|
||||
/**
|
||||
* Updates notes that should be updated.
|
||||
*/
|
||||
protected function possibly_update_notes() {
|
||||
foreach ( self::$note_classes_to_added_or_updated as $note_class ) {
|
||||
if ( method_exists( $note_class, 'possibly_update_note' ) ) {
|
||||
$note_class::possibly_update_note();
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Checks if remote inbox notifications are enabled.
|
||||
*
|
||||
* @return bool Whether remote inbox notifications are enabled.
|
||||
*/
|
||||
protected function is_remote_inbox_notifications_enabled() {
|
||||
// Check if the feature flag is disabled.
|
||||
if ( ! Features::is_enabled( 'remote-inbox-notifications' ) ) {
|
||||
return false;
|
||||
}
|
||||
|
||||
// Check if the site has opted out of marketplace suggestions.
|
||||
if ( get_option( 'woocommerce_show_marketplace_suggestions', 'yes' ) !== 'yes' ) {
|
||||
return false;
|
||||
}
|
||||
|
||||
// All checks have passed.
|
||||
return true;
|
||||
}
|
||||
|
||||
/**
|
||||
* Checks if merchant email notifications are enabled.
|
||||
*
|
||||
* @return bool Whether merchant email notifications are enabled.
|
||||
*/
|
||||
protected function is_merchant_email_notifications_enabled() {
|
||||
// Check if the feature flag is disabled.
|
||||
if ( get_option( 'woocommerce_merchant_email_notifications', 'no' ) !== 'yes' ) {
|
||||
return false;
|
||||
}
|
||||
|
||||
// All checks have passed.
|
||||
return true;
|
||||
}
|
||||
|
||||
/**
|
||||
* Refresh transient for the following DataSourcePollers on wc_admin_daily cron job.
|
||||
* - PaymentGatewaySuggestionsDataSourcePoller
|
||||
* - RemoteFreeExtensionsDataSourcePoller
|
||||
*/
|
||||
protected function possibly_refresh_data_source_pollers() {
|
||||
$completed_tasks = get_option( 'woocommerce_task_list_tracked_completed_tasks', array() );
|
||||
|
||||
if ( ! in_array( 'payments', $completed_tasks, true ) && ! in_array( 'woocommerce-payments', $completed_tasks, true ) ) {
|
||||
PaymentGatewaySuggestionsDataSourcePoller::get_instance()->read_specs_from_data_sources();
|
||||
}
|
||||
|
||||
if ( ! in_array( 'store_details', $completed_tasks, true ) && ! in_array( 'marketing', $completed_tasks, true ) ) {
|
||||
RemoteFreeExtensionsDataSourcePoller::get_instance()->read_specs_from_data_sources();
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,238 @@
|
||||
<?php
|
||||
/**
|
||||
* WooCommerce Admin: Feature plugin main class.
|
||||
*/
|
||||
|
||||
namespace Automattic\WooCommerce\Internal\Admin;
|
||||
|
||||
defined( 'ABSPATH' ) || exit;
|
||||
|
||||
use Automattic\WooCommerce\Admin\API;
|
||||
use Automattic\WooCommerce\Admin\Notes\Notes;
|
||||
use Automattic\WooCommerce\Internal\Admin\Notes\OrderMilestones;
|
||||
use Automattic\WooCommerce\Internal\Admin\Notes\WooSubscriptionsNotes;
|
||||
use Automattic\WooCommerce\Internal\Admin\Notes\TrackingOptIn;
|
||||
use Automattic\WooCommerce\Internal\Admin\Notes\WooCommercePayments;
|
||||
use Automattic\WooCommerce\Internal\Admin\Notes\InstallJPAndWCSPlugins;
|
||||
use Automattic\WooCommerce\Internal\Admin\Notes\TestCheckout;
|
||||
use Automattic\WooCommerce\Internal\Admin\Notes\SellingOnlineCourses;
|
||||
use Automattic\WooCommerce\Internal\Admin\Notes\MerchantEmailNotifications;
|
||||
use Automattic\WooCommerce\Internal\Admin\Notes\MagentoMigration;
|
||||
use Automattic\WooCommerce\Admin\Features\Features;
|
||||
use Automattic\WooCommerce\Admin\PluginsHelper;
|
||||
use Automattic\WooCommerce\Admin\PluginsInstaller;
|
||||
use Automattic\WooCommerce\Admin\ReportExporter;
|
||||
use Automattic\WooCommerce\Admin\ReportsSync;
|
||||
use Automattic\WooCommerce\Internal\Admin\CategoryLookup;
|
||||
use Automattic\WooCommerce\Internal\Admin\Events;
|
||||
use Automattic\WooCommerce\Internal\Admin\Onboarding\Onboarding;
|
||||
|
||||
/**
|
||||
* Feature plugin main class.
|
||||
*
|
||||
* @internal This file will not be bundled with woo core, only the feature plugin.
|
||||
* @internal Note this is not called WC_Admin due to a class already existing in core with that name.
|
||||
*/
|
||||
class FeaturePlugin {
|
||||
/**
|
||||
* The single instance of the class.
|
||||
*
|
||||
* @var object
|
||||
*/
|
||||
protected static $instance = null;
|
||||
|
||||
/**
|
||||
* Constructor
|
||||
*
|
||||
* @return void
|
||||
*/
|
||||
protected function __construct() {}
|
||||
|
||||
/**
|
||||
* Get class instance.
|
||||
*
|
||||
* @return object Instance.
|
||||
*/
|
||||
final public static function instance() {
|
||||
if ( null === static::$instance ) {
|
||||
static::$instance = new static();
|
||||
}
|
||||
return static::$instance;
|
||||
}
|
||||
|
||||
/**
|
||||
* Init the feature plugin, only if we can detect both Gutenberg and WooCommerce.
|
||||
*/
|
||||
public function init() {
|
||||
// Bail if WC isn't initialized (This can be called from WCAdmin's entrypoint).
|
||||
if ( ! defined( 'WC_ABSPATH' ) ) {
|
||||
return;
|
||||
}
|
||||
|
||||
// Load the page controller functions file first to prevent fatal errors when disabling WooCommerce Admin.
|
||||
$this->define_constants();
|
||||
require_once WC_ADMIN_ABSPATH . '/includes/react-admin/page-controller-functions.php';
|
||||
require_once WC_ADMIN_ABSPATH . '/src/Admin/Notes/DeprecatedNotes.php';
|
||||
require_once WC_ADMIN_ABSPATH . '/includes/react-admin/core-functions.php';
|
||||
require_once WC_ADMIN_ABSPATH . '/includes/react-admin/feature-config.php';
|
||||
require_once WC_ADMIN_ABSPATH . '/includes/react-admin/wc-admin-update-functions.php';
|
||||
require_once WC_ADMIN_ABSPATH . '/includes/react-admin/class-experimental-abtest.php';
|
||||
|
||||
if ( did_action( 'plugins_loaded' ) ) {
|
||||
self::on_plugins_loaded();
|
||||
} else {
|
||||
// Make sure we hook into `plugins_loaded` before core's Automattic\WooCommerce\Package::init().
|
||||
// If core is network activated but we aren't, the packaged version of WooCommerce Admin will
|
||||
// attempt to use a data store that hasn't been loaded yet - because we've defined our constants here.
|
||||
// See: https://github.com/woocommerce/woocommerce-admin/issues/3869.
|
||||
add_action( 'plugins_loaded', array( $this, 'on_plugins_loaded' ), 9 );
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Setup plugin once all other plugins are loaded.
|
||||
*
|
||||
* @return void
|
||||
*/
|
||||
public function on_plugins_loaded() {
|
||||
$this->hooks();
|
||||
$this->includes();
|
||||
}
|
||||
|
||||
/**
|
||||
* Define Constants.
|
||||
*/
|
||||
protected function define_constants() {
|
||||
$this->define( 'WC_ADMIN_APP', 'wc-admin-app' );
|
||||
$this->define( 'WC_ADMIN_ABSPATH', WC_ABSPATH );
|
||||
$this->define( 'WC_ADMIN_DIST_JS_FOLDER', 'assets/client/admin/' );
|
||||
$this->define( 'WC_ADMIN_DIST_CSS_FOLDER', 'assets/client/admin/' );
|
||||
$this->define( 'WC_ADMIN_PLUGIN_FILE', WC_PLUGIN_FILE );
|
||||
|
||||
/**
|
||||
* Define the WC Admin Images Folder URL.
|
||||
*
|
||||
* @deprecated 6.7.0
|
||||
* @var string
|
||||
*/
|
||||
if ( ! defined( 'WC_ADMIN_IMAGES_FOLDER_URL' ) ) {
|
||||
/**
|
||||
* Define the WC Admin Images Folder URL.
|
||||
*
|
||||
* @deprecated 6.7.0
|
||||
* @var string
|
||||
*/
|
||||
define( 'WC_ADMIN_IMAGES_FOLDER_URL', plugins_url( 'assets/images', WC_PLUGIN_FILE ) );
|
||||
}
|
||||
|
||||
/**
|
||||
* Define the current WC Admin version.
|
||||
*
|
||||
* @deprecated 6.4.0
|
||||
* @var string
|
||||
*/
|
||||
if ( ! defined( 'WC_ADMIN_VERSION_NUMBER' ) ) {
|
||||
/**
|
||||
* Define the current WC Admin version.
|
||||
*
|
||||
* @deprecated 6.4.0
|
||||
* @var string
|
||||
*/
|
||||
define( 'WC_ADMIN_VERSION_NUMBER', '3.3.0' );
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Include WC Admin classes.
|
||||
*/
|
||||
public function includes() {
|
||||
// Initialize Database updates, option migrations, and Notes.
|
||||
Events::instance()->init();
|
||||
Notes::init();
|
||||
|
||||
// Initialize Plugins Installer.
|
||||
PluginsInstaller::init();
|
||||
PluginsHelper::init();
|
||||
|
||||
// Initialize API.
|
||||
API\Init::instance();
|
||||
|
||||
if ( Features::is_enabled( 'onboarding' ) ) {
|
||||
Onboarding::init();
|
||||
}
|
||||
|
||||
if ( Features::is_enabled( 'analytics' ) ) {
|
||||
// Initialize Reports syncing.
|
||||
ReportsSync::init();
|
||||
CategoryLookup::instance()->init();
|
||||
|
||||
// Initialize Reports exporter.
|
||||
ReportExporter::init();
|
||||
}
|
||||
|
||||
// Admin note providers.
|
||||
// @todo These should be bundled in the features/ folder, but loading them from there currently has a load order issue.
|
||||
new WooSubscriptionsNotes();
|
||||
new OrderMilestones();
|
||||
new TrackingOptIn();
|
||||
new WooCommercePayments();
|
||||
new InstallJPAndWCSPlugins();
|
||||
new TestCheckout();
|
||||
new SellingOnlineCourses();
|
||||
new MagentoMigration();
|
||||
|
||||
// Initialize MerchantEmailNotifications.
|
||||
MerchantEmailNotifications::init();
|
||||
}
|
||||
|
||||
/**
|
||||
* Set up our admin hooks and plugin loader.
|
||||
*/
|
||||
protected function hooks() {
|
||||
add_filter( 'woocommerce_admin_features', array( $this, 'replace_supported_features' ), 0 );
|
||||
|
||||
Loader::get_instance();
|
||||
WCAdminAssets::get_instance();
|
||||
}
|
||||
|
||||
|
||||
/**
|
||||
* Overwrites the allowed features array using a local `feature-config.php` file.
|
||||
*
|
||||
* @param array $features Array of feature slugs.
|
||||
*/
|
||||
public function replace_supported_features( $features ) {
|
||||
/**
|
||||
* Get additional feature config
|
||||
*
|
||||
* @since 6.5.0
|
||||
*/
|
||||
$feature_config = apply_filters( 'woocommerce_admin_get_feature_config', wc_admin_get_feature_config() );
|
||||
$features = array_keys( array_filter( $feature_config ) );
|
||||
return $features;
|
||||
}
|
||||
|
||||
/**
|
||||
* Define constant if not already set.
|
||||
*
|
||||
* @param string $name Constant name.
|
||||
* @param string|bool $value Constant value.
|
||||
*/
|
||||
protected function define( $name, $value ) {
|
||||
if ( ! defined( $name ) ) {
|
||||
define( $name, $value );
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Prevent cloning.
|
||||
*/
|
||||
private function __clone() {}
|
||||
|
||||
/**
|
||||
* Prevent unserializing.
|
||||
*/
|
||||
public function __wakeup() {
|
||||
die();
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,269 @@
|
||||
<?php
|
||||
/**
|
||||
* WooCommerce Homescreen.
|
||||
*/
|
||||
|
||||
namespace Automattic\WooCommerce\Internal\Admin;
|
||||
|
||||
use Automattic\WooCommerce\Admin\Features\Features;
|
||||
use Automattic\WooCommerce\Admin\Features\OnboardingTasks\Tasks\Shipping;
|
||||
|
||||
/**
|
||||
* Contains backend logic for the homescreen feature.
|
||||
*/
|
||||
class Homescreen {
|
||||
/**
|
||||
* Menu slug.
|
||||
*/
|
||||
const MENU_SLUG = 'wc-admin';
|
||||
|
||||
/**
|
||||
* Class instance.
|
||||
*
|
||||
* @var Homescreen 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_filter( 'woocommerce_admin_get_user_data_fields', array( $this, 'add_user_data_fields' ) );
|
||||
add_action( 'admin_menu', array( $this, 'register_page' ) );
|
||||
// In WC Core 5.1 $submenu manipulation occurs in admin_menu, not admin_head. See https://github.com/woocommerce/woocommerce/pull/29088.
|
||||
if ( version_compare( WC_VERSION, '5.1', '>=' ) ) {
|
||||
// priority is 20 to run after admin_menu hook for woocommerce runs, so that submenu is populated.
|
||||
add_action( 'admin_menu', array( $this, 'possibly_remove_woocommerce_menu' ) );
|
||||
add_action( 'admin_menu', array( $this, 'update_link_structure' ), 20 );
|
||||
} else {
|
||||
// priority is 20 to run after https://github.com/woocommerce/woocommerce/blob/a55ae325306fc2179149ba9b97e66f32f84fdd9c/includes/admin/class-wc-admin-menus.php#L165.
|
||||
add_action( 'admin_head', array( $this, 'update_link_structure' ), 20 );
|
||||
}
|
||||
|
||||
add_filter( 'woocommerce_admin_preload_options', array( $this, 'preload_options' ) );
|
||||
|
||||
if ( Features::is_enabled( 'shipping-smart-defaults' ) ) {
|
||||
add_filter(
|
||||
'woocommerce_admin_shared_settings',
|
||||
array( $this, 'maybe_set_default_shipping_options_on_home' ),
|
||||
9999
|
||||
);
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Set free shipping in the same country as the store default
|
||||
* Flag rate in all other countries when any of the following conditions are ture
|
||||
*
|
||||
* - The store sells physical products, has JP and WCS installed and connected, and is located in the US.
|
||||
* - The store sells physical products, and is not located in US/Canada/Australia/UK (irrelevant if JP is installed or not).
|
||||
* - The store sells physical products and is located in US, but JP and WCS are not installed.
|
||||
*
|
||||
* @param array $settings shared admin settings.
|
||||
* @return array
|
||||
*/
|
||||
public function maybe_set_default_shipping_options_on_home( $settings ) {
|
||||
if ( ! function_exists( 'get_current_screen' ) ) {
|
||||
return $settings;
|
||||
}
|
||||
|
||||
$current_screen = get_current_screen();
|
||||
|
||||
// Abort if it's not the homescreen.
|
||||
if ( ! isset( $current_screen->id ) || 'woocommerce_page_wc-admin' !== $current_screen->id ) {
|
||||
return $settings;
|
||||
}
|
||||
|
||||
// Abort if we already created the shipping options.
|
||||
$already_created = get_option( 'woocommerce_admin_created_default_shipping_zones' );
|
||||
if ( $already_created === 'yes' ) {
|
||||
return $settings;
|
||||
}
|
||||
|
||||
$zone_count = count( \WC_Data_Store::load( 'shipping-zone' )->get_zones() );
|
||||
if ( $zone_count ) {
|
||||
update_option( 'woocommerce_admin_created_default_shipping_zones', 'yes' );
|
||||
update_option( 'woocommerce_admin_reviewed_default_shipping_zones', 'yes' );
|
||||
return $settings;
|
||||
}
|
||||
|
||||
$user_skipped_obw = $settings['onboarding']['profile']['skipped'] ?? false;
|
||||
$store_address = $settings['preloadSettings']['general']['woocommerce_store_address'] ?? '';
|
||||
$product_types = $settings['onboarding']['profile']['product_types'] ?? array();
|
||||
$user_has_set_store_country = $settings['onboarding']['profile']['is_store_country_set'] ?? false;
|
||||
|
||||
// Do not proceed if user has not filled out their country in the onboarding profiler.
|
||||
if ( ! $user_has_set_store_country ) {
|
||||
return $settings;
|
||||
}
|
||||
|
||||
// If user skipped the obw or has not completed the store_details
|
||||
// then we assume the user is going to sell physical products.
|
||||
if ( $user_skipped_obw || '' === $store_address ) {
|
||||
$product_types[] = 'physical';
|
||||
}
|
||||
|
||||
if ( false === in_array( 'physical', $product_types, true ) ) {
|
||||
return $settings;
|
||||
}
|
||||
|
||||
$country_code = wc_format_country_state_string( $settings['preloadSettings']['general']['woocommerce_default_country'] )['country'];
|
||||
$country_name = WC()->countries->get_countries()[ $country_code ] ?? null;
|
||||
|
||||
$is_jetpack_installed = in_array( 'jetpack', $settings['plugins']['installedPlugins'] ?? array(), true );
|
||||
$is_wcs_installed = in_array( 'woocommerce-services', $settings['plugins']['installedPlugins'] ?? array(), true );
|
||||
|
||||
if (
|
||||
( 'US' === $country_code && $is_jetpack_installed )
|
||||
||
|
||||
( ! in_array( $country_code, array( 'CA', 'AU', 'GB', 'ES', 'IT', 'DE', 'FR', 'MX', 'CO', 'CL', 'AR', 'PE', 'BR', 'UY', 'GT', 'NL', 'AT', 'BE' ), true ) )
|
||||
||
|
||||
( 'US' === $country_code && false === $is_jetpack_installed && false === $is_wcs_installed )
|
||||
) {
|
||||
$zone = new \WC_Shipping_Zone();
|
||||
$zone->set_zone_name( $country_name );
|
||||
$zone->add_location( $country_code, 'country' );
|
||||
$zone->add_shipping_method( 'free_shipping' );
|
||||
update_option( 'woocommerce_admin_created_default_shipping_zones', 'yes' );
|
||||
Shipping::delete_zone_count_transient();
|
||||
}
|
||||
|
||||
return $settings;
|
||||
}
|
||||
|
||||
/**
|
||||
* Adds fields so that we can store performance indicators, row settings, and chart type settings for users.
|
||||
*
|
||||
* @param array $user_data_fields User data fields.
|
||||
* @return array
|
||||
*/
|
||||
public function add_user_data_fields( $user_data_fields ) {
|
||||
return array_merge(
|
||||
$user_data_fields,
|
||||
array(
|
||||
'homepage_layout',
|
||||
'homepage_stats',
|
||||
'task_list_tracked_started_tasks',
|
||||
'help_panel_highlight_shown',
|
||||
)
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Registers home page.
|
||||
*/
|
||||
public function register_page() {
|
||||
// Register a top-level item for users who cannot view the core WooCommerce menu.
|
||||
if ( ! self::is_admin_user() ) {
|
||||
wc_admin_register_page(
|
||||
array(
|
||||
'id' => 'woocommerce-home',
|
||||
'title' => __( 'WooCommerce', 'woocommerce' ),
|
||||
'path' => self::MENU_SLUG,
|
||||
'capability' => 'read',
|
||||
)
|
||||
);
|
||||
return;
|
||||
}
|
||||
|
||||
wc_admin_register_page(
|
||||
array(
|
||||
'id' => 'woocommerce-home',
|
||||
'title' => __( 'Home', 'woocommerce' ),
|
||||
'parent' => 'woocommerce',
|
||||
'path' => self::MENU_SLUG,
|
||||
'order' => 0,
|
||||
'capability' => 'read',
|
||||
)
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Check if the user can access the top-level WooCommerce item.
|
||||
*
|
||||
* @return bool
|
||||
*/
|
||||
public static function is_admin_user() {
|
||||
if ( ! class_exists( 'WC_Admin_Menus', false ) ) {
|
||||
include_once WC_ABSPATH . 'includes/admin/class-wc-admin-menus.php';
|
||||
}
|
||||
if ( method_exists( 'WC_Admin_Menus', 'can_view_woocommerce_menu_item' ) ) {
|
||||
return \WC_Admin_Menus::can_view_woocommerce_menu_item() || current_user_can( 'manage_woocommerce' );
|
||||
} else {
|
||||
// We leave this line for WC versions <= 6.2.
|
||||
return current_user_can( 'edit_others_shop_orders' ) || current_user_can( 'manage_woocommerce' );
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Possibly remove the WooCommerce menu item if it was purely used to access wc-admin pages.
|
||||
*/
|
||||
public function possibly_remove_woocommerce_menu() {
|
||||
global $menu;
|
||||
|
||||
if ( self::is_admin_user() ) {
|
||||
return;
|
||||
}
|
||||
|
||||
foreach ( $menu as $key => $menu_item ) {
|
||||
if ( self::MENU_SLUG !== $menu_item[2] || 'read' !== $menu_item[1] ) {
|
||||
continue;
|
||||
}
|
||||
|
||||
unset( $menu[ $key ] );
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Update the WooCommerce menu structure to make our main dashboard/handler
|
||||
* the top level link for 'WooCommerce'.
|
||||
*/
|
||||
public function update_link_structure() {
|
||||
global $submenu;
|
||||
// User does not have capabilites to see the submenu.
|
||||
if ( ! current_user_can( 'manage_woocommerce' ) || empty( $submenu['woocommerce'] ) ) {
|
||||
return;
|
||||
}
|
||||
|
||||
$wc_admin_key = null;
|
||||
foreach ( $submenu['woocommerce'] as $submenu_key => $submenu_item ) {
|
||||
if ( self::MENU_SLUG === $submenu_item[2] ) {
|
||||
$wc_admin_key = $submenu_key;
|
||||
break;
|
||||
}
|
||||
}
|
||||
|
||||
if ( ! $wc_admin_key ) {
|
||||
return;
|
||||
}
|
||||
|
||||
$menu = $submenu['woocommerce'][ $wc_admin_key ];
|
||||
|
||||
// Move menu item to top of array.
|
||||
unset( $submenu['woocommerce'][ $wc_admin_key ] );
|
||||
array_unshift( $submenu['woocommerce'], $menu );
|
||||
}
|
||||
|
||||
/**
|
||||
* Preload options to prime state of the application.
|
||||
*
|
||||
* @param array $options Array of options to preload.
|
||||
* @return array
|
||||
*/
|
||||
public function preload_options( $options ) {
|
||||
$options[] = 'woocommerce_default_homepage_layout';
|
||||
$options[] = 'woocommerce_admin_install_timestamp';
|
||||
|
||||
return $options;
|
||||
}
|
||||
}
|
||||
572
wp/wp-content/plugins/woocommerce/src/Internal/Admin/Loader.php
Normal file
572
wp/wp-content/plugins/woocommerce/src/Internal/Admin/Loader.php
Normal file
@@ -0,0 +1,572 @@
|
||||
<?php
|
||||
/**
|
||||
* Register the scripts, styles, and includes needed for pieces of the WooCommerce Admin experience.
|
||||
*/
|
||||
|
||||
namespace Automattic\WooCommerce\Internal\Admin;
|
||||
|
||||
use Automattic\WooCommerce\Admin\Features\Features;
|
||||
use Automattic\WooCommerce\Admin\PageController;
|
||||
use Automattic\WooCommerce\Admin\PluginsHelper;
|
||||
use Automattic\WooCommerce\Internal\Admin\ProductReviews\Reviews;
|
||||
use Automattic\WooCommerce\Internal\Admin\ProductReviews\ReviewsCommentsOverrides;
|
||||
use Automattic\WooCommerce\Internal\Admin\Settings;
|
||||
|
||||
/**
|
||||
* Loader Class.
|
||||
*/
|
||||
class Loader {
|
||||
/**
|
||||
* Class instance.
|
||||
*
|
||||
* @var Loader instance
|
||||
*/
|
||||
protected static $instance = null;
|
||||
|
||||
/**
|
||||
* An array of classes to load from the includes folder.
|
||||
*
|
||||
* @var array
|
||||
*/
|
||||
protected static $classes = array();
|
||||
|
||||
/**
|
||||
* WordPress capability required to use analytics features.
|
||||
*
|
||||
* @var string
|
||||
*/
|
||||
protected static $required_capability = null;
|
||||
|
||||
/**
|
||||
* An array of dependencies that have been preloaded (to avoid duplicates).
|
||||
*
|
||||
* @var array
|
||||
*/
|
||||
protected $preloaded_dependencies = array(
|
||||
'script' => array(),
|
||||
'style' => array(),
|
||||
);
|
||||
|
||||
/**
|
||||
* Get class instance.
|
||||
*/
|
||||
public static function get_instance() {
|
||||
if ( ! self::$instance ) {
|
||||
self::$instance = new self();
|
||||
}
|
||||
return self::$instance;
|
||||
}
|
||||
|
||||
/**
|
||||
* Constructor.
|
||||
* Hooks added here should be removed in `wc_admin_initialize` via the feature plugin.
|
||||
*/
|
||||
public function __construct() {
|
||||
Features::get_instance();
|
||||
WCAdminSharedSettings::get_instance();
|
||||
Translations::get_instance();
|
||||
WCAdminUser::get_instance();
|
||||
Settings::get_instance();
|
||||
SiteHealth::get_instance();
|
||||
SystemStatusReport::get_instance();
|
||||
|
||||
wc_get_container()->get( Reviews::class );
|
||||
wc_get_container()->get( ReviewsCommentsOverrides::class );
|
||||
|
||||
add_filter( 'admin_body_class', array( __CLASS__, 'add_admin_body_classes' ) );
|
||||
add_filter( 'admin_title', array( __CLASS__, 'update_admin_title' ) );
|
||||
add_action( 'in_admin_header', array( __CLASS__, 'embed_page_header' ) );
|
||||
add_action( 'admin_head', array( __CLASS__, 'remove_notices' ) );
|
||||
add_action( 'admin_head', array( __CLASS__, 'smart_app_banner' ) );
|
||||
add_action( 'admin_notices', array( __CLASS__, 'inject_before_notices' ), -9999 );
|
||||
add_action( 'admin_notices', array( __CLASS__, 'inject_after_notices' ), PHP_INT_MAX );
|
||||
|
||||
// Added this hook to delete the field woocommerce_onboarding_homepage_post_id when deleting the homepage.
|
||||
add_action( 'trashed_post', array( __CLASS__, 'delete_homepage' ) );
|
||||
|
||||
/*
|
||||
* Remove the emoji script as it always defaults to replacing emojis with Twemoji images.
|
||||
* Gutenberg has also disabled emojis. More on that here -> https://github.com/WordPress/gutenberg/pull/6151
|
||||
*/
|
||||
remove_action( 'admin_print_scripts', 'print_emoji_detection_script' );
|
||||
|
||||
add_action( 'admin_init', array( __CLASS__, 'deactivate_wc_admin_plugin' ) );
|
||||
}
|
||||
|
||||
/**
|
||||
* If WooCommerce Admin is installed and activated, it will attempt to deactivate and show a notice.
|
||||
*/
|
||||
public static function deactivate_wc_admin_plugin() {
|
||||
$plugin_path = PluginsHelper::get_plugin_path_from_slug( 'woocommerce-admin' );
|
||||
if ( is_plugin_active( $plugin_path ) ) {
|
||||
$path = PluginsHelper::get_plugin_path_from_slug( 'woocommerce-admin' );
|
||||
deactivate_plugins( $path );
|
||||
$notice_action = is_network_admin() ? 'network_admin_notices' : 'admin_notices';
|
||||
add_action(
|
||||
$notice_action,
|
||||
function() {
|
||||
echo '<div class="error"><p>';
|
||||
printf(
|
||||
/* translators: %s: is referring to the plugin's name. */
|
||||
esc_html__( 'The %1$s plugin has been deactivated as the latest improvements are now included with the %2$s plugin.', 'woocommerce' ),
|
||||
'<code>WooCommerce Admin</code>',
|
||||
'<code>WooCommerce</code>'
|
||||
);
|
||||
echo '</p></div>';
|
||||
}
|
||||
);
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Returns breadcrumbs for the current page.
|
||||
*/
|
||||
private static function get_embed_breadcrumbs() {
|
||||
return wc_admin_get_breadcrumbs();
|
||||
}
|
||||
|
||||
/**
|
||||
* Outputs breadcrumbs via PHP for the initial load of an embedded page.
|
||||
*
|
||||
* @param array $section Section to create breadcrumb from.
|
||||
*/
|
||||
private static function output_heading( $section ) {
|
||||
echo esc_html( $section );
|
||||
}
|
||||
|
||||
/**
|
||||
* Set up a div for the header embed to render into.
|
||||
* The initial contents here are meant as a place loader for when the PHP page initialy loads.
|
||||
*/
|
||||
public static function embed_page_header() {
|
||||
if ( ! PageController::is_admin_page() && ! PageController::is_embed_page() ) {
|
||||
return;
|
||||
}
|
||||
|
||||
if ( ! PageController::is_embed_page() ) {
|
||||
return;
|
||||
}
|
||||
|
||||
$sections = self::get_embed_breadcrumbs();
|
||||
$sections = is_array( $sections ) ? $sections : array( $sections );
|
||||
?>
|
||||
<div id="woocommerce-embedded-root" class="is-embed-loading">
|
||||
<div class="woocommerce-layout">
|
||||
<div class="woocommerce-layout__header is-embed-loading">
|
||||
<h1 class="woocommerce-layout__header-heading">
|
||||
<?php self::output_heading( end( $sections ) ); ?>
|
||||
</h1>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
<?php
|
||||
}
|
||||
|
||||
/**
|
||||
* Adds body classes to the main wp-admin wrapper, allowing us to better target elements in specific scenarios.
|
||||
*
|
||||
* @param string $admin_body_class Body class to add.
|
||||
*/
|
||||
public static function add_admin_body_classes( $admin_body_class = '' ) {
|
||||
if ( ! PageController::is_admin_or_embed_page() ) {
|
||||
return $admin_body_class;
|
||||
}
|
||||
|
||||
$classes = explode( ' ', trim( $admin_body_class ) );
|
||||
$classes[] = 'woocommerce-page';
|
||||
if ( PageController::is_embed_page() ) {
|
||||
$classes[] = 'woocommerce-embed-page';
|
||||
}
|
||||
|
||||
/**
|
||||
* Some routes or features like onboarding hide the wp-admin navigation and masterbar.
|
||||
* Setting `woocommerce_admin_is_loading` to true allows us to premeptively hide these
|
||||
* elements while the JS app loads.
|
||||
* This class needs to be removed by those feature components (like <ProfileWizard />).
|
||||
*
|
||||
* @param bool $is_loading If WooCommerce Admin is loading a fullscreen view.
|
||||
*/
|
||||
$is_loading = apply_filters( 'woocommerce_admin_is_loading', false );
|
||||
|
||||
if ( PageController::is_admin_page() && $is_loading ) {
|
||||
$classes[] = 'woocommerce-admin-is-loading';
|
||||
}
|
||||
|
||||
$admin_body_class = implode( ' ', array_unique( $classes ) );
|
||||
return " $admin_body_class ";
|
||||
}
|
||||
|
||||
/**
|
||||
* Adds an iOS "Smart App Banner" for display on iOS Safari.
|
||||
* See https://developer.apple.com/library/archive/documentation/AppleApplications/Reference/SafariWebContent/PromotingAppswithAppBanners/PromotingAppswithAppBanners.html
|
||||
*/
|
||||
public static function smart_app_banner() {
|
||||
if ( PageController::is_admin_or_embed_page() ) {
|
||||
echo "
|
||||
<meta name='apple-itunes-app' content='app-id=1389130815'>
|
||||
";
|
||||
}
|
||||
}
|
||||
|
||||
|
||||
/**
|
||||
* Removes notices that should not be displayed on WC Admin pages.
|
||||
*/
|
||||
public static function remove_notices() {
|
||||
if ( ! PageController::is_admin_or_embed_page() ) {
|
||||
return;
|
||||
}
|
||||
|
||||
// Hello Dolly.
|
||||
if ( function_exists( 'hello_dolly' ) ) {
|
||||
remove_action( 'admin_notices', 'hello_dolly' );
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Runs before admin notices action and hides them.
|
||||
*/
|
||||
public static function inject_before_notices() {
|
||||
if ( ! PageController::is_admin_or_embed_page() ) {
|
||||
return;
|
||||
}
|
||||
|
||||
// The JITMs won't be shown in the Onboarding Wizard.
|
||||
$is_onboarding = isset( $_GET['path'] ) && '/setup-wizard' === wc_clean( wp_unslash( $_GET['path'] ) ); // phpcs:ignore WordPress.Security.NonceVerification
|
||||
$maybe_hide_jitm = $is_onboarding ? '-hide' : '';
|
||||
|
||||
echo '<div class="woocommerce-layout__jitm' . sanitize_html_class( $maybe_hide_jitm ) . '" id="jp-admin-notices"></div>';
|
||||
|
||||
// Wrap the notices in a hidden div to prevent flickering before
|
||||
// they are moved elsewhere in the page by WordPress Core.
|
||||
echo '<div class="woocommerce-layout__notice-list-hide" id="wp__notice-list">';
|
||||
|
||||
if ( PageController::is_admin_page() ) {
|
||||
// Capture all notices and hide them. WordPress Core looks for
|
||||
// `.wp-header-end` and appends notices after it if found.
|
||||
// https://github.com/WordPress/WordPress/blob/f6a37e7d39e2534d05b9e542045174498edfe536/wp-admin/js/common.js#L737 .
|
||||
echo '<div class="wp-header-end" id="woocommerce-layout__notice-catcher"></div>';
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Runs after admin notices and closes div.
|
||||
*/
|
||||
public static function inject_after_notices() {
|
||||
if ( ! PageController::is_admin_or_embed_page() ) {
|
||||
return;
|
||||
}
|
||||
|
||||
// Close the hidden div used to prevent notices from flickering before
|
||||
// they are inserted elsewhere in the page.
|
||||
echo '</div>';
|
||||
}
|
||||
|
||||
/**
|
||||
* Edits Admin title based on section of wc-admin.
|
||||
*
|
||||
* @param string $admin_title Modifies admin title.
|
||||
* @todo Can we do some URL rewriting so we can figure out which page they are on server side?
|
||||
*/
|
||||
public static function update_admin_title( $admin_title ) {
|
||||
if (
|
||||
! did_action( 'current_screen' ) ||
|
||||
! PageController::is_admin_page()
|
||||
) {
|
||||
return $admin_title;
|
||||
}
|
||||
|
||||
$sections = self::get_embed_breadcrumbs();
|
||||
$pieces = array();
|
||||
|
||||
foreach ( $sections as $section ) {
|
||||
$pieces[] = is_array( $section ) ? $section[1] : $section;
|
||||
}
|
||||
|
||||
$pieces = array_reverse( $pieces );
|
||||
$title = implode( ' ‹ ', $pieces );
|
||||
|
||||
/* translators: %1$s: updated title, %2$s: blog info name */
|
||||
return sprintf( __( '%1$s ‹ %2$s', 'woocommerce' ), $title, get_bloginfo( 'name' ) );
|
||||
}
|
||||
|
||||
/**
|
||||
* Set up a div for the app to render into.
|
||||
*/
|
||||
public static function page_wrapper() {
|
||||
?>
|
||||
<div class="wrap">
|
||||
<div id="root"></div>
|
||||
</div>
|
||||
<?php
|
||||
}
|
||||
|
||||
/**
|
||||
* Hooks extra neccessary data into the component settings array already set in WooCommerce core.
|
||||
*
|
||||
* @param array $settings Array of component settings.
|
||||
* @return array Array of component settings.
|
||||
*/
|
||||
public static function add_component_settings( $settings ) {
|
||||
if ( ! is_admin() ) {
|
||||
return $settings;
|
||||
}
|
||||
|
||||
if ( ! function_exists( 'wc_blocks_container' ) ) {
|
||||
global $wp_locale;
|
||||
// inject data not available via older versions of wc_blocks/woo.
|
||||
$settings['orderStatuses'] = self::get_order_statuses( wc_get_order_statuses() );
|
||||
$settings['stockStatuses'] = self::get_order_statuses( wc_get_product_stock_status_options() );
|
||||
$settings['currency'] = self::get_currency_settings();
|
||||
$settings['locale'] = [
|
||||
'siteLocale' => isset( $settings['siteLocale'] )
|
||||
? $settings['siteLocale']
|
||||
: get_locale(),
|
||||
'userLocale' => isset( $settings['l10n']['userLocale'] )
|
||||
? $settings['l10n']['userLocale']
|
||||
: get_user_locale(),
|
||||
'weekdaysShort' => isset( $settings['l10n']['weekdaysShort'] )
|
||||
? $settings['l10n']['weekdaysShort']
|
||||
: array_values( $wp_locale->weekday_abbrev ),
|
||||
];
|
||||
}
|
||||
|
||||
$preload_data_endpoints = apply_filters( 'woocommerce_component_settings_preload_endpoints', array() );
|
||||
if ( class_exists( 'Jetpack' ) ) {
|
||||
$preload_data_endpoints['jetpackStatus'] = '/jetpack/v4/connection';
|
||||
}
|
||||
if ( ! empty( $preload_data_endpoints ) ) {
|
||||
$preload_data = array_reduce(
|
||||
array_values( $preload_data_endpoints ),
|
||||
'rest_preload_api_request'
|
||||
);
|
||||
}
|
||||
|
||||
$preload_options = apply_filters( 'woocommerce_admin_preload_options', array() );
|
||||
if ( ! empty( $preload_options ) ) {
|
||||
foreach ( $preload_options as $option ) {
|
||||
$settings['preloadOptions'][ $option ] = get_option( $option );
|
||||
}
|
||||
}
|
||||
|
||||
$preload_settings = apply_filters( 'woocommerce_admin_preload_settings', array() );
|
||||
if ( ! empty( $preload_settings ) ) {
|
||||
$setting_options = new \WC_REST_Setting_Options_V2_Controller();
|
||||
foreach ( $preload_settings as $group ) {
|
||||
$group_settings = $setting_options->get_group_settings( $group );
|
||||
$preload_settings = [];
|
||||
foreach ( $group_settings as $option ) {
|
||||
if ( array_key_exists( 'id', $option ) && array_key_exists( 'value', $option ) ) {
|
||||
$preload_settings[ $option['id'] ] = $option['value'];
|
||||
}
|
||||
}
|
||||
$settings['preloadSettings'][ $group ] = $preload_settings;
|
||||
}
|
||||
}
|
||||
|
||||
$user_controller = new \WP_REST_Users_Controller();
|
||||
$request = new \WP_REST_Request();
|
||||
$request->set_query_params( array( 'context' => 'edit' ) );
|
||||
$user_response = $user_controller->get_current_item( $request );
|
||||
$current_user_data = is_wp_error( $user_response ) ? (object) array() : $user_response->get_data();
|
||||
|
||||
$settings['currentUserData'] = $current_user_data;
|
||||
$settings['reviewsEnabled'] = get_option( 'woocommerce_enable_reviews' );
|
||||
$settings['manageStock'] = get_option( 'woocommerce_manage_stock' );
|
||||
$settings['commentModeration'] = get_option( 'comment_moderation' );
|
||||
$settings['notifyLowStockAmount'] = get_option( 'woocommerce_notify_low_stock_amount' );
|
||||
// @todo On merge, once plugin images are added to core WooCommerce, `wcAdminAssetUrl` can be retired,
|
||||
// and `wcAssetUrl` can be used in its place throughout the codebase.
|
||||
$settings['wcAdminAssetUrl'] = WC_ADMIN_IMAGES_FOLDER_URL;
|
||||
$settings['wcVersion'] = WC_VERSION;
|
||||
$settings['siteUrl'] = site_url();
|
||||
$settings['shopUrl'] = get_permalink( wc_get_page_id( 'shop' ) );
|
||||
$settings['homeUrl'] = home_url();
|
||||
$settings['dateFormat'] = get_option( 'date_format' );
|
||||
$settings['timeZone'] = wc_timezone_string();
|
||||
$settings['plugins'] = array(
|
||||
'installedPlugins' => PluginsHelper::get_installed_plugin_slugs(),
|
||||
'activePlugins' => Plugins::get_active_plugins(),
|
||||
);
|
||||
// Plugins that depend on changing the translation work on the server but not the client -
|
||||
// WooCommerce Branding is an example of this - so pass through the translation of
|
||||
// 'WooCommerce' to wcSettings.
|
||||
$settings['woocommerceTranslation'] = __( 'WooCommerce', 'woocommerce' );
|
||||
// We may have synced orders with a now-unregistered status.
|
||||
// E.g An extension that added statuses is now inactive or removed.
|
||||
$settings['unregisteredOrderStatuses'] = self::get_unregistered_order_statuses();
|
||||
// The separator used for attributes found in Variation titles.
|
||||
$settings['variationTitleAttributesSeparator'] = apply_filters( 'woocommerce_product_variation_title_attributes_separator', ' - ', new \WC_Product() );
|
||||
|
||||
if ( ! empty( $preload_data_endpoints ) ) {
|
||||
$settings['dataEndpoints'] = isset( $settings['dataEndpoints'] )
|
||||
? $settings['dataEndpoints']
|
||||
: [];
|
||||
foreach ( $preload_data_endpoints as $key => $endpoint ) {
|
||||
// Handle error case: rest_do_request() doesn't guarantee success.
|
||||
if ( empty( $preload_data[ $endpoint ] ) ) {
|
||||
$settings['dataEndpoints'][ $key ] = array();
|
||||
} else {
|
||||
$settings['dataEndpoints'][ $key ] = $preload_data[ $endpoint ]['body'];
|
||||
}
|
||||
}
|
||||
}
|
||||
$settings = self::get_custom_settings( $settings );
|
||||
if ( PageController::is_embed_page() ) {
|
||||
$settings['embedBreadcrumbs'] = self::get_embed_breadcrumbs();
|
||||
}
|
||||
|
||||
$settings['allowMarketplaceSuggestions'] = WC_Marketplace_Suggestions::allow_suggestions();
|
||||
$settings['connectNonce'] = wp_create_nonce( 'connect' );
|
||||
$settings['wcpay_welcome_page_connect_nonce'] = wp_create_nonce( 'wcpay-connect' );
|
||||
|
||||
return $settings;
|
||||
}
|
||||
|
||||
/**
|
||||
* Format order statuses by removing a leading 'wc-' if present.
|
||||
*
|
||||
* @param array $statuses Order statuses.
|
||||
* @return array formatted statuses.
|
||||
*/
|
||||
public static function get_order_statuses( $statuses ) {
|
||||
$formatted_statuses = array();
|
||||
foreach ( $statuses as $key => $value ) {
|
||||
$formatted_key = preg_replace( '/^wc-/', '', $key );
|
||||
$formatted_statuses[ $formatted_key ] = $value;
|
||||
}
|
||||
return $formatted_statuses;
|
||||
}
|
||||
|
||||
/**
|
||||
* Get all order statuses present in analytics tables that aren't registered.
|
||||
*
|
||||
* @return array Unregistered order statuses.
|
||||
*/
|
||||
public static function get_unregistered_order_statuses() {
|
||||
$registered_statuses = wc_get_order_statuses();
|
||||
$all_synced_statuses = OrdersDataStore::get_all_statuses();
|
||||
$unregistered_statuses = array_diff( $all_synced_statuses, array_keys( $registered_statuses ) );
|
||||
$formatted_status_keys = self::get_order_statuses( array_fill_keys( $unregistered_statuses, '' ) );
|
||||
$formatted_statuses = array_keys( $formatted_status_keys );
|
||||
|
||||
return array_combine( $formatted_statuses, $formatted_statuses );
|
||||
}
|
||||
|
||||
/**
|
||||
* Register the admin settings for use in the WC REST API
|
||||
*
|
||||
* @param array $groups Array of setting groups.
|
||||
* @return array
|
||||
*/
|
||||
public static function add_settings_group( $groups ) {
|
||||
$groups[] = array(
|
||||
'id' => 'wc_admin',
|
||||
'label' => __( 'WooCommerce Admin', 'woocommerce' ),
|
||||
'description' => __( 'Settings for WooCommerce admin reporting.', 'woocommerce' ),
|
||||
);
|
||||
return $groups;
|
||||
}
|
||||
|
||||
/**
|
||||
* Add WC Admin specific settings
|
||||
*
|
||||
* @param array $settings Array of settings in wc admin group.
|
||||
* @return array
|
||||
*/
|
||||
public static function add_settings( $settings ) {
|
||||
$unregistered_statuses = self::get_unregistered_order_statuses();
|
||||
$registered_statuses = self::get_order_statuses( wc_get_order_statuses() );
|
||||
$all_statuses = array_merge( $unregistered_statuses, $registered_statuses );
|
||||
|
||||
$settings[] = array(
|
||||
'id' => 'woocommerce_excluded_report_order_statuses',
|
||||
'option_key' => 'woocommerce_excluded_report_order_statuses',
|
||||
'label' => __( 'Excluded report order statuses', 'woocommerce' ),
|
||||
'description' => __( 'Statuses that should not be included when calculating report totals.', 'woocommerce' ),
|
||||
'default' => array( 'pending', 'cancelled', 'failed' ),
|
||||
'type' => 'multiselect',
|
||||
'options' => $all_statuses,
|
||||
);
|
||||
$settings[] = array(
|
||||
'id' => 'woocommerce_actionable_order_statuses',
|
||||
'option_key' => 'woocommerce_actionable_order_statuses',
|
||||
'label' => __( 'Actionable order statuses', 'woocommerce' ),
|
||||
'description' => __( 'Statuses that require extra action on behalf of the store admin.', 'woocommerce' ),
|
||||
'default' => array( 'processing', 'on-hold' ),
|
||||
'type' => 'multiselect',
|
||||
'options' => $all_statuses,
|
||||
);
|
||||
$settings[] = array(
|
||||
'id' => 'woocommerce_default_date_range',
|
||||
'option_key' => 'woocommerce_default_date_range',
|
||||
'label' => __( 'Default Date Range', 'woocommerce' ),
|
||||
'description' => __( 'Default Date Range', 'woocommerce' ),
|
||||
'default' => 'period=month&compare=previous_year',
|
||||
'type' => 'text',
|
||||
);
|
||||
return $settings;
|
||||
}
|
||||
|
||||
/**
|
||||
* Gets custom settings used for WC Admin.
|
||||
*
|
||||
* @param array $settings Array of settings to merge into.
|
||||
* @return array
|
||||
*/
|
||||
public static function get_custom_settings( $settings ) {
|
||||
$wc_rest_settings_options_controller = new \WC_REST_Setting_Options_Controller();
|
||||
$wc_admin_group_settings = $wc_rest_settings_options_controller->get_group_settings( 'wc_admin' );
|
||||
$settings['wcAdminSettings'] = array();
|
||||
|
||||
foreach ( $wc_admin_group_settings as $setting ) {
|
||||
if ( ! empty( $setting['id'] ) ) {
|
||||
$settings['wcAdminSettings'][ $setting['id'] ] = $setting['value'];
|
||||
}
|
||||
}
|
||||
return $settings;
|
||||
}
|
||||
|
||||
/**
|
||||
* Return an object defining the currecy options for the site's current currency
|
||||
*
|
||||
* @return array Settings for the current currency {
|
||||
* Array of settings.
|
||||
*
|
||||
* @type string $code Currency code.
|
||||
* @type string $precision Number of decimals.
|
||||
* @type string $symbol Symbol for currency.
|
||||
* }
|
||||
*/
|
||||
public static function get_currency_settings() {
|
||||
$code = get_woocommerce_currency();
|
||||
|
||||
return apply_filters(
|
||||
'wc_currency_settings',
|
||||
array(
|
||||
'code' => $code,
|
||||
'precision' => wc_get_price_decimals(),
|
||||
'symbol' => html_entity_decode( get_woocommerce_currency_symbol( $code ) ),
|
||||
'symbolPosition' => get_option( 'woocommerce_currency_pos' ),
|
||||
'decimalSeparator' => wc_get_price_decimal_separator(),
|
||||
'thousandSeparator' => wc_get_price_thousand_separator(),
|
||||
'priceFormat' => html_entity_decode( get_woocommerce_price_format() ),
|
||||
)
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Delete woocommerce_onboarding_homepage_post_id field when the homepage is deleted
|
||||
*
|
||||
* @param int $post_id The deleted post id.
|
||||
*/
|
||||
public static function delete_homepage( $post_id ) {
|
||||
if ( 'page' !== get_post_type( $post_id ) ) {
|
||||
return;
|
||||
}
|
||||
$homepage_id = intval( get_option( 'woocommerce_onboarding_homepage_post_id', false ) );
|
||||
if ( $homepage_id === $post_id ) {
|
||||
delete_option( 'woocommerce_onboarding_homepage_post_id' );
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,159 @@
|
||||
<?php
|
||||
/**
|
||||
* WooCommerce Marketing.
|
||||
*/
|
||||
|
||||
namespace Automattic\WooCommerce\Internal\Admin;
|
||||
|
||||
use Automattic\WooCommerce\Admin\Features\Features;
|
||||
use Automattic\WooCommerce\Admin\Marketing\InstalledExtensions;
|
||||
use Automattic\WooCommerce\Admin\PageController;
|
||||
|
||||
/**
|
||||
* Contains backend logic for the Marketing feature.
|
||||
*/
|
||||
class Marketing {
|
||||
|
||||
use CouponsMovedTrait;
|
||||
|
||||
/**
|
||||
* Class instance.
|
||||
*
|
||||
* @var Marketing 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() {
|
||||
if ( ! is_admin() ) {
|
||||
return;
|
||||
}
|
||||
|
||||
add_action( 'admin_menu', array( $this, 'register_pages' ), 5 );
|
||||
add_action( 'admin_menu', array( $this, 'add_parent_menu_item' ), 6 );
|
||||
|
||||
add_filter( 'woocommerce_admin_shared_settings', array( $this, 'component_settings' ), 30 );
|
||||
}
|
||||
|
||||
/**
|
||||
* Add main marketing menu item.
|
||||
*
|
||||
* Uses priority of 9 so other items can easily be added at the default priority (10).
|
||||
*/
|
||||
public function add_parent_menu_item() {
|
||||
if ( ! Features::is_enabled( 'navigation' ) ) {
|
||||
add_menu_page(
|
||||
__( 'Marketing', 'woocommerce' ),
|
||||
__( 'Marketing', 'woocommerce' ),
|
||||
'manage_woocommerce',
|
||||
'woocommerce-marketing',
|
||||
null,
|
||||
'dashicons-megaphone',
|
||||
58
|
||||
);
|
||||
}
|
||||
|
||||
PageController::get_instance()->connect_page(
|
||||
[
|
||||
'id' => 'woocommerce-marketing',
|
||||
'title' => 'Marketing',
|
||||
'capability' => 'manage_woocommerce',
|
||||
'path' => 'wc-admin&path=/marketing',
|
||||
]
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Registers report pages.
|
||||
*/
|
||||
public function register_pages() {
|
||||
$this->register_overview_page();
|
||||
|
||||
$controller = PageController::get_instance();
|
||||
$defaults = [
|
||||
'parent' => 'woocommerce-marketing',
|
||||
'existing_page' => false,
|
||||
];
|
||||
|
||||
$marketing_pages = apply_filters( 'woocommerce_marketing_menu_items', [] );
|
||||
foreach ( $marketing_pages as $marketing_page ) {
|
||||
if ( ! is_array( $marketing_page ) ) {
|
||||
continue;
|
||||
}
|
||||
|
||||
$marketing_page = array_merge( $defaults, $marketing_page );
|
||||
|
||||
if ( $marketing_page['existing_page'] ) {
|
||||
$controller->connect_page( $marketing_page );
|
||||
} else {
|
||||
$controller->register_page( $marketing_page );
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Register the main Marketing page, which is Marketing > Overview.
|
||||
*
|
||||
* This is done separately because we need to ensure the page is registered properly and
|
||||
* that the link is done properly. For some reason the normal page registration process
|
||||
* gives us the wrong menu link.
|
||||
*/
|
||||
protected function register_overview_page() {
|
||||
global $submenu;
|
||||
|
||||
// First register the page.
|
||||
PageController::get_instance()->register_page(
|
||||
[
|
||||
'id' => 'woocommerce-marketing-overview',
|
||||
'title' => __( 'Overview', 'woocommerce' ),
|
||||
'path' => 'wc-admin&path=/marketing',
|
||||
'parent' => 'woocommerce-marketing',
|
||||
'nav_args' => array(
|
||||
'parent' => 'woocommerce-marketing',
|
||||
'order' => 10,
|
||||
),
|
||||
]
|
||||
);
|
||||
|
||||
// Now fix the path, since register_page() gets it wrong.
|
||||
if ( ! isset( $submenu['woocommerce-marketing'] ) ) {
|
||||
return;
|
||||
}
|
||||
|
||||
foreach ( $submenu['woocommerce-marketing'] as &$item ) {
|
||||
// The "slug" (aka the path) is the third item in the array.
|
||||
if ( 0 === strpos( $item[2], 'wc-admin' ) ) {
|
||||
$item[2] = 'admin.php?page=' . $item[2];
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Add settings for marketing feature.
|
||||
*
|
||||
* @param array $settings Component settings.
|
||||
* @return array
|
||||
*/
|
||||
public function component_settings( $settings ) {
|
||||
// Bail early if not on a wc-admin powered page.
|
||||
if ( ! PageController::is_admin_page() ) {
|
||||
return $settings;
|
||||
}
|
||||
|
||||
$settings['marketing']['installedExtensions'] = InstalledExtensions::get_data();
|
||||
|
||||
return $settings;
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,217 @@
|
||||
<?php
|
||||
/**
|
||||
* Marketing Specs Handler
|
||||
*
|
||||
* Fetches the specifications for the marketing feature from WC.com API.
|
||||
*/
|
||||
|
||||
namespace Automattic\WooCommerce\Internal\Admin\Marketing;
|
||||
|
||||
/**
|
||||
* Marketing Specifications Class.
|
||||
*
|
||||
* @internal
|
||||
* @since x.x.x
|
||||
*/
|
||||
class MarketingSpecs {
|
||||
/**
|
||||
* Name of recommended plugins transient.
|
||||
*
|
||||
* @var string
|
||||
*/
|
||||
const RECOMMENDED_PLUGINS_TRANSIENT = 'wc_marketing_recommended_plugins';
|
||||
|
||||
/**
|
||||
* Name of knowledge base post transient.
|
||||
*
|
||||
* @var string
|
||||
*/
|
||||
const KNOWLEDGE_BASE_TRANSIENT = 'wc_marketing_knowledge_base';
|
||||
|
||||
/**
|
||||
* Slug of the category specifying marketing extensions on the WooCommerce.com store.
|
||||
*
|
||||
* @var string
|
||||
*/
|
||||
const MARKETING_EXTENSION_CATEGORY_SLUG = 'marketing';
|
||||
|
||||
/**
|
||||
* Slug of the subcategory specifying marketing channels on the WooCommerce.com store.
|
||||
*
|
||||
* @var string
|
||||
*/
|
||||
const MARKETING_CHANNEL_SUBCATEGORY_SLUG = 'sales-channels';
|
||||
|
||||
/**
|
||||
* Load recommended plugins from WooCommerce.com
|
||||
*
|
||||
* @return array
|
||||
*/
|
||||
public function get_recommended_plugins(): array {
|
||||
$plugins = get_transient( self::RECOMMENDED_PLUGINS_TRANSIENT );
|
||||
|
||||
if ( false === $plugins ) {
|
||||
$request = wp_remote_get(
|
||||
'https://woocommerce.com/wp-json/wccom/marketing-tab/1.2/recommendations.json',
|
||||
array(
|
||||
'user-agent' => 'WooCommerce/' . WC()->version . '; ' . get_bloginfo( 'url' ),
|
||||
)
|
||||
);
|
||||
$plugins = [];
|
||||
|
||||
if ( ! is_wp_error( $request ) && 200 === $request['response']['code'] ) {
|
||||
$plugins = json_decode( $request['body'], true );
|
||||
}
|
||||
|
||||
set_transient(
|
||||
self::RECOMMENDED_PLUGINS_TRANSIENT,
|
||||
$plugins,
|
||||
// Expire transient in 15 minutes if remote get failed.
|
||||
// Cache an empty result to avoid repeated failed requests.
|
||||
empty( $plugins ) ? 900 : 3 * DAY_IN_SECONDS
|
||||
);
|
||||
}
|
||||
|
||||
return array_values( $plugins );
|
||||
}
|
||||
|
||||
/**
|
||||
* Return only the recommended marketing channels from WooCommerce.com.
|
||||
*
|
||||
* @return array
|
||||
*/
|
||||
public function get_recommended_marketing_channels(): array {
|
||||
return array_filter( $this->get_recommended_plugins(), [ $this, 'is_marketing_channel_plugin' ] );
|
||||
}
|
||||
|
||||
/**
|
||||
* Return all recommended marketing extensions EXCEPT the marketing channels from WooCommerce.com.
|
||||
*
|
||||
* @return array
|
||||
*/
|
||||
public function get_recommended_marketing_extensions_excluding_channels(): array {
|
||||
return array_filter(
|
||||
$this->get_recommended_plugins(),
|
||||
function ( array $plugin_data ) {
|
||||
return $this->is_marketing_plugin( $plugin_data ) && ! $this->is_marketing_channel_plugin( $plugin_data );
|
||||
}
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Returns whether a plugin is a marketing extension.
|
||||
*
|
||||
* @param array $plugin_data The plugin properties returned by the API.
|
||||
*
|
||||
* @return bool
|
||||
*/
|
||||
protected function is_marketing_plugin( array $plugin_data ): bool {
|
||||
$categories = $plugin_data['categories'] ?? [];
|
||||
|
||||
return in_array( self::MARKETING_EXTENSION_CATEGORY_SLUG, $categories, true );
|
||||
}
|
||||
|
||||
/**
|
||||
* Returns whether a plugin is a marketing channel.
|
||||
*
|
||||
* @param array $plugin_data The plugin properties returned by the API.
|
||||
*
|
||||
* @return bool
|
||||
*/
|
||||
protected function is_marketing_channel_plugin( array $plugin_data ): bool {
|
||||
if ( ! $this->is_marketing_plugin( $plugin_data ) ) {
|
||||
return false;
|
||||
}
|
||||
|
||||
$subcategories = $plugin_data['subcategories'] ?? [];
|
||||
foreach ( $subcategories as $subcategory ) {
|
||||
if ( isset( $subcategory['slug'] ) && self::MARKETING_CHANNEL_SUBCATEGORY_SLUG === $subcategory['slug'] ) {
|
||||
return true;
|
||||
}
|
||||
}
|
||||
|
||||
return false;
|
||||
}
|
||||
|
||||
/**
|
||||
* Load knowledge base posts from WooCommerce.com
|
||||
*
|
||||
* @param string|null $category Category of posts to retrieve.
|
||||
* @return array
|
||||
*/
|
||||
public function get_knowledge_base_posts( ?string $category ): array {
|
||||
$kb_transient = self::KNOWLEDGE_BASE_TRANSIENT;
|
||||
|
||||
$categories = array(
|
||||
'marketing' => 1744,
|
||||
'coupons' => 25202,
|
||||
);
|
||||
|
||||
// Default to marketing category (if no category set on the kb component).
|
||||
if ( ! empty( $category ) && array_key_exists( $category, $categories ) ) {
|
||||
$category_id = $categories[ $category ];
|
||||
$kb_transient = $kb_transient . '_' . strtolower( $category );
|
||||
} else {
|
||||
$category_id = $categories['marketing'];
|
||||
}
|
||||
|
||||
$posts = get_transient( $kb_transient );
|
||||
|
||||
if ( false === $posts ) {
|
||||
$request_url = add_query_arg(
|
||||
array(
|
||||
'categories' => $category_id,
|
||||
'page' => 1,
|
||||
'per_page' => 8,
|
||||
'_embed' => 1,
|
||||
),
|
||||
'https://woocommerce.com/wp-json/wp/v2/posts?utm_medium=product'
|
||||
);
|
||||
|
||||
$request = wp_remote_get(
|
||||
$request_url,
|
||||
array(
|
||||
'user-agent' => 'WooCommerce/' . WC()->version . '; ' . get_bloginfo( 'url' ),
|
||||
)
|
||||
);
|
||||
$posts = [];
|
||||
|
||||
if ( ! is_wp_error( $request ) && 200 === $request['response']['code'] ) {
|
||||
$raw_posts = json_decode( $request['body'], true );
|
||||
|
||||
foreach ( $raw_posts as $raw_post ) {
|
||||
$post = [
|
||||
'title' => html_entity_decode( $raw_post['title']['rendered'] ),
|
||||
'date' => $raw_post['date_gmt'],
|
||||
'link' => $raw_post['link'],
|
||||
'author_name' => isset( $raw_post['author_name'] ) ? html_entity_decode( $raw_post['author_name'] ) : '',
|
||||
'author_avatar' => isset( $raw_post['author_avatar_url'] ) ? $raw_post['author_avatar_url'] : '',
|
||||
];
|
||||
|
||||
$featured_media = $raw_post['_embedded']['wp:featuredmedia'] ?? [];
|
||||
if ( count( $featured_media ) > 0 ) {
|
||||
$image = current( $featured_media );
|
||||
$post['image'] = add_query_arg(
|
||||
array(
|
||||
'resize' => '650,340',
|
||||
'crop' => 1,
|
||||
),
|
||||
$image['source_url']
|
||||
);
|
||||
}
|
||||
|
||||
$posts[] = $post;
|
||||
}
|
||||
}
|
||||
|
||||
set_transient(
|
||||
$kb_transient,
|
||||
$posts,
|
||||
// Expire transient in 15 minutes if remote get failed.
|
||||
empty( $posts ) ? 900 : DAY_IN_SECONDS
|
||||
);
|
||||
}
|
||||
|
||||
return $posts;
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,49 @@
|
||||
<?php
|
||||
|
||||
namespace Automattic\WooCommerce\Internal\Admin;
|
||||
|
||||
defined( 'ABSPATH' ) || exit;
|
||||
|
||||
/**
|
||||
* Determine if the mobile app banner shows on Android devices
|
||||
*/
|
||||
class MobileAppBanner {
|
||||
/**
|
||||
* Class instance.
|
||||
*
|
||||
* @var Analytics 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_filter( 'woocommerce_admin_get_user_data_fields', array( $this, 'add_user_data_fields' ) );
|
||||
}
|
||||
|
||||
/**
|
||||
* Adds fields so that we can store user preferences for the mobile app banner
|
||||
*
|
||||
* @param array $user_data_fields User data fields.
|
||||
* @return array
|
||||
*/
|
||||
public function add_user_data_fields( $user_data_fields ) {
|
||||
return array_merge(
|
||||
$user_data_fields,
|
||||
array(
|
||||
'android_app_banner_dismissed',
|
||||
)
|
||||
);
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,93 @@
|
||||
<?php
|
||||
/**
|
||||
* WooCommerce Admin: Add First Product.
|
||||
*
|
||||
* Adds a note (type `email`) to bring the client back to the store setup flow.
|
||||
*/
|
||||
|
||||
namespace Automattic\WooCommerce\Internal\Admin\Notes;
|
||||
|
||||
defined( 'ABSPATH' ) || exit;
|
||||
|
||||
use Automattic\WooCommerce\Admin\Notes\Note;
|
||||
use Automattic\WooCommerce\Admin\Notes\NoteTraits;
|
||||
|
||||
/**
|
||||
* Add_First_Product.
|
||||
*/
|
||||
class AddFirstProduct {
|
||||
/**
|
||||
* Note traits.
|
||||
*/
|
||||
use NoteTraits;
|
||||
|
||||
/**
|
||||
* Name of the note for use in the database.
|
||||
*/
|
||||
const NOTE_NAME = 'wc-admin-add-first-product-note';
|
||||
|
||||
/**
|
||||
* Get the note.
|
||||
*
|
||||
* @return Note
|
||||
*/
|
||||
public static function get_note() {
|
||||
if ( ! self::wc_admin_active_for( 2 * DAY_IN_SECONDS ) || self::wc_admin_active_for( 5 * DAY_IN_SECONDS ) ) {
|
||||
return;
|
||||
}
|
||||
|
||||
// Don't show if there is a product.
|
||||
$query = new \WC_Product_Query(
|
||||
array(
|
||||
'limit' => 1,
|
||||
'return' => 'ids',
|
||||
'status' => array( 'publish' ),
|
||||
)
|
||||
);
|
||||
$products = $query->get_products();
|
||||
if ( 0 !== count( $products ) ) {
|
||||
return;
|
||||
}
|
||||
|
||||
// Don't show if there is an orders.
|
||||
$args = array(
|
||||
'limit' => 1,
|
||||
'return' => 'ids',
|
||||
);
|
||||
$orders = wc_get_orders( $args );
|
||||
if ( 0 !== count( $orders ) ) {
|
||||
return;
|
||||
}
|
||||
|
||||
// If you're updating the following please use sprintf to separate HTML tags.
|
||||
// https://github.com/woocommerce/woocommerce-admin/pull/6617#discussion_r596889685.
|
||||
$content_lines = array(
|
||||
'{greetings}<br/><br/>',
|
||||
/* translators: %s: line break */
|
||||
sprintf( __( 'Nice one; you\'ve created a WooCommerce store! Now it\'s time to add your first product and get ready to start selling.%s', 'woocommerce' ), '<br/><br/>' ),
|
||||
__( 'There are three ways to add your products: you can <strong>create products manually, import them at once via CSV file</strong>, or <strong>migrate them from another service</strong>.<br/><br/>', 'woocommerce' ),
|
||||
/* translators: %1$s is an open anchor tag (<a>) and %2$s is a close link tag (</a>). */
|
||||
sprintf( __( '%1$1sExplore our docs%2$2s for more information, or just get started!', 'woocommerce' ), '<a href="https://woocommerce.com/document/managing-products/?utm_source=help_panel&utm_medium=product">', '</a>' ),
|
||||
);
|
||||
|
||||
$additional_data = array(
|
||||
'role' => 'administrator',
|
||||
);
|
||||
|
||||
$note = new Note();
|
||||
$note->set_title( __( 'Add your first product', 'woocommerce' ) );
|
||||
$note->set_content( implode( '', $content_lines ) );
|
||||
$note->set_content_data( (object) $additional_data );
|
||||
$note->set_image(
|
||||
plugins_url(
|
||||
'/images/admin_notes/dashboard-widget-setup.png',
|
||||
WC_ADMIN_PLUGIN_FILE
|
||||
)
|
||||
);
|
||||
$note->set_type( Note::E_WC_ADMIN_NOTE_EMAIL );
|
||||
$note->set_name( self::NOTE_NAME );
|
||||
$note->set_source( 'woocommerce-admin' );
|
||||
$note->add_action( 'add-first-product', __( 'Add a product', 'woocommerce' ), admin_url( 'admin.php?page=wc-admin&task=products' ) );
|
||||
return $note;
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,55 @@
|
||||
<?php
|
||||
/**
|
||||
* WooCommerce Admin (Dashboard) choosing a theme note
|
||||
*
|
||||
* Adds notes to the merchant's inbox about choosing a theme.
|
||||
*/
|
||||
|
||||
namespace Automattic\WooCommerce\Internal\Admin\Notes;
|
||||
|
||||
defined( 'ABSPATH' ) || exit;
|
||||
|
||||
use Automattic\WooCommerce\Admin\Notes\Note;
|
||||
use Automattic\WooCommerce\Admin\Notes\NoteTraits;
|
||||
|
||||
/**
|
||||
* Giving_Feedback_Notes
|
||||
*/
|
||||
class ChoosingTheme {
|
||||
/**
|
||||
* Note traits.
|
||||
*/
|
||||
use NoteTraits;
|
||||
|
||||
/**
|
||||
* Name of the note for use in the database.
|
||||
*/
|
||||
const NOTE_NAME = 'wc-admin-choosing-a-theme';
|
||||
|
||||
/**
|
||||
* Get the note.
|
||||
*
|
||||
* @return Note
|
||||
*/
|
||||
public static function get_note() {
|
||||
// We need to show choosing a theme notification after 1 day of install.
|
||||
if ( ! self::is_wc_admin_active_in_date_range( 'week-1', DAY_IN_SECONDS ) ) {
|
||||
return;
|
||||
}
|
||||
|
||||
// Otherwise, create our new note.
|
||||
$note = new Note();
|
||||
$note->set_title( __( 'Choosing a theme?', 'woocommerce' ) );
|
||||
$note->set_content( __( 'Check out the themes that are compatible with WooCommerce and choose one aligned with your brand and business needs.', 'woocommerce' ) );
|
||||
$note->set_content_data( (object) array() );
|
||||
$note->set_type( Note::E_WC_ADMIN_NOTE_MARKETING );
|
||||
$note->set_name( self::NOTE_NAME );
|
||||
$note->set_source( 'woocommerce-admin' );
|
||||
$note->add_action(
|
||||
'visit-the-theme-marketplace',
|
||||
__( 'Visit the theme marketplace', 'woocommerce' ),
|
||||
'https://woocommerce.com/product-category/themes/?utm_source=inbox&utm_medium=product'
|
||||
);
|
||||
return $note;
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,157 @@
|
||||
<?php
|
||||
/**
|
||||
* WooCommerce Admin Coupon Page Moved provider.
|
||||
*
|
||||
* Adds a notice when the store manager access the coupons page via the old WooCommerce > Coupons menu.
|
||||
*/
|
||||
|
||||
namespace Automattic\WooCommerce\Internal\Admin\Notes;
|
||||
|
||||
defined( 'ABSPATH' ) || exit;
|
||||
|
||||
use Automattic\WooCommerce\Admin\Notes\Note;
|
||||
use Automattic\WooCommerce\Admin\Notes\Notes;
|
||||
use Automattic\WooCommerce\Admin\Notes\NoteTraits;
|
||||
use Automattic\WooCommerce\Internal\Admin\CouponsMovedTrait;
|
||||
use stdClass;
|
||||
use WC_Data_Store;
|
||||
|
||||
/**
|
||||
* Coupon_Page_Moved class.
|
||||
*/
|
||||
class CouponPageMoved {
|
||||
|
||||
use NoteTraits, CouponsMovedTrait;
|
||||
|
||||
const NOTE_NAME = 'wc-admin-coupon-page-moved';
|
||||
|
||||
/**
|
||||
* Initialize our hooks.
|
||||
*/
|
||||
public function init() {
|
||||
if ( ! wc_coupons_enabled() ) {
|
||||
return;
|
||||
}
|
||||
|
||||
add_action( 'admin_init', [ $this, 'possibly_add_note' ] );
|
||||
add_action( 'admin_init', [ $this, 'redirect_to_coupons' ] );
|
||||
add_action( 'woocommerce_admin_newly_installed', [ $this, 'disable_legacy_menu_for_new_install' ] );
|
||||
}
|
||||
|
||||
/**
|
||||
* Checks if a note can and should be added.
|
||||
*
|
||||
* @return bool
|
||||
*/
|
||||
public static function can_be_added() {
|
||||
if ( ! wc_coupons_enabled() ) {
|
||||
return false;
|
||||
}
|
||||
|
||||
// Don't add the notice if the legacy coupon menu is already disabled.
|
||||
if ( ! self::should_display_legacy_menu() ) {
|
||||
return false;
|
||||
}
|
||||
|
||||
// Don't add the notice if it's been hidden by the user before.
|
||||
if ( self::has_dismissed_note() ) {
|
||||
return false;
|
||||
}
|
||||
|
||||
// If we already have a notice, don't add a new one.
|
||||
if ( self::has_unactioned_note() ) {
|
||||
return false;
|
||||
}
|
||||
|
||||
return isset( $_GET[ self::$query_key ] ) && (bool) $_GET[ self::$query_key ]; // phpcs:ignore WordPress.Security.NonceVerification
|
||||
}
|
||||
|
||||
/**
|
||||
* Get the note object for this class.
|
||||
*
|
||||
* @return Note
|
||||
*/
|
||||
public static function get_note() {
|
||||
$note = new Note();
|
||||
$note->set_title( __( 'Coupon management has moved!', 'woocommerce' ) );
|
||||
$note->set_content( __( 'Coupons can now be managed from Marketing > Coupons. Click the button below to remove the legacy WooCommerce > Coupons menu item.', 'woocommerce' ) );
|
||||
$note->set_type( Note::E_WC_ADMIN_NOTE_UPDATE );
|
||||
$note->set_name( self::NOTE_NAME );
|
||||
$note->set_content_data( new stdClass() );
|
||||
$note->set_source( 'woocommerce-admin' );
|
||||
$note->add_action(
|
||||
'remove-legacy-coupon-menu',
|
||||
__( 'Remove legacy coupon menu', 'woocommerce' ),
|
||||
wc_admin_url( '&action=remove-coupon-menu' ),
|
||||
Note::E_WC_ADMIN_NOTE_ACTIONED
|
||||
);
|
||||
|
||||
return $note;
|
||||
}
|
||||
|
||||
/**
|
||||
* Find notes that have not been actioned.
|
||||
*
|
||||
* @return bool
|
||||
*/
|
||||
protected static function has_unactioned_note() {
|
||||
$note = Notes::get_note_by_name( self::NOTE_NAME );
|
||||
|
||||
if ( ! $note ) {
|
||||
return false;
|
||||
}
|
||||
|
||||
return $note->get_status() === 'unactioned';
|
||||
}
|
||||
|
||||
/**
|
||||
* Whether any notes have been dismissed by the user previously.
|
||||
*
|
||||
* @return bool
|
||||
*/
|
||||
protected static function has_dismissed_note() {
|
||||
$note = Notes::get_note_by_name( self::NOTE_NAME );
|
||||
|
||||
if ( ! $note ) {
|
||||
return false;
|
||||
}
|
||||
|
||||
return ! $note->get_is_deleted();
|
||||
}
|
||||
|
||||
/**
|
||||
* Get the data store object.
|
||||
*
|
||||
* @return DataStore The data store object.
|
||||
*/
|
||||
protected static function get_data_store() {
|
||||
return WC_Data_Store::load( 'admin-note' );
|
||||
}
|
||||
|
||||
/**
|
||||
* Safe redirect to the coupon page to force page refresh.
|
||||
*/
|
||||
public function redirect_to_coupons() {
|
||||
/* phpcs:disable WordPress.Security.NonceVerification */
|
||||
if (
|
||||
! isset( $_GET['page'] ) ||
|
||||
'wc-admin' !== $_GET['page'] ||
|
||||
! isset( $_GET['action'] ) ||
|
||||
'remove-coupon-menu' !== $_GET['action'] ||
|
||||
! defined( 'WC_ADMIN_PLUGIN_FILE' )
|
||||
) {
|
||||
return;
|
||||
}
|
||||
/* phpcs:enable */
|
||||
$this->display_legacy_menu( false );
|
||||
wp_safe_redirect( self::get_management_url( 'coupons' ) );
|
||||
exit;
|
||||
}
|
||||
|
||||
/**
|
||||
* Disable legacy coupon menu when installing for the first time.
|
||||
*/
|
||||
public function disable_legacy_menu_for_new_install() {
|
||||
$this->display_legacy_menu( false );
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,86 @@
|
||||
<?php
|
||||
/**
|
||||
* WooCommerce Admin: Customize your online store with WooCommerce blocks.
|
||||
*
|
||||
* Adds a note to customize the client online store with WooCommerce blocks.
|
||||
*
|
||||
* @package WooCommerce\Admin
|
||||
*/
|
||||
|
||||
namespace Automattic\WooCommerce\Internal\Admin\Notes;
|
||||
|
||||
defined( 'ABSPATH' ) || exit;
|
||||
|
||||
use Automattic\WooCommerce\Admin\Notes\Note;
|
||||
use Automattic\WooCommerce\Admin\Notes\NoteTraits;
|
||||
|
||||
/**
|
||||
* Customize_Store_With_Blocks.
|
||||
*/
|
||||
class CustomizeStoreWithBlocks {
|
||||
/**
|
||||
* Note traits.
|
||||
*/
|
||||
use NoteTraits;
|
||||
|
||||
/**
|
||||
* Name of the note for use in the database.
|
||||
*/
|
||||
const NOTE_NAME = 'wc-admin-customize-store-with-blocks';
|
||||
|
||||
/**
|
||||
* Get the note.
|
||||
*
|
||||
* @return Note
|
||||
*/
|
||||
public static function get_note() {
|
||||
$onboarding_profile = get_option( 'woocommerce_onboarding_profile', array() );
|
||||
|
||||
// Confirm that $onboarding_profile is set.
|
||||
if ( empty( $onboarding_profile ) ) {
|
||||
return;
|
||||
}
|
||||
|
||||
// Make sure that the person who filled out the OBW was not setting up
|
||||
// the store for their customer/client.
|
||||
if (
|
||||
! isset( $onboarding_profile['setup_client'] ) ||
|
||||
$onboarding_profile['setup_client']
|
||||
) {
|
||||
return;
|
||||
}
|
||||
|
||||
// We want to show the note after fourteen days.
|
||||
if ( ! self::is_wc_admin_active_in_date_range( 'week-1-4', 14 * DAY_IN_SECONDS ) ) {
|
||||
return;
|
||||
}
|
||||
|
||||
// Don't show if there aren't products.
|
||||
$query = new \WC_Product_Query(
|
||||
array(
|
||||
'limit' => 1,
|
||||
'return' => 'ids',
|
||||
'status' => array( 'publish' ),
|
||||
)
|
||||
);
|
||||
$products = $query->get_products();
|
||||
if ( 0 === count( $products ) ) {
|
||||
return;
|
||||
}
|
||||
|
||||
$note = new Note();
|
||||
$note->set_title( __( 'Customize your online store with WooCommerce blocks', 'woocommerce' ) );
|
||||
$note->set_content( __( 'With our blocks, you can select and display products, categories, filters, and more virtually anywhere on your site — no need to use shortcodes or edit lines of code. Learn more about how to use each one of them.', 'woocommerce' ) );
|
||||
$note->set_type( Note::E_WC_ADMIN_NOTE_INFORMATIONAL );
|
||||
$note->set_name( self::NOTE_NAME );
|
||||
$note->set_content_data( (object) array() );
|
||||
$note->set_source( 'woocommerce-admin' );
|
||||
$note->add_action(
|
||||
'customize-store-with-blocks',
|
||||
__( 'Learn more', 'woocommerce' ),
|
||||
'https://woocommerce.com/posts/how-to-customize-your-online-store-with-woocommerce-blocks/?utm_source=inbox&utm_medium=product',
|
||||
Note::E_WC_ADMIN_NOTE_ACTIONED
|
||||
);
|
||||
return $note;
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,83 @@
|
||||
<?php
|
||||
/**
|
||||
* WooCommerce Admin: How to customize your product catalog note provider
|
||||
*
|
||||
* Adds a note with a link to the customizer a day after adding the first product
|
||||
*/
|
||||
|
||||
namespace Automattic\WooCommerce\Internal\Admin\Notes;
|
||||
|
||||
defined( 'ABSPATH' ) || exit;
|
||||
|
||||
use Automattic\WooCommerce\Admin\Notes\Note;
|
||||
use Automattic\WooCommerce\Admin\Notes\NoteTraits;
|
||||
|
||||
/**
|
||||
* Class CustomizingProductCatalog
|
||||
*
|
||||
* @package Automattic\WooCommerce\Admin\Notes
|
||||
*/
|
||||
class CustomizingProductCatalog {
|
||||
/**
|
||||
* Note traits.
|
||||
*/
|
||||
use NoteTraits;
|
||||
|
||||
/**
|
||||
* Name of the note for use in the database.
|
||||
*/
|
||||
const NOTE_NAME = 'wc-admin-customizing-product-catalog';
|
||||
|
||||
/**
|
||||
* Get the note.
|
||||
*
|
||||
* @return Note
|
||||
*/
|
||||
public static function get_note() {
|
||||
$query = new \WC_Product_Query(
|
||||
array(
|
||||
'limit' => 1,
|
||||
'paginate' => true,
|
||||
'status' => array( 'publish' ),
|
||||
'orderby' => 'post_date',
|
||||
'order' => 'DESC',
|
||||
)
|
||||
);
|
||||
|
||||
$products = $query->get_products();
|
||||
|
||||
// we need at least 1 product.
|
||||
if ( 0 === $products->total ) {
|
||||
return;
|
||||
}
|
||||
|
||||
$product = $products->products[0];
|
||||
$created_timestamp = $product->get_date_created()->getTimestamp();
|
||||
$is_a_day_old = ( time() - $created_timestamp ) >= DAY_IN_SECONDS;
|
||||
|
||||
// the product must be at least 1 day old.
|
||||
if ( ! $is_a_day_old ) {
|
||||
return;
|
||||
}
|
||||
|
||||
// store must not been active more than 14 days.
|
||||
if ( self::wc_admin_active_for( DAY_IN_SECONDS * 14 ) ) {
|
||||
return;
|
||||
}
|
||||
|
||||
$note = new Note();
|
||||
$note->set_title( __( 'How to customize your product catalog', 'woocommerce' ) );
|
||||
$note->set_content( __( 'You want your product catalog and images to look great and align with your brand. This guide will give you all the tips you need to get your products looking great in your store.', 'woocommerce' ) );
|
||||
$note->set_type( Note::E_WC_ADMIN_NOTE_INFORMATIONAL );
|
||||
$note->set_name( self::NOTE_NAME );
|
||||
$note->set_content_data( (object) array() );
|
||||
$note->set_source( 'woocommerce-admin' );
|
||||
$note->add_action(
|
||||
'day-after-first-product',
|
||||
__( 'Learn more', 'woocommerce' ),
|
||||
'https://woocommerce.com/document/woocommerce-customizer/?utm_source=inbox&utm_medium=product'
|
||||
);
|
||||
|
||||
return $note;
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,62 @@
|
||||
<?php
|
||||
/**
|
||||
* WooCommerce Admin: EU VAT Number Note.
|
||||
*
|
||||
* Adds a note for EU store to install the EU VAT Number extension.
|
||||
*/
|
||||
|
||||
namespace Automattic\WooCommerce\Internal\Admin\Notes;
|
||||
|
||||
defined( 'ABSPATH' ) || exit;
|
||||
|
||||
use Automattic\WooCommerce\Admin\Notes\Note;
|
||||
use Automattic\WooCommerce\Admin\Notes\NoteTraits;
|
||||
|
||||
/**
|
||||
* EU_VAT_Number
|
||||
*/
|
||||
class EUVATNumber {
|
||||
/**
|
||||
* Note traits.
|
||||
*/
|
||||
use NoteTraits;
|
||||
|
||||
/**
|
||||
* Name of the note for use in the database.
|
||||
*/
|
||||
const NOTE_NAME = 'wc-admin-eu-vat-number';
|
||||
|
||||
/**
|
||||
* Get the note.
|
||||
*
|
||||
* @return Note
|
||||
*/
|
||||
public static function get_note() {
|
||||
if ( 'yes' !== get_option( 'wc_connect_taxes_enabled', 'no' ) ) {
|
||||
return;
|
||||
}
|
||||
|
||||
$country_code = WC()->countries->get_base_country();
|
||||
$eu_countries = WC()->countries->get_european_union_countries();
|
||||
if ( ! in_array( $country_code, $eu_countries, true ) ) {
|
||||
return;
|
||||
}
|
||||
|
||||
$content = __( "If your store is based in the EU, we recommend using the EU VAT Number extension in addition to automated taxes. It provides your checkout with a field to collect and validate a customer's EU VAT number, if they have one.", 'woocommerce' );
|
||||
|
||||
$note = new Note();
|
||||
$note->set_title( __( 'Collect and validate EU VAT numbers at checkout', 'woocommerce' ) );
|
||||
$note->set_content( $content );
|
||||
$note->set_content_data( (object) array() );
|
||||
$note->set_type( Note::E_WC_ADMIN_NOTE_MARKETING );
|
||||
$note->set_name( self::NOTE_NAME );
|
||||
$note->set_source( 'woocommerce-admin' );
|
||||
$note->add_action(
|
||||
'learn-more',
|
||||
__( 'Learn more', 'woocommerce' ),
|
||||
'https://woocommerce.com/products/eu-vat-number/?utm_medium=product',
|
||||
Note::E_WC_ADMIN_NOTE_ACTIONED
|
||||
);
|
||||
return $note;
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,71 @@
|
||||
<?php
|
||||
/**
|
||||
* WooCommerce Admin Edit products on the move note.
|
||||
*
|
||||
* Adds a note to download the mobile app.
|
||||
*/
|
||||
|
||||
namespace Automattic\WooCommerce\Internal\Admin\Notes;
|
||||
|
||||
defined( 'ABSPATH' ) || exit;
|
||||
|
||||
use Automattic\WooCommerce\Admin\Notes\Note;
|
||||
use Automattic\WooCommerce\Admin\Notes\NoteTraits;
|
||||
|
||||
/**
|
||||
* Edit_Products_On_The_Move
|
||||
*/
|
||||
class EditProductsOnTheMove {
|
||||
/**
|
||||
* Note traits.
|
||||
*/
|
||||
use NoteTraits;
|
||||
|
||||
/**
|
||||
* Name of the note for use in the database.
|
||||
*/
|
||||
const NOTE_NAME = 'wc-admin-edit-products-on-the-move';
|
||||
|
||||
/**
|
||||
* Get the note.
|
||||
*
|
||||
* @return Note
|
||||
*/
|
||||
public static function get_note() {
|
||||
// Only add this note if this store is at least a year old.
|
||||
$year_in_seconds = 365 * DAY_IN_SECONDS;
|
||||
if ( ! self::wc_admin_active_for( $year_in_seconds ) ) {
|
||||
return;
|
||||
}
|
||||
|
||||
// Check that the previous mobile app notes have not been actioned.
|
||||
if ( MobileApp::has_note_been_actioned() ) {
|
||||
return;
|
||||
}
|
||||
if ( RealTimeOrderAlerts::has_note_been_actioned() ) {
|
||||
return;
|
||||
}
|
||||
if ( ManageOrdersOnTheGo::has_note_been_actioned() ) {
|
||||
return;
|
||||
}
|
||||
if ( PerformanceOnMobile::has_note_been_actioned() ) {
|
||||
return;
|
||||
}
|
||||
|
||||
$note = new Note();
|
||||
|
||||
$note->set_title( __( 'Edit products on the move', 'woocommerce' ) );
|
||||
$note->set_content( __( 'Edit and create new products from your mobile devices with the Woo app', 'woocommerce' ) );
|
||||
$note->set_content_data( (object) array() );
|
||||
$note->set_type( Note::E_WC_ADMIN_NOTE_INFORMATIONAL );
|
||||
$note->set_name( self::NOTE_NAME );
|
||||
$note->set_source( 'woocommerce-admin' );
|
||||
$note->add_action(
|
||||
'learn-more',
|
||||
__( 'Learn more', 'woocommerce' ),
|
||||
'https://woocommerce.com/mobile/?utm_source=inbox&utm_medium=product'
|
||||
);
|
||||
|
||||
return $note;
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,221 @@
|
||||
<?php
|
||||
/**
|
||||
* Handles emailing user notes.
|
||||
*/
|
||||
|
||||
namespace Automattic\WooCommerce\Internal\Admin\Notes;
|
||||
|
||||
if ( ! defined( 'ABSPATH' ) ) {
|
||||
exit;
|
||||
}
|
||||
|
||||
use Automattic\WooCommerce\Admin\Notes\Notes;
|
||||
|
||||
/**
|
||||
* Include dependencies.
|
||||
*/
|
||||
if ( ! class_exists( 'WC_Email', false ) ) {
|
||||
include_once WC_ABSPATH . 'includes/emails/class-wc-email.php';
|
||||
}
|
||||
|
||||
/**
|
||||
* EmailNotification Class.
|
||||
*/
|
||||
class EmailNotification extends \WC_Email {
|
||||
/**
|
||||
* Constructor.
|
||||
*
|
||||
* @param Note $note The notification to send.
|
||||
*/
|
||||
public function __construct( $note ) {
|
||||
$this->note = $note;
|
||||
$this->id = 'merchant_notification';
|
||||
$this->template_base = WC_ADMIN_ABSPATH . 'includes/react-admin/emails/';
|
||||
$this->placeholders = array(
|
||||
'{greetings}' => __( 'Hi there,', 'woocommerce' ),
|
||||
);
|
||||
|
||||
// Call parent constructor.
|
||||
parent::__construct();
|
||||
}
|
||||
|
||||
/**
|
||||
* This email has no user-facing settings.
|
||||
*/
|
||||
public function init_form_fields() {}
|
||||
|
||||
/**
|
||||
* This email has no user-facing settings.
|
||||
*/
|
||||
public function init_settings() {}
|
||||
|
||||
/**
|
||||
* Return template filename.
|
||||
*
|
||||
* @param string $type Type of email to send.
|
||||
* @return string
|
||||
*/
|
||||
public function get_template_filename( $type = 'html' ) {
|
||||
if ( ! in_array( $type, array( 'html', 'plain' ), true ) ) {
|
||||
return;
|
||||
}
|
||||
$content_data = $this->note->get_content_data();
|
||||
$template_filename = "{$type}-merchant-notification.php";
|
||||
if ( isset( $content_data->{"template_{$type}"} ) && file_exists( $this->template_base . $content_data->{ "template_{$type}" } ) ) {
|
||||
$template_filename = $content_data[ "template_{$type}" ];
|
||||
}
|
||||
return $template_filename;
|
||||
}
|
||||
|
||||
/**
|
||||
* Return email type.
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
public function get_email_type() {
|
||||
return class_exists( 'DOMDocument' ) ? 'html' : 'plain';
|
||||
}
|
||||
|
||||
/**
|
||||
* Get email heading.
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
public function get_default_heading() {
|
||||
$content_data = $this->note->get_content_data();
|
||||
if ( isset( $content_data->heading ) ) {
|
||||
return $content_data->heading;
|
||||
}
|
||||
|
||||
return $this->note->get_title();
|
||||
}
|
||||
|
||||
/**
|
||||
* Get email headers.
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
public function get_headers() {
|
||||
$header = 'Content-Type: ' . $this->get_content_type() . "\r\n";
|
||||
return apply_filters( 'woocommerce_email_headers', $header, $this->id, $this->object, $this );
|
||||
}
|
||||
|
||||
/**
|
||||
* Get email subject.
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
public function get_default_subject() {
|
||||
return $this->note->get_title();
|
||||
}
|
||||
|
||||
/**
|
||||
* Get note content.
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
public function get_note_content() {
|
||||
return $this->note->get_content();
|
||||
}
|
||||
|
||||
/**
|
||||
* Get note image.
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
public function get_image() {
|
||||
return $this->note->get_image();
|
||||
}
|
||||
|
||||
/**
|
||||
* Get email action.
|
||||
*
|
||||
* @return stdClass
|
||||
*/
|
||||
public function get_actions() {
|
||||
return $this->note->get_actions();
|
||||
}
|
||||
|
||||
/**
|
||||
* Get content html.
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
public function get_content_html() {
|
||||
return wc_get_template_html(
|
||||
$this->get_template_filename( 'html' ),
|
||||
array(
|
||||
'email_actions' => $this->get_actions(),
|
||||
'email_content' => $this->format_string( $this->get_note_content() ),
|
||||
'email_heading' => $this->format_string( $this->get_heading() ),
|
||||
'email_image' => $this->get_image(),
|
||||
'sent_to_admin' => true,
|
||||
'plain_text' => false,
|
||||
'email' => $this,
|
||||
'opened_tracking_url' => $this->opened_tracking_url,
|
||||
'trigger_note_action_url' => $this->trigger_note_action_url,
|
||||
),
|
||||
'',
|
||||
$this->template_base
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Get content plain.
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
public function get_content_plain() {
|
||||
return wc_get_template_html(
|
||||
$this->get_template_filename( 'plain' ),
|
||||
array(
|
||||
'email_heading' => $this->format_string( $this->get_heading() ),
|
||||
'email_content' => $this->format_string( $this->get_note_content() ),
|
||||
'email_actions' => $this->get_actions(),
|
||||
'sent_to_admin' => true,
|
||||
'plain_text' => true,
|
||||
'email' => $this,
|
||||
'trigger_note_action_url' => $this->trigger_note_action_url,
|
||||
),
|
||||
'',
|
||||
$this->template_base
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Trigger the sending of this email.
|
||||
*
|
||||
* @param string $user_email Email to send the note.
|
||||
* @param int $user_id User id to to track the note.
|
||||
* @param string $user_name User's name.
|
||||
*/
|
||||
public function trigger( $user_email, $user_id, $user_name ) {
|
||||
$this->recipient = $user_email;
|
||||
$this->opened_tracking_url = sprintf(
|
||||
'%1$s/wp-json/wc-analytics/admin/notes/tracker/%2$d/user/%3$d',
|
||||
site_url(),
|
||||
$this->note->get_id(),
|
||||
$user_id
|
||||
);
|
||||
$this->trigger_note_action_url = sprintf(
|
||||
'%1$s&external_redirect=1¬e=%2$d&user=%3$d&action=',
|
||||
wc_admin_url(),
|
||||
$this->note->get_id(),
|
||||
$user_id
|
||||
);
|
||||
|
||||
if ( $user_name ) {
|
||||
/* translators: %s = merchant name */
|
||||
$this->placeholders['{greetings}'] = sprintf( __( 'Hi %s,', 'woocommerce' ), $user_name );
|
||||
}
|
||||
|
||||
$this->send(
|
||||
$this->get_recipient(),
|
||||
$this->get_subject(),
|
||||
$this->get_content(),
|
||||
$this->get_headers(),
|
||||
$this->get_attachments()
|
||||
);
|
||||
Notes::record_tracks_event_with_user( $user_id, 'email_note_sent', array( 'note_name' => $this->note->get_name() ) );
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,86 @@
|
||||
<?php
|
||||
/**
|
||||
* WooCommerce Admin: Do you need help with adding your first product?
|
||||
*
|
||||
* Adds a note to ask the client if they need help adding their first product.
|
||||
*/
|
||||
|
||||
namespace Automattic\WooCommerce\Internal\Admin\Notes;
|
||||
|
||||
defined( 'ABSPATH' ) || exit;
|
||||
|
||||
use Automattic\WooCommerce\Admin\Notes\Note;
|
||||
use Automattic\WooCommerce\Admin\Notes\NoteTraits;
|
||||
|
||||
/**
|
||||
* First_Product.
|
||||
*/
|
||||
class FirstProduct {
|
||||
/**
|
||||
* Note traits.
|
||||
*/
|
||||
use NoteTraits;
|
||||
|
||||
/**
|
||||
* Name of the note for use in the database.
|
||||
*/
|
||||
const NOTE_NAME = 'wc-admin-first-product';
|
||||
|
||||
/**
|
||||
* Get the note.
|
||||
*
|
||||
* @return Note
|
||||
*/
|
||||
public static function get_note() {
|
||||
// We want to show the note after seven days.
|
||||
if ( ! self::is_wc_admin_active_in_date_range( 'week-1-4' ) ) {
|
||||
return;
|
||||
}
|
||||
|
||||
$onboarding_profile = get_option( 'woocommerce_onboarding_profile', array() );
|
||||
|
||||
// Confirm that $onboarding_profile is set.
|
||||
if ( empty( $onboarding_profile ) ) {
|
||||
return;
|
||||
}
|
||||
|
||||
// Make sure that the person who filled out the OBW was not setting up
|
||||
// the store for their customer/client.
|
||||
if (
|
||||
! isset( $onboarding_profile['setup_client'] ) ||
|
||||
$onboarding_profile['setup_client']
|
||||
) {
|
||||
return;
|
||||
}
|
||||
|
||||
// Don't show if there are products.
|
||||
$query = new \WC_Product_Query(
|
||||
array(
|
||||
'limit' => 1,
|
||||
'paginate' => true,
|
||||
'return' => 'ids',
|
||||
'status' => array( 'publish' ),
|
||||
)
|
||||
);
|
||||
$products = $query->get_products();
|
||||
$count = $products->total;
|
||||
if ( 0 !== $count ) {
|
||||
return;
|
||||
}
|
||||
|
||||
$note = new Note();
|
||||
$note->set_title( __( 'Do you need help with adding your first product?', 'woocommerce' ) );
|
||||
$note->set_content( __( 'This video tutorial will help you go through the process of adding your first product in WooCommerce.', 'woocommerce' ) );
|
||||
$note->set_type( Note::E_WC_ADMIN_NOTE_INFORMATIONAL );
|
||||
$note->set_name( self::NOTE_NAME );
|
||||
$note->set_content_data( (object) array() );
|
||||
$note->set_source( 'woocommerce-admin' );
|
||||
$note->add_action(
|
||||
'first-product-watch-tutorial',
|
||||
__( 'Watch tutorial', 'woocommerce' ),
|
||||
'https://www.youtube.com/watch?v=sFtXa00Jf_o&list=PLHdG8zvZd0E575Ia8Mu3w1h750YLXNfsC&index=24'
|
||||
);
|
||||
|
||||
return $note;
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,55 @@
|
||||
<?php
|
||||
/**
|
||||
* WooCommerce Admin (Dashboard) Giving feedback notes provider
|
||||
*
|
||||
* Adds notes to the merchant's inbox about giving feedback.
|
||||
*/
|
||||
|
||||
namespace Automattic\WooCommerce\Internal\Admin\Notes;
|
||||
|
||||
defined( 'ABSPATH' ) || exit;
|
||||
|
||||
use Automattic\WooCommerce\Admin\Notes\Note;
|
||||
use Automattic\WooCommerce\Admin\Notes\NoteTraits;
|
||||
use Automattic\WooCommerce\Internal\Admin\Survey;
|
||||
|
||||
/**
|
||||
* Giving_Feedback_Notes
|
||||
*/
|
||||
class GivingFeedbackNotes {
|
||||
/**
|
||||
* Note traits.
|
||||
*/
|
||||
use NoteTraits;
|
||||
|
||||
/**
|
||||
* Name of the note for use in the database.
|
||||
*/
|
||||
const NOTE_NAME = 'wc-admin-store-notice-giving-feedback-2';
|
||||
|
||||
/**
|
||||
* Get the note.
|
||||
*
|
||||
* @return Note
|
||||
*/
|
||||
public static function get_note() {
|
||||
if ( ! self::is_wc_admin_active_in_date_range( 'week-1-4' ) ) {
|
||||
return;
|
||||
}
|
||||
|
||||
// Otherwise, create our new note.
|
||||
$note = new Note();
|
||||
$note->set_title( __( 'You\'re invited to share your experience', 'woocommerce' ) );
|
||||
$note->set_content( __( 'Now that you’ve chosen us as a partner, our goal is to make sure we\'re providing the right tools to meet your needs. We\'re looking forward to having your feedback on the store setup experience so we can improve it in the future.', 'woocommerce' ) );
|
||||
$note->set_content_data( (object) array() );
|
||||
$note->set_type( Note::E_WC_ADMIN_NOTE_INFORMATIONAL );
|
||||
$note->set_name( self::NOTE_NAME );
|
||||
$note->set_source( 'woocommerce-admin' );
|
||||
$note->add_action(
|
||||
'share-feedback',
|
||||
__( 'Share feedback', 'woocommerce' ),
|
||||
Survey::get_url( '/store-setup-survey' )
|
||||
);
|
||||
return $note;
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,145 @@
|
||||
<?php
|
||||
/**
|
||||
* WooCommerce Admin Add Install Jetpack and WooCommerce Shipping & Tax Plugin Note Provider.
|
||||
*
|
||||
* Adds a note to the merchant's inbox prompting them to install the Jetpack
|
||||
* and WooCommerce Shipping & Tax plugins after it fails to install during
|
||||
* WooCommerce setup.
|
||||
*/
|
||||
|
||||
namespace Automattic\WooCommerce\Internal\Admin\Notes;
|
||||
|
||||
defined( 'ABSPATH' ) || exit;
|
||||
|
||||
use Automattic\WooCommerce\Admin\Notes\Note;
|
||||
use Automattic\WooCommerce\Admin\Notes\Notes;
|
||||
use Automattic\WooCommerce\Admin\Notes\NoteTraits;
|
||||
use Automattic\WooCommerce\Admin\PluginsHelper;
|
||||
|
||||
/**
|
||||
* Install_JP_And_WCS_Plugins
|
||||
*/
|
||||
class InstallJPAndWCSPlugins {
|
||||
/**
|
||||
* Note traits.
|
||||
*/
|
||||
use NoteTraits;
|
||||
|
||||
/**
|
||||
* Name of the note for use in the database.
|
||||
*/
|
||||
const NOTE_NAME = 'wc-admin-install-jp-and-wcs-plugins';
|
||||
|
||||
/**
|
||||
* Constructor.
|
||||
*/
|
||||
public function __construct() {
|
||||
add_action( 'woocommerce_note_action_install-jp-and-wcs-plugins', array( $this, 'install_jp_and_wcs_plugins' ) );
|
||||
add_action( 'activated_plugin', array( $this, 'action_note' ) );
|
||||
add_action( 'woocommerce_plugins_install_api_error', array( $this, 'on_install_error' ) );
|
||||
add_action( 'woocommerce_plugins_install_error', array( $this, 'on_install_error' ) );
|
||||
add_action( 'woocommerce_plugins_activate_error', array( $this, 'on_install_error' ) );
|
||||
}
|
||||
|
||||
/**
|
||||
* Get the note.
|
||||
*
|
||||
* @return Note
|
||||
*/
|
||||
public static function get_note() {
|
||||
$content = __( 'We noticed that there was a problem during the Jetpack and WooCommerce Shipping & Tax install. Please try again and enjoy all the advantages of having the plugins connected to your store! Sorry for the inconvenience. The "Jetpack" and "WooCommerce Shipping & Tax" plugins will be installed & activated for free.', 'woocommerce' );
|
||||
|
||||
$note = new Note();
|
||||
$note->set_title( __( 'Uh oh... There was a problem during the Jetpack and WooCommerce Shipping & Tax install. Please try again.', 'woocommerce' ) );
|
||||
$note->set_content( $content );
|
||||
$note->set_content_data( (object) array() );
|
||||
$note->set_type( Note::E_WC_ADMIN_NOTE_INFORMATIONAL );
|
||||
$note->set_name( self::NOTE_NAME );
|
||||
$note->set_source( 'woocommerce-admin' );
|
||||
$note->add_action(
|
||||
'install-jp-and-wcs-plugins',
|
||||
__( 'Install plugins', 'woocommerce' ),
|
||||
false,
|
||||
Note::E_WC_ADMIN_NOTE_ACTIONED
|
||||
);
|
||||
return $note;
|
||||
}
|
||||
|
||||
/**
|
||||
* Action the Install Jetpack and WooCommerce Shipping & Tax note, if any exists,
|
||||
* and as long as both the Jetpack and WooCommerce Shipping & Tax plugins have been
|
||||
* activated.
|
||||
*/
|
||||
public static function action_note() {
|
||||
// Make sure that both plugins are active before actioning the note.
|
||||
$active_plugin_slugs = PluginsHelper::get_active_plugin_slugs();
|
||||
$jp_active = in_array( 'jetpack', $active_plugin_slugs, true );
|
||||
$wcs_active = in_array( 'woocommerce-services', $active_plugin_slugs, true );
|
||||
|
||||
if ( ! $jp_active || ! $wcs_active ) {
|
||||
return;
|
||||
}
|
||||
|
||||
// Action any notes with a matching name.
|
||||
$data_store = Notes::load_data_store();
|
||||
$note_ids = $data_store->get_notes_with_name( self::NOTE_NAME );
|
||||
|
||||
foreach ( $note_ids as $note_id ) {
|
||||
$note = Notes::get_note( $note_id );
|
||||
|
||||
if ( $note ) {
|
||||
$note->set_status( Note::E_WC_ADMIN_NOTE_ACTIONED );
|
||||
$note->save();
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Install the Jetpack and WooCommerce Shipping & Tax plugins in response to the action
|
||||
* being clicked in the admin note.
|
||||
*
|
||||
* @param Note $note The note being actioned.
|
||||
*/
|
||||
public function install_jp_and_wcs_plugins( $note ) {
|
||||
if ( self::NOTE_NAME !== $note->get_name() ) {
|
||||
return;
|
||||
}
|
||||
|
||||
$this->install_and_activate_plugin( 'jetpack' );
|
||||
$this->install_and_activate_plugin( 'woocommerce-services' );
|
||||
}
|
||||
|
||||
/**
|
||||
* Installs and activates the specified plugin.
|
||||
*
|
||||
* @param string $plugin The plugin slug.
|
||||
*/
|
||||
private function install_and_activate_plugin( $plugin ) {
|
||||
$install_request = array( 'plugin' => $plugin );
|
||||
$installer = new \Automattic\WooCommerce\Admin\API\OnboardingPlugins();
|
||||
$result = $installer->install_plugin( $install_request );
|
||||
|
||||
// @todo Use the error statuses to decide whether or not to action the note.
|
||||
if ( is_wp_error( $result ) ) {
|
||||
return;
|
||||
}
|
||||
|
||||
$activate_request = array( 'plugins' => $plugin );
|
||||
|
||||
$installer->activate_plugins( $activate_request );
|
||||
}
|
||||
|
||||
/**
|
||||
* Create an alert notification in response to an error installing a plugin.
|
||||
*
|
||||
* @param string $slug The slug of the plugin being installed.
|
||||
*/
|
||||
public function on_install_error( $slug ) {
|
||||
// Exit early if we're not installing the Jetpack or the WooCommerce Shipping & Tax plugins.
|
||||
if ( 'jetpack' !== $slug && 'woocommerce-services' !== $slug ) {
|
||||
return;
|
||||
}
|
||||
|
||||
self::possibly_add_note();
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,60 @@
|
||||
<?php
|
||||
/**
|
||||
* WooCommerce Admin Launch Checklist Note.
|
||||
*
|
||||
* Adds a note to cover pre-launch checklist items for store owners.
|
||||
*/
|
||||
|
||||
namespace Automattic\WooCommerce\Internal\Admin\Notes;
|
||||
|
||||
defined( 'ABSPATH' ) || exit;
|
||||
|
||||
use Automattic\WooCommerce\Admin\Notes\Note;
|
||||
use Automattic\WooCommerce\Admin\Notes\NoteTraits;
|
||||
|
||||
/**
|
||||
* Launch_Checklist
|
||||
*/
|
||||
class LaunchChecklist {
|
||||
/**
|
||||
* Note traits.
|
||||
*/
|
||||
use NoteTraits;
|
||||
|
||||
/**
|
||||
* Name of the note for use in the database.
|
||||
*/
|
||||
const NOTE_NAME = 'wc-admin-launch-checklist';
|
||||
|
||||
/**
|
||||
* Get the note.
|
||||
*
|
||||
* @return Note
|
||||
*/
|
||||
public static function get_note() {
|
||||
// Only add this note if completing the task list or completed 3 tasks in 10 days.
|
||||
$completed_tasks = get_option( 'woocommerce_task_list_tracked_completed_tasks', array() );
|
||||
$ten_days_in_seconds = 10 * DAY_IN_SECONDS;
|
||||
if (
|
||||
! get_option( 'woocommerce_task_list_complete' ) &&
|
||||
(
|
||||
count( $completed_tasks ) < 3 ||
|
||||
self::is_wc_admin_active_in_date_range( 'week-1-4', $ten_days_in_seconds )
|
||||
)
|
||||
) {
|
||||
return;
|
||||
}
|
||||
|
||||
$content = __( 'To make sure you never get that sinking "what did I forget" feeling, we\'ve put together the essential pre-launch checklist.', 'woocommerce' );
|
||||
|
||||
$note = new Note();
|
||||
$note->set_title( __( 'Ready to launch your store?', 'woocommerce' ) );
|
||||
$note->set_content( $content );
|
||||
$note->set_content_data( (object) array() );
|
||||
$note->set_type( Note::E_WC_ADMIN_NOTE_INFORMATIONAL );
|
||||
$note->set_name( self::NOTE_NAME );
|
||||
$note->set_source( 'woocommerce-admin' );
|
||||
$note->add_action( 'learn-more', __( 'Learn more', 'woocommerce' ), 'https://woocommerce.com/posts/pre-launch-checklist-the-essentials/?utm_source=inbox&utm_medium=product' );
|
||||
return $note;
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,100 @@
|
||||
<?php
|
||||
/**
|
||||
* WooCommerce Admin note on how to migrate from Magento.
|
||||
*/
|
||||
|
||||
namespace Automattic\WooCommerce\Internal\Admin\Notes;
|
||||
|
||||
use Automattic\WooCommerce\Internal\Admin\Onboarding\OnboardingProfile;
|
||||
|
||||
defined( 'ABSPATH' ) || exit;
|
||||
|
||||
use Automattic\WooCommerce\Admin\Features\Onboarding;
|
||||
use Automattic\WooCommerce\Admin\Notes\Note;
|
||||
use Automattic\WooCommerce\Admin\Notes\NoteTraits;
|
||||
|
||||
/**
|
||||
* MagentoMigration
|
||||
*/
|
||||
class MagentoMigration {
|
||||
/**
|
||||
* Note traits.
|
||||
*/
|
||||
use NoteTraits;
|
||||
|
||||
/**
|
||||
* Name of the note for use in the database.
|
||||
*/
|
||||
const NOTE_NAME = 'wc-admin-magento-migration';
|
||||
|
||||
/**
|
||||
* Attach hooks.
|
||||
*/
|
||||
public function __construct() {
|
||||
add_action( 'update_option_' . OnboardingProfile::DATA_OPTION, array( __CLASS__, 'possibly_add_note' ) );
|
||||
add_action( 'woocommerce_admin_magento_migration_note', array( __CLASS__, 'save_note' ) );
|
||||
}
|
||||
|
||||
/**
|
||||
* Add the note if it passes predefined conditions.
|
||||
*/
|
||||
public static function possibly_add_note() {
|
||||
$onboarding_profile = get_option( OnboardingProfile::DATA_OPTION, array() );
|
||||
|
||||
if ( empty( $onboarding_profile ) ) {
|
||||
return;
|
||||
}
|
||||
|
||||
if (
|
||||
! isset( $onboarding_profile['other_platform'] ) ||
|
||||
'magento' !== $onboarding_profile['other_platform']
|
||||
) {
|
||||
return;
|
||||
}
|
||||
|
||||
if (
|
||||
! isset( $onboarding_profile['setup_client'] ) ||
|
||||
$onboarding_profile['setup_client']
|
||||
) {
|
||||
return;
|
||||
}
|
||||
|
||||
WC()->queue()->schedule_single( time() + ( 5 * MINUTE_IN_SECONDS ), 'woocommerce_admin_magento_migration_note' );
|
||||
}
|
||||
|
||||
/**
|
||||
* Save the note to the database.
|
||||
*/
|
||||
public static function save_note() {
|
||||
$note = self::get_note();
|
||||
|
||||
if ( self::note_exists() ) {
|
||||
return;
|
||||
}
|
||||
|
||||
$note->save();
|
||||
}
|
||||
|
||||
/**
|
||||
* Get the note.
|
||||
*
|
||||
* @return Note
|
||||
*/
|
||||
public static function get_note() {
|
||||
$note = new Note();
|
||||
|
||||
$note->set_title( __( 'How to Migrate from Magento to WooCommerce', 'woocommerce' ) );
|
||||
$note->set_content( __( 'Changing platforms might seem like a big hurdle to overcome, but it is easier than you might think to move your products, customers, and orders to WooCommerce. This article will help you with going through this process.', 'woocommerce' ) );
|
||||
$note->set_content_data( (object) array() );
|
||||
$note->set_type( Note::E_WC_ADMIN_NOTE_INFORMATIONAL );
|
||||
$note->set_name( self::NOTE_NAME );
|
||||
$note->set_source( 'woocommerce-admin' );
|
||||
$note->add_action(
|
||||
'learn-more',
|
||||
__( 'Learn more', 'woocommerce' ),
|
||||
'https://woocommerce.com/posts/how-migrate-from-magento-to-woocommerce/?utm_source=inbox'
|
||||
);
|
||||
|
||||
return $note;
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,64 @@
|
||||
<?php
|
||||
/**
|
||||
* WooCommerce Admin Manage orders on the go note.
|
||||
*
|
||||
* Adds a note to download the mobile app to manage orders on the go.
|
||||
*/
|
||||
|
||||
namespace Automattic\WooCommerce\Internal\Admin\Notes;
|
||||
|
||||
defined( 'ABSPATH' ) || exit;
|
||||
|
||||
use Automattic\WooCommerce\Admin\Notes\Note;
|
||||
use Automattic\WooCommerce\Admin\Notes\NoteTraits;
|
||||
|
||||
/**
|
||||
* Manage_Orders_On_The_Go
|
||||
*/
|
||||
class ManageOrdersOnTheGo {
|
||||
/**
|
||||
* Note traits.
|
||||
*/
|
||||
use NoteTraits;
|
||||
|
||||
/**
|
||||
* Name of the note for use in the database.
|
||||
*/
|
||||
const NOTE_NAME = 'wc-admin-manage-orders-on-the-go';
|
||||
|
||||
/**
|
||||
* Get the note.
|
||||
*
|
||||
* @return Note|null
|
||||
*/
|
||||
public static function get_note() {
|
||||
// Only add this note if this store is at least 6 months old.
|
||||
if ( ! self::is_wc_admin_active_in_date_range( 'month-6+' ) ) {
|
||||
return;
|
||||
}
|
||||
|
||||
// Check that the previous mobile app notes have not been actioned.
|
||||
if ( MobileApp::has_note_been_actioned() ) {
|
||||
return;
|
||||
}
|
||||
if ( RealTimeOrderAlerts::has_note_been_actioned() ) {
|
||||
return;
|
||||
}
|
||||
|
||||
$note = new Note();
|
||||
|
||||
$note->set_title( __( 'Manage your orders on the go', 'woocommerce' ) );
|
||||
$note->set_content( __( 'Look for orders, customer info, and process refunds in one click with the Woo app.', 'woocommerce' ) );
|
||||
$note->set_content_data( (object) array() );
|
||||
$note->set_type( Note::E_WC_ADMIN_NOTE_INFORMATIONAL );
|
||||
$note->set_name( self::NOTE_NAME );
|
||||
$note->set_source( 'woocommerce-admin' );
|
||||
$note->add_action(
|
||||
'learn-more',
|
||||
__( 'Learn more', 'woocommerce' ),
|
||||
'https://woocommerce.com/mobile/?utm_source=inbox&utm_medium=product'
|
||||
);
|
||||
|
||||
return $note;
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,146 @@
|
||||
<?php
|
||||
/**
|
||||
* WooCommerce Admin Jetpack Marketing Note Provider.
|
||||
*
|
||||
* Adds notes to the merchant's inbox concerning Jetpack Backup.
|
||||
*/
|
||||
|
||||
namespace Automattic\WooCommerce\Internal\Admin\Notes;
|
||||
|
||||
defined( 'ABSPATH' ) || exit;
|
||||
|
||||
use Automattic\Jetpack\Constants;
|
||||
use Automattic\WooCommerce\Admin\Notes\Note;
|
||||
use Automattic\WooCommerce\Admin\Notes\Notes;
|
||||
use Automattic\WooCommerce\Admin\Notes\NoteTraits;
|
||||
use Automattic\WooCommerce\Admin\PluginsHelper;
|
||||
|
||||
/**
|
||||
* Suggest Jetpack Backup to Woo users.
|
||||
*
|
||||
* Note: This should probably live in the Jetpack plugin in the future.
|
||||
*
|
||||
* @see https://developer.woocommerce.com/2020/10/16/using-the-admin-notes-inbox-in-woocommerce/
|
||||
*/
|
||||
class MarketingJetpack {
|
||||
// Shared Note Traits.
|
||||
use NoteTraits;
|
||||
|
||||
/**
|
||||
* Name of the note for use in the database.
|
||||
*/
|
||||
const NOTE_NAME = 'wc-admin-marketing-jetpack-backup';
|
||||
|
||||
/**
|
||||
* Product IDs that include Backup.
|
||||
*/
|
||||
const BACKUP_IDS = [
|
||||
2010,
|
||||
2011,
|
||||
2012,
|
||||
2013,
|
||||
2014,
|
||||
2015,
|
||||
2100,
|
||||
2101,
|
||||
2102,
|
||||
2103,
|
||||
2005,
|
||||
2006,
|
||||
2000,
|
||||
2003,
|
||||
2001,
|
||||
2004,
|
||||
];
|
||||
|
||||
/**
|
||||
* Maybe add a note on Jetpack Backups for Jetpack sites older than a week without Backups.
|
||||
*/
|
||||
public static function possibly_add_note() {
|
||||
/**
|
||||
* Check if Jetpack is installed.
|
||||
*/
|
||||
$installed_plugins = PluginsHelper::get_installed_plugin_slugs();
|
||||
if ( ! in_array( 'jetpack', $installed_plugins, true ) ) {
|
||||
return;
|
||||
}
|
||||
|
||||
$data_store = \WC_Data_Store::load( 'admin-note' );
|
||||
|
||||
// Do we already have this note?
|
||||
$note_ids = $data_store->get_notes_with_name( self::NOTE_NAME );
|
||||
if ( ! empty( $note_ids ) ) {
|
||||
|
||||
$note_id = array_pop( $note_ids );
|
||||
$note = Notes::get_note( $note_id );
|
||||
if ( false === $note ) {
|
||||
return;
|
||||
}
|
||||
|
||||
// If Jetpack Backups was purchased after the note was created, mark this note as actioned.
|
||||
if ( self::has_backups() && Note::E_WC_ADMIN_NOTE_ACTIONED !== $note->get_status() ) {
|
||||
$note->set_status( Note::E_WC_ADMIN_NOTE_ACTIONED );
|
||||
$note->save();
|
||||
}
|
||||
|
||||
return;
|
||||
}
|
||||
|
||||
// Check requirements.
|
||||
if ( ! self::is_wc_admin_active_in_date_range( 'week-1-4', DAY_IN_SECONDS * 3 ) || ! self::can_be_added() || self::has_backups() ) {
|
||||
return;
|
||||
}
|
||||
|
||||
// Add note.
|
||||
$note = self::get_note();
|
||||
$note->save();
|
||||
}
|
||||
|
||||
/**
|
||||
* Get the note.
|
||||
*/
|
||||
public static function get_note() {
|
||||
$note = new Note();
|
||||
$note->set_title( __( 'Protect your WooCommerce Store with Jetpack Backup.', 'woocommerce' ) );
|
||||
$note->set_content( __( 'Store downtime means lost sales. One-click restores get you back online quickly if something goes wrong.', 'woocommerce' ) );
|
||||
$note->set_type( Note::E_WC_ADMIN_NOTE_MARKETING );
|
||||
$note->set_name( self::NOTE_NAME );
|
||||
$note->set_layout( 'thumbnail' );
|
||||
$note->set_image(
|
||||
WC_ADMIN_IMAGES_FOLDER_URL . '/admin_notes/marketing-jetpack-2x.png'
|
||||
);
|
||||
$note->set_content_data( (object) array() );
|
||||
$note->set_source( 'woocommerce-admin-notes' );
|
||||
$note->add_action(
|
||||
'jetpack-backup-woocommerce',
|
||||
__( 'Get backups', 'woocommerce' ),
|
||||
esc_url( 'https://jetpack.com/upgrade/backup-woocommerce/?utm_source=inbox&utm_medium=automattic_referred&utm_campaign=jp_backup_to_woo' ),
|
||||
Note::E_WC_ADMIN_NOTE_ACTIONED
|
||||
);
|
||||
return $note;
|
||||
}
|
||||
|
||||
/**
|
||||
* Check if this blog already has a Jetpack Backups product.
|
||||
*
|
||||
* @return boolean Whether or not this blog has backups.
|
||||
*/
|
||||
protected static function has_backups() {
|
||||
$product_ids = [];
|
||||
|
||||
$plan = get_option( 'jetpack_active_plan' );
|
||||
if ( ! empty( $plan ) ) {
|
||||
$product_ids[] = $plan['product_id'];
|
||||
}
|
||||
|
||||
$products = get_option( 'jetpack_site_products' );
|
||||
if ( ! empty( $products ) ) {
|
||||
foreach ( $products as $product ) {
|
||||
$product_ids[] = $product['product_id'];
|
||||
}
|
||||
}
|
||||
|
||||
return (bool) array_intersect( self::BACKUP_IDS, $product_ids );
|
||||
}
|
||||
|
||||
}
|
||||
@@ -0,0 +1,140 @@
|
||||
<?php
|
||||
/**
|
||||
* Handles merchant email notifications
|
||||
*/
|
||||
|
||||
namespace Automattic\WooCommerce\Internal\Admin\Notes;
|
||||
|
||||
use Automattic\WooCommerce\Admin\Notes\Note;
|
||||
use Automattic\WooCommerce\Admin\Notes\Notes;
|
||||
|
||||
defined( 'ABSPATH' ) || exit;
|
||||
|
||||
/**
|
||||
* Merchant email notifications.
|
||||
* This gets all non-sent notes type `email` and sends them.
|
||||
*/
|
||||
class MerchantEmailNotifications {
|
||||
/**
|
||||
* Initialize the merchant email notifications.
|
||||
*/
|
||||
public static function init() {
|
||||
add_action( 'admin_init', array( __CLASS__, 'trigger_notification_action' ) );
|
||||
}
|
||||
|
||||
/**
|
||||
* Trigger the note action.
|
||||
*/
|
||||
public static function trigger_notification_action() {
|
||||
/* phpcs:disable WordPress.Security.NonceVerification */
|
||||
if (
|
||||
! isset( $_GET['external_redirect'] ) ||
|
||||
1 !== intval( $_GET['external_redirect'] ) ||
|
||||
! isset( $_GET['user'] ) ||
|
||||
! isset( $_GET['note'] ) ||
|
||||
! isset( $_GET['action'] )
|
||||
) {
|
||||
return;
|
||||
}
|
||||
$note_id = intval( $_GET['note'] );
|
||||
$action_id = intval( $_GET['action'] );
|
||||
$user_id = intval( $_GET['user'] );
|
||||
/* phpcs:enable */
|
||||
|
||||
$note = Notes::get_note( $note_id );
|
||||
|
||||
if ( ! $note || Note::E_WC_ADMIN_NOTE_EMAIL !== $note->get_type() ) {
|
||||
return;
|
||||
}
|
||||
|
||||
$triggered_action = Notes::get_action_by_id( $note, $action_id );
|
||||
|
||||
if ( ! $triggered_action ) {
|
||||
return;
|
||||
}
|
||||
|
||||
Notes::trigger_note_action( $note, $triggered_action );
|
||||
$url = $triggered_action->query;
|
||||
|
||||
// We will use "wp_safe_redirect" when it's an internal redirect.
|
||||
if ( strpos( $url, 'http' ) === false ) {
|
||||
wp_safe_redirect( $url );
|
||||
} else {
|
||||
header( 'Location: ' . $url );
|
||||
}
|
||||
exit();
|
||||
}
|
||||
|
||||
/**
|
||||
* Send all the notifications type `email`.
|
||||
*/
|
||||
public static function run() {
|
||||
$data_store = Notes::load_data_store();
|
||||
$notes = $data_store->get_notes(
|
||||
array(
|
||||
'type' => array( Note::E_WC_ADMIN_NOTE_EMAIL ),
|
||||
'status' => array( 'unactioned' ),
|
||||
)
|
||||
);
|
||||
|
||||
foreach ( $notes as $note ) {
|
||||
$note = Notes::get_note( $note->note_id );
|
||||
if ( $note ) {
|
||||
self::send_merchant_notification( $note );
|
||||
$note->set_status( 'sent' );
|
||||
$note->save();
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Send the notification to the merchant.
|
||||
*
|
||||
* @param object $note The note to send.
|
||||
*/
|
||||
public static function send_merchant_notification( $note ) {
|
||||
\WC_Emails::instance();
|
||||
$users = self::get_notification_recipients( $note );
|
||||
$email = new EmailNotification( $note );
|
||||
foreach ( $users as $user ) {
|
||||
if ( is_email( $user->user_email ) ) {
|
||||
$name = self::get_merchant_preferred_name( $user );
|
||||
$email->trigger( $user->user_email, $user->ID, $name );
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Get the preferred name for user. First choice is
|
||||
* the user's first name, and then display_name.
|
||||
*
|
||||
* @param WP_User $user Recipient to send the note to.
|
||||
* @return string User's name.
|
||||
*/
|
||||
public static function get_merchant_preferred_name( $user ) {
|
||||
$first_name = get_user_meta( $user->ID, 'first_name', true );
|
||||
if ( $first_name ) {
|
||||
return $first_name;
|
||||
}
|
||||
if ( $user->display_name ) {
|
||||
return $user->display_name;
|
||||
}
|
||||
return '';
|
||||
}
|
||||
|
||||
/**
|
||||
* Get users by role to notify.
|
||||
*
|
||||
* @param object $note The note to send.
|
||||
* @return array Users to notify
|
||||
*/
|
||||
public static function get_notification_recipients( $note ) {
|
||||
$content_data = $note->get_content_data();
|
||||
$role = 'administrator';
|
||||
if ( isset( $content_data->role ) ) {
|
||||
$role = $content_data->role;
|
||||
}
|
||||
$args = array( 'role' => $role );
|
||||
return get_users( $args );
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,79 @@
|
||||
<?php
|
||||
/**
|
||||
* WooCommerce Admin: Migrate from Shopify to WooCommerce.
|
||||
*
|
||||
* Adds a note to ask the client if they want to migrate from Shopify to WooCommerce.
|
||||
*/
|
||||
|
||||
namespace Automattic\WooCommerce\Internal\Admin\Notes;
|
||||
|
||||
defined( 'ABSPATH' ) || exit;
|
||||
|
||||
use Automattic\WooCommerce\Admin\Notes\Note;
|
||||
use Automattic\WooCommerce\Admin\Notes\NoteTraits;
|
||||
|
||||
/**
|
||||
* Migrate_From_Shopify.
|
||||
*/
|
||||
class MigrateFromShopify {
|
||||
/**
|
||||
* Note traits.
|
||||
*/
|
||||
use NoteTraits;
|
||||
|
||||
/**
|
||||
* Name of the note for use in the database.
|
||||
*/
|
||||
const NOTE_NAME = 'wc-admin-migrate-from-shopify';
|
||||
|
||||
/**
|
||||
* Get the note.
|
||||
*
|
||||
* @return Note
|
||||
*/
|
||||
public static function get_note() {
|
||||
|
||||
// We want to show the note after two days.
|
||||
$two_days = 2 * DAY_IN_SECONDS;
|
||||
if ( ! self::is_wc_admin_active_in_date_range( 'week-1', $two_days ) ) {
|
||||
return;
|
||||
}
|
||||
|
||||
$onboarding_profile = get_option( 'woocommerce_onboarding_profile', array() );
|
||||
if (
|
||||
! isset( $onboarding_profile['setup_client'] ) ||
|
||||
! isset( $onboarding_profile['selling_venues'] ) ||
|
||||
! isset( $onboarding_profile['other_platform'] )
|
||||
) {
|
||||
return;
|
||||
}
|
||||
|
||||
// Make sure the client is not setup.
|
||||
if ( $onboarding_profile['setup_client'] ) {
|
||||
return;
|
||||
}
|
||||
|
||||
// We will show the notification when the client already is selling and is using Shopify.
|
||||
if (
|
||||
'other' !== $onboarding_profile['selling_venues'] ||
|
||||
'shopify' !== $onboarding_profile['other_platform']
|
||||
) {
|
||||
return;
|
||||
}
|
||||
|
||||
$note = new Note();
|
||||
$note->set_title( __( 'Do you want to migrate from Shopify to WooCommerce?', 'woocommerce' ) );
|
||||
$note->set_content( __( 'Changing eCommerce platforms might seem like a big hurdle to overcome, but it is easier than you might think to move your products, customers, and orders to WooCommerce. This article will help you with going through this process.', 'woocommerce' ) );
|
||||
$note->set_type( Note::E_WC_ADMIN_NOTE_INFORMATIONAL );
|
||||
$note->set_name( self::NOTE_NAME );
|
||||
$note->set_content_data( (object) array() );
|
||||
$note->set_source( 'woocommerce-admin' );
|
||||
$note->add_action(
|
||||
'migrate-from-shopify',
|
||||
__( 'Learn more', 'woocommerce' ),
|
||||
'https://woocommerce.com/posts/migrate-from-shopify-to-woocommerce/?utm_source=inbox&utm_medium=product',
|
||||
Note::E_WC_ADMIN_NOTE_ACTIONED
|
||||
);
|
||||
return $note;
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,53 @@
|
||||
<?php
|
||||
/**
|
||||
* WooCommerce Admin Mobile App Note Provider.
|
||||
*
|
||||
* Adds a note to the merchant's inbox showing the benefits of the mobile app.
|
||||
*/
|
||||
|
||||
namespace Automattic\WooCommerce\Internal\Admin\Notes;
|
||||
|
||||
defined( 'ABSPATH' ) || exit;
|
||||
|
||||
use Automattic\WooCommerce\Admin\Notes\Note;
|
||||
use Automattic\WooCommerce\Admin\Notes\NoteTraits;
|
||||
|
||||
/**
|
||||
* Mobile_App
|
||||
*/
|
||||
class MobileApp {
|
||||
/**
|
||||
* Note traits.
|
||||
*/
|
||||
use NoteTraits;
|
||||
|
||||
/**
|
||||
* Name of the note for use in the database.
|
||||
*/
|
||||
const NOTE_NAME = 'wc-admin-mobile-app';
|
||||
|
||||
/**
|
||||
* Get the note.
|
||||
*
|
||||
* @return Note
|
||||
*/
|
||||
public static function get_note() {
|
||||
// We want to show the mobile app note after day 2.
|
||||
$two_days_in_seconds = 2 * DAY_IN_SECONDS;
|
||||
if ( ! self::is_wc_admin_active_in_date_range( 'week-1', $two_days_in_seconds ) ) {
|
||||
return;
|
||||
}
|
||||
|
||||
$content = __( 'Install the WooCommerce mobile app to manage orders, receive sales notifications, and view key metrics — wherever you are.', 'woocommerce' );
|
||||
|
||||
$note = new Note();
|
||||
$note->set_title( __( 'Install Woo mobile app', 'woocommerce' ) );
|
||||
$note->set_content( $content );
|
||||
$note->set_content_data( (object) array() );
|
||||
$note->set_type( Note::E_WC_ADMIN_NOTE_INFORMATIONAL );
|
||||
$note->set_name( self::NOTE_NAME );
|
||||
$note->set_source( 'woocommerce-admin' );
|
||||
$note->add_action( 'learn-more', __( 'Learn more', 'woocommerce' ), 'https://woocommerce.com/mobile/?utm_medium=product' );
|
||||
return $note;
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,179 @@
|
||||
<?php
|
||||
/**
|
||||
* WooCommerce Admin (Dashboard) New Sales Record Note Provider.
|
||||
*
|
||||
* Adds a note to the merchant's inbox when the previous day's sales are a new record.
|
||||
*/
|
||||
|
||||
namespace Automattic\WooCommerce\Internal\Admin\Notes;
|
||||
|
||||
defined( 'ABSPATH' ) || exit;
|
||||
|
||||
use Automattic\WooCommerce\Admin\Notes\Note;
|
||||
use Automattic\WooCommerce\Admin\Notes\Notes;
|
||||
use Automattic\WooCommerce\Admin\Notes\NoteTraits;
|
||||
|
||||
/**
|
||||
* New_Sales_Record
|
||||
*/
|
||||
class NewSalesRecord {
|
||||
/**
|
||||
* Note traits.
|
||||
*/
|
||||
use NoteTraits;
|
||||
|
||||
/**
|
||||
* Name of the note for use in the database.
|
||||
*/
|
||||
const NOTE_NAME = 'wc-admin-new-sales-record';
|
||||
|
||||
/**
|
||||
* Option name for the sales record date in ISO 8601 (YYYY-MM-DD) date.
|
||||
*/
|
||||
const RECORD_DATE_OPTION_KEY = 'woocommerce_sales_record_date';
|
||||
|
||||
/**
|
||||
* Option name for the sales record amount.
|
||||
*/
|
||||
const RECORD_AMOUNT_OPTION_KEY = 'woocommerce_sales_record_amount';
|
||||
|
||||
/**
|
||||
* Returns the total of yesterday's sales.
|
||||
*
|
||||
* @param string $date Date for sales to sum (i.e. YYYY-MM-DD).
|
||||
* @return floatval
|
||||
*/
|
||||
public static function sum_sales_for_date( $date ) {
|
||||
$order_query = new \WC_Order_Query( array( 'date_created' => $date ) );
|
||||
$orders = $order_query->get_orders();
|
||||
$total = 0;
|
||||
|
||||
foreach ( (array) $orders as $order ) {
|
||||
$total += $order->get_total();
|
||||
}
|
||||
|
||||
return $total;
|
||||
}
|
||||
|
||||
/**
|
||||
* Possibly add a sales record note.
|
||||
*/
|
||||
public static function possibly_add_note() {
|
||||
/**
|
||||
* Filter to allow for disabling sales record milestones.
|
||||
*
|
||||
* @since 3.7.0
|
||||
*
|
||||
* @param boolean default true
|
||||
*/
|
||||
$sales_record_notes_enabled = apply_filters( 'woocommerce_admin_sales_record_milestone_enabled', true );
|
||||
|
||||
if ( ! $sales_record_notes_enabled ) {
|
||||
return;
|
||||
}
|
||||
|
||||
$yesterday = gmdate( 'Y-m-d', current_time( 'timestamp', 0 ) - DAY_IN_SECONDS );
|
||||
$total = self::sum_sales_for_date( $yesterday );
|
||||
|
||||
// No sales yesterday? Bail.
|
||||
if ( 0 >= $total ) {
|
||||
return;
|
||||
}
|
||||
|
||||
$record_date = get_option( self::RECORD_DATE_OPTION_KEY, '' );
|
||||
$record_amt = floatval( get_option( self::RECORD_AMOUNT_OPTION_KEY, 0 ) );
|
||||
|
||||
// No previous entry? Just enter what we have and return without generating a note.
|
||||
if ( empty( $record_date ) ) {
|
||||
update_option( self::RECORD_DATE_OPTION_KEY, $yesterday );
|
||||
update_option( self::RECORD_AMOUNT_OPTION_KEY, $total );
|
||||
return;
|
||||
}
|
||||
|
||||
// Otherwise, if yesterdays total bested the record, update AND generate a note.
|
||||
if ( $total > $record_amt ) {
|
||||
update_option( self::RECORD_DATE_OPTION_KEY, $yesterday );
|
||||
update_option( self::RECORD_AMOUNT_OPTION_KEY, $total );
|
||||
|
||||
// We only want one sales record note at any time in the inbox, so we delete any other first.
|
||||
Notes::delete_notes_with_name( self::NOTE_NAME );
|
||||
|
||||
$note = self::get_note_with_record_data( $record_date, $record_amt, $yesterday, $total );
|
||||
$note->save();
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Get the note with record data.
|
||||
*
|
||||
* @param string $record_date record date Y-m-d.
|
||||
* @param float $record_amt record amount.
|
||||
* @param string $yesterday yesterday's date Y-m-d.
|
||||
* @param string $total total sales for yesterday.
|
||||
*
|
||||
* @return Note
|
||||
*/
|
||||
public static function get_note_with_record_data( $record_date, $record_amt, $yesterday, $total ) {
|
||||
// Use F jS (March 7th) format for English speaking countries.
|
||||
if ( substr( get_user_locale(), 0, 2 ) === 'en' ) {
|
||||
$date_format = 'F jS';
|
||||
} else {
|
||||
// otherwise, fallback to the system date format.
|
||||
$date_format = get_option( 'date_format' );
|
||||
}
|
||||
|
||||
$formatted_yesterday = date_i18n( $date_format, strtotime( $yesterday ) );
|
||||
$formatted_total = html_entity_decode( wp_strip_all_tags( wc_price( $total ) ) );
|
||||
$formatted_record_date = date_i18n( $date_format, strtotime( $record_date ) );
|
||||
$formatted_record_amt = html_entity_decode( wp_strip_all_tags( wc_price( $record_amt ) ) );
|
||||
|
||||
$content = sprintf(
|
||||
/* translators: 1 and 4: Date (e.g. October 16th), 2 and 3: Amount (e.g. $160.00) */
|
||||
__( 'Woohoo, %1$s was your record day for sales! Net sales was %2$s beating the previous record of %3$s set on %4$s.', 'woocommerce' ),
|
||||
$formatted_yesterday,
|
||||
$formatted_total,
|
||||
$formatted_record_amt,
|
||||
$formatted_record_date
|
||||
);
|
||||
|
||||
$content_data = (object) array(
|
||||
'old_record_date' => $record_date,
|
||||
'old_record_amt' => $record_amt,
|
||||
'new_record_date' => $yesterday,
|
||||
'new_record_amt' => $total,
|
||||
);
|
||||
|
||||
$report_url = '?page=wc-admin&path=/analytics/revenue&period=custom&compare=previous_year&after=' . $yesterday . '&before=' . $yesterday;
|
||||
|
||||
// And now, create our new note.
|
||||
$note = new Note();
|
||||
$note->set_title( __( 'New sales record!', 'woocommerce' ) );
|
||||
$note->set_content( $content );
|
||||
$note->set_content_data( $content_data );
|
||||
$note->set_type( Note::E_WC_ADMIN_NOTE_INFORMATIONAL );
|
||||
$note->set_name( self::NOTE_NAME );
|
||||
$note->set_source( 'woocommerce-admin' );
|
||||
$note->add_action( 'view-report', __( 'View report', 'woocommerce' ), $report_url );
|
||||
|
||||
return $note;
|
||||
}
|
||||
|
||||
/**
|
||||
* Get the note. This is used for localizing the note.
|
||||
*
|
||||
* @return Note
|
||||
*/
|
||||
public static function get_note() {
|
||||
$note = Notes::get_note_by_name( self::NOTE_NAME );
|
||||
if ( ! $note ) {
|
||||
return false;
|
||||
}
|
||||
$content_data = $note->get_content_data();
|
||||
return self::get_note_with_record_data(
|
||||
$content_data->old_record_date,
|
||||
$content_data->old_record_amt,
|
||||
$content_data->new_record_date,
|
||||
$content_data->new_record_amt
|
||||
);
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,68 @@
|
||||
<?php
|
||||
/**
|
||||
* WooCommerce Admin: Payments reminder note.
|
||||
*
|
||||
* Adds a notes to complete the payment methods.
|
||||
*/
|
||||
|
||||
namespace Automattic\WooCommerce\Internal\Admin\Notes;
|
||||
|
||||
defined( 'ABSPATH' ) || exit;
|
||||
|
||||
use Automattic\WooCommerce\Admin\Notes\Note;
|
||||
use Automattic\WooCommerce\Admin\Notes\NoteTraits;
|
||||
|
||||
/**
|
||||
* Onboarding_Payments.
|
||||
*/
|
||||
class OnboardingPayments {
|
||||
/**
|
||||
* Note traits.
|
||||
*/
|
||||
use NoteTraits;
|
||||
|
||||
/**
|
||||
* Name of the note for use in the database.
|
||||
*/
|
||||
const NOTE_NAME = 'wc-admin-onboarding-payments-reminder';
|
||||
|
||||
/**
|
||||
* Get the note.
|
||||
*
|
||||
* @return Note
|
||||
*/
|
||||
public static function get_note() {
|
||||
// We want to show the note after five days.
|
||||
if ( ! self::is_wc_admin_active_in_date_range( 'week-1-4', 5 * DAY_IN_SECONDS ) ) {
|
||||
return;
|
||||
}
|
||||
|
||||
// Check to see if any gateways have been added.
|
||||
$gateways = WC()->payment_gateways->get_available_payment_gateways();
|
||||
$enabled_gateways = array_filter(
|
||||
$gateways,
|
||||
function( $gateway ) {
|
||||
return 'yes' === $gateway->enabled;
|
||||
}
|
||||
);
|
||||
if ( ! empty( $enabled_gateways ) ) {
|
||||
return;
|
||||
}
|
||||
|
||||
$note = new Note();
|
||||
$note->set_title( __( 'Start accepting payments on your store!', 'woocommerce' ) );
|
||||
$note->set_content( __( 'Take payments with the provider that’s right for you - choose from 100+ payment gateways for WooCommerce.', 'woocommerce' ) );
|
||||
$note->set_type( Note::E_WC_ADMIN_NOTE_INFORMATIONAL );
|
||||
$note->set_name( self::NOTE_NAME );
|
||||
$note->set_content_data( (object) array() );
|
||||
$note->set_source( 'woocommerce-admin' );
|
||||
$note->add_action(
|
||||
'view-payment-gateways',
|
||||
__( 'Learn more', 'woocommerce' ),
|
||||
'https://woocommerce.com/product-category/woocommerce-extensions/payment-gateways/?utm_medium=product',
|
||||
Note::E_WC_ADMIN_NOTE_ACTIONED,
|
||||
true
|
||||
);
|
||||
return $note;
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,98 @@
|
||||
<?php
|
||||
/**
|
||||
* WooCommerce Admin: Start your online clothing store.
|
||||
*
|
||||
* Adds a note to ask the client if they are considering starting an online
|
||||
* clothing store.
|
||||
*/
|
||||
|
||||
namespace Automattic\WooCommerce\Internal\Admin\Notes;
|
||||
|
||||
defined( 'ABSPATH' ) || exit;
|
||||
|
||||
use Automattic\WooCommerce\Admin\Notes\Note;
|
||||
use Automattic\WooCommerce\Admin\Notes\NoteTraits;
|
||||
|
||||
/**
|
||||
* Online_Clothing_Store.
|
||||
*/
|
||||
class OnlineClothingStore {
|
||||
/**
|
||||
* Note traits.
|
||||
*/
|
||||
use NoteTraits;
|
||||
|
||||
/**
|
||||
* Name of the note for use in the database.
|
||||
*/
|
||||
const NOTE_NAME = 'wc-admin-online-clothing-store';
|
||||
|
||||
/**
|
||||
* Returns whether the industries includes fashion-apparel-accessories.
|
||||
*
|
||||
* @param array $industries The industries to search.
|
||||
*
|
||||
* @return bool Whether the industries includes fashion-apparel-accessories.
|
||||
*/
|
||||
private static function is_in_fashion_industry( $industries ) {
|
||||
foreach ( $industries as $industry ) {
|
||||
if ( 'fashion-apparel-accessories' === $industry['slug'] ) {
|
||||
return true;
|
||||
}
|
||||
}
|
||||
|
||||
return false;
|
||||
}
|
||||
|
||||
/**
|
||||
* Get the note.
|
||||
*
|
||||
* @return Note
|
||||
*/
|
||||
public static function get_note() {
|
||||
// We want to show the note after two days.
|
||||
if ( ! self::is_wc_admin_active_in_date_range( 'week-1', 2 * DAY_IN_SECONDS ) ) {
|
||||
return;
|
||||
}
|
||||
|
||||
$onboarding_profile = get_option( 'woocommerce_onboarding_profile', array() );
|
||||
|
||||
// Confirm that $onboarding_profile is set.
|
||||
if ( empty( $onboarding_profile ) ) {
|
||||
return;
|
||||
}
|
||||
|
||||
// Make sure that the person who filled out the OBW was not setting up
|
||||
// the store for their customer/client.
|
||||
if (
|
||||
! isset( $onboarding_profile['setup_client'] ) ||
|
||||
$onboarding_profile['setup_client']
|
||||
) {
|
||||
return;
|
||||
}
|
||||
|
||||
// We need to show the notification when the industry is
|
||||
// fashion/apparel/accessories.
|
||||
if ( ! isset( $onboarding_profile['industry'] ) ) {
|
||||
return;
|
||||
}
|
||||
if ( ! self::is_in_fashion_industry( $onboarding_profile['industry'] ) ) {
|
||||
return;
|
||||
}
|
||||
|
||||
$note = new Note();
|
||||
$note->set_title( __( 'Start your online clothing store', 'woocommerce' ) );
|
||||
$note->set_content( __( 'Starting a fashion website is exciting but it may seem overwhelming as well. In this article, we\'ll walk you through the setup process, teach you to create successful product listings, and show you how to market to your ideal audience.', 'woocommerce' ) );
|
||||
$note->set_type( Note::E_WC_ADMIN_NOTE_INFORMATIONAL );
|
||||
$note->set_name( self::NOTE_NAME );
|
||||
$note->set_content_data( (object) array() );
|
||||
$note->set_source( 'woocommerce-admin' );
|
||||
$note->add_action(
|
||||
'online-clothing-store',
|
||||
__( 'Learn more', 'woocommerce' ),
|
||||
'https://woocommerce.com/posts/starting-an-online-clothing-store/?utm_source=inbox&utm_medium=product',
|
||||
Note::E_WC_ADMIN_NOTE_ACTIONED
|
||||
);
|
||||
return $note;
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,369 @@
|
||||
<?php
|
||||
/**
|
||||
* WooCommerce Admin (Dashboard) Order Milestones Note Provider.
|
||||
*
|
||||
* Adds a note to the merchant's inbox when certain order milestones are reached.
|
||||
*/
|
||||
|
||||
namespace Automattic\WooCommerce\Internal\Admin\Notes;
|
||||
|
||||
defined( 'ABSPATH' ) || exit;
|
||||
|
||||
use Automattic\WooCommerce\Admin\Notes\Note;
|
||||
use Automattic\WooCommerce\Admin\Notes\Notes;
|
||||
/**
|
||||
* Order_Milestones
|
||||
*/
|
||||
class OrderMilestones {
|
||||
/**
|
||||
* Name of the "other milestones" note.
|
||||
*/
|
||||
const NOTE_NAME = 'wc-admin-orders-milestone';
|
||||
|
||||
/**
|
||||
* Option key name to store last order milestone.
|
||||
*/
|
||||
const LAST_ORDER_MILESTONE_OPTION_KEY = 'woocommerce_admin_last_orders_milestone';
|
||||
|
||||
/**
|
||||
* Hook to process order milestones.
|
||||
*/
|
||||
const PROCESS_ORDERS_MILESTONE_HOOK = 'wc_admin_process_orders_milestone';
|
||||
|
||||
/**
|
||||
* Allowed order statuses for calculating milestones.
|
||||
*
|
||||
* @var array
|
||||
*/
|
||||
protected $allowed_statuses = array(
|
||||
'pending',
|
||||
'processing',
|
||||
'completed',
|
||||
);
|
||||
|
||||
/**
|
||||
* Orders count cache.
|
||||
*
|
||||
* @var int
|
||||
*/
|
||||
protected $orders_count = null;
|
||||
|
||||
/**
|
||||
* Further order milestone thresholds.
|
||||
*
|
||||
* @var array
|
||||
*/
|
||||
protected $milestones = array(
|
||||
1,
|
||||
10,
|
||||
100,
|
||||
250,
|
||||
500,
|
||||
1000,
|
||||
5000,
|
||||
10000,
|
||||
500000,
|
||||
1000000,
|
||||
);
|
||||
|
||||
/**
|
||||
* Delay hook attachment until after the WC post types have been registered.
|
||||
*
|
||||
* This is required for retrieving the order count.
|
||||
*/
|
||||
public function __construct() {
|
||||
/**
|
||||
* Filter Order statuses that will count towards milestones.
|
||||
*
|
||||
* @since 3.5.0
|
||||
*
|
||||
* @param array $allowed_statuses Order statuses that will count towards milestones.
|
||||
*/
|
||||
$this->allowed_statuses = apply_filters( 'woocommerce_admin_order_milestone_statuses', $this->allowed_statuses );
|
||||
|
||||
add_action( 'woocommerce_after_register_post_type', array( $this, 'init' ) );
|
||||
register_deactivation_hook( WC_PLUGIN_FILE, array( $this, 'clear_scheduled_event' ) );
|
||||
}
|
||||
|
||||
/**
|
||||
* Hook everything up.
|
||||
*/
|
||||
public function init() {
|
||||
if ( ! wp_next_scheduled( self::PROCESS_ORDERS_MILESTONE_HOOK ) ) {
|
||||
wp_schedule_event( time(), 'hourly', self::PROCESS_ORDERS_MILESTONE_HOOK );
|
||||
}
|
||||
|
||||
add_action( 'wc_admin_installed', array( $this, 'backfill_last_milestone' ) );
|
||||
|
||||
add_action( self::PROCESS_ORDERS_MILESTONE_HOOK, array( $this, 'possibly_add_note' ) );
|
||||
}
|
||||
|
||||
/**
|
||||
* Clear out our hourly milestone hook upon plugin deactivation.
|
||||
*/
|
||||
public function clear_scheduled_event() {
|
||||
wp_clear_scheduled_hook( self::PROCESS_ORDERS_MILESTONE_HOOK );
|
||||
}
|
||||
|
||||
/**
|
||||
* Get the total count of orders (in the allowed statuses).
|
||||
*
|
||||
* @param bool $no_cache Optional. Skip cache.
|
||||
* @return int Total orders count.
|
||||
*/
|
||||
public function get_orders_count( $no_cache = false ) {
|
||||
if ( $no_cache || is_null( $this->orders_count ) ) {
|
||||
$status_counts = array_map( 'wc_orders_count', $this->allowed_statuses );
|
||||
$this->orders_count = array_sum( $status_counts );
|
||||
}
|
||||
|
||||
return $this->orders_count;
|
||||
}
|
||||
|
||||
/**
|
||||
* Backfill the store's current milestone.
|
||||
*
|
||||
* Used to avoid celebrating milestones that were reached before plugin activation.
|
||||
*/
|
||||
public function backfill_last_milestone() {
|
||||
// If the milestone notes have been disabled via filter, bail.
|
||||
if ( ! $this->are_milestones_enabled() ) {
|
||||
return;
|
||||
}
|
||||
|
||||
$this->set_last_milestone( $this->get_current_milestone() );
|
||||
}
|
||||
|
||||
/**
|
||||
* Get the store's last milestone.
|
||||
*
|
||||
* @return int Last milestone reached.
|
||||
*/
|
||||
public function get_last_milestone() {
|
||||
return get_option( self::LAST_ORDER_MILESTONE_OPTION_KEY, 0 );
|
||||
}
|
||||
|
||||
/**
|
||||
* Update the last reached milestone.
|
||||
*
|
||||
* @param int $milestone Last milestone reached.
|
||||
*/
|
||||
public function set_last_milestone( $milestone ) {
|
||||
update_option( self::LAST_ORDER_MILESTONE_OPTION_KEY, $milestone );
|
||||
}
|
||||
|
||||
/**
|
||||
* Calculate the current orders milestone.
|
||||
*
|
||||
* Based on the threshold values in $this->milestones.
|
||||
*
|
||||
* @return int Current orders milestone.
|
||||
*/
|
||||
public function get_current_milestone() {
|
||||
$milestone_reached = 0;
|
||||
$orders_count = $this->get_orders_count();
|
||||
|
||||
foreach ( $this->milestones as $milestone ) {
|
||||
if ( $milestone <= $orders_count ) {
|
||||
$milestone_reached = $milestone;
|
||||
}
|
||||
}
|
||||
|
||||
return $milestone_reached;
|
||||
}
|
||||
|
||||
/**
|
||||
* Get the appropriate note title for a given milestone.
|
||||
*
|
||||
* @param int $milestone Order milestone.
|
||||
* @return string Note title for the milestone.
|
||||
*/
|
||||
public static function get_note_title_for_milestone( $milestone ) {
|
||||
switch ( $milestone ) {
|
||||
case 1:
|
||||
return __( 'First order received', 'woocommerce' );
|
||||
case 10:
|
||||
case 100:
|
||||
case 250:
|
||||
case 500:
|
||||
case 1000:
|
||||
case 5000:
|
||||
case 10000:
|
||||
case 500000:
|
||||
case 1000000:
|
||||
return sprintf(
|
||||
/* translators: Number of orders processed. */
|
||||
__( 'Congratulations on processing %s orders!', 'woocommerce' ),
|
||||
wc_format_decimal( $milestone )
|
||||
);
|
||||
default:
|
||||
return '';
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Get the appropriate note content for a given milestone.
|
||||
*
|
||||
* @param int $milestone Order milestone.
|
||||
* @return string Note content for the milestone.
|
||||
*/
|
||||
public static function get_note_content_for_milestone( $milestone ) {
|
||||
switch ( $milestone ) {
|
||||
case 1:
|
||||
return __( 'Congratulations on getting your first order! Now is a great time to learn how to manage your orders.', 'woocommerce' );
|
||||
case 10:
|
||||
return __( "You've hit the 10 orders milestone! Look at you go. Browse some WooCommerce success stories for inspiration.", 'woocommerce' );
|
||||
case 100:
|
||||
case 250:
|
||||
case 500:
|
||||
case 1000:
|
||||
case 5000:
|
||||
case 10000:
|
||||
case 500000:
|
||||
case 1000000:
|
||||
return __( 'Another order milestone! Take a look at your Orders Report to review your orders to date.', 'woocommerce' );
|
||||
default:
|
||||
return '';
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Get the appropriate note action for a given milestone.
|
||||
*
|
||||
* @param int $milestone Order milestone.
|
||||
* @return array Note actoion (name, label, query) for the milestone.
|
||||
*/
|
||||
public static function get_note_action_for_milestone( $milestone ) {
|
||||
switch ( $milestone ) {
|
||||
case 1:
|
||||
return array(
|
||||
'name' => 'learn-more',
|
||||
'label' => __( 'Learn more', 'woocommerce' ),
|
||||
'query' => 'https://woocommerce.com/document/managing-orders/?utm_source=inbox&utm_medium=product',
|
||||
);
|
||||
case 10:
|
||||
return array(
|
||||
'name' => 'browse',
|
||||
'label' => __( 'Browse', 'woocommerce' ),
|
||||
'query' => 'https://woocommerce.com/success-stories/?utm_source=inbox&utm_medium=product',
|
||||
);
|
||||
case 100:
|
||||
case 250:
|
||||
case 500:
|
||||
case 1000:
|
||||
case 5000:
|
||||
case 10000:
|
||||
case 500000:
|
||||
case 1000000:
|
||||
return array(
|
||||
'name' => 'review-orders',
|
||||
'label' => __( 'Review your orders', 'woocommerce' ),
|
||||
'query' => '?page=wc-admin&path=/analytics/orders',
|
||||
);
|
||||
default:
|
||||
return array(
|
||||
'name' => '',
|
||||
'label' => '',
|
||||
'query' => '',
|
||||
);
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Convenience method to see if the milestone notes are enabled.
|
||||
*
|
||||
* @return boolean True if milestone notifications are enabled.
|
||||
*/
|
||||
public function are_milestones_enabled() {
|
||||
/**
|
||||
* Filter to allow for disabling order milestones.
|
||||
*
|
||||
* @since 3.7.0
|
||||
*
|
||||
* @param boolean default true
|
||||
*/
|
||||
$milestone_notes_enabled = apply_filters( 'woocommerce_admin_order_milestones_enabled', true );
|
||||
|
||||
return $milestone_notes_enabled;
|
||||
}
|
||||
|
||||
/**
|
||||
* Get the note. This is used for localizing the note.
|
||||
*
|
||||
* @return Note
|
||||
*/
|
||||
public static function get_note() {
|
||||
$note = Notes::get_note_by_name( self::NOTE_NAME );
|
||||
if ( ! $note ) {
|
||||
return false;
|
||||
}
|
||||
$content_data = $note->get_content_data();
|
||||
if ( ! isset( $content_data->current_milestone ) ) {
|
||||
return false;
|
||||
}
|
||||
return self::get_note_by_milestone(
|
||||
$content_data->current_milestone
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Get the note by milestones.
|
||||
*
|
||||
* @param int $current_milestone Current milestone.
|
||||
*
|
||||
* @return Note
|
||||
*/
|
||||
public static function get_note_by_milestone( $current_milestone ) {
|
||||
$content_data = (object) array(
|
||||
'current_milestone' => $current_milestone,
|
||||
);
|
||||
|
||||
$note = new Note();
|
||||
$note->set_title( self::get_note_title_for_milestone( $current_milestone ) );
|
||||
$note->set_content( self::get_note_content_for_milestone( $current_milestone ) );
|
||||
$note->set_content_data( $content_data );
|
||||
$note->set_type( Note::E_WC_ADMIN_NOTE_INFORMATIONAL );
|
||||
$note->set_name( self::NOTE_NAME );
|
||||
$note->set_source( 'woocommerce-admin' );
|
||||
$note_action = self::get_note_action_for_milestone( $current_milestone );
|
||||
$note->add_action( $note_action['name'], $note_action['label'], $note_action['query'] );
|
||||
return $note;
|
||||
}
|
||||
|
||||
/**
|
||||
* Checks if a note can and should be added.
|
||||
*
|
||||
* @return bool
|
||||
*/
|
||||
public function can_be_added() {
|
||||
// If the milestone notes have been disabled via filter, bail.
|
||||
if ( ! $this->are_milestones_enabled() ) {
|
||||
return false;
|
||||
}
|
||||
|
||||
$last_milestone = $this->get_last_milestone();
|
||||
$current_milestone = $this->get_current_milestone();
|
||||
|
||||
if ( $current_milestone <= $last_milestone ) {
|
||||
return false;
|
||||
}
|
||||
|
||||
return true;
|
||||
}
|
||||
|
||||
/**
|
||||
* Add milestone notes for other significant thresholds.
|
||||
*/
|
||||
public function possibly_add_note() {
|
||||
if ( ! self::can_be_added() ) {
|
||||
return;
|
||||
}
|
||||
$current_milestone = $this->get_current_milestone();
|
||||
$this->set_last_milestone( $current_milestone );
|
||||
|
||||
// We only want one milestone note at any time.
|
||||
Notes::delete_notes_with_name( self::NOTE_NAME );
|
||||
$note = $this->get_note_by_milestone( $current_milestone );
|
||||
$note->save();
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,84 @@
|
||||
<?php
|
||||
/**
|
||||
* WooCommerce Admin Payments More Info Needed Inbox Note Provider
|
||||
*/
|
||||
|
||||
namespace Automattic\WooCommerce\Internal\Admin\Notes;
|
||||
|
||||
use Automattic\WooCommerce\Admin\Notes\Note;
|
||||
use Automattic\WooCommerce\Admin\Notes\NoteTraits;
|
||||
use Automattic\WooCommerce\Admin\PluginsHelper;
|
||||
|
||||
defined( 'ABSPATH' ) || exit;
|
||||
|
||||
/**
|
||||
* PaymentsMoreInfoNeeded
|
||||
*/
|
||||
class PaymentsMoreInfoNeeded {
|
||||
/**
|
||||
* Note traits.
|
||||
*/
|
||||
use NoteTraits;
|
||||
|
||||
/**
|
||||
* Name of the note for use in the database.
|
||||
*/
|
||||
const NOTE_NAME = 'wc-admin-payments-more-info-needed';
|
||||
|
||||
/**
|
||||
* Should this note exist?
|
||||
*/
|
||||
public static function is_applicable() {
|
||||
return self::should_display_note();
|
||||
}
|
||||
|
||||
/**
|
||||
* Returns true if we should display the note.
|
||||
*
|
||||
* @return bool
|
||||
*/
|
||||
public static function should_display_note() {
|
||||
// If user has installed WCPay, don't show this note.
|
||||
$installed_plugins = PluginsHelper::get_installed_plugin_slugs();
|
||||
if ( in_array( 'woocommerce-payments', $installed_plugins, true ) ) {
|
||||
return false;
|
||||
}
|
||||
|
||||
// User has dismissed the WCPay Welcome Page.
|
||||
if ( 'yes' !== get_option( 'wc_calypso_bridge_payments_dismissed', 'no' ) ) {
|
||||
return false;
|
||||
}
|
||||
|
||||
// More than 30 days since viewing the welcome page.
|
||||
$exit_survey_timestamp = get_option( 'wc_pay_exit_survey_more_info_needed_timestamp', false );
|
||||
if ( ! $exit_survey_timestamp ||
|
||||
( time() - $exit_survey_timestamp < 30 * DAY_IN_SECONDS )
|
||||
) {
|
||||
return false;
|
||||
}
|
||||
|
||||
return true;
|
||||
}
|
||||
|
||||
/**
|
||||
* Get the note.
|
||||
*
|
||||
* @return Note
|
||||
*/
|
||||
public static function get_note() {
|
||||
if ( ! self::should_display_note() ) {
|
||||
return;
|
||||
}
|
||||
$content = __( 'We recently asked you if you wanted more information about WooCommerce Payments. Run your business and manage your payments in one place with the solution built and supported by WooCommerce.', 'woocommerce' );
|
||||
|
||||
$note = new Note();
|
||||
$note->set_title( __( 'Payments made simple with WooCommerce Payments', 'woocommerce' ) );
|
||||
$note->set_content( $content );
|
||||
$note->set_content_data( (object) array() );
|
||||
$note->set_type( Note::E_WC_ADMIN_NOTE_INFORMATIONAL );
|
||||
$note->set_name( self::NOTE_NAME );
|
||||
$note->set_source( 'woocommerce-admin' );
|
||||
$note->add_action( 'learn-more', __( 'Learn more here', 'woocommerce' ), 'https://woocommerce.com/payments/' );
|
||||
return $note;
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,83 @@
|
||||
<?php
|
||||
/**
|
||||
* WooCommerce Admin Payment Reminder Me later
|
||||
*/
|
||||
|
||||
namespace Automattic\WooCommerce\Internal\Admin\Notes;
|
||||
|
||||
use Automattic\WooCommerce\Admin\Notes\Note;
|
||||
use Automattic\WooCommerce\Admin\Notes\NoteTraits;
|
||||
use Automattic\WooCommerce\Admin\PluginsHelper;
|
||||
|
||||
defined( 'ABSPATH' ) || exit;
|
||||
|
||||
/**
|
||||
* PaymentsRemindMeLater
|
||||
*/
|
||||
class PaymentsRemindMeLater {
|
||||
/**
|
||||
* Note traits.
|
||||
*/
|
||||
use NoteTraits;
|
||||
|
||||
/**
|
||||
* Name of the note for use in the database.
|
||||
*/
|
||||
const NOTE_NAME = 'wc-admin-payments-remind-me-later';
|
||||
|
||||
/**
|
||||
* Should this note exist?
|
||||
*/
|
||||
public static function is_applicable() {
|
||||
return self::should_display_note();
|
||||
}
|
||||
|
||||
/**
|
||||
* Returns true if we should display the note.
|
||||
*
|
||||
* @return bool
|
||||
*/
|
||||
public static function should_display_note() {
|
||||
// Installed WCPay.
|
||||
$installed_plugins = PluginsHelper::get_installed_plugin_slugs();
|
||||
if ( in_array( 'woocommerce-payments', $installed_plugins, true ) ) {
|
||||
return false;
|
||||
}
|
||||
// Dismissed WCPay welcome page.
|
||||
if ( 'yes' === get_option( 'wc_calypso_bridge_payments_dismissed', 'no' ) ) {
|
||||
return false;
|
||||
}
|
||||
|
||||
// Less than 3 days since viewing welcome page.
|
||||
$view_timestamp = get_option( 'wc_pay_welcome_page_viewed_timestamp', false );
|
||||
if ( ! $view_timestamp ||
|
||||
( time() - $view_timestamp < 3 * DAY_IN_SECONDS )
|
||||
) {
|
||||
return false;
|
||||
}
|
||||
return true;
|
||||
}
|
||||
|
||||
|
||||
/**
|
||||
* Get the note.
|
||||
*
|
||||
* @return Note
|
||||
*/
|
||||
public static function get_note() {
|
||||
if ( ! self::should_display_note() ) {
|
||||
return;
|
||||
}
|
||||
$content = __( 'Save up to $800 in fees by managing transactions with WooCommerce Payments. With WooCommerce Payments, you can securely accept major cards, Apple Pay, and payments in over 100 currencies.', 'woocommerce' );
|
||||
|
||||
$note = new Note();
|
||||
$note->set_title( __( 'Save big with WooCommerce Payments', 'woocommerce' ) );
|
||||
$note->set_content( $content );
|
||||
$note->set_content_data( (object) array() );
|
||||
$note->set_type( Note::E_WC_ADMIN_NOTE_INFORMATIONAL );
|
||||
$note->set_name( self::NOTE_NAME );
|
||||
$note->set_source( 'woocommerce-admin' );
|
||||
$note->add_action( 'learn-more', __( 'Learn more', 'woocommerce' ), admin_url( 'admin.php?page=wc-admin&path=/wc-pay-welcome-page' ) );
|
||||
return $note;
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,68 @@
|
||||
<?php
|
||||
/**
|
||||
* WooCommerce Admin Performance on mobile note.
|
||||
*
|
||||
* Adds a note to download the mobile app, performance on mobile.
|
||||
*/
|
||||
|
||||
namespace Automattic\WooCommerce\Internal\Admin\Notes;
|
||||
|
||||
defined( 'ABSPATH' ) || exit;
|
||||
|
||||
use Automattic\WooCommerce\Admin\Notes\Note;
|
||||
use Automattic\WooCommerce\Admin\Notes\NoteTraits;
|
||||
|
||||
/**
|
||||
* Performance_On_Mobile
|
||||
*/
|
||||
class PerformanceOnMobile {
|
||||
/**
|
||||
* Note traits.
|
||||
*/
|
||||
use NoteTraits;
|
||||
|
||||
/**
|
||||
* Name of the note for use in the database.
|
||||
*/
|
||||
const NOTE_NAME = 'wc-admin-performance-on-mobile';
|
||||
|
||||
/**
|
||||
* Get the note.
|
||||
*
|
||||
* @return Note
|
||||
*/
|
||||
public static function get_note() {
|
||||
// Only add this note if this store is at least 9 months old.
|
||||
$nine_months_in_seconds = MONTH_IN_SECONDS * 9;
|
||||
if ( ! self::wc_admin_active_for( $nine_months_in_seconds ) ) {
|
||||
return;
|
||||
}
|
||||
|
||||
// Check that the previous mobile app notes have not been actioned.
|
||||
if ( MobileApp::has_note_been_actioned() ) {
|
||||
return;
|
||||
}
|
||||
if ( RealTimeOrderAlerts::has_note_been_actioned() ) {
|
||||
return;
|
||||
}
|
||||
if ( ManageOrdersOnTheGo::has_note_been_actioned() ) {
|
||||
return;
|
||||
}
|
||||
|
||||
$note = new Note();
|
||||
|
||||
$note->set_title( __( 'Track your store performance on mobile', 'woocommerce' ) );
|
||||
$note->set_content( __( 'Monitor your sales and high performing products with the Woo app.', 'woocommerce' ) );
|
||||
$note->set_content_data( (object) array() );
|
||||
$note->set_type( Note::E_WC_ADMIN_NOTE_INFORMATIONAL );
|
||||
$note->set_name( self::NOTE_NAME );
|
||||
$note->set_source( 'woocommerce-admin' );
|
||||
$note->add_action(
|
||||
'learn-more',
|
||||
__( 'Learn more', 'woocommerce' ),
|
||||
'https://woocommerce.com/mobile/?utm_source=inbox&utm_medium=product'
|
||||
);
|
||||
|
||||
return $note;
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,63 @@
|
||||
<?php
|
||||
/**
|
||||
* WooCommerce Admin Personalize Your Store Note Provider.
|
||||
*
|
||||
* Adds a note to the merchant's inbox prompting them to personalize their store.
|
||||
*/
|
||||
|
||||
namespace Automattic\WooCommerce\Internal\Admin\Notes;
|
||||
|
||||
defined( 'ABSPATH' ) || exit;
|
||||
|
||||
use Automattic\WooCommerce\Admin\Notes\Note;
|
||||
use Automattic\WooCommerce\Admin\Notes\NoteTraits;
|
||||
|
||||
/**
|
||||
* Personalize_Store
|
||||
*/
|
||||
class PersonalizeStore {
|
||||
/**
|
||||
* Note traits.
|
||||
*/
|
||||
use NoteTraits;
|
||||
|
||||
/**
|
||||
* Name of the note for use in the database.
|
||||
*/
|
||||
const NOTE_NAME = 'wc-admin-personalize-store';
|
||||
|
||||
/**
|
||||
* Get the note.
|
||||
*
|
||||
* @return Note
|
||||
*/
|
||||
public static function get_note() {
|
||||
// Only show the note to stores with homepage.
|
||||
$homepage_id = get_option( 'woocommerce_onboarding_homepage_post_id', false );
|
||||
if ( ! $homepage_id ) {
|
||||
return;
|
||||
}
|
||||
|
||||
// Show the note after task list is done.
|
||||
$is_task_list_complete = get_option( 'woocommerce_task_list_complete', false );
|
||||
|
||||
// We want to show the note after day 5.
|
||||
$five_days_in_seconds = 5 * DAY_IN_SECONDS;
|
||||
|
||||
if ( ! self::is_wc_admin_active_in_date_range( 'week-1-4', $five_days_in_seconds ) && ! $is_task_list_complete ) {
|
||||
return;
|
||||
}
|
||||
|
||||
$content = __( 'The homepage is one of the most important entry points in your store. When done right it can lead to higher conversions and engagement. Don\'t forget to personalize the homepage that we created for your store during the onboarding.', 'woocommerce' );
|
||||
|
||||
$note = new Note();
|
||||
$note->set_title( __( 'Personalize your store\'s homepage', 'woocommerce' ) );
|
||||
$note->set_content( $content );
|
||||
$note->set_content_data( (object) array() );
|
||||
$note->set_type( Note::E_WC_ADMIN_NOTE_INFORMATIONAL );
|
||||
$note->set_name( self::NOTE_NAME );
|
||||
$note->set_source( 'woocommerce-admin' );
|
||||
$note->add_action( 'personalize-homepage', __( 'Personalize homepage', 'woocommerce' ), admin_url( 'post.php?post=' . $homepage_id . '&action=edit' ), Note::E_WC_ADMIN_NOTE_ACTIONED );
|
||||
return $note;
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,57 @@
|
||||
<?php
|
||||
/**
|
||||
* WooCommerce Admin Real Time Order Alerts Note.
|
||||
*
|
||||
* Adds a note to download the mobile app to monitor store activity.
|
||||
*/
|
||||
|
||||
namespace Automattic\WooCommerce\Internal\Admin\Notes;
|
||||
|
||||
defined( 'ABSPATH' ) || exit;
|
||||
|
||||
use Automattic\WooCommerce\Admin\Notes\Note;
|
||||
use Automattic\WooCommerce\Admin\Notes\NoteTraits;
|
||||
|
||||
/**
|
||||
* Real_Time_Order_Alerts
|
||||
*/
|
||||
class RealTimeOrderAlerts {
|
||||
/**
|
||||
* Note traits.
|
||||
*/
|
||||
use NoteTraits;
|
||||
|
||||
/**
|
||||
* Name of the note for use in the database.
|
||||
*/
|
||||
const NOTE_NAME = 'wc-admin-real-time-order-alerts';
|
||||
|
||||
/**
|
||||
* Get the note.
|
||||
*
|
||||
* @return Note
|
||||
*/
|
||||
public static function get_note() {
|
||||
// Only add this note if the store is 3 months old.
|
||||
if ( ! self::is_wc_admin_active_in_date_range( 'month-3-6' ) ) {
|
||||
return;
|
||||
}
|
||||
|
||||
// Check that the previous mobile app note was not actioned.
|
||||
if ( MobileApp::has_note_been_actioned() ) {
|
||||
return;
|
||||
}
|
||||
|
||||
$content = __( 'Get notifications about store activity, including new orders and product reviews directly on your mobile devices with the Woo app.', 'woocommerce' );
|
||||
|
||||
$note = new Note();
|
||||
$note->set_title( __( 'Get real-time order alerts anywhere', 'woocommerce' ) );
|
||||
$note->set_content( $content );
|
||||
$note->set_content_data( (object) array() );
|
||||
$note->set_type( Note::E_WC_ADMIN_NOTE_INFORMATIONAL );
|
||||
$note->set_name( self::NOTE_NAME );
|
||||
$note->set_source( 'woocommerce-admin' );
|
||||
$note->add_action( 'learn-more', __( 'Learn more', 'woocommerce' ), 'https://woocommerce.com/mobile/?utm_source=inbox&utm_medium=product' );
|
||||
return $note;
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,85 @@
|
||||
<?php
|
||||
/**
|
||||
* WooCommerce Admin: Selling Online Courses note
|
||||
*
|
||||
* Adds a note to encourage selling online courses.
|
||||
*/
|
||||
|
||||
namespace Automattic\WooCommerce\Internal\Admin\Notes;
|
||||
|
||||
defined( 'ABSPATH' ) || exit;
|
||||
|
||||
use Automattic\WooCommerce\Admin\Notes\Note;
|
||||
use Automattic\WooCommerce\Admin\Notes\NoteTraits;
|
||||
use Automattic\WooCommerce\Internal\Admin\Onboarding\OnboardingProfile;
|
||||
|
||||
/**
|
||||
* Selling_Online_Courses
|
||||
*/
|
||||
class SellingOnlineCourses {
|
||||
/**
|
||||
* Note traits.
|
||||
*/
|
||||
use NoteTraits;
|
||||
|
||||
/**
|
||||
* Name of the note for use in the database.
|
||||
*/
|
||||
const NOTE_NAME = 'wc-admin-selling-online-courses';
|
||||
|
||||
/**
|
||||
* Attach hooks.
|
||||
*/
|
||||
public function __construct() {
|
||||
add_action(
|
||||
'update_option_' . OnboardingProfile::DATA_OPTION,
|
||||
array( $this, 'check_onboarding_profile' ),
|
||||
10,
|
||||
3
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Check to see if the profiler options match before possibly adding note.
|
||||
*
|
||||
* @param object $old_value The old option value.
|
||||
* @param object $value The new option value.
|
||||
* @param string $option The name of the option.
|
||||
*/
|
||||
public static function check_onboarding_profile( $old_value, $value, $option ) {
|
||||
// Skip adding if this store is in the education/learning industry.
|
||||
if ( ! isset( $value['industry'] ) ) {
|
||||
return;
|
||||
}
|
||||
$industry_slugs = array_column( $value['industry'], 'slug' );
|
||||
if ( ! in_array( 'education-and-learning', $industry_slugs, true ) ) {
|
||||
return;
|
||||
}
|
||||
|
||||
self::possibly_add_note();
|
||||
}
|
||||
|
||||
/**
|
||||
* Get the note.
|
||||
*
|
||||
* @return Note
|
||||
*/
|
||||
public static function get_note() {
|
||||
$note = new Note();
|
||||
|
||||
$note->set_title( __( 'Do you want to sell online courses?', 'woocommerce' ) );
|
||||
$note->set_content( __( 'Online courses are a great solution for any business that can teach a new skill. Since courses don’t require physical product development or shipping, they’re affordable, fast to create, and can generate passive income for years to come. In this article, we provide you more information about selling courses using WooCommerce.', 'woocommerce' ) );
|
||||
$note->set_content_data( (object) array() );
|
||||
$note->set_type( Note::E_WC_ADMIN_NOTE_MARKETING );
|
||||
$note->set_name( self::NOTE_NAME );
|
||||
$note->set_source( 'woocommerce-admin' );
|
||||
$note->add_action(
|
||||
'learn-more',
|
||||
__( 'Learn more', 'woocommerce' ),
|
||||
'https://woocommerce.com/posts/how-to-sell-online-courses-wordpress/?utm_source=inbox&utm_medium=product',
|
||||
Note::E_WC_ADMIN_NOTE_ACTIONED
|
||||
);
|
||||
|
||||
return $note;
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,104 @@
|
||||
<?php
|
||||
/**
|
||||
* WooCommerce Admin Test Checkout.
|
||||
*
|
||||
* Adds a note to remind the user to test their store checkout.
|
||||
*
|
||||
* @package WooCommerce\Admin
|
||||
*/
|
||||
|
||||
namespace Automattic\WooCommerce\Internal\Admin\Notes;
|
||||
|
||||
defined( 'ABSPATH' ) || exit;
|
||||
|
||||
use Automattic\WooCommerce\Admin\Notes\Note;
|
||||
use Automattic\WooCommerce\Admin\Notes\NoteTraits;
|
||||
|
||||
/**
|
||||
* Test_Checkout
|
||||
*/
|
||||
class TestCheckout {
|
||||
/**
|
||||
* Note traits.
|
||||
*/
|
||||
use NoteTraits;
|
||||
|
||||
/**
|
||||
* Name of the note for use in the database.
|
||||
*/
|
||||
const NOTE_NAME = 'wc-admin-test-checkout';
|
||||
|
||||
/**
|
||||
* Completed tasks option name.
|
||||
*/
|
||||
const TASK_LIST_TRACKED_TASKS = 'woocommerce_task_list_tracked_completed_tasks';
|
||||
|
||||
/**
|
||||
* Constructor.
|
||||
*/
|
||||
public function __construct() {
|
||||
add_action( 'update_option_' . self::TASK_LIST_TRACKED_TASKS, array( $this, 'possibly_add_note' ) );
|
||||
}
|
||||
|
||||
/**
|
||||
* Get the note.
|
||||
*
|
||||
* @return Note|null
|
||||
*/
|
||||
public static function get_note() {
|
||||
$onboarding_profile = get_option( 'woocommerce_onboarding_profile', array() );
|
||||
|
||||
// Confirm that $onboarding_profile is set.
|
||||
if ( empty( $onboarding_profile ) ) {
|
||||
return;
|
||||
}
|
||||
|
||||
// Make sure that the person who filled out the OBW was not setting up
|
||||
// the store for their customer/client.
|
||||
if (
|
||||
! isset( $onboarding_profile['setup_client'] ) ||
|
||||
$onboarding_profile['setup_client']
|
||||
) {
|
||||
return;
|
||||
}
|
||||
|
||||
// Make sure payments task was completed.
|
||||
$completed_tasks = get_option( self::TASK_LIST_TRACKED_TASKS, array() );
|
||||
if ( ! in_array( 'payments', $completed_tasks, true ) ) {
|
||||
return;
|
||||
}
|
||||
|
||||
// Make sure that products were added within the previous 1/2 hour.
|
||||
$query = new \WC_Product_Query(
|
||||
array(
|
||||
'limit' => 1,
|
||||
'status' => 'publish',
|
||||
'orderby' => 'date',
|
||||
'order' => 'ASC',
|
||||
)
|
||||
);
|
||||
|
||||
$products = $query->get_products();
|
||||
if ( 0 === count( $products ) ) {
|
||||
return;
|
||||
}
|
||||
|
||||
$oldest_product_timestamp = $products[0]->get_date_created()->getTimestamp();
|
||||
$half_hour_in_seconds = 30 * MINUTE_IN_SECONDS;
|
||||
if ( ( time() - $oldest_product_timestamp ) > $half_hour_in_seconds ) {
|
||||
return;
|
||||
}
|
||||
|
||||
$content = __( 'Make sure that your checkout is working properly before you launch your store. Go through your checkout process in its entirety: from adding a product to your cart, choosing a shipping location, and making a payment.', 'woocommerce' );
|
||||
|
||||
$note = new Note();
|
||||
$note->set_title( __( 'Don\'t forget to test your checkout', 'woocommerce' ) );
|
||||
$note->set_content( $content );
|
||||
$note->set_content_data( (object) array() );
|
||||
$note->set_type( Note::E_WC_ADMIN_NOTE_INFORMATIONAL );
|
||||
$note->set_name( self::NOTE_NAME );
|
||||
$note->set_source( 'woocommerce-admin' );
|
||||
$note->add_action( 'test-checkout', __( 'Test checkout', 'woocommerce' ), wc_get_page_permalink( 'shop' ) );
|
||||
return $note;
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,89 @@
|
||||
<?php
|
||||
/**
|
||||
* WooCommerce Admin Usage Tracking Opt In Note Provider.
|
||||
*
|
||||
* Adds a Usage Tracking Opt In extension note.
|
||||
*/
|
||||
|
||||
namespace Automattic\WooCommerce\Internal\Admin\Notes;
|
||||
|
||||
defined( 'ABSPATH' ) || exit;
|
||||
|
||||
use Automattic\WooCommerce\Admin\Notes\Note;
|
||||
use Automattic\WooCommerce\Admin\Notes\NoteTraits;
|
||||
|
||||
/**
|
||||
* Tracking_Opt_In
|
||||
*/
|
||||
class TrackingOptIn {
|
||||
/**
|
||||
* Note traits.
|
||||
*/
|
||||
use NoteTraits;
|
||||
|
||||
/**
|
||||
* Name of the note for use in the database.
|
||||
*/
|
||||
const NOTE_NAME = 'wc-admin-usage-tracking-opt-in';
|
||||
|
||||
/**
|
||||
* Attach hooks.
|
||||
*/
|
||||
public function __construct() {
|
||||
add_action( 'woocommerce_note_action_tracking-opt-in', array( $this, 'opt_in_to_tracking' ) );
|
||||
}
|
||||
|
||||
/**
|
||||
* Get the note.
|
||||
*
|
||||
* @return Note|null
|
||||
*/
|
||||
public static function get_note() {
|
||||
// Only show this note to stores that are opted out.
|
||||
if ( 'yes' === get_option( 'woocommerce_allow_tracking', 'no' ) ) {
|
||||
return;
|
||||
}
|
||||
|
||||
// We want to show the note after one week.
|
||||
if ( ! self::is_wc_admin_active_in_date_range( 'week-1-4' ) ) {
|
||||
return;
|
||||
}
|
||||
|
||||
/* translators: 1: open link to WooCommerce.com settings, 2: open link to WooCommerce.com tracking documentation, 3: close link tag. */
|
||||
$content_format = __(
|
||||
'Gathering usage data allows us to improve WooCommerce. Your store will be considered as we evaluate new features, judge the quality of an update, or determine if an improvement makes sense. You can always visit the %1$sSettings%3$s and choose to stop sharing data. %2$sRead more%3$s about what data we collect.',
|
||||
'woocommerce'
|
||||
);
|
||||
|
||||
$note_content = sprintf(
|
||||
$content_format,
|
||||
'<a href="' . esc_url( admin_url( 'admin.php?page=wc-settings&tab=advanced§ion=woocommerce_com' ) ) . '" target="_blank">',
|
||||
'<a href="https://woocommerce.com/usage-tracking?utm_medium=product" target="_blank">',
|
||||
'</a>'
|
||||
);
|
||||
|
||||
$note = new Note();
|
||||
$note->set_title( __( 'Help WooCommerce improve with usage tracking', 'woocommerce' ) );
|
||||
$note->set_content( $note_content );
|
||||
$note->set_content_data( (object) array() );
|
||||
$note->set_type( Note::E_WC_ADMIN_NOTE_INFORMATIONAL );
|
||||
$note->set_name( self::NOTE_NAME );
|
||||
$note->set_source( 'woocommerce-admin' );
|
||||
$note->add_action( 'tracking-opt-in', __( 'Activate usage tracking', 'woocommerce' ), false, Note::E_WC_ADMIN_NOTE_ACTIONED, true );
|
||||
return $note;
|
||||
}
|
||||
|
||||
/**
|
||||
* Opt in to usage tracking when note is actioned.
|
||||
*
|
||||
* @param Note $note Note being acted upon.
|
||||
*/
|
||||
public function opt_in_to_tracking( $note ) {
|
||||
if ( self::NOTE_NAME === $note->get_name() ) {
|
||||
// Opt in to tracking and schedule the first data update.
|
||||
// Same mechanism as in WC_Admin_Setup_Wizard::wc_setup_store_setup_save().
|
||||
update_option( 'woocommerce_allow_tracking', 'yes' );
|
||||
wp_schedule_single_event( time() + 10, 'woocommerce_tracker_send_event', array( true ) );
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,88 @@
|
||||
<?php
|
||||
/**
|
||||
* WooCommerce Admin Unsecured Files Note.
|
||||
*
|
||||
* Adds a warning about potentially unsecured files.
|
||||
*/
|
||||
|
||||
namespace Automattic\WooCommerce\Internal\Admin\Notes;
|
||||
|
||||
defined( 'ABSPATH' ) || exit;
|
||||
|
||||
use Automattic\WooCommerce\Admin\Notes\Note;
|
||||
|
||||
if ( ! class_exists( Note::class ) ) {
|
||||
class_alias( WC_Admin_Note::class, Note::class );
|
||||
}
|
||||
|
||||
/**
|
||||
* Unsecured_Report_Files
|
||||
*/
|
||||
class UnsecuredReportFiles {
|
||||
|
||||
/**
|
||||
* Name of the note for use in the database.
|
||||
*/
|
||||
const NOTE_NAME = 'wc-admin-remove-unsecured-report-files';
|
||||
|
||||
/**
|
||||
* Get the note.
|
||||
*
|
||||
* @return Note|null
|
||||
*/
|
||||
public static function get_note() {
|
||||
$note = new Note();
|
||||
$note->set_title( __( 'Potentially unsecured files were found in your uploads directory', 'woocommerce' ) );
|
||||
$note->set_content(
|
||||
sprintf(
|
||||
/* translators: 1: opening analytics docs link tag. 2: closing link tag */
|
||||
__( 'Files that may contain %1$sstore analytics%2$s reports were found in your uploads directory - we recommend assessing and deleting any such files.', 'woocommerce' ),
|
||||
'<a href="https://woocommerce.com/document/woocommerce-analytics/" target="_blank">',
|
||||
'</a>'
|
||||
)
|
||||
);
|
||||
$note->set_content_data( (object) array() );
|
||||
$note->set_type( Note::E_WC_ADMIN_NOTE_ERROR );
|
||||
$note->set_name( self::NOTE_NAME );
|
||||
$note->set_source( 'woocommerce-admin' );
|
||||
$note->add_action(
|
||||
'learn-more',
|
||||
__( 'Learn more', 'woocommerce' ),
|
||||
'https://developer.woocommerce.com/?p=10410',
|
||||
Note::E_WC_ADMIN_NOTE_UNACTIONED,
|
||||
true
|
||||
);
|
||||
$note->add_action(
|
||||
'dismiss',
|
||||
__( 'Dismiss', 'woocommerce' ),
|
||||
wc_admin_url(),
|
||||
Note::E_WC_ADMIN_NOTE_ACTIONED,
|
||||
false
|
||||
);
|
||||
|
||||
return $note;
|
||||
}
|
||||
|
||||
/**
|
||||
* Add the note if it passes predefined conditions.
|
||||
*/
|
||||
public static function possibly_add_note() {
|
||||
$note = self::get_note();
|
||||
|
||||
if ( self::note_exists() ) {
|
||||
return;
|
||||
}
|
||||
|
||||
$note->save();
|
||||
}
|
||||
|
||||
/**
|
||||
* Check if the note has been previously added.
|
||||
*/
|
||||
public static function note_exists() {
|
||||
$data_store = \WC_Data_Store::load( 'admin-note' );
|
||||
$note_ids = $data_store->get_notes_with_name( self::NOTE_NAME );
|
||||
return ! empty( $note_ids );
|
||||
}
|
||||
|
||||
}
|
||||
@@ -0,0 +1,224 @@
|
||||
<?php
|
||||
/**
|
||||
* WooCommerce Admin WooCommerce Payments Note Provider.
|
||||
*
|
||||
* Adds a note to the merchant's inbox showing the benefits of the WooCommerce Payments.
|
||||
*/
|
||||
|
||||
namespace Automattic\WooCommerce\Internal\Admin\Notes;
|
||||
|
||||
defined( 'ABSPATH' ) || exit;
|
||||
|
||||
use Automattic\WooCommerce\Admin\Notes\Note;
|
||||
use Automattic\WooCommerce\Admin\Notes\Notes;
|
||||
use Automattic\WooCommerce\Admin\Notes\NoteTraits;
|
||||
|
||||
/**
|
||||
* WooCommerce_Payments
|
||||
*/
|
||||
class WooCommercePayments {
|
||||
/**
|
||||
* Note traits.
|
||||
*/
|
||||
use NoteTraits;
|
||||
|
||||
/**
|
||||
* Name of the note for use in the database.
|
||||
*/
|
||||
const NOTE_NAME = 'wc-admin-woocommerce-payments';
|
||||
|
||||
/**
|
||||
* Name of the note for use in the database.
|
||||
*/
|
||||
const PLUGIN_SLUG = 'woocommerce-payments';
|
||||
|
||||
/**
|
||||
* Name of the note for use in the database.
|
||||
*/
|
||||
const PLUGIN_FILE = 'woocommerce-payments/woocommerce-payments.php';
|
||||
|
||||
/**
|
||||
* Attach hooks.
|
||||
*/
|
||||
public function __construct() {
|
||||
add_action( 'init', array( $this, 'install_on_action' ) );
|
||||
add_action( 'wc-admin-woocommerce-payments_add_note', array( $this, 'add_note' ) );
|
||||
}
|
||||
|
||||
/**
|
||||
* Maybe add a note on WooCommerce Payments for US based sites older than a week without the plugin installed.
|
||||
*/
|
||||
public static function possibly_add_note() {
|
||||
if ( ! self::is_wc_admin_active_in_date_range( 'week-1-4' ) || 'US' !== WC()->countries->get_base_country() ) {
|
||||
return;
|
||||
}
|
||||
|
||||
$data_store = Notes::load_data_store();
|
||||
|
||||
// We already have this note? Then mark the note as actioned.
|
||||
$note_ids = $data_store->get_notes_with_name( self::NOTE_NAME );
|
||||
if ( ! empty( $note_ids ) ) {
|
||||
|
||||
$note_id = array_pop( $note_ids );
|
||||
$note = Notes::get_note( $note_id );
|
||||
if ( false === $note ) {
|
||||
return;
|
||||
}
|
||||
|
||||
// If the WooCommerce Payments plugin was installed after the note was created, make sure it's marked as actioned.
|
||||
if ( self::is_installed() && Note::E_WC_ADMIN_NOTE_ACTIONED !== $note->get_status() ) {
|
||||
$note->set_status( Note::E_WC_ADMIN_NOTE_ACTIONED );
|
||||
$note->save();
|
||||
}
|
||||
|
||||
return;
|
||||
}
|
||||
|
||||
$current_date = new \DateTime();
|
||||
$publish_date = new \DateTime( '2020-04-14' );
|
||||
|
||||
if ( $current_date >= $publish_date ) {
|
||||
|
||||
$note = self::get_note();
|
||||
if ( self::can_be_added() ) {
|
||||
$note->save();
|
||||
}
|
||||
|
||||
return;
|
||||
|
||||
} else {
|
||||
|
||||
$hook_name = sprintf( '%s_add_note', self::NOTE_NAME );
|
||||
|
||||
if ( ! WC()->queue()->get_next( $hook_name ) ) {
|
||||
WC()->queue()->schedule_single( $publish_date->getTimestamp(), $hook_name );
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Add a note about WooCommerce Payments.
|
||||
*
|
||||
* @return Note
|
||||
*/
|
||||
public static function get_note() {
|
||||
$note = new Note();
|
||||
$note->set_title( __( 'Try the new way to get paid', 'woocommerce' ) );
|
||||
$note->set_content(
|
||||
__( 'Securely accept credit and debit cards on your site. Manage transactions without leaving your WordPress dashboard. Only with <strong>WooCommerce Payments</strong>.', 'woocommerce' ) .
|
||||
'<br><br>' .
|
||||
sprintf(
|
||||
/* translators: 1: opening link tag, 2: closing tag */
|
||||
__( 'By clicking "Get started", you agree to our %1$sTerms of Service%2$s', 'woocommerce' ),
|
||||
'<a href="https://wordpress.com/tos/" target="_blank">',
|
||||
'</a>'
|
||||
)
|
||||
);
|
||||
$note->set_content_data( (object) array() );
|
||||
$note->set_type( Note::E_WC_ADMIN_NOTE_MARKETING );
|
||||
$note->set_name( self::NOTE_NAME );
|
||||
$note->set_source( 'woocommerce-admin' );
|
||||
$note->add_action( 'learn-more', __( 'Learn more', 'woocommerce' ), 'https://woocommerce.com/payments/?utm_medium=product', Note::E_WC_ADMIN_NOTE_UNACTIONED );
|
||||
$note->add_action( 'get-started', __( 'Get started', 'woocommerce' ), wc_admin_url( '&action=setup-woocommerce-payments' ), Note::E_WC_ADMIN_NOTE_ACTIONED, true );
|
||||
$note->add_nonce_to_action( 'get-started', 'setup-woocommerce-payments', '' );
|
||||
|
||||
// Create the note as "actioned" if the plugin is already installed.
|
||||
if ( self::is_installed() ) {
|
||||
$note->set_status( Note::E_WC_ADMIN_NOTE_ACTIONED );
|
||||
}
|
||||
return $note;
|
||||
}
|
||||
|
||||
|
||||
/**
|
||||
* Check if the WooCommerce Payments plugin is active or installed.
|
||||
*/
|
||||
protected static function is_installed() {
|
||||
if ( defined( 'WC_Payments' ) ) {
|
||||
return true;
|
||||
}
|
||||
include_once ABSPATH . '/wp-admin/includes/plugin.php';
|
||||
return 0 === validate_plugin( self::PLUGIN_FILE );
|
||||
}
|
||||
|
||||
/**
|
||||
* Install and activate WooCommerce Payments.
|
||||
*
|
||||
* @return boolean Whether the plugin was successfully activated.
|
||||
*/
|
||||
private function install_and_activate_wcpay() {
|
||||
$install_request = array( 'plugins' => self::PLUGIN_SLUG );
|
||||
$installer = new \Automattic\WooCommerce\Admin\API\Plugins();
|
||||
$result = $installer->install_plugins( $install_request );
|
||||
if ( is_wp_error( $result ) ) {
|
||||
return false;
|
||||
}
|
||||
|
||||
wc_admin_record_tracks_event( 'woocommerce_payments_install', array( 'context' => 'inbox' ) );
|
||||
|
||||
$activate_request = array( 'plugins' => self::PLUGIN_SLUG );
|
||||
$result = $installer->activate_plugins( $activate_request );
|
||||
if ( is_wp_error( $result ) ) {
|
||||
return false;
|
||||
}
|
||||
|
||||
return true;
|
||||
}
|
||||
|
||||
/**
|
||||
* Install & activate WooCommerce Payments plugin, and redirect to setup.
|
||||
*/
|
||||
public function install_on_action() {
|
||||
// TODO: Need to validate this request more strictly since we're taking install actions directly?
|
||||
if (
|
||||
! isset( $_GET['page'] ) ||
|
||||
'wc-admin' !== $_GET['page'] ||
|
||||
! isset( $_GET['action'] ) ||
|
||||
'setup-woocommerce-payments' !== $_GET['action']
|
||||
) {
|
||||
return;
|
||||
}
|
||||
|
||||
$data_store = Notes::load_data_store();
|
||||
|
||||
// We already have this note? Then mark the note as actioned.
|
||||
$note_ids = $data_store->get_notes_with_name( self::NOTE_NAME );
|
||||
if ( empty( $note_ids ) ) {
|
||||
return;
|
||||
}
|
||||
|
||||
$note_id = array_pop( $note_ids );
|
||||
$note = Notes::get_note( $note_id );
|
||||
if ( false === $note ) {
|
||||
return;
|
||||
}
|
||||
$action = $note->get_action( 'get-started' );
|
||||
if ( ! $action ||
|
||||
( isset( $action->nonce_action ) &&
|
||||
(
|
||||
empty( $_GET['_wpnonce'] ) ||
|
||||
! wp_verify_nonce( wp_unslash( $_GET['_wpnonce'] ), $action->nonce_action ) // phpcs:ignore WordPress.Security.ValidatedSanitizedInput
|
||||
)
|
||||
)
|
||||
) {
|
||||
return;
|
||||
}
|
||||
|
||||
if ( ! current_user_can( 'install_plugins' ) ) {
|
||||
return;
|
||||
}
|
||||
|
||||
$this->install_and_activate_wcpay();
|
||||
|
||||
// WooCommerce Payments is installed at this point, so link straight into the onboarding flow.
|
||||
$connect_url = add_query_arg(
|
||||
array(
|
||||
'wcpay-connect' => '1',
|
||||
'_wpnonce' => wp_create_nonce( 'wcpay-connect' ),
|
||||
),
|
||||
admin_url()
|
||||
);
|
||||
wp_safe_redirect( $connect_url );
|
||||
exit;
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,62 @@
|
||||
<?php
|
||||
/**
|
||||
* WooCommerce Admin: WooCommerce Subscriptions.
|
||||
*
|
||||
* Adds a note to learn more about WooCommerce Subscriptions.
|
||||
*/
|
||||
|
||||
namespace Automattic\WooCommerce\Internal\Admin\Notes;
|
||||
|
||||
defined( 'ABSPATH' ) || exit;
|
||||
|
||||
use Automattic\WooCommerce\Admin\Notes\Note;
|
||||
use Automattic\WooCommerce\Admin\Notes\NoteTraits;
|
||||
use Automattic\WooCommerce\Internal\Admin\Onboarding\OnboardingProfile;
|
||||
|
||||
/**
|
||||
* WooCommerce_Subscriptions.
|
||||
*/
|
||||
class WooCommerceSubscriptions {
|
||||
/**
|
||||
* Note traits.
|
||||
*/
|
||||
use NoteTraits;
|
||||
|
||||
/**
|
||||
* Name of the note for use in the database.
|
||||
*/
|
||||
const NOTE_NAME = 'wc-admin-woocommerce-subscriptions';
|
||||
|
||||
/**
|
||||
* Get the note.
|
||||
*
|
||||
* @return Note|null
|
||||
*/
|
||||
public static function get_note() {
|
||||
$onboarding_data = get_option( OnboardingProfile::DATA_OPTION, array() );
|
||||
|
||||
if ( ! isset( $onboarding_data['product_types'] ) || ! in_array( 'subscriptions', $onboarding_data['product_types'], true ) ) {
|
||||
return;
|
||||
}
|
||||
|
||||
if ( ! self::is_wc_admin_active_in_date_range( 'week-1', DAY_IN_SECONDS ) ) {
|
||||
return;
|
||||
}
|
||||
|
||||
$note = new Note();
|
||||
$note->set_title( __( 'Do you need more info about WooCommerce Subscriptions?', 'woocommerce' ) );
|
||||
$note->set_content( __( 'WooCommerce Subscriptions allows you to introduce a variety of subscriptions for physical or virtual products and services. Create product-of-the-month clubs, weekly service subscriptions or even yearly software billing packages. Add sign-up fees, offer free trials, or set expiration periods.', 'woocommerce' ) );
|
||||
$note->set_type( Note::E_WC_ADMIN_NOTE_MARKETING );
|
||||
$note->set_name( self::NOTE_NAME );
|
||||
$note->set_content_data( (object) array() );
|
||||
$note->set_source( 'woocommerce-admin' );
|
||||
$note->add_action(
|
||||
'learn-more',
|
||||
__( 'Learn More', 'woocommerce' ),
|
||||
'https://woocommerce.com/products/woocommerce-subscriptions/?utm_source=inbox&utm_medium=product',
|
||||
Note::E_WC_ADMIN_NOTE_UNACTIONED,
|
||||
true
|
||||
);
|
||||
return $note;
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,467 @@
|
||||
<?php
|
||||
/**
|
||||
* WooCommerce Admin (Dashboard) WooCommerce.com Extension Subscriptions Note Provider.
|
||||
*
|
||||
* Adds notes to the merchant's inbox concerning WooCommerce.com extension subscriptions.
|
||||
*/
|
||||
|
||||
namespace Automattic\WooCommerce\Internal\Admin\Notes;
|
||||
|
||||
defined( 'ABSPATH' ) || exit;
|
||||
|
||||
use Automattic\WooCommerce\Admin\Notes\Note;
|
||||
use Automattic\WooCommerce\Admin\Notes\Notes;
|
||||
|
||||
/**
|
||||
* Woo_Subscriptions_Notes
|
||||
*/
|
||||
class WooSubscriptionsNotes {
|
||||
const LAST_REFRESH_OPTION_KEY = 'woocommerce_admin-wc-helper-last-refresh';
|
||||
const NOTE_NAME = 'wc-admin-wc-helper-connection';
|
||||
const CONNECTION_NOTE_NAME = 'wc-admin-wc-helper-connection';
|
||||
const SUBSCRIPTION_NOTE_NAME = 'wc-admin-wc-helper-subscription';
|
||||
const NOTIFY_WHEN_DAYS_LEFT = 60;
|
||||
|
||||
/**
|
||||
* We want to bubble up expiration notices when they cross certain age
|
||||
* thresholds. PHP 5.2 doesn't support constant arrays, so we do this.
|
||||
*
|
||||
* @return array
|
||||
*/
|
||||
private function get_bump_thresholds() {
|
||||
return array( 60, 45, 20, 7, 1 ); // days.
|
||||
}
|
||||
|
||||
/**
|
||||
* Hook all the things.
|
||||
*/
|
||||
public function __construct() {
|
||||
add_action( 'admin_init', array( $this, 'admin_init' ) );
|
||||
add_action( 'update_option_woocommerce_helper_data', array( $this, 'update_option_woocommerce_helper_data' ), 10, 2 );
|
||||
}
|
||||
|
||||
/**
|
||||
* Reacts to changes in the helper option.
|
||||
*
|
||||
* @param array $old_value The previous value of the option.
|
||||
* @param array $value The new value of the option.
|
||||
*/
|
||||
public function update_option_woocommerce_helper_data( $old_value, $value ) {
|
||||
if ( ! is_array( $old_value ) ) {
|
||||
$old_value = array();
|
||||
}
|
||||
if ( ! is_array( $value ) ) {
|
||||
$value = array();
|
||||
}
|
||||
|
||||
$old_auth = array_key_exists( 'auth', $old_value ) ? $old_value['auth'] : array();
|
||||
$new_auth = array_key_exists( 'auth', $value ) ? $value['auth'] : array();
|
||||
$old_token = array_key_exists( 'access_token', $old_auth ) ? $old_auth['access_token'] : '';
|
||||
$new_token = array_key_exists( 'access_token', $new_auth ) ? $new_auth['access_token'] : '';
|
||||
|
||||
// The site just disconnected.
|
||||
if ( ! empty( $old_token ) && empty( $new_token ) ) {
|
||||
$this->remove_notes();
|
||||
$this->add_no_connection_note();
|
||||
return;
|
||||
}
|
||||
|
||||
// The site is connected.
|
||||
if ( $this->is_connected() ) {
|
||||
$this->remove_notes();
|
||||
$this->refresh_subscription_notes();
|
||||
return;
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Things to do on admin_init.
|
||||
*/
|
||||
public function admin_init() {
|
||||
$this->check_connection();
|
||||
|
||||
if ( $this->is_connected() ) {
|
||||
$refresh_notes = false;
|
||||
|
||||
// Did the user just do something on the helper page?.
|
||||
if ( isset( $_GET['wc-helper-status'] ) ) { // @codingStandardsIgnoreLine.
|
||||
$refresh_notes = true;
|
||||
}
|
||||
|
||||
// Has it been more than a day since we last checked?
|
||||
// Note: We do it this way and not wp_scheduled_task since WC_Helper_Options is not loaded for cron.
|
||||
$time_now_gmt = current_time( 'timestamp', 0 );
|
||||
$last_refresh = intval( get_option( self::LAST_REFRESH_OPTION_KEY, 0 ) );
|
||||
if ( $last_refresh + DAY_IN_SECONDS <= $time_now_gmt ) {
|
||||
update_option( self::LAST_REFRESH_OPTION_KEY, $time_now_gmt );
|
||||
$refresh_notes = true;
|
||||
}
|
||||
|
||||
if ( $refresh_notes ) {
|
||||
$this->refresh_subscription_notes();
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Checks the connection. Adds a note (as necessary) if there is no connection.
|
||||
*/
|
||||
public function check_connection() {
|
||||
if ( ! $this->is_connected() ) {
|
||||
$data_store = Notes::load_data_store();
|
||||
$note_ids = $data_store->get_notes_with_name( self::CONNECTION_NOTE_NAME );
|
||||
if ( ! empty( $note_ids ) ) {
|
||||
// We already have a connection note. Exit early.
|
||||
return;
|
||||
}
|
||||
|
||||
$this->remove_notes();
|
||||
$this->add_no_connection_note();
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Whether or not we think the site is currently connected to WooCommerce.com.
|
||||
*
|
||||
* @return bool
|
||||
*/
|
||||
public function is_connected() {
|
||||
$auth = \WC_Helper_Options::get( 'auth' );
|
||||
return ( ! empty( $auth['access_token'] ) );
|
||||
}
|
||||
|
||||
/**
|
||||
* Returns the WooCommerce.com provided site ID for this site.
|
||||
*
|
||||
* @return int|false
|
||||
*/
|
||||
public function get_connected_site_id() {
|
||||
if ( ! $this->is_connected() ) {
|
||||
return false;
|
||||
}
|
||||
|
||||
$auth = \WC_Helper_Options::get( 'auth' );
|
||||
return absint( $auth['site_id'] );
|
||||
}
|
||||
|
||||
/**
|
||||
* Returns an array of product_ids whose subscriptions are active on this site.
|
||||
*
|
||||
* @return array
|
||||
*/
|
||||
public function get_subscription_active_product_ids() {
|
||||
$site_id = $this->get_connected_site_id();
|
||||
if ( ! $site_id ) {
|
||||
return array();
|
||||
}
|
||||
|
||||
$product_ids = array();
|
||||
|
||||
if ( $this->is_connected() ) {
|
||||
$subscriptions = \WC_Helper::get_subscriptions();
|
||||
|
||||
foreach ( (array) $subscriptions as $subscription ) {
|
||||
if ( in_array( $site_id, $subscription['connections'], true ) ) {
|
||||
$product_ids[] = $subscription['product_id'];
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
return $product_ids;
|
||||
}
|
||||
|
||||
/**
|
||||
* Clears all connection or subscription notes.
|
||||
*/
|
||||
public function remove_notes() {
|
||||
Notes::delete_notes_with_name( self::CONNECTION_NOTE_NAME );
|
||||
Notes::delete_notes_with_name( self::SUBSCRIPTION_NOTE_NAME );
|
||||
}
|
||||
|
||||
/**
|
||||
* Adds a note prompting to connect to WooCommerce.com.
|
||||
*/
|
||||
public function add_no_connection_note() {
|
||||
$note = self::get_note();
|
||||
$note->save();
|
||||
}
|
||||
|
||||
/**
|
||||
* Get the WooCommerce.com connection note
|
||||
*/
|
||||
public static function get_note() {
|
||||
$note = new Note();
|
||||
$note->set_title( __( 'Connect to WooCommerce.com', 'woocommerce' ) );
|
||||
$note->set_content( __( 'Connect to get important product notifications and updates.', 'woocommerce' ) );
|
||||
$note->set_content_data( (object) array() );
|
||||
$note->set_type( Note::E_WC_ADMIN_NOTE_INFORMATIONAL );
|
||||
$note->set_name( self::CONNECTION_NOTE_NAME );
|
||||
$note->set_source( 'woocommerce-admin' );
|
||||
$note->add_action(
|
||||
'connect',
|
||||
__( 'Connect', 'woocommerce' ),
|
||||
'?page=wc-addons§ion=helper',
|
||||
Note::E_WC_ADMIN_NOTE_UNACTIONED
|
||||
);
|
||||
return $note;
|
||||
}
|
||||
|
||||
/**
|
||||
* Gets the product_id (if any) associated with a note.
|
||||
*
|
||||
* @param Note $note The note object to interrogate.
|
||||
* @return int|false
|
||||
*/
|
||||
public function get_product_id_from_subscription_note( &$note ) {
|
||||
$content_data = $note->get_content_data();
|
||||
|
||||
if ( property_exists( $content_data, 'product_id' ) ) {
|
||||
return intval( $content_data->product_id );
|
||||
}
|
||||
|
||||
return false;
|
||||
}
|
||||
|
||||
/**
|
||||
* Removes notes for product_ids no longer active on this site.
|
||||
*/
|
||||
public function prune_inactive_subscription_notes() {
|
||||
$active_product_ids = $this->get_subscription_active_product_ids();
|
||||
|
||||
$data_store = Notes::load_data_store();
|
||||
$note_ids = $data_store->get_notes_with_name( self::SUBSCRIPTION_NOTE_NAME );
|
||||
|
||||
foreach ( (array) $note_ids as $note_id ) {
|
||||
$note = Notes::get_note( $note_id );
|
||||
$product_id = $this->get_product_id_from_subscription_note( $note );
|
||||
if ( ! empty( $product_id ) ) {
|
||||
if ( ! in_array( $product_id, $active_product_ids, true ) ) {
|
||||
$note->delete();
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Finds a note for a given product ID, if the note exists at all.
|
||||
*
|
||||
* @param int $product_id The product ID to search for.
|
||||
* @return Note|false
|
||||
*/
|
||||
public function find_note_for_product_id( $product_id ) {
|
||||
$product_id = intval( $product_id );
|
||||
|
||||
$data_store = Notes::load_data_store();
|
||||
$note_ids = $data_store->get_notes_with_name( self::SUBSCRIPTION_NOTE_NAME );
|
||||
foreach ( (array) $note_ids as $note_id ) {
|
||||
$note = Notes::get_note( $note_id );
|
||||
$found_product_id = $this->get_product_id_from_subscription_note( $note );
|
||||
|
||||
if ( $product_id === $found_product_id ) {
|
||||
return $note;
|
||||
}
|
||||
}
|
||||
|
||||
return false;
|
||||
}
|
||||
|
||||
/**
|
||||
* Deletes a note for a given product ID, if the note exists at all.
|
||||
*
|
||||
* @param int $product_id The product ID to search for.
|
||||
*/
|
||||
public function delete_any_note_for_product_id( $product_id ) {
|
||||
$product_id = intval( $product_id );
|
||||
|
||||
$note = $this->find_note_for_product_id( $product_id );
|
||||
if ( $note ) {
|
||||
$note->delete();
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Adds or updates a note for an expiring subscription.
|
||||
*
|
||||
* @param array $subscription The subscription to work with.
|
||||
*/
|
||||
public function add_or_update_subscription_expiring( $subscription ) {
|
||||
$product_id = $subscription['product_id'];
|
||||
$product_name = $subscription['product_name'];
|
||||
$expires = intval( $subscription['expires'] );
|
||||
$time_now_gmt = current_time( 'timestamp', 0 );
|
||||
$days_until_expiration = intval( ceil( ( $expires - $time_now_gmt ) / DAY_IN_SECONDS ) );
|
||||
|
||||
$note = $this->find_note_for_product_id( $product_id );
|
||||
|
||||
if ( $note ) {
|
||||
$content_data = $note->get_content_data();
|
||||
if ( property_exists( $content_data, 'days_until_expiration' ) ) {
|
||||
// Note: There is no reason this property should not exist. This is just defensive programming.
|
||||
$note_days_until_expiration = intval( $content_data->days_until_expiration );
|
||||
if ( $days_until_expiration === $note_days_until_expiration ) {
|
||||
// Note is already up to date. Bail.
|
||||
return;
|
||||
}
|
||||
|
||||
// If we have a note and we are at or have crossed a threshold, we should delete
|
||||
// the old note and create a new one, thereby "bumping" the note to the top of the inbox.
|
||||
$bump_thresholds = $this->get_bump_thresholds();
|
||||
$crossing_threshold = false;
|
||||
|
||||
foreach ( (array) $bump_thresholds as $bump_threshold ) {
|
||||
if ( ( $note_days_until_expiration > $bump_threshold ) && ( $days_until_expiration <= $bump_threshold ) ) {
|
||||
$note->delete();
|
||||
$note = false;
|
||||
continue;
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
$note_title = sprintf(
|
||||
/* translators: name of the extension subscription expiring soon */
|
||||
__( '%s subscription expiring soon', 'woocommerce' ),
|
||||
$product_name
|
||||
);
|
||||
|
||||
$note_content = sprintf(
|
||||
/* translators: number of days until the subscription expires */
|
||||
__( 'Your subscription expires in %d days. Enable autorenew to avoid losing updates and access to support.', 'woocommerce' ),
|
||||
$days_until_expiration
|
||||
);
|
||||
|
||||
$note_content_data = (object) array(
|
||||
'product_id' => $product_id,
|
||||
'product_name' => $product_name,
|
||||
'expired' => false,
|
||||
'days_until_expiration' => $days_until_expiration,
|
||||
);
|
||||
|
||||
if ( ! $note ) {
|
||||
$note = new Note();
|
||||
}
|
||||
|
||||
// Reset everything in case we are repurposing an expired note as an expiring note.
|
||||
$note->set_title( $note_title );
|
||||
$note->set_type( Note::E_WC_ADMIN_NOTE_WARNING );
|
||||
$note->set_name( self::SUBSCRIPTION_NOTE_NAME );
|
||||
$note->set_source( 'woocommerce-admin' );
|
||||
$note->clear_actions();
|
||||
$note->add_action(
|
||||
'enable-autorenew',
|
||||
__( 'Enable Autorenew', 'woocommerce' ),
|
||||
'https://woocommerce.com/my-account/my-subscriptions/?utm_medium=product'
|
||||
);
|
||||
$note->set_content( $note_content );
|
||||
$note->set_content_data( $note_content_data );
|
||||
$note->save();
|
||||
}
|
||||
|
||||
/**
|
||||
* Adds a note for an expired subscription, or updates an expiring note to expired.
|
||||
*
|
||||
* @param array $subscription The subscription to work with.
|
||||
*/
|
||||
public function add_or_update_subscription_expired( $subscription ) {
|
||||
$product_id = $subscription['product_id'];
|
||||
$product_name = $subscription['product_name'];
|
||||
$product_page = $subscription['product_url'];
|
||||
$expires = intval( $subscription['expires'] );
|
||||
$expires_date = gmdate( 'F jS', $expires );
|
||||
|
||||
$note = $this->find_note_for_product_id( $product_id );
|
||||
if ( $note ) {
|
||||
$note_content_data = $note->get_content_data();
|
||||
if ( $note_content_data->expired ) {
|
||||
// We've already got a full fledged expired note for this. Bail.
|
||||
// Expired notes' content don't change with time.
|
||||
return;
|
||||
}
|
||||
}
|
||||
|
||||
$note_title = sprintf(
|
||||
/* translators: name of the extension subscription that expired */
|
||||
__( '%s subscription expired', 'woocommerce' ),
|
||||
$product_name
|
||||
);
|
||||
|
||||
$note_content = sprintf(
|
||||
/* translators: date the subscription expired, e.g. Jun 7th 2018 */
|
||||
__( 'Your subscription expired on %s. Get a new subscription to continue receiving updates and access to support.', 'woocommerce' ),
|
||||
$expires_date
|
||||
);
|
||||
|
||||
$note_content_data = (object) array(
|
||||
'product_id' => $product_id,
|
||||
'product_name' => $product_name,
|
||||
'expired' => true,
|
||||
'expires' => $expires,
|
||||
'expires_date' => $expires_date,
|
||||
);
|
||||
|
||||
if ( ! $note ) {
|
||||
$note = new Note();
|
||||
}
|
||||
|
||||
$note->set_title( $note_title );
|
||||
$note->set_content( $note_content );
|
||||
$note->set_content_data( $note_content_data );
|
||||
$note->set_type( Note::E_WC_ADMIN_NOTE_WARNING );
|
||||
$note->set_name( self::SUBSCRIPTION_NOTE_NAME );
|
||||
$note->set_source( 'woocommerce-admin' );
|
||||
$note->clear_actions();
|
||||
$note->add_action(
|
||||
'renew-subscription',
|
||||
__( 'Renew Subscription', 'woocommerce' ),
|
||||
$product_page
|
||||
);
|
||||
$note->save();
|
||||
}
|
||||
|
||||
/**
|
||||
* For each active subscription on this site, checks the expiration date and creates/updates/deletes notes.
|
||||
*/
|
||||
public function refresh_subscription_notes() {
|
||||
if ( ! $this->is_connected() ) {
|
||||
return;
|
||||
}
|
||||
|
||||
$this->prune_inactive_subscription_notes();
|
||||
|
||||
$subscriptions = \WC_Helper::get_subscriptions();
|
||||
$active_product_ids = $this->get_subscription_active_product_ids();
|
||||
|
||||
foreach ( (array) $subscriptions as $subscription ) {
|
||||
// Only concern ourselves with active products.
|
||||
$product_id = $subscription['product_id'];
|
||||
if ( ! in_array( $product_id, $active_product_ids, true ) ) {
|
||||
continue;
|
||||
}
|
||||
|
||||
// If the subscription will auto-renew, clean up and exit.
|
||||
if ( $subscription['autorenew'] ) {
|
||||
$this->delete_any_note_for_product_id( $product_id );
|
||||
continue;
|
||||
}
|
||||
|
||||
// If the subscription is not expiring by the first threshold, clean up and exit.
|
||||
$bump_thresholds = $this->get_bump_thresholds();
|
||||
$first_threshold = DAY_IN_SECONDS * $bump_thresholds[0];
|
||||
$expires = intval( $subscription['expires'] );
|
||||
$time_now_gmt = current_time( 'timestamp', 0 );
|
||||
if ( $expires > $time_now_gmt + $first_threshold ) {
|
||||
$this->delete_any_note_for_product_id( $product_id );
|
||||
continue;
|
||||
}
|
||||
|
||||
// Otherwise, if the subscription can still have auto-renew enabled, let them know that now.
|
||||
if ( $expires > $time_now_gmt ) {
|
||||
$this->add_or_update_subscription_expiring( $subscription );
|
||||
continue;
|
||||
}
|
||||
|
||||
// If we got this far, the subscription has completely expired, let them know.
|
||||
$this->add_or_update_subscription_expired( $subscription );
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,25 @@
|
||||
<?php
|
||||
/**
|
||||
* WooCommerce Onboarding
|
||||
*/
|
||||
|
||||
namespace Automattic\WooCommerce\Internal\Admin\Onboarding;
|
||||
|
||||
/**
|
||||
* Initializes backend logic for the onboarding process.
|
||||
*/
|
||||
class Onboarding {
|
||||
/**
|
||||
* Initialize onboarding functionality.
|
||||
*/
|
||||
public static function init() {
|
||||
OnboardingHelper::instance()->init();
|
||||
OnboardingIndustries::init();
|
||||
OnboardingJetpack::instance()->init();
|
||||
OnboardingMailchimp::instance()->init();
|
||||
OnboardingProfile::init();
|
||||
OnboardingSetupWizard::instance()->init();
|
||||
OnboardingSync::instance()->init();
|
||||
OnboardingThemes::init();
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,169 @@
|
||||
<?php
|
||||
/**
|
||||
* WooCommerce Onboarding Helper
|
||||
*/
|
||||
|
||||
namespace Automattic\WooCommerce\Internal\Admin\Onboarding;
|
||||
|
||||
use Automattic\WooCommerce\Admin\PageController;
|
||||
use Automattic\WooCommerce\Admin\Features\OnboardingTasks\TaskLists;
|
||||
|
||||
/**
|
||||
* Contains backend logic for the onboarding profile and checklist feature.
|
||||
*/
|
||||
class OnboardingHelper {
|
||||
|
||||
/**
|
||||
* Class instance.
|
||||
*
|
||||
* @var OnboardingHelper instance
|
||||
*/
|
||||
private static $instance = null;
|
||||
|
||||
/**
|
||||
* Get class instance.
|
||||
*/
|
||||
final public static function instance() {
|
||||
if ( ! static::$instance ) {
|
||||
static::$instance = new static();
|
||||
}
|
||||
return static::$instance;
|
||||
}
|
||||
|
||||
/**
|
||||
* Init.
|
||||
*/
|
||||
public function init() {
|
||||
if ( ! is_admin() ) {
|
||||
return;
|
||||
}
|
||||
|
||||
add_action( 'current_screen', array( $this, 'add_help_tab' ), 60 );
|
||||
add_action( 'current_screen', array( $this, 'reset_task_list' ) );
|
||||
add_action( 'current_screen', array( $this, 'reset_extended_task_list' ) );
|
||||
}
|
||||
|
||||
/**
|
||||
* Update the help tab setup link to reset the onboarding profiler.
|
||||
*/
|
||||
public function add_help_tab() {
|
||||
if ( ! function_exists( 'wc_get_screen_ids' ) ) {
|
||||
return;
|
||||
}
|
||||
|
||||
$screen = get_current_screen();
|
||||
|
||||
if ( ! $screen || ! in_array( $screen->id, wc_get_screen_ids(), true ) ) {
|
||||
return;
|
||||
}
|
||||
|
||||
// Remove the old help tab if it exists.
|
||||
$help_tabs = $screen->get_help_tabs();
|
||||
foreach ( $help_tabs as $help_tab ) {
|
||||
if ( 'woocommerce_onboard_tab' !== $help_tab['id'] ) {
|
||||
continue;
|
||||
}
|
||||
|
||||
$screen->remove_help_tab( 'woocommerce_onboard_tab' );
|
||||
}
|
||||
|
||||
// Add the new help tab.
|
||||
$help_tab = array(
|
||||
'title' => __( 'Setup wizard', 'woocommerce' ),
|
||||
'id' => 'woocommerce_onboard_tab',
|
||||
);
|
||||
|
||||
$setup_list = TaskLists::get_list( 'setup' );
|
||||
$extended_list = TaskLists::get_list( 'extended' );
|
||||
|
||||
if ( $setup_list ) {
|
||||
$help_tab['content'] = '<h2>' . __( 'WooCommerce Onboarding', 'woocommerce' ) . '</h2>';
|
||||
|
||||
$help_tab['content'] .= '<h3>' . __( 'Profile Setup Wizard', 'woocommerce' ) . '</h3>';
|
||||
$help_tab['content'] .= '<p>' . __( 'If you need to access the setup wizard again, please click on the button below.', 'woocommerce' ) . '</p>' .
|
||||
'<p><a href="' . wc_admin_url( '&path=/setup-wizard' ) . '" class="button button-primary">' . __( 'Setup wizard', 'woocommerce' ) . '</a></p>';
|
||||
|
||||
$help_tab['content'] .= '<h3>' . __( 'Task List', 'woocommerce' ) . '</h3>';
|
||||
$help_tab['content'] .= '<p>' . __( 'If you need to enable or disable the task lists, please click on the button below.', 'woocommerce' ) . '</p>' .
|
||||
( $setup_list->is_hidden()
|
||||
? '<p><a href="' . wc_admin_url( '&reset_task_list=1' ) . '" class="button button-primary">' . __( 'Enable', 'woocommerce' ) . '</a></p>'
|
||||
: '<p><a href="' . wc_admin_url( '&reset_task_list=0' ) . '" class="button button-primary">' . __( 'Disable', 'woocommerce' ) . '</a></p>'
|
||||
);
|
||||
}
|
||||
|
||||
if ( $extended_list ) {
|
||||
$help_tab['content'] .= '<h3>' . __( 'Extended task List', 'woocommerce' ) . '</h3>';
|
||||
$help_tab['content'] .= '<p>' . __( 'If you need to enable or disable the extended task lists, please click on the button below.', 'woocommerce' ) . '</p>' .
|
||||
( $extended_list->is_hidden()
|
||||
? '<p><a href="' . wc_admin_url( '&reset_extended_task_list=1' ) . '" class="button button-primary">' . __( 'Enable', 'woocommerce' ) . '</a></p>'
|
||||
: '<p><a href="' . wc_admin_url( '&reset_extended_task_list=0' ) . '" class="button button-primary">' . __( 'Disable', 'woocommerce' ) . '</a></p>'
|
||||
);
|
||||
}
|
||||
|
||||
$screen->add_help_tab( $help_tab );
|
||||
}
|
||||
|
||||
/**
|
||||
* Reset the onboarding task list and redirect to the dashboard.
|
||||
*/
|
||||
public function reset_task_list() {
|
||||
if (
|
||||
! PageController::is_admin_page() ||
|
||||
! isset( $_GET['reset_task_list'] ) // phpcs:ignore CSRF ok.
|
||||
) {
|
||||
return;
|
||||
}
|
||||
|
||||
$task_list = TaskLists::get_list( 'setup' );
|
||||
|
||||
if ( ! $task_list ) {
|
||||
return;
|
||||
}
|
||||
$show = 1 === absint( $_GET['reset_task_list'] ); // phpcs:ignore CSRF ok.
|
||||
$update = $show ? $task_list->unhide() : $task_list->hide(); // phpcs:ignore CSRF ok.
|
||||
|
||||
if ( $update ) {
|
||||
wc_admin_record_tracks_event(
|
||||
'tasklist_toggled',
|
||||
array(
|
||||
'status' => $show ? 'enabled' : 'disabled',
|
||||
)
|
||||
);
|
||||
}
|
||||
|
||||
wp_safe_redirect( wc_admin_url() );
|
||||
exit;
|
||||
}
|
||||
|
||||
/**
|
||||
* Reset the extended task list and redirect to the dashboard.
|
||||
*/
|
||||
public function reset_extended_task_list() {
|
||||
if (
|
||||
! PageController::is_admin_page() ||
|
||||
! isset( $_GET['reset_extended_task_list'] ) // phpcs:ignore CSRF ok.
|
||||
) {
|
||||
return;
|
||||
}
|
||||
|
||||
$task_list = TaskLists::get_list( 'extended' );
|
||||
|
||||
if ( ! $task_list ) {
|
||||
return;
|
||||
}
|
||||
$show = 1 === absint( $_GET['reset_extended_task_list'] ); // phpcs:ignore CSRF ok.
|
||||
$update = $show ? $task_list->unhide() : $task_list->hide(); // phpcs:ignore CSRF ok.
|
||||
|
||||
if ( $update ) {
|
||||
wc_admin_record_tracks_event(
|
||||
'extended_tasklist_toggled',
|
||||
array(
|
||||
'status' => $show ? 'disabled' : 'enabled',
|
||||
)
|
||||
);
|
||||
}
|
||||
|
||||
wp_safe_redirect( wc_admin_url() );
|
||||
exit;
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,83 @@
|
||||
<?php
|
||||
/**
|
||||
* WooCommerce Onboarding Industries
|
||||
*/
|
||||
|
||||
namespace Automattic\WooCommerce\Internal\Admin\Onboarding;
|
||||
|
||||
/**
|
||||
* Logic around onboarding industries.
|
||||
*/
|
||||
class OnboardingIndustries {
|
||||
/**
|
||||
* Init.
|
||||
*/
|
||||
public static function init() {
|
||||
add_filter( 'woocommerce_admin_onboarding_preloaded_data', array( __CLASS__, 'preload_data' ) );
|
||||
}
|
||||
|
||||
/**
|
||||
* Get a list of allowed industries for the onboarding wizard.
|
||||
*
|
||||
* @return array
|
||||
*/
|
||||
public static function get_allowed_industries() {
|
||||
/* With "use_description" we turn the description input on. With "description_label" we set the input label */
|
||||
return apply_filters(
|
||||
'woocommerce_admin_onboarding_industries',
|
||||
array(
|
||||
'fashion-apparel-accessories' => array(
|
||||
'label' => __( 'Fashion, apparel, and accessories', 'woocommerce' ),
|
||||
'use_description' => false,
|
||||
'description_label' => '',
|
||||
),
|
||||
'health-beauty' => array(
|
||||
'label' => __( 'Health and beauty', 'woocommerce' ),
|
||||
'use_description' => false,
|
||||
'description_label' => '',
|
||||
),
|
||||
'electronics-computers' => array(
|
||||
'label' => __( 'Electronics and computers', 'woocommerce' ),
|
||||
'use_description' => false,
|
||||
'description_label' => '',
|
||||
),
|
||||
'food-drink' => array(
|
||||
'label' => __( 'Food and drink', 'woocommerce' ),
|
||||
'use_description' => false,
|
||||
'description_label' => '',
|
||||
),
|
||||
'home-furniture-garden' => array(
|
||||
'label' => __( 'Home, furniture, and garden', 'woocommerce' ),
|
||||
'use_description' => false,
|
||||
'description_label' => '',
|
||||
),
|
||||
'cbd-other-hemp-derived-products' => array(
|
||||
'label' => __( 'CBD and other hemp-derived products', 'woocommerce' ),
|
||||
'use_description' => false,
|
||||
'description_label' => '',
|
||||
),
|
||||
'education-and-learning' => array(
|
||||
'label' => __( 'Education and learning', 'woocommerce' ),
|
||||
'use_description' => false,
|
||||
'description_label' => '',
|
||||
),
|
||||
'other' => array(
|
||||
'label' => __( 'Other', 'woocommerce' ),
|
||||
'use_description' => true,
|
||||
'description_label' => __( 'Description', 'woocommerce' ),
|
||||
),
|
||||
)
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Add preloaded data to onboarding.
|
||||
*
|
||||
* @param array $settings Component settings.
|
||||
* @return array
|
||||
*/
|
||||
public static function preload_data( $settings ) {
|
||||
$settings['onboarding']['industries'] = self::get_allowed_industries();
|
||||
return $settings;
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,66 @@
|
||||
<?php
|
||||
/**
|
||||
* WooCommerce Onboarding Jetpack
|
||||
*/
|
||||
|
||||
namespace Automattic\WooCommerce\Internal\Admin\Onboarding;
|
||||
|
||||
/**
|
||||
* Contains logic around Jetpack setup during onboarding.
|
||||
*/
|
||||
class OnboardingJetpack {
|
||||
/**
|
||||
* Class instance.
|
||||
*
|
||||
* @var OnboardingJetpack instance
|
||||
*/
|
||||
private static $instance = null;
|
||||
|
||||
/**
|
||||
* Get class instance.
|
||||
*/
|
||||
final public static function instance() {
|
||||
if ( ! static::$instance ) {
|
||||
static::$instance = new static();
|
||||
}
|
||||
return static::$instance;
|
||||
}
|
||||
|
||||
/**
|
||||
* Init.
|
||||
*/
|
||||
public function init() {
|
||||
add_action( 'woocommerce_admin_plugins_pre_activate', array( $this, 'activate_and_install_jetpack_ahead_of_wcpay' ) );
|
||||
add_action( 'woocommerce_admin_plugins_pre_install', array( $this, 'activate_and_install_jetpack_ahead_of_wcpay' ) );
|
||||
|
||||
// Always hook into Jetpack connection even if outside of admin.
|
||||
add_action( 'jetpack_site_registered', array( $this, 'set_woocommerce_setup_jetpack_opted_in' ) );
|
||||
}
|
||||
|
||||
/**
|
||||
* Sets the woocommerce_setup_jetpack_opted_in to true when Jetpack connects to WPCOM.
|
||||
*/
|
||||
public function set_woocommerce_setup_jetpack_opted_in() {
|
||||
update_option( 'woocommerce_setup_jetpack_opted_in', true );
|
||||
}
|
||||
|
||||
/**
|
||||
* Ensure that Jetpack gets installed and activated ahead of WooCommerce Payments
|
||||
* if both are being installed/activated at the same time.
|
||||
*
|
||||
* See: https://github.com/Automattic/woocommerce-payments/issues/1663
|
||||
* See: https://github.com/Automattic/jetpack/issues/19624
|
||||
*
|
||||
* @param array $plugins A list of plugins to install or activate.
|
||||
*
|
||||
* @return array
|
||||
*/
|
||||
public function activate_and_install_jetpack_ahead_of_wcpay( $plugins ) {
|
||||
if ( in_array( 'jetpack', $plugins, true ) && in_array( 'woocommerce-payments', $plugins, true ) ) {
|
||||
array_unshift( $plugins, 'jetpack' );
|
||||
$plugins = array_unique( $plugins );
|
||||
}
|
||||
return $plugins;
|
||||
}
|
||||
|
||||
}
|
||||
@@ -0,0 +1,53 @@
|
||||
<?php
|
||||
/**
|
||||
* WooCommerce Onboarding Mailchimp
|
||||
*/
|
||||
|
||||
namespace Automattic\WooCommerce\Internal\Admin\Onboarding;
|
||||
|
||||
use Automattic\WooCommerce\Internal\Admin\Schedulers\MailchimpScheduler;
|
||||
|
||||
/**
|
||||
* Logic around updating Mailchimp during onboarding.
|
||||
*/
|
||||
class OnboardingMailchimp {
|
||||
/**
|
||||
* Class instance.
|
||||
*
|
||||
* @var OnboardingMailchimp instance
|
||||
*/
|
||||
private static $instance = null;
|
||||
|
||||
/**
|
||||
* Get class instance.
|
||||
*/
|
||||
final public static function instance() {
|
||||
if ( ! static::$instance ) {
|
||||
static::$instance = new static();
|
||||
}
|
||||
return static::$instance;
|
||||
}
|
||||
|
||||
/**
|
||||
* Init.
|
||||
*/
|
||||
public function init() {
|
||||
add_action( 'woocommerce_onboarding_profile_data_updated', array( $this, 'on_profile_data_updated' ), 10, 2 );
|
||||
}
|
||||
|
||||
/**
|
||||
* Reset MailchimpScheduler if profile data is being updated with a new email.
|
||||
*
|
||||
* @param array $existing_data Existing option data.
|
||||
* @param array $updating_data Updating option data.
|
||||
*/
|
||||
public function on_profile_data_updated( $existing_data, $updating_data ) {
|
||||
if (
|
||||
isset( $existing_data['store_email'] ) &&
|
||||
isset( $updating_data['store_email'] ) &&
|
||||
$existing_data['store_email'] !== $updating_data['store_email']
|
||||
) {
|
||||
MailchimpScheduler::reset();
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,178 @@
|
||||
<?php
|
||||
/**
|
||||
* WooCommerce Onboarding Products
|
||||
*/
|
||||
|
||||
namespace Automattic\WooCommerce\Internal\Admin\Onboarding;
|
||||
|
||||
use Automattic\WooCommerce\Admin\Features\Features;
|
||||
use Automattic\WooCommerce\Internal\Admin\Onboarding\OnboardingProfile;
|
||||
use Automattic\WooCommerce\Admin\Loader;
|
||||
use Automattic\WooCommerce\Admin\PluginsHelper;
|
||||
|
||||
/**
|
||||
* Class for handling product types and data around product types.
|
||||
*/
|
||||
class OnboardingProducts {
|
||||
|
||||
/**
|
||||
* Name of product data transient.
|
||||
*
|
||||
* @var string
|
||||
*/
|
||||
const PRODUCT_DATA_TRANSIENT = 'wc_onboarding_product_data';
|
||||
|
||||
/**
|
||||
* Get a list of allowed product types for the onboarding wizard.
|
||||
*
|
||||
* @return array
|
||||
*/
|
||||
public static function get_allowed_product_types() {
|
||||
$products = array(
|
||||
'physical' => array(
|
||||
'label' => __( 'Physical products', 'woocommerce' ),
|
||||
'default' => true,
|
||||
),
|
||||
'downloads' => array(
|
||||
'label' => __( 'Downloads', 'woocommerce' ),
|
||||
),
|
||||
'subscriptions' => array(
|
||||
'label' => __( 'Subscriptions', 'woocommerce' ),
|
||||
),
|
||||
'memberships' => array(
|
||||
'label' => __( 'Memberships', 'woocommerce' ),
|
||||
'product' => 958589,
|
||||
),
|
||||
'bookings' => array(
|
||||
'label' => __( 'Bookings', 'woocommerce' ),
|
||||
'product' => 390890,
|
||||
),
|
||||
'product-bundles' => array(
|
||||
'label' => __( 'Bundles', 'woocommerce' ),
|
||||
'product' => 18716,
|
||||
),
|
||||
'product-add-ons' => array(
|
||||
'label' => __( 'Customizable products', 'woocommerce' ),
|
||||
'product' => 18618,
|
||||
),
|
||||
);
|
||||
$base_location = wc_get_base_location();
|
||||
$has_cbd_industry = false;
|
||||
if ( 'US' === $base_location['country'] ) {
|
||||
$profile = get_option( OnboardingProfile::DATA_OPTION, array() );
|
||||
if ( ! empty( $profile['industry'] ) ) {
|
||||
$has_cbd_industry = in_array( 'cbd-other-hemp-derived-products', array_column( $profile['industry'], 'slug' ), true );
|
||||
}
|
||||
}
|
||||
if ( ! Features::is_enabled( 'subscriptions' ) || 'US' !== $base_location['country'] || $has_cbd_industry ) {
|
||||
$products['subscriptions']['product'] = 27147;
|
||||
}
|
||||
|
||||
return apply_filters( 'woocommerce_admin_onboarding_product_types', $products );
|
||||
}
|
||||
|
||||
/**
|
||||
* Get dynamic product data from API.
|
||||
*
|
||||
* @param array $product_types Array of product types.
|
||||
* @return array
|
||||
*/
|
||||
public static function get_product_data( $product_types ) {
|
||||
$locale = get_user_locale();
|
||||
// Transient value is an array of product data keyed by locale.
|
||||
$transient_value = get_transient( self::PRODUCT_DATA_TRANSIENT );
|
||||
$transient_value = is_array( $transient_value ) ? $transient_value : array();
|
||||
$woocommerce_products = $transient_value[ $locale ] ?? false;
|
||||
|
||||
if ( false === $woocommerce_products ) {
|
||||
$woocommerce_products = wp_remote_get(
|
||||
add_query_arg(
|
||||
array(
|
||||
'locale' => $locale,
|
||||
),
|
||||
'https://woocommerce.com/wp-json/wccom-extensions/1.0/search'
|
||||
),
|
||||
array(
|
||||
'user-agent' => 'WooCommerce/' . WC()->version . '; ' . get_bloginfo( 'url' ),
|
||||
)
|
||||
);
|
||||
if ( is_wp_error( $woocommerce_products ) ) {
|
||||
return $product_types;
|
||||
}
|
||||
$transient_value[ $locale ] = $woocommerce_products;
|
||||
set_transient( self::PRODUCT_DATA_TRANSIENT, $transient_value, DAY_IN_SECONDS );
|
||||
}
|
||||
|
||||
$data = json_decode( $woocommerce_products['body'] );
|
||||
$products = array();
|
||||
$product_data = array();
|
||||
|
||||
// Map product data by ID.
|
||||
if ( isset( $data ) && isset( $data->products ) ) {
|
||||
foreach ( $data->products as $product_datum ) {
|
||||
if ( isset( $product_datum->id ) ) {
|
||||
$products[ $product_datum->id ] = $product_datum;
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
// Loop over product types and append data.
|
||||
foreach ( $product_types as $key => $product_type ) {
|
||||
$product_data[ $key ] = $product_types[ $key ];
|
||||
|
||||
if ( isset( $product_type['product'] ) && isset( $products[ $product_type['product'] ] ) ) {
|
||||
$price = html_entity_decode( $products[ $product_type['product'] ]->price );
|
||||
$yearly_price = (float) str_replace( '$', '', $price );
|
||||
|
||||
$product_data[ $key ]['yearly_price'] = $yearly_price;
|
||||
$product_data[ $key ]['description'] = $products[ $product_type['product'] ]->excerpt;
|
||||
$product_data[ $key ]['more_url'] = $products[ $product_type['product'] ]->link;
|
||||
$product_data[ $key ]['slug'] = strtolower( preg_replace( '~[^\pL\d]+~u', '-', $products[ $product_type['product'] ]->slug ) );
|
||||
} elseif ( isset( $product_type['product'] ) ) {
|
||||
/* translators: site currency symbol (used to show that the product costs money) */
|
||||
$product_data[ $key ]['label'] .= sprintf( __( ' — %s', 'woocommerce' ), html_entity_decode( get_woocommerce_currency_symbol() ) );
|
||||
}
|
||||
}
|
||||
|
||||
return $product_data;
|
||||
}
|
||||
|
||||
/**
|
||||
* Get the allowed product types with the polled data.
|
||||
*
|
||||
* @return array
|
||||
*/
|
||||
public static function get_product_types_with_data() {
|
||||
return self::get_product_data( self::get_allowed_product_types() );
|
||||
}
|
||||
|
||||
/**
|
||||
* Get relevant purchaseable products for the site.
|
||||
*
|
||||
* @return array
|
||||
*/
|
||||
public static function get_relevant_products() {
|
||||
$profiler_data = get_option( OnboardingProfile::DATA_OPTION, array() );
|
||||
$installed = PluginsHelper::get_installed_plugin_slugs();
|
||||
$product_types = isset( $profiler_data['product_types'] ) ? $profiler_data['product_types'] : array();
|
||||
$product_data = self::get_product_types_with_data();
|
||||
$purchaseable = array();
|
||||
$remaining = array();
|
||||
foreach ( $product_types as $type ) {
|
||||
if ( ! isset( $product_data[ $type ]['slug'] ) ) {
|
||||
continue;
|
||||
}
|
||||
|
||||
$purchaseable[] = $product_data[ $type ];
|
||||
|
||||
if ( ! in_array( $product_data[ $type ]['slug'], $installed, true ) ) {
|
||||
$remaining[] = $product_data[ $type ]['label'];
|
||||
}
|
||||
}
|
||||
|
||||
return array(
|
||||
'purchaseable' => $purchaseable,
|
||||
'remaining' => $remaining,
|
||||
);
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,101 @@
|
||||
<?php
|
||||
/**
|
||||
* WooCommerce Onboarding Setup Wizard
|
||||
*/
|
||||
|
||||
namespace Automattic\WooCommerce\Internal\Admin\Onboarding;
|
||||
|
||||
use Automattic\WooCommerce\Admin\Features\OnboardingTasks\TaskLists;
|
||||
use Automattic\WooCommerce\Admin\PageController;
|
||||
use Automattic\WooCommerce\Admin\WCAdminHelper;
|
||||
|
||||
/**
|
||||
* Contains backend logic for the onboarding profile and checklist feature.
|
||||
*/
|
||||
class OnboardingProfile {
|
||||
/**
|
||||
* Profile data option name.
|
||||
*/
|
||||
const DATA_OPTION = 'woocommerce_onboarding_profile';
|
||||
|
||||
/**
|
||||
* Add onboarding actions.
|
||||
*/
|
||||
public static function init() {
|
||||
add_action( 'woocommerce_updated', array( __CLASS__, 'maybe_mark_complete' ) );
|
||||
add_action( 'update_option_' . self::DATA_OPTION, array( __CLASS__, 'trigger_complete' ), 10, 2 );
|
||||
}
|
||||
|
||||
/**
|
||||
* Trigger the woocommerce_onboarding_profile_completed action
|
||||
*
|
||||
* @param array $old_value Previous value.
|
||||
* @param array $value Current value.
|
||||
*/
|
||||
public static function trigger_complete( $old_value, $value ) {
|
||||
if ( isset( $old_value['completed'] ) && $old_value['completed'] ) {
|
||||
return;
|
||||
}
|
||||
|
||||
if ( ! isset( $value['completed'] ) || ! $value['completed'] ) {
|
||||
return;
|
||||
}
|
||||
|
||||
/**
|
||||
* Action hook fired when the onboarding profile (or onboarding wizard,
|
||||
* or profiler) is completed.
|
||||
*
|
||||
* @since 1.5.0
|
||||
*/
|
||||
do_action( 'woocommerce_onboarding_profile_completed' );
|
||||
}
|
||||
|
||||
/**
|
||||
* Check if the profiler still needs to be completed.
|
||||
*
|
||||
* @return bool
|
||||
*/
|
||||
public static function needs_completion() {
|
||||
$onboarding_data = get_option( self::DATA_OPTION, 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;
|
||||
}
|
||||
|
||||
/**
|
||||
* When updating WooCommerce, mark the profiler and task list complete.
|
||||
*
|
||||
* @todo The `maybe_enable_setup_wizard()` method should be revamped on onboarding enable in core.
|
||||
* See https://github.com/woocommerce/woocommerce/blob/1ca791f8f2325fe2ee0947b9c47e6a4627366374/includes/class-wc-install.php#L341
|
||||
*/
|
||||
public static function maybe_mark_complete() {
|
||||
// The install notice still exists so don't complete the profiler.
|
||||
if ( ! class_exists( 'WC_Admin_Notices' ) || \WC_Admin_Notices::has_notice( 'install' ) ) {
|
||||
return;
|
||||
}
|
||||
|
||||
$onboarding_data = get_option( self::DATA_OPTION, array() );
|
||||
// Don't make updates if the profiler is completed or skipped, but task list is potentially incomplete.
|
||||
if (
|
||||
( isset( $onboarding_data['completed'] ) && $onboarding_data['completed'] ) ||
|
||||
( isset( $onboarding_data['skipped'] ) && $onboarding_data['skipped'] )
|
||||
) {
|
||||
return;
|
||||
}
|
||||
|
||||
$onboarding_data['completed'] = true;
|
||||
update_option( self::DATA_OPTION, $onboarding_data );
|
||||
|
||||
if ( ! WCAdminHelper::is_wc_admin_active_for( DAY_IN_SECONDS ) ) {
|
||||
$task_list = TaskLists::get_list( 'setup' );
|
||||
if ( ! $task_list ) {
|
||||
return;
|
||||
}
|
||||
$task_list->hide();
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,285 @@
|
||||
<?php
|
||||
/**
|
||||
* WooCommerce Onboarding Setup Wizard
|
||||
*/
|
||||
|
||||
namespace Automattic\WooCommerce\Internal\Admin\Onboarding;
|
||||
|
||||
use Automattic\WooCommerce\Admin\PageController;
|
||||
use Automattic\WooCommerce\Admin\WCAdminHelper;
|
||||
use Automattic\WooCommerce\Internal\Admin\Onboarding\OnboardingProfile;
|
||||
use Automattic\WooCommerce\Admin\Features\OnboardingTasks\TaskLists;
|
||||
|
||||
/**
|
||||
* Contains backend logic for the onboarding profile and checklist feature.
|
||||
*/
|
||||
class OnboardingSetupWizard {
|
||||
/**
|
||||
* Class instance.
|
||||
*
|
||||
* @var OnboardingSetupWizard instance
|
||||
*/
|
||||
private static $instance = null;
|
||||
|
||||
/**
|
||||
* Get class instance.
|
||||
*/
|
||||
final public static function instance() {
|
||||
if ( ! static::$instance ) {
|
||||
static::$instance = new static();
|
||||
}
|
||||
return static::$instance;
|
||||
}
|
||||
|
||||
/**
|
||||
* Add onboarding actions.
|
||||
*/
|
||||
public function init() {
|
||||
if ( ! is_admin() ) {
|
||||
return;
|
||||
}
|
||||
|
||||
// Old settings injection.
|
||||
// Run after Automattic\WooCommerce\Internal\Admin\Loader.
|
||||
add_filter( 'woocommerce_components_settings', array( $this, 'component_settings' ), 20 );
|
||||
// New settings injection.
|
||||
add_filter( 'woocommerce_admin_shared_settings', array( $this, 'component_settings' ), 20 );
|
||||
add_filter( 'woocommerce_admin_preload_settings', array( $this, 'preload_settings' ) );
|
||||
add_filter( 'admin_body_class', array( $this, 'add_loading_classes' ) );
|
||||
add_action( 'admin_init', array( $this, 'do_admin_redirects' ) );
|
||||
add_action( 'current_screen', array( $this, 'redirect_to_profiler' ) );
|
||||
add_filter( 'woocommerce_show_admin_notice', array( $this, 'remove_old_install_notice' ), 10, 2 );
|
||||
}
|
||||
|
||||
/**
|
||||
* Test whether the context of execution comes from async action scheduler.
|
||||
* Note: this is a polyfill for wc_is_running_from_async_action_scheduler()
|
||||
* which was introduced in WC 4.0.
|
||||
*
|
||||
* @return bool
|
||||
*/
|
||||
private function is_running_from_async_action_scheduler() {
|
||||
if ( function_exists( '\wc_is_running_from_async_action_scheduler' ) ) {
|
||||
return \wc_is_running_from_async_action_scheduler();
|
||||
}
|
||||
|
||||
// phpcs:ignore WordPress.Security.NonceVerification.Recommended
|
||||
return isset( $_REQUEST['action'] ) && 'as_async_request_queue_runner' === $_REQUEST['action'];
|
||||
}
|
||||
|
||||
/**
|
||||
* Handle redirects to setup/welcome page after install and updates.
|
||||
*
|
||||
* For setup wizard, transient must be present, the user must have access rights, and we must ignore the network/bulk plugin updaters.
|
||||
*/
|
||||
public function do_admin_redirects() {
|
||||
// Don't run this fn from Action Scheduler requests, as it would clear _wc_activation_redirect transient.
|
||||
// That means OBW would never be shown.
|
||||
if ( $this->is_running_from_async_action_scheduler() ) {
|
||||
return;
|
||||
}
|
||||
|
||||
// Setup wizard redirect.
|
||||
if ( get_transient( '_wc_activation_redirect' ) && apply_filters( 'woocommerce_enable_setup_wizard', true ) ) {
|
||||
$do_redirect = true;
|
||||
$current_page = isset( $_GET['page'] ) ? wc_clean( wp_unslash( $_GET['page'] ) ) : false; // phpcs:ignore WordPress.Security.NonceVerification
|
||||
$is_onboarding_path = ! isset( $_GET['path'] ) || '/setup-wizard' === wc_clean( wp_unslash( $_GET['page'] ) ); // phpcs:ignore WordPress.Security.NonceVerification
|
||||
|
||||
// On these pages, or during these events, postpone the redirect.
|
||||
if ( wp_doing_ajax() || is_network_admin() || ! current_user_can( 'manage_woocommerce' ) ) {
|
||||
$do_redirect = false;
|
||||
}
|
||||
|
||||
// On these pages, or during these events, disable the redirect.
|
||||
if (
|
||||
( 'wc-admin' === $current_page && $is_onboarding_path ) ||
|
||||
apply_filters( 'woocommerce_prevent_automatic_wizard_redirect', false ) ||
|
||||
isset( $_GET['activate-multi'] ) // phpcs:ignore WordPress.Security.NonceVerification
|
||||
) {
|
||||
delete_transient( '_wc_activation_redirect' );
|
||||
$do_redirect = false;
|
||||
}
|
||||
|
||||
if ( $do_redirect ) {
|
||||
delete_transient( '_wc_activation_redirect' );
|
||||
wp_safe_redirect( wc_admin_url() );
|
||||
exit;
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Trigger the woocommerce_onboarding_profile_completed action
|
||||
*
|
||||
* @param array $old_value Previous value.
|
||||
* @param array $value Current value.
|
||||
*/
|
||||
public function trigger_profile_completed_action( $old_value, $value ) {
|
||||
if ( isset( $old_value['completed'] ) && $old_value['completed'] ) {
|
||||
return;
|
||||
}
|
||||
|
||||
if ( ! isset( $value['completed'] ) || ! $value['completed'] ) {
|
||||
return;
|
||||
}
|
||||
|
||||
/**
|
||||
* Action hook fired when the onboarding profile (or onboarding wizard,
|
||||
* or profiler) is completed.
|
||||
*
|
||||
* @since 1.5.0
|
||||
*/
|
||||
do_action( 'woocommerce_onboarding_profile_completed' );
|
||||
}
|
||||
|
||||
/**
|
||||
* Returns true if the profiler should be displayed (not completed and not skipped).
|
||||
*
|
||||
* @return bool
|
||||
*/
|
||||
private function should_show() {
|
||||
if ( $this->is_setup_wizard() ) {
|
||||
return true;
|
||||
}
|
||||
|
||||
return OnboardingProfile::needs_completion();
|
||||
}
|
||||
|
||||
/**
|
||||
* Redirect to the profiler on homepage if completion is needed.
|
||||
*/
|
||||
public function redirect_to_profiler() {
|
||||
if ( ! $this->is_homepage() || ! OnboardingProfile::needs_completion() ) {
|
||||
return;
|
||||
}
|
||||
|
||||
wp_safe_redirect( wc_admin_url( '&path=/setup-wizard' ) );
|
||||
exit;
|
||||
}
|
||||
|
||||
/**
|
||||
* Check if the current page is the profile wizard.
|
||||
*
|
||||
* @return bool
|
||||
*/
|
||||
private function is_setup_wizard() {
|
||||
/* phpcs:disable WordPress.Security.NonceVerification */
|
||||
return isset( $_GET['page'] ) &&
|
||||
'wc-admin' === $_GET['page'] &&
|
||||
isset( $_GET['path'] ) &&
|
||||
'/setup-wizard' === $_GET['path'];
|
||||
/* phpcs: enable */
|
||||
}
|
||||
|
||||
/**
|
||||
* Check if the current page is the homepage.
|
||||
*
|
||||
* @return bool
|
||||
*/
|
||||
private function is_homepage() {
|
||||
/* phpcs:disable WordPress.Security.NonceVerification */
|
||||
return isset( $_GET['page'] ) &&
|
||||
'wc-admin' === $_GET['page'] &&
|
||||
! isset( $_GET['path'] );
|
||||
/* phpcs: enable */
|
||||
}
|
||||
|
||||
/**
|
||||
* Determine if the current page is one of the WC Admin pages.
|
||||
*
|
||||
* @return bool
|
||||
*/
|
||||
private function is_woocommerce_page() {
|
||||
$current_page = PageController::get_instance()->get_current_page();
|
||||
if ( ! $current_page || ! isset( $current_page['path'] ) ) {
|
||||
return false;
|
||||
}
|
||||
|
||||
return 0 === strpos( $current_page['path'], 'wc-admin' );
|
||||
}
|
||||
|
||||
/**
|
||||
* Add profiler items to component settings.
|
||||
*
|
||||
* @param array $settings Component settings.
|
||||
*
|
||||
* @return array
|
||||
*/
|
||||
public function component_settings( $settings ) {
|
||||
$profile = (array) get_option( OnboardingProfile::DATA_OPTION, array() );
|
||||
$settings['onboarding'] = array(
|
||||
'profile' => $profile,
|
||||
);
|
||||
|
||||
// Only fetch if the onboarding wizard OR the task list is incomplete or currently shown
|
||||
// or the current page is one of the WooCommerce Admin pages.
|
||||
if (
|
||||
( ! $this->should_show() && ! count( TaskLists::get_visible() )
|
||||
||
|
||||
! $this->is_woocommerce_page()
|
||||
)
|
||||
) {
|
||||
return $settings;
|
||||
}
|
||||
|
||||
include_once WC_ABSPATH . 'includes/admin/helper/class-wc-helper-options.php';
|
||||
$wccom_auth = \WC_Helper_Options::get( 'auth' );
|
||||
$profile['wccom_connected'] = empty( $wccom_auth['access_token'] ) ? false : true;
|
||||
|
||||
$settings['onboarding']['currencySymbols'] = get_woocommerce_currency_symbols();
|
||||
$settings['onboarding']['euCountries'] = WC()->countries->get_european_union_countries();
|
||||
$settings['onboarding']['localeInfo'] = include WC()->plugin_path() . '/i18n/locale-info.php';
|
||||
$settings['onboarding']['profile'] = $profile;
|
||||
|
||||
if ( $this->is_setup_wizard() ) {
|
||||
$settings['onboarding']['pageCount'] = (int) ( wp_count_posts( 'page' ) )->publish;
|
||||
$settings['onboarding']['postCount'] = (int) ( wp_count_posts( 'post' ) )->publish;
|
||||
$settings['onboarding']['isBlockTheme'] = wc_current_theme_is_fse_theme();
|
||||
}
|
||||
|
||||
return apply_filters( 'woocommerce_admin_onboarding_preloaded_data', $settings );
|
||||
}
|
||||
|
||||
/**
|
||||
* Preload WC setting options to prime state of the application.
|
||||
*
|
||||
* @param array $options Array of options to preload.
|
||||
* @return array
|
||||
*/
|
||||
public function preload_settings( $options ) {
|
||||
$options[] = 'general';
|
||||
|
||||
return $options;
|
||||
}
|
||||
|
||||
/**
|
||||
* Set the admin full screen class when loading to prevent flashes of unstyled content.
|
||||
*
|
||||
* @param bool $classes Body classes.
|
||||
* @return array
|
||||
*/
|
||||
public function add_loading_classes( $classes ) {
|
||||
/* phpcs:disable WordPress.Security.NonceVerification */
|
||||
if ( $this->is_setup_wizard() ) {
|
||||
$classes .= ' woocommerce-admin-full-screen';
|
||||
}
|
||||
/* phpcs: enable */
|
||||
|
||||
return $classes;
|
||||
}
|
||||
|
||||
/**
|
||||
* Remove the install notice that prompts the user to visit the old onboarding setup wizard.
|
||||
*
|
||||
* @param bool $show Show or hide the notice.
|
||||
* @param string $notice The slug of the notice.
|
||||
* @return bool
|
||||
*/
|
||||
public function remove_old_install_notice( $show, $notice ) {
|
||||
if ( 'install' === $notice ) {
|
||||
return false;
|
||||
}
|
||||
|
||||
return $show;
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,152 @@
|
||||
<?php
|
||||
/**
|
||||
* WooCommerce Onboarding
|
||||
*/
|
||||
|
||||
namespace Automattic\WooCommerce\Internal\Admin\Onboarding;
|
||||
|
||||
use Automattic\WooCommerce\Internal\Admin\Onboarding\OnboardingProfile;
|
||||
use Automattic\WooCommerce\Admin\Features\OnboardingTasks\TaskLists;
|
||||
|
||||
/**
|
||||
* Contains backend logic for the onboarding profile and checklist feature.
|
||||
*/
|
||||
class OnboardingSync {
|
||||
/**
|
||||
* Class instance.
|
||||
*
|
||||
* @var OnboardingSync instance
|
||||
*/
|
||||
private static $instance = null;
|
||||
|
||||
/**
|
||||
* Get class instance.
|
||||
*/
|
||||
final public static function instance() {
|
||||
if ( ! static::$instance ) {
|
||||
static::$instance = new static();
|
||||
}
|
||||
return static::$instance;
|
||||
}
|
||||
|
||||
/**
|
||||
* Init.
|
||||
*/
|
||||
public function init() {
|
||||
add_action( 'update_option_' . OnboardingProfile::DATA_OPTION, array( $this, 'send_profile_data_on_update' ), 10, 2 );
|
||||
add_action( 'woocommerce_helper_connected', array( $this, 'send_profile_data_on_connect' ) );
|
||||
|
||||
if ( ! is_admin() ) {
|
||||
return;
|
||||
}
|
||||
|
||||
add_action( 'current_screen', array( $this, 'redirect_wccom_install' ) );
|
||||
}
|
||||
|
||||
/**
|
||||
* Send profile data to WooCommerce.com.
|
||||
*/
|
||||
private function send_profile_data() {
|
||||
if ( 'yes' !== get_option( 'woocommerce_allow_tracking', 'no' ) ) {
|
||||
return;
|
||||
}
|
||||
|
||||
if ( ! class_exists( '\WC_Helper_API' ) || ! method_exists( '\WC_Helper_API', 'put' ) ) {
|
||||
return;
|
||||
}
|
||||
|
||||
if ( ! class_exists( '\WC_Helper_Options' ) ) {
|
||||
return;
|
||||
}
|
||||
|
||||
$auth = \WC_Helper_Options::get( 'auth' );
|
||||
if ( empty( $auth['access_token'] ) || empty( $auth['access_token_secret'] ) ) {
|
||||
return false;
|
||||
}
|
||||
|
||||
$profile = get_option( OnboardingProfile::DATA_OPTION, array() );
|
||||
$base_location = wc_get_base_location();
|
||||
$defaults = array(
|
||||
'plugins' => 'skipped',
|
||||
'industry' => array(),
|
||||
'product_types' => array(),
|
||||
'product_count' => '0',
|
||||
'selling_venues' => 'no',
|
||||
'number_employees' => '1',
|
||||
'revenue' => 'none',
|
||||
'other_platform' => 'none',
|
||||
'business_extensions' => array(),
|
||||
'theme' => get_stylesheet(),
|
||||
'setup_client' => false,
|
||||
'store_location' => $base_location['country'],
|
||||
'default_currency' => get_woocommerce_currency(),
|
||||
);
|
||||
|
||||
// Prepare industries as an array of slugs if they are in array format.
|
||||
if ( isset( $profile['industry'] ) && is_array( $profile['industry'] ) ) {
|
||||
$industry_slugs = array();
|
||||
foreach ( $profile['industry'] as $industry ) {
|
||||
$industry_slugs[] = is_array( $industry ) ? $industry['slug'] : $industry;
|
||||
}
|
||||
$profile['industry'] = $industry_slugs;
|
||||
}
|
||||
$body = wp_parse_args( $profile, $defaults );
|
||||
|
||||
\WC_Helper_API::put(
|
||||
'profile',
|
||||
array(
|
||||
'authenticated' => true,
|
||||
'body' => wp_json_encode( $body ),
|
||||
'headers' => array(
|
||||
'Content-Type' => 'application/json',
|
||||
),
|
||||
)
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Send profiler data on profiler change to completion.
|
||||
*
|
||||
* @param array $old_value Previous value.
|
||||
* @param array $value Current value.
|
||||
*/
|
||||
public function send_profile_data_on_update( $old_value, $value ) {
|
||||
if ( ! isset( $value['completed'] ) || ! $value['completed'] ) {
|
||||
return;
|
||||
}
|
||||
|
||||
$this->send_profile_data();
|
||||
}
|
||||
|
||||
/**
|
||||
* Send profiler data after a site is connected.
|
||||
*/
|
||||
public function send_profile_data_on_connect() {
|
||||
$profile = get_option( OnboardingProfile::DATA_OPTION, array() );
|
||||
if ( ! isset( $profile['completed'] ) || ! $profile['completed'] ) {
|
||||
return;
|
||||
}
|
||||
|
||||
$this->send_profile_data();
|
||||
}
|
||||
|
||||
/**
|
||||
* Redirects the user to the task list if the task list is enabled and finishing a wccom checkout.
|
||||
*
|
||||
* @todo Once URL params are added to the redirect, we can check those instead of the referer.
|
||||
*/
|
||||
public function redirect_wccom_install() {
|
||||
$task_list = TaskLists::get_list( 'setup' );
|
||||
|
||||
if (
|
||||
! $task_list ||
|
||||
$task_list->is_hidden() ||
|
||||
! isset( $_SERVER['HTTP_REFERER'] ) ||
|
||||
0 !== strpos( $_SERVER['HTTP_REFERER'], 'https://woocommerce.com/checkout?utm_medium=product' ) // phpcs:ignore sanitization ok.
|
||||
) {
|
||||
return;
|
||||
}
|
||||
|
||||
wp_safe_redirect( wc_admin_url() );
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,233 @@
|
||||
<?php
|
||||
/**
|
||||
* WooCommerce Onboarding Themes
|
||||
*/
|
||||
|
||||
namespace Automattic\WooCommerce\Internal\Admin\Onboarding;
|
||||
|
||||
use Automattic\WooCommerce\Admin\Loader;
|
||||
use Automattic\WooCommerce\Admin\PageController;
|
||||
use Automattic\WooCommerce\Admin\WCAdminHelper;
|
||||
use Automattic\WooCommerce\Admin\Features\OnboardingTasks\Init as OnboardingTasks;
|
||||
use Automattic\WooCommerce\Admin\Features\OnboardingTasks\TaskLists;
|
||||
use Automattic\WooCommerce\Admin\Schedulers\MailchimpScheduler;
|
||||
|
||||
/**
|
||||
* Logic around onboarding themes.
|
||||
*/
|
||||
class OnboardingThemes {
|
||||
/**
|
||||
* Name of themes transient.
|
||||
*
|
||||
* @var string
|
||||
*/
|
||||
const THEMES_TRANSIENT = 'wc_onboarding_themes';
|
||||
|
||||
/**
|
||||
* Init.
|
||||
*/
|
||||
public static function init() {
|
||||
add_action( 'woocommerce_theme_installed', array( __CLASS__, 'delete_themes_transient' ) );
|
||||
add_action( 'after_switch_theme', array( __CLASS__, 'delete_themes_transient' ) );
|
||||
add_filter( 'woocommerce_rest_prepare_themes', array( __CLASS__, 'add_uploaded_theme_data' ) );
|
||||
add_filter( 'woocommerce_admin_onboarding_preloaded_data', array( __CLASS__, 'preload_data' ) );
|
||||
}
|
||||
|
||||
/**
|
||||
* Get puchasable theme by slug.
|
||||
*
|
||||
* @param string $price_string string of price.
|
||||
* @return float|null
|
||||
*/
|
||||
private static function get_price_from_string( $price_string ) {
|
||||
$price_match = null;
|
||||
// Parse price from string as it includes the currency symbol.
|
||||
preg_match( '/\\d+\.\d{2}\s*/', $price_string, $price_match );
|
||||
if ( count( $price_match ) > 0 ) {
|
||||
return (float) $price_match[0];
|
||||
}
|
||||
return null;
|
||||
}
|
||||
|
||||
/**
|
||||
* Get puchasable theme by slug.
|
||||
*
|
||||
* @param string $slug from theme.
|
||||
* @return array|null
|
||||
*/
|
||||
public static function get_paid_theme_by_slug( $slug ) {
|
||||
$themes = self::get_themes();
|
||||
$theme_key = array_search( $slug, array_column( $themes, 'slug' ), true );
|
||||
$theme = false !== $theme_key ? $themes[ $theme_key ] : null;
|
||||
if ( $theme && isset( $theme['id'] ) && isset( $theme['price'] ) ) {
|
||||
$price = self::get_price_from_string( $theme['price'] );
|
||||
if ( $price && $price > 0 ) {
|
||||
return $themes[ $theme_key ];
|
||||
}
|
||||
}
|
||||
return null;
|
||||
}
|
||||
|
||||
/**
|
||||
* Sort themes returned from WooCommerce.com
|
||||
*
|
||||
* @param array $themes Array of themes from WooCommerce.com.
|
||||
* @return array
|
||||
*/
|
||||
public static function sort_woocommerce_themes( $themes ) {
|
||||
usort(
|
||||
$themes,
|
||||
function ( $product_1, $product_2 ) {
|
||||
if ( ! property_exists( $product_1, 'id' ) || ! property_exists( $product_1, 'slug' ) ) {
|
||||
return 1;
|
||||
}
|
||||
if ( ! property_exists( $product_2, 'id' ) || ! property_exists( $product_2, 'slug' ) ) {
|
||||
return 1;
|
||||
}
|
||||
if ( in_array( 'Storefront', array( $product_1->slug, $product_2->slug ), true ) ) {
|
||||
return 'Storefront' === $product_1->slug ? -1 : 1;
|
||||
}
|
||||
return $product_1->id < $product_2->id ? 1 : -1;
|
||||
}
|
||||
);
|
||||
return $themes;
|
||||
}
|
||||
|
||||
/**
|
||||
* Get a list of themes for the onboarding wizard.
|
||||
*
|
||||
* @return array
|
||||
*/
|
||||
public static function get_themes() {
|
||||
$themes = get_transient( self::THEMES_TRANSIENT );
|
||||
if ( false === $themes ) {
|
||||
$theme_data = wp_remote_get(
|
||||
'https://woocommerce.com/wp-json/wccom-extensions/1.0/search?category=themes',
|
||||
array(
|
||||
'user-agent' => 'WooCommerce/' . WC()->version . '; ' . get_bloginfo( 'url' ),
|
||||
)
|
||||
);
|
||||
$themes = array();
|
||||
|
||||
if ( ! is_wp_error( $theme_data ) ) {
|
||||
$theme_data = json_decode( $theme_data['body'] );
|
||||
$woo_themes = property_exists( $theme_data, 'products' ) ? $theme_data->products : array();
|
||||
$sorted_themes = self::sort_woocommerce_themes( $woo_themes );
|
||||
|
||||
foreach ( $sorted_themes as $theme ) {
|
||||
$slug = sanitize_title_with_dashes( $theme->slug );
|
||||
$themes[ $slug ] = (array) $theme;
|
||||
$themes[ $slug ]['is_installed'] = false;
|
||||
$themes[ $slug ]['has_woocommerce_support'] = true;
|
||||
$themes[ $slug ]['slug'] = $slug;
|
||||
}
|
||||
}
|
||||
|
||||
$installed_themes = wp_get_themes();
|
||||
foreach ( $installed_themes as $slug => $theme ) {
|
||||
$theme_data = self::get_theme_data( $theme );
|
||||
if ( isset( $themes[ $slug ] ) ) {
|
||||
$themes[ $slug ]['is_installed'] = true;
|
||||
$themes[ $slug ]['image'] = $theme_data['image'];
|
||||
} else {
|
||||
$themes[ $slug ] = $theme_data;
|
||||
}
|
||||
}
|
||||
|
||||
$active_theme = get_option( 'stylesheet' );
|
||||
|
||||
/**
|
||||
* The active theme may no be set if active_theme is not compatible with current version of WordPress.
|
||||
* In this case, we should not add active theme to onboarding themes.
|
||||
*/
|
||||
if ( isset( $themes[ $active_theme ] ) ) {
|
||||
// Add the WooCommerce support tag for default themes that don't explicitly declare support.
|
||||
if ( function_exists( 'wc_is_wp_default_theme_active' ) && wc_is_wp_default_theme_active() ) {
|
||||
$themes[ $active_theme ]['has_woocommerce_support'] = true;
|
||||
}
|
||||
|
||||
$themes = array( $active_theme => $themes[ $active_theme ] ) + $themes;
|
||||
}
|
||||
|
||||
set_transient( self::THEMES_TRANSIENT, $themes, DAY_IN_SECONDS );
|
||||
}
|
||||
|
||||
$themes = apply_filters( 'woocommerce_admin_onboarding_themes', $themes );
|
||||
return array_values( $themes );
|
||||
}
|
||||
|
||||
/**
|
||||
* Get theme data used in onboarding theme browser.
|
||||
*
|
||||
* @param WP_Theme $theme Theme to gather data from.
|
||||
* @return array
|
||||
*/
|
||||
public static function get_theme_data( $theme ) {
|
||||
return array(
|
||||
'slug' => sanitize_text_field( $theme->stylesheet ),
|
||||
'title' => $theme->get( 'Name' ),
|
||||
'price' => '0.00',
|
||||
'is_installed' => true,
|
||||
'image' => $theme->get_screenshot(),
|
||||
'has_woocommerce_support' => true,
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Add theme data to response from themes controller.
|
||||
*
|
||||
* @param WP_REST_Response $response Rest response.
|
||||
* @return WP_REST_Response
|
||||
*/
|
||||
public static function add_uploaded_theme_data( $response ) {
|
||||
if ( ! isset( $response->data['theme'] ) ) {
|
||||
return $response;
|
||||
}
|
||||
|
||||
$theme = wp_get_theme( $response->data['theme'] );
|
||||
$response->data['theme_data'] = self::get_theme_data( $theme );
|
||||
|
||||
return $response;
|
||||
}
|
||||
|
||||
/**
|
||||
* Delete the stored themes transient.
|
||||
*/
|
||||
public static function delete_themes_transient() {
|
||||
delete_transient( self::THEMES_TRANSIENT );
|
||||
}
|
||||
|
||||
/**
|
||||
* Add preloaded data to onboarding.
|
||||
*
|
||||
* @param array $settings Component settings.
|
||||
*
|
||||
* @return array
|
||||
*/
|
||||
public static function preload_data( $settings ) {
|
||||
$settings['onboarding']['activeTheme'] = get_option( 'stylesheet' );
|
||||
$settings['onboarding']['themes'] = self::get_themes();
|
||||
return $settings;
|
||||
}
|
||||
|
||||
/**
|
||||
* Gets an array of themes that can be installed & activated via the onboarding wizard.
|
||||
*
|
||||
* @return array
|
||||
*/
|
||||
public static function get_allowed_themes() {
|
||||
$allowed_themes = array();
|
||||
$themes = self::get_themes();
|
||||
|
||||
foreach ( $themes as $theme ) {
|
||||
$price = preg_replace( '/&#?[a-z0-9]+;/i', '', $theme['price'] );
|
||||
|
||||
if ( $theme['is_installed'] || '0.00' === $price ) {
|
||||
$allowed_themes[] = $theme['slug'];
|
||||
}
|
||||
}
|
||||
|
||||
return apply_filters( 'woocommerce_admin_onboarding_themes_whitelist', $allowed_themes );
|
||||
}
|
||||
|
||||
}
|
||||
@@ -0,0 +1,75 @@
|
||||
<?php
|
||||
|
||||
namespace Automattic\WooCommerce\Internal\Admin\Orders;
|
||||
|
||||
use Automattic\WooCommerce\Internal\Traits\AccessiblePrivateMethods;
|
||||
|
||||
/**
|
||||
* When Custom Order Tables are not the default order store (ie, posts are authoritative), we should take care of
|
||||
* redirecting requests for the order editor and order admin list table to the equivalent posts-table screens.
|
||||
*
|
||||
* If the redirect logic is problematic, it can be unhooked using code like the following example:
|
||||
*
|
||||
* remove_action(
|
||||
* 'admin_page_access_denied',
|
||||
* array( wc_get_container()->get( COTRedirectionController::class ), 'handle_hpos_admin_requests' )
|
||||
* );
|
||||
*/
|
||||
class COTRedirectionController {
|
||||
use AccessiblePrivateMethods;
|
||||
|
||||
/**
|
||||
* Add hooks needed to perform our magic.
|
||||
*/
|
||||
public function setup(): void {
|
||||
// Only take action in cases where access to the admin screen would otherwise be denied.
|
||||
self::add_action( 'admin_page_access_denied', array( $this, 'handle_hpos_admin_requests' ) );
|
||||
}
|
||||
|
||||
/**
|
||||
* Listen for denied admin requests and, if they appear to relate to HPOS admin screens, potentially
|
||||
* redirect the user to the equivalent CPT-driven screens.
|
||||
*
|
||||
* @param array|null $query_params The query parameters to use when determining the redirect. If not provided, the $_GET superglobal will be used.
|
||||
*/
|
||||
private function handle_hpos_admin_requests( $query_params = null ) {
|
||||
$query_params = is_array( $query_params ) ? $query_params : $_GET;
|
||||
|
||||
if ( ! isset( $query_params['page'] ) || 'wc-orders' !== $query_params['page'] ) {
|
||||
return;
|
||||
}
|
||||
|
||||
$params = wp_unslash( $query_params );
|
||||
$action = $params['action'] ?? '';
|
||||
unset( $params['page'] );
|
||||
|
||||
if ( 'edit' === $action && isset( $params['id'] ) ) {
|
||||
$params['post'] = $params['id'];
|
||||
unset( $params['id'] );
|
||||
$new_url = add_query_arg( $params, get_admin_url( null, 'post.php' ) );
|
||||
} elseif ( 'new' === $action ) {
|
||||
unset( $params['action'] );
|
||||
$params['post_type'] = 'shop_order';
|
||||
$new_url = add_query_arg( $params, get_admin_url( null, 'post-new.php' ) );
|
||||
} else {
|
||||
// If nonce parameters are present and valid, rebuild them for the CPT admin list table.
|
||||
if ( isset( $params['_wpnonce'] ) && check_admin_referer( 'bulk-orders' ) ) {
|
||||
$params['_wp_http_referer'] = get_admin_url( null, 'edit.php?post_type=shop_order' );
|
||||
$params['_wpnonce'] = wp_create_nonce( 'bulk-posts' );
|
||||
}
|
||||
|
||||
// If an `order` array parameter is present, rename as `post`.
|
||||
if ( isset( $params['order'] ) && is_array( $params['order'] ) ) {
|
||||
$params['post'] = $params['order'];
|
||||
unset( $params['order'] );
|
||||
}
|
||||
|
||||
$params['post_type'] = 'shop_order';
|
||||
$new_url = add_query_arg( $params, get_admin_url( null, 'edit.php' ) );
|
||||
}
|
||||
|
||||
if ( ! empty( $new_url ) && wp_safe_redirect( $new_url, 301 ) ) {
|
||||
exit;
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,338 @@
|
||||
<?php
|
||||
/**
|
||||
* Renders order edit page, works with both post and order object.
|
||||
*/
|
||||
|
||||
namespace Automattic\WooCommerce\Internal\Admin\Orders;
|
||||
|
||||
use Automattic\WooCommerce\Internal\Admin\Orders\MetaBoxes\CustomMetaBox;
|
||||
|
||||
/**
|
||||
* Class Edit.
|
||||
*/
|
||||
class Edit {
|
||||
|
||||
/**
|
||||
* Screen ID for the edit order screen.
|
||||
*
|
||||
* @var string
|
||||
*/
|
||||
private $screen_id;
|
||||
|
||||
/**
|
||||
* Instance of the CustomMetaBox class. Used to render meta box for custom meta.
|
||||
*
|
||||
* @var CustomMetaBox
|
||||
*/
|
||||
private $custom_meta_box;
|
||||
|
||||
/**
|
||||
* Instance of WC_Order to be used in metaboxes.
|
||||
*
|
||||
* @var \WC_Order
|
||||
*/
|
||||
private $order;
|
||||
|
||||
/**
|
||||
* Action name that the form is currently handling. Could be new_order or edit_order.
|
||||
*
|
||||
* @var string
|
||||
*/
|
||||
private $current_action;
|
||||
|
||||
/**
|
||||
* Message to be displayed to the user. Index of message from the messages array registered when declaring shop_order post type.
|
||||
*
|
||||
* @var int
|
||||
*/
|
||||
private $message;
|
||||
|
||||
/**
|
||||
* Hooks all meta-boxes for order edit page. This is static since this may be called by post edit form rendering.
|
||||
*
|
||||
* @param string $screen_id Screen ID.
|
||||
* @param string $title Title of the page.
|
||||
*/
|
||||
public static function add_order_meta_boxes( string $screen_id, string $title ) {
|
||||
/* Translators: %s order type name. */
|
||||
add_meta_box( 'woocommerce-order-data', sprintf( __( '%s data', 'woocommerce' ), $title ), 'WC_Meta_Box_Order_Data::output', $screen_id, 'normal', 'high' );
|
||||
add_meta_box( 'woocommerce-order-items', __( 'Items', 'woocommerce' ), 'WC_Meta_Box_Order_Items::output', $screen_id, 'normal', 'high' );
|
||||
/* Translators: %s order type name. */
|
||||
add_meta_box( 'woocommerce-order-notes', sprintf( __( '%s notes', 'woocommerce' ), $title ), 'WC_Meta_Box_Order_Notes::output', $screen_id, 'side', 'default' );
|
||||
add_meta_box( 'woocommerce-order-downloads', __( 'Downloadable product permissions', 'woocommerce' ) . wc_help_tip( __( 'Note: Permissions for order items will automatically be granted when the order status changes to processing/completed.', 'woocommerce' ) ), 'WC_Meta_Box_Order_Downloads::output', $screen_id, 'normal', 'default' );
|
||||
/* Translators: %s order type name. */
|
||||
add_meta_box( 'woocommerce-order-actions', sprintf( __( '%s actions', 'woocommerce' ), $title ), 'WC_Meta_Box_Order_Actions::output', $screen_id, 'side', 'high' );
|
||||
}
|
||||
|
||||
/**
|
||||
* Hooks metabox save functions for order edit page.
|
||||
*
|
||||
* @return void
|
||||
*/
|
||||
public static function add_save_meta_boxes() {
|
||||
/**
|
||||
* Save Order Meta Boxes.
|
||||
*
|
||||
* In order:
|
||||
* Save the order items.
|
||||
* Save the order totals.
|
||||
* Save the order downloads.
|
||||
* Save order data - also updates status and sends out admin emails if needed. Last to show latest data.
|
||||
* Save actions - sends out other emails. Last to show latest data.
|
||||
*/
|
||||
add_action( 'woocommerce_process_shop_order_meta', 'WC_Meta_Box_Order_Items::save', 10 );
|
||||
add_action( 'woocommerce_process_shop_order_meta', 'WC_Meta_Box_Order_Downloads::save', 30, 2 );
|
||||
add_action( 'woocommerce_process_shop_order_meta', 'WC_Meta_Box_Order_Data::save', 40 );
|
||||
add_action( 'woocommerce_process_shop_order_meta', 'WC_Meta_Box_Order_Actions::save', 50, 2 );
|
||||
}
|
||||
|
||||
/**
|
||||
* Enqueue necessary scripts for order edit page.
|
||||
*/
|
||||
private function enqueue_scripts() {
|
||||
if ( wp_is_mobile() ) {
|
||||
wp_enqueue_script( 'jquery-touch-punch' );
|
||||
}
|
||||
wp_enqueue_script( 'post' ); // Ensure existing JS libraries are still available for backward compat.
|
||||
}
|
||||
|
||||
/**
|
||||
* Setup hooks, actions and variables needed to render order edit page.
|
||||
*
|
||||
* @param \WC_Order $order Order object.
|
||||
*/
|
||||
public function setup( \WC_Order $order ) {
|
||||
$this->order = $order;
|
||||
$wc_screen_id = wc_get_page_screen_id( 'shop-order' );
|
||||
$current_screen = get_current_screen();
|
||||
$current_screen->is_block_editor( false );
|
||||
$this->screen_id = $current_screen->id;
|
||||
if ( ! isset( $this->custom_meta_box ) ) {
|
||||
$this->custom_meta_box = wc_get_container()->get( CustomMetaBox::class );
|
||||
}
|
||||
$this->add_save_meta_boxes();
|
||||
$this->handle_order_update();
|
||||
$this->add_order_meta_boxes( $this->screen_id, __( 'Order', 'woocommerce' ) );
|
||||
$this->add_order_specific_meta_box();
|
||||
|
||||
/**
|
||||
* From wp-admin/includes/meta-boxes.php.
|
||||
*
|
||||
* Fires after all built-in meta boxes have been added. Custom metaboxes may be enqueued here.
|
||||
*
|
||||
* @since 3.8.0.
|
||||
*/
|
||||
do_action( 'add_meta_boxes', $wc_screen_id, $this->order );
|
||||
|
||||
/**
|
||||
* Provides an opportunity to inject custom meta boxes into the order editor screen. This
|
||||
* hook is an analog of `add_meta_boxes_<POST_TYPE>` as provided by WordPress core.
|
||||
*
|
||||
* @since 7.4.0
|
||||
*
|
||||
* @oaram WC_Order $order The order being edited.
|
||||
*/
|
||||
do_action( 'add_meta_boxes_' . $wc_screen_id, $this->order );
|
||||
|
||||
$this->enqueue_scripts();
|
||||
}
|
||||
|
||||
/**
|
||||
* Set the current action for the form.
|
||||
*
|
||||
* @param string $action Action name.
|
||||
*/
|
||||
public function set_current_action( string $action ) {
|
||||
$this->current_action = $action;
|
||||
}
|
||||
|
||||
/**
|
||||
* Hooks meta box for order specific meta.
|
||||
*/
|
||||
private function add_order_specific_meta_box() {
|
||||
add_meta_box(
|
||||
'order_custom',
|
||||
__( 'Custom Fields', 'woocommerce' ),
|
||||
array( $this, 'render_custom_meta_box' ),
|
||||
$this->screen_id,
|
||||
'normal'
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Takes care of updating order data. Fires action that metaboxes can hook to for order data updating.
|
||||
*
|
||||
* @return void
|
||||
*/
|
||||
public function handle_order_update() {
|
||||
global $theorder;
|
||||
if ( ! isset( $this->order ) ) {
|
||||
return;
|
||||
}
|
||||
|
||||
if ( 'edit_order' !== sanitize_text_field( wp_unslash( $_POST['action'] ?? '' ) ) ) {
|
||||
return;
|
||||
}
|
||||
|
||||
check_admin_referer( $this->get_order_edit_nonce_action() );
|
||||
|
||||
/**
|
||||
* Save meta for shop order.
|
||||
*
|
||||
* @param int Order ID.
|
||||
* @param \WC_Order Post object.
|
||||
*
|
||||
* @since 2.1.0
|
||||
*/
|
||||
do_action( 'woocommerce_process_shop_order_meta', $this->order->get_id(), $this->order );
|
||||
|
||||
// Order updated message.
|
||||
$this->message = 1;
|
||||
|
||||
// Refresh the order from DB.
|
||||
$this->order = wc_get_order( $this->order->get_id() );
|
||||
$theorder = $this->order;
|
||||
}
|
||||
|
||||
/**
|
||||
* Helper method to get the name of order edit nonce.
|
||||
*
|
||||
* @return string Nonce action name.
|
||||
*/
|
||||
private function get_order_edit_nonce_action() {
|
||||
return 'update-order_' . $this->order->get_id();
|
||||
}
|
||||
|
||||
/**
|
||||
* Render meta box for order specific meta.
|
||||
*/
|
||||
public function render_custom_meta_box() {
|
||||
$this->custom_meta_box->output( $this->order );
|
||||
}
|
||||
|
||||
/**
|
||||
* Render order edit page.
|
||||
*/
|
||||
public function display() {
|
||||
/**
|
||||
* This is used by the order edit page to show messages in the notice fields.
|
||||
* It should be similar to post_updated_messages filter, i.e.:
|
||||
* array(
|
||||
* {order_type} => array(
|
||||
* 1 => 'Order updated.',
|
||||
* 2 => 'Custom field updated.',
|
||||
* ...
|
||||
* ).
|
||||
*
|
||||
* The index to be displayed is computed from the $_GET['message'] variable.
|
||||
*
|
||||
* @since 7.4.0.
|
||||
*/
|
||||
$messages = apply_filters( 'woocommerce_order_updated_messages', array() );
|
||||
|
||||
$message = $this->message;
|
||||
if ( isset( $_GET['message'] ) ) {
|
||||
$message = absint( $_GET['message'] );
|
||||
}
|
||||
|
||||
if ( isset( $message ) ) {
|
||||
$message = $messages[ $this->order->get_type() ][ $message ] ?? false;
|
||||
}
|
||||
|
||||
$this->render_wrapper_start( '', $message );
|
||||
$this->render_meta_boxes();
|
||||
$this->render_wrapper_end();
|
||||
}
|
||||
|
||||
/**
|
||||
* Helper function to render wrapper start.
|
||||
*
|
||||
* @param string $notice Notice to display, if any.
|
||||
* @param string $message Message to display, if any.
|
||||
*/
|
||||
private function render_wrapper_start( $notice = '', $message = '' ) {
|
||||
$post_type = get_post_type_object( $this->order->get_type() );
|
||||
|
||||
$edit_page_url = wc_get_container()->get( PageController::class )->get_edit_url( $this->order->get_id() );
|
||||
$form_action = 'edit_order';
|
||||
$referer = wp_get_referer();
|
||||
$new_page_url = wc_get_container()->get( PageController::class )->get_new_page_url( $this->order->get_type() );
|
||||
|
||||
?>
|
||||
<div class="wrap">
|
||||
<h1 class="wp-heading-inline">
|
||||
<?php
|
||||
echo 'new_order' === $this->current_action ? esc_html( $post_type->labels->add_new_item ) : esc_html( $post_type->labels->edit_item );
|
||||
?>
|
||||
</h1>
|
||||
<?php
|
||||
if ( 'edit_order' === $this->current_action ) {
|
||||
echo ' <a href="' . esc_url( $new_page_url ) . '" class="page-title-action">' . esc_html( $post_type->labels->add_new ) . '</a>';
|
||||
}
|
||||
?>
|
||||
<hr class="wp-header-end">
|
||||
|
||||
<?php
|
||||
if ( $notice ) :
|
||||
?>
|
||||
<div id="notice" class="notice notice-warning"><p
|
||||
id="has-newer-autosave"><?php echo wp_kses_post( $notice ); ?></p></div>
|
||||
<?php endif; ?>
|
||||
<?php if ( $message ) : ?>
|
||||
<div id="message" class="updated notice notice-success is-dismissible">
|
||||
<p><?php echo wp_kses_post( $message ); ?></p></div>
|
||||
<?php
|
||||
endif;
|
||||
?>
|
||||
|
||||
<form name="order" action="<?php echo esc_url( $edit_page_url ); ?>" method="post" id="order"
|
||||
<?php
|
||||
/**
|
||||
* Fires inside the order edit form tag.
|
||||
*
|
||||
* @param \WC_Order $order Order object.
|
||||
*
|
||||
* @since 6.9.0
|
||||
*/
|
||||
do_action( 'order_edit_form_tag', $this->order );
|
||||
?>
|
||||
>
|
||||
<?php wp_nonce_field( $this->get_order_edit_nonce_action() ); ?>
|
||||
<input type="hidden" id="hiddenaction" name="action" value="<?php echo esc_attr( $form_action ); ?>"/>
|
||||
<input type="hidden" id="original_order_status" name="original_order_status" value="<?php echo esc_attr( $this->order->get_status() ); ?>"/>
|
||||
<input type="hidden" id="referredby" name="referredby" value="<?php echo $referer ? esc_url( $referer ) : ''; ?>"/>
|
||||
<div id="poststuff">
|
||||
<div id="post-body"
|
||||
class="metabox-holder columns-<?php echo ( 1 === get_current_screen()->get_columns() ) ? '1' : '2'; ?>">
|
||||
<?php
|
||||
}
|
||||
|
||||
/**
|
||||
* Helper function to render meta boxes.
|
||||
*/
|
||||
private function render_meta_boxes() {
|
||||
?>
|
||||
<div id="postbox-container-1" class="postbox-container">
|
||||
<?php do_meta_boxes( $this->screen_id, 'side', $this->order ); ?>
|
||||
</div>
|
||||
<div id="postbox-container-2" class="postbox-container">
|
||||
<?php
|
||||
do_meta_boxes( $this->screen_id, 'normal', $this->order );
|
||||
do_meta_boxes( $this->screen_id, 'advanced', $this->order );
|
||||
?>
|
||||
</div>
|
||||
<?php
|
||||
}
|
||||
|
||||
/**
|
||||
* Helper function to render wrapper end.
|
||||
*/
|
||||
private function render_wrapper_end() {
|
||||
?>
|
||||
</div> <!-- /post-body -->
|
||||
</div> <!-- /poststuff -->
|
||||
</form>
|
||||
</div> <!-- /wrap -->
|
||||
<?php
|
||||
}
|
||||
}
|
||||
File diff suppressed because it is too large
Load Diff
@@ -0,0 +1,418 @@
|
||||
<?php
|
||||
/**
|
||||
* Meta box to edit and add custom meta values for an order.
|
||||
*/
|
||||
|
||||
namespace Automattic\WooCommerce\Internal\Admin\Orders\MetaBoxes;
|
||||
|
||||
use WC_Data_Store;
|
||||
use WC_Meta_Data;
|
||||
use WC_Order;
|
||||
use WP_Ajax_Response;
|
||||
|
||||
/**
|
||||
* Class CustomMetaBox.
|
||||
*/
|
||||
class CustomMetaBox {
|
||||
|
||||
/**
|
||||
* Update nonce shared among different meta rows.
|
||||
*
|
||||
* @var string
|
||||
*/
|
||||
private $update_nonce;
|
||||
|
||||
/**
|
||||
* Helper method to get formatted meta data array with proper keys. This can be directly fed to `list_meta()` method.
|
||||
*
|
||||
* @param \WC_Order $order Order object.
|
||||
*
|
||||
* @return array Meta data.
|
||||
*/
|
||||
private function get_formatted_order_meta_data( \WC_Order $order ) {
|
||||
$metadata = $order->get_meta_data();
|
||||
$metadata_to_list = array();
|
||||
foreach ( $metadata as $meta ) {
|
||||
$data = $meta->get_data();
|
||||
if ( is_protected_meta( $data['key'], 'order' ) ) {
|
||||
continue;
|
||||
}
|
||||
$metadata_to_list[] = array(
|
||||
'meta_id' => $data['id'],
|
||||
'meta_key' => $data['key'], // phpcs:ignore WordPress.DB.SlowDBQuery.slow_db_query_meta_key -- False positive, not a meta query.
|
||||
'meta_value' => maybe_serialize( $data['value'] ), // phpcs:ignore WordPress.DB.SlowDBQuery.slow_db_query_meta_value -- False positive, not a meta query.
|
||||
);
|
||||
}
|
||||
return $metadata_to_list;
|
||||
}
|
||||
|
||||
/**
|
||||
* Renders the meta box to manage custom meta.
|
||||
*
|
||||
* @param \WP_Post|\WC_Order $order_or_post Post or order object that we are rendering for.
|
||||
*/
|
||||
public function output( $order_or_post ) {
|
||||
if ( is_a( $order_or_post, \WP_Post::class ) ) {
|
||||
$order = wc_get_order( $order_or_post );
|
||||
} else {
|
||||
$order = $order_or_post;
|
||||
}
|
||||
$this->render_custom_meta_form( $this->get_formatted_order_meta_data( $order ), $order );
|
||||
}
|
||||
|
||||
/**
|
||||
* Helper method to render layout and actual HTML
|
||||
*
|
||||
* @param array $metadata_to_list List of metadata to render.
|
||||
* @param \WC_Order $order Order object.
|
||||
*/
|
||||
private function render_custom_meta_form( array $metadata_to_list, \WC_Order $order ) {
|
||||
?>
|
||||
<div id="postcustomstuff">
|
||||
<div id="ajax-response"></div>
|
||||
<?php
|
||||
list_meta( $metadata_to_list );
|
||||
$this->render_meta_form( $order );
|
||||
?>
|
||||
</div>
|
||||
<p>
|
||||
<?php
|
||||
printf(
|
||||
/* translators: 1: opening documentation tag 2: closing documentation tag. */
|
||||
esc_html( __( 'Custom fields can be used to add extra metadata to an order that you can %1$suse in your theme%2$s.', 'woocommerce' ) ),
|
||||
'<a href="' . esc_attr__( 'https://wordpress.org/support/article/custom-fields/', 'woocommerce' ) . '">',
|
||||
'</a>'
|
||||
);
|
||||
?>
|
||||
</p>
|
||||
<?php
|
||||
}
|
||||
|
||||
/**
|
||||
* Compute keys to display in autofill when adding new meta key entry in custom meta box.
|
||||
* Currently, returns empty keys, will be implemented after caching is merged.
|
||||
*
|
||||
* @param array|null $keys Keys to display in autofill.
|
||||
* @param \WP_Post|\WC_Order $order Order object.
|
||||
*
|
||||
* @return array|mixed Array of keys to display in autofill.
|
||||
*/
|
||||
public function order_meta_keys_autofill( $keys, $order ) {
|
||||
if ( is_a( $order, \WC_Order::class ) ) {
|
||||
return array();
|
||||
}
|
||||
|
||||
return $keys;
|
||||
}
|
||||
|
||||
/**
|
||||
* Reimplementation of WP core's `meta_form` function. Renders meta form box.
|
||||
*
|
||||
* @param \WC_Order $order WC_Order object.
|
||||
*
|
||||
* @return void
|
||||
*/
|
||||
public function render_meta_form( \WC_Order $order ) : void {
|
||||
$meta_key_input_id = 'metakeyselect';
|
||||
|
||||
$keys = $this->order_meta_keys_autofill( null, $order );
|
||||
/**
|
||||
* Filters values for the meta key dropdown in the Custom Fields meta box.
|
||||
*
|
||||
* Compatibility filter for `postmeta_form_keys` filter.
|
||||
*
|
||||
* @since 6.9.0
|
||||
*
|
||||
* @param array|null $keys Pre-defined meta keys to be used in place of a postmeta query. Default null.
|
||||
* @param \WC_Order $order The current post object.
|
||||
*/
|
||||
$keys = apply_filters( 'postmeta_form_keys', $keys, $order );
|
||||
?>
|
||||
<p><strong><?php esc_html_e( 'Add New Custom Field:', 'woocommerce' ); ?></strong></p>
|
||||
<table id="newmeta">
|
||||
<thead>
|
||||
<tr>
|
||||
<th class="left"><label for="<?php echo esc_attr( $meta_key_input_id ); ?>"><?php esc_html_e( 'Name', 'woocommerce' ); ?></label></th>
|
||||
<th><label for="metavalue"><?php esc_html_e( 'Value', 'woocommerce' ); ?></label></th>
|
||||
</tr>
|
||||
</thead>
|
||||
|
||||
<tbody>
|
||||
<tr>
|
||||
<td id="newmetaleft" class="left">
|
||||
<?php if ( $keys ) { ?>
|
||||
<select id="metakeyselect" name="metakeyselect">
|
||||
<option value="#NONE#"><?php esc_html_e( '— Select —', 'woocommerce' ); ?></option>
|
||||
<?php
|
||||
foreach ( $keys as $key ) {
|
||||
if ( is_protected_meta( $key, 'post' ) || ! current_user_can( 'edit_others_shop_order', $order->get_id() ) ) {
|
||||
continue;
|
||||
}
|
||||
echo "\n<option value='" . esc_attr( $key ) . "'>" . esc_html( $key ) . '</option>';
|
||||
}
|
||||
?>
|
||||
</select>
|
||||
<input class="hide-if-js" type="text" id="metakeyinput" name="metakeyinput" value="" />
|
||||
<a href="#postcustomstuff" class="hide-if-no-js" onclick="jQuery('#metakeyinput, #metakeyselect, #enternew, #cancelnew').toggle();return false;">
|
||||
<span id="enternew"><?php esc_html_e( 'Enter new', 'woocommerce' ); ?></span>
|
||||
<span id="cancelnew" class="hidden"><?php esc_html_e( 'Cancel', 'woocommerce' ); ?></span></a>
|
||||
<?php } else { ?>
|
||||
<input type="text" id="metakeyinput" name="metakeyinput" value="" />
|
||||
<?php } ?>
|
||||
</td>
|
||||
<td><textarea id="metavalue" name="metavalue" rows="2" cols="25"></textarea></td>
|
||||
</tr>
|
||||
|
||||
<tr><td colspan="2">
|
||||
<div class="submit">
|
||||
<?php
|
||||
submit_button(
|
||||
__( 'Add Custom Field', 'woocommerce' ),
|
||||
'',
|
||||
'addmeta',
|
||||
false,
|
||||
array(
|
||||
'id' => 'newmeta-submit',
|
||||
'data-wp-lists' => 'add:the-list:newmeta',
|
||||
)
|
||||
);
|
||||
?>
|
||||
</div>
|
||||
<?php wp_nonce_field( 'add-meta', '_ajax_nonce-add-meta', false ); ?>
|
||||
</td></tr>
|
||||
</tbody>
|
||||
</table>
|
||||
<?php
|
||||
}
|
||||
|
||||
/**
|
||||
* Helper method to verify order edit permissions.
|
||||
*
|
||||
* @param int $order_id Order ID.
|
||||
*
|
||||
* @return ?WC_Order WC_Order object if the user can edit the order, die otherwise.
|
||||
*/
|
||||
private function verify_order_edit_permission_for_ajax( int $order_id ): ?WC_Order {
|
||||
if ( ! current_user_can( 'manage_woocommerce' ) || ! current_user_can( 'edit_others_shop_orders' ) ) {
|
||||
wp_send_json_error( 'missing_capabilities' );
|
||||
wp_die();
|
||||
}
|
||||
|
||||
$order = wc_get_order( $order_id );
|
||||
if ( ! $order ) {
|
||||
wp_send_json_error( 'invalid_order_id' );
|
||||
wp_die();
|
||||
}
|
||||
return $order;
|
||||
}
|
||||
|
||||
/**
|
||||
* Reimplementation of WP core's `wp_ajax_add_meta` method to support order custom meta updates with custom tables.
|
||||
*/
|
||||
public function add_meta_ajax() {
|
||||
if ( ! check_ajax_referer( 'add-meta', '_ajax_nonce-add-meta' ) ) {
|
||||
wp_send_json_error( 'invalid_nonce' );
|
||||
wp_die();
|
||||
}
|
||||
|
||||
$order_id = (int) $_POST['order_id'] ?? 0;
|
||||
$order = $this->verify_order_edit_permission_for_ajax( $order_id );
|
||||
|
||||
if ( isset( $_POST['metakeyselect'] ) && '#NONE#' === $_POST['metakeyselect'] && empty( $_POST['metakeyinput'] ) ) {
|
||||
wp_die( 1 );
|
||||
}
|
||||
|
||||
if ( isset( $_POST['metakeyinput'] ) ) { // add meta.
|
||||
$meta_key = sanitize_text_field( wp_unslash( $_POST['metakeyinput'] ) );
|
||||
$meta_value = sanitize_text_field( wp_unslash( $_POST['metavalue'] ?? '' ) );
|
||||
$this->handle_add_meta( $order, $meta_key, $meta_value );
|
||||
} else { // update.
|
||||
$meta = wp_unslash( $_POST['meta'] ?? array() ); // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized -- sanitization done below in array_walk.
|
||||
$this->handle_update_meta( $order, $meta );
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Part of WP Core's `wp_ajax_add_meta`. This is re-implemented to support updating meta for custom tables.
|
||||
*
|
||||
* @param WC_Order $order Order object.
|
||||
* @param string $meta_key Meta key.
|
||||
* @param string $meta_value Meta value.
|
||||
*
|
||||
* @return void
|
||||
*/
|
||||
private function handle_add_meta( WC_Order $order, string $meta_key, string $meta_value ) {
|
||||
$order_data_store = WC_Data_Store::load( 'order' );
|
||||
$count = 0;
|
||||
if ( is_protected_meta( $meta_key ) ) {
|
||||
wp_send_json_error( 'protected_meta' );
|
||||
wp_die();
|
||||
}
|
||||
$meta_id = $order_data_store->add_meta(
|
||||
$order,
|
||||
new WC_Meta_Data(
|
||||
array(
|
||||
'key' => $meta_key,
|
||||
'value' => $meta_value,
|
||||
)
|
||||
)
|
||||
);
|
||||
$response = new WP_Ajax_Response(
|
||||
array(
|
||||
'what' => 'meta',
|
||||
'id' => $meta_id,
|
||||
'data' => $this->list_meta_row(
|
||||
array(
|
||||
'meta_id' => $meta_id,
|
||||
'meta_key' => $meta_key, // phpcs:ignore WordPress.DB.SlowDBQuery.slow_db_query_meta_key -- false positive, not a meta query.
|
||||
'meta_value' => $meta_value, // phpcs:ignore WordPress.DB.SlowDBQuery.slow_db_query_meta_value -- false positive, not a meta query.
|
||||
),
|
||||
$count
|
||||
),
|
||||
'position' => 1,
|
||||
)
|
||||
);
|
||||
$response->send();
|
||||
}
|
||||
|
||||
/**
|
||||
* Handles updating metadata.
|
||||
*
|
||||
* @param WC_Order $order Order object.
|
||||
* @param array $meta Meta object to update.
|
||||
*
|
||||
* @return void
|
||||
*/
|
||||
private function handle_update_meta( WC_Order $order, array $meta ) {
|
||||
if ( ! is_array( $meta ) ) {
|
||||
wp_send_json_error( 'invalid_meta' );
|
||||
wp_die();
|
||||
}
|
||||
array_walk( $meta, 'sanitize_text_field' );
|
||||
$mid = (int) key( $meta );
|
||||
if ( ! $mid ) {
|
||||
wp_send_json_error( 'invalid_meta_id' );
|
||||
wp_die();
|
||||
}
|
||||
$key = $meta[ $mid ]['key'];
|
||||
$value = $meta[ $mid ]['value'];
|
||||
if ( is_protected_meta( $key ) ) {
|
||||
wp_send_json_error( 'protected_meta' );
|
||||
wp_die();
|
||||
}
|
||||
if ( '' === trim( $key ) ) {
|
||||
wp_send_json_error( 'invalid_meta_key' );
|
||||
wp_die();
|
||||
}
|
||||
|
||||
$order_data_store = WC_Data_Store::load( 'order' );
|
||||
$count = 0;
|
||||
$meta_object = new WC_Meta_Data(
|
||||
array(
|
||||
'id' => $mid,
|
||||
'key' => $key,
|
||||
'value' => $value,
|
||||
)
|
||||
);
|
||||
$order_data_store->update_meta( $order, $meta_object );
|
||||
$response = new WP_Ajax_Response(
|
||||
array(
|
||||
'what' => 'meta',
|
||||
'id' => $mid,
|
||||
'old_id' => $mid,
|
||||
'data' => $this->list_meta_row(
|
||||
array(
|
||||
'meta_key' => $key, // phpcs:ignore WordPress.DB.SlowDBQuery.slow_db_query_meta_key -- false positive, not a meta query.
|
||||
'meta_value' => $value, // phpcs:ignore WordPress.DB.SlowDBQuery.slow_db_query_meta_value -- false positive, not a meta query.
|
||||
'meta_id' => $mid,
|
||||
),
|
||||
$count
|
||||
),
|
||||
'position' => 0,
|
||||
)
|
||||
);
|
||||
$response->send();
|
||||
}
|
||||
|
||||
/**
|
||||
* Outputs a single row of public meta data in the Custom Fields meta box.
|
||||
*
|
||||
* @since 2.5.0
|
||||
*
|
||||
* @param array $entry Meta entry.
|
||||
* @param int $count Sequence number of meta entries.
|
||||
* @return string
|
||||
*/
|
||||
private function list_meta_row( array $entry, int &$count ) : string {
|
||||
if ( is_protected_meta( $entry['meta_key'], 'post' ) ) {
|
||||
return '';
|
||||
}
|
||||
|
||||
if ( ! $this->update_nonce ) {
|
||||
$this->update_nonce = wp_create_nonce( 'add-meta' );
|
||||
}
|
||||
|
||||
$r = '';
|
||||
++ $count;
|
||||
|
||||
if ( is_serialized( $entry['meta_value'] ) ) {
|
||||
if ( is_serialized_string( $entry['meta_value'] ) ) {
|
||||
// This is a serialized string, so we should display it.
|
||||
$entry['meta_value'] = maybe_unserialize( $entry['meta_value'] ); // // phpcs:ignore WordPress.DB.SlowDBQuery.slow_db_query_meta_value -- false positive, not a meta query.
|
||||
} else {
|
||||
// This is a serialized array/object so we should NOT display it.
|
||||
--$count;
|
||||
return '';
|
||||
}
|
||||
}
|
||||
|
||||
$entry['meta_key'] = esc_attr( $entry['meta_key'] ); // phpcs:ignore WordPress.DB.SlowDBQuery.slow_db_query_meta_key -- false positive, not a meta query.
|
||||
$entry['meta_value'] = esc_textarea( $entry['meta_value'] ); // phpcs:ignore WordPress.DB.SlowDBQuery.slow_db_query_meta_value -- false positive, not a meta query.
|
||||
$entry['meta_id'] = (int) $entry['meta_id'];
|
||||
|
||||
$delete_nonce = wp_create_nonce( 'delete-meta_' . $entry['meta_id'] );
|
||||
|
||||
$r .= "\n\t<tr id='meta-{$entry['meta_id']}'>";
|
||||
$r .= "\n\t\t<td class='left'><label class='screen-reader-text' for='meta-{$entry['meta_id']}-key'>" . __( 'Key', 'woocommerce' ) . "</label><input name='meta[{$entry['meta_id']}][key]' id='meta-{$entry['meta_id']}-key' type='text' size='20' value='{$entry['meta_key']}' />";
|
||||
|
||||
$r .= "\n\t\t<div class='submit'>";
|
||||
$r .= get_submit_button( __( 'Delete', 'woocommerce' ), 'deletemeta small', "deletemeta[{$entry['meta_id']}]", false, array( 'data-wp-lists' => "delete:the-list:meta-{$entry['meta_id']}::_ajax_nonce:$delete_nonce" ) );
|
||||
$r .= "\n\t\t";
|
||||
$r .= get_submit_button( __( 'Update', 'woocommerce' ), 'updatemeta small', "meta-{$entry['meta_id']}-submit", false, array( 'data-wp-lists' => "add:the-list:meta-{$entry['meta_id']}::_ajax_nonce-add-meta={$this->update_nonce}" ) );
|
||||
$r .= '</div>';
|
||||
$r .= wp_nonce_field( 'change-meta', '_ajax_nonce', false, false );
|
||||
$r .= '</td>';
|
||||
|
||||
$r .= "\n\t\t<td><label class='screen-reader-text' for='meta-{$entry['meta_id']}-value'>" . __( 'Value', 'woocommerce' ) . "</label><textarea name='meta[{$entry['meta_id']}][value]' id='meta-{$entry['meta_id']}-value' rows='2' cols='30'>{$entry['meta_value']}</textarea></td>\n\t</tr>";
|
||||
return $r;
|
||||
}
|
||||
|
||||
/**
|
||||
* Reimplementation of WP core's `wp_ajax_delete_meta` method to support order custom meta updates with custom tables.
|
||||
*
|
||||
* @return void
|
||||
*/
|
||||
public function delete_meta_ajax() {
|
||||
$meta_id = (int) $_POST['id'] ?? 0;
|
||||
$order_id = (int) $_POST['order_id'] ?? 0;
|
||||
if ( ! $meta_id || ! $order_id ) {
|
||||
wp_send_json_error( 'invalid_meta_id' );
|
||||
wp_die();
|
||||
}
|
||||
check_ajax_referer( "delete-meta_$meta_id" );
|
||||
|
||||
$order = $this->verify_order_edit_permission_for_ajax( $order_id );
|
||||
$meta_to_delete = wp_list_filter( $order->get_meta_data(), array( 'id' => $meta_id ) );
|
||||
|
||||
if ( empty( $meta_to_delete ) ) {
|
||||
wp_send_json_error( 'invalid_meta_id' );
|
||||
wp_die();
|
||||
}
|
||||
|
||||
$order->delete_meta_data_by_mid( $meta_id );
|
||||
if ( $order->save() ) {
|
||||
wp_die( 1 );
|
||||
}
|
||||
wp_die( 0 );
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,387 @@
|
||||
<?php
|
||||
namespace Automattic\WooCommerce\Internal\Admin\Orders;
|
||||
|
||||
use Automattic\WooCommerce\Internal\DataStores\Orders\CustomOrdersTableController;
|
||||
use Automattic\WooCommerce\Internal\Traits\AccessiblePrivateMethods;
|
||||
|
||||
/**
|
||||
* Controls the different pages/screens associated to the "Orders" menu page.
|
||||
*/
|
||||
class PageController {
|
||||
|
||||
use AccessiblePrivateMethods;
|
||||
|
||||
/**
|
||||
* The order type.
|
||||
*
|
||||
* @var string
|
||||
*/
|
||||
private $order_type = '';
|
||||
|
||||
/**
|
||||
* Instance of the posts redirection controller.
|
||||
*
|
||||
* @var PostsRedirectionController
|
||||
*/
|
||||
private $redirection_controller;
|
||||
|
||||
/**
|
||||
* Instance of the orders list table.
|
||||
*
|
||||
* @var ListTable
|
||||
*/
|
||||
private $orders_table;
|
||||
|
||||
/**
|
||||
* Instance of orders edit form.
|
||||
*
|
||||
* @var Edit
|
||||
*/
|
||||
private $order_edit_form;
|
||||
|
||||
/**
|
||||
* Current action.
|
||||
*
|
||||
* @var string
|
||||
*/
|
||||
private $current_action = '';
|
||||
|
||||
/**
|
||||
* Order object to be used in edit/new form.
|
||||
*
|
||||
* @var \WC_Order
|
||||
*/
|
||||
private $order;
|
||||
|
||||
/**
|
||||
* Verify that user has permission to edit orders.
|
||||
*
|
||||
* @return void
|
||||
*/
|
||||
private function verify_edit_permission() {
|
||||
if ( 'edit_order' === $this->current_action && ( ! isset( $this->order ) || ! $this->order ) ) {
|
||||
wp_die( esc_html__( 'You attempted to edit an order that does not exist. Perhaps it was deleted?', 'woocommerce' ) );
|
||||
}
|
||||
|
||||
if ( $this->order->get_type() !== $this->order_type ) {
|
||||
wp_die( esc_html__( 'Order type mismatch.', 'woocommerce' ) );
|
||||
}
|
||||
|
||||
if ( ! current_user_can( get_post_type_object( $this->order_type )->cap->edit_post, $this->order->get_id() ) && ! current_user_can( 'manage_woocommerce' ) ) {
|
||||
wp_die( esc_html__( 'You do not have permission to edit this order', 'woocommerce' ) );
|
||||
}
|
||||
|
||||
if ( 'trash' === $this->order->get_status() ) {
|
||||
wp_die( esc_html__( 'You cannot edit this item because it is in the Trash. Please restore it and try again.', 'woocommerce' ) );
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Verify that user has permission to create order.
|
||||
*
|
||||
* @return void
|
||||
*/
|
||||
private function verify_create_permission() {
|
||||
if ( ! current_user_can( get_post_type_object( $this->order_type )->cap->publish_posts ) && ! current_user_can( 'manage_woocommerce' ) ) {
|
||||
wp_die( esc_html__( 'You don\'t have permission to create a new order', 'woocommerce' ) );
|
||||
}
|
||||
|
||||
if ( isset( $this->order ) ) {
|
||||
$this->verify_edit_permission();
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Sets up the page controller, including registering the menu item.
|
||||
*
|
||||
* @return void
|
||||
*/
|
||||
public function setup(): void {
|
||||
$this->redirection_controller = new PostsRedirectionController( $this );
|
||||
|
||||
// Register menu.
|
||||
if ( 'admin_menu' === current_action() ) {
|
||||
$this->register_menu();
|
||||
} else {
|
||||
add_action( 'admin_menu', 'register_menu', 9 );
|
||||
}
|
||||
|
||||
$this->set_order_type();
|
||||
$this->set_action();
|
||||
|
||||
$page_suffix = ( 'shop_order' === $this->order_type ? '' : '--' . $this->order_type );
|
||||
|
||||
self::add_action( 'load-woocommerce_page_wc-orders' . $page_suffix, array( $this, 'handle_load_page_action' ) );
|
||||
}
|
||||
|
||||
/**
|
||||
* Perform initialization for the current action.
|
||||
*/
|
||||
private function handle_load_page_action() {
|
||||
if ( method_exists( $this, 'setup_action_' . $this->current_action ) ) {
|
||||
$this->{"setup_action_{$this->current_action}"}();
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Determines the order type for the current screen.
|
||||
*
|
||||
* @return void
|
||||
*/
|
||||
private function set_order_type() {
|
||||
global $plugin_page, $pagenow;
|
||||
|
||||
if ( 'admin.php' !== $pagenow || 0 !== strpos( $plugin_page, 'wc-orders' ) ) {
|
||||
return;
|
||||
}
|
||||
|
||||
$this->order_type = str_replace( array( 'wc-orders--', 'wc-orders' ), '', $plugin_page );
|
||||
$this->order_type = empty( $this->order_type ) ? 'shop_order' : $this->order_type;
|
||||
|
||||
$wc_order_type = wc_get_order_type( $this->order_type );
|
||||
$wp_order_type = get_post_type_object( $this->order_type );
|
||||
|
||||
if ( ! $wc_order_type || ! $wp_order_type || ! $wp_order_type->show_ui || ! current_user_can( $wp_order_type->cap->edit_posts ) ) {
|
||||
wp_die();
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Sets the current action based on querystring arguments. Defaults to 'list_orders'.
|
||||
*
|
||||
* @return void
|
||||
*/
|
||||
private function set_action(): void {
|
||||
switch ( isset( $_GET['action'] ) ? sanitize_text_field( wp_unslash( $_GET['action'] ) ) : '' ) {
|
||||
case 'edit':
|
||||
$this->current_action = 'edit_order';
|
||||
break;
|
||||
case 'new':
|
||||
$this->current_action = 'new_order';
|
||||
break;
|
||||
default:
|
||||
$this->current_action = 'list_orders';
|
||||
break;
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Registers the "Orders" menu.
|
||||
*
|
||||
* @return void
|
||||
*/
|
||||
public function register_menu(): void {
|
||||
$order_types = wc_get_order_types( 'admin-menu' );
|
||||
|
||||
foreach ( $order_types as $order_type ) {
|
||||
$post_type = get_post_type_object( $order_type );
|
||||
|
||||
add_submenu_page(
|
||||
'woocommerce',
|
||||
$post_type->labels->name,
|
||||
$post_type->labels->menu_name,
|
||||
$post_type->cap->edit_posts,
|
||||
'wc-orders' . ( 'shop_order' === $order_type ? '' : '--' . $order_type ),
|
||||
array( $this, 'output' )
|
||||
);
|
||||
}
|
||||
|
||||
// In some cases (such as if the authoritative order store was changed earlier in the current request) we
|
||||
// need an extra step to remove the menu entry for the menu post type.
|
||||
add_action(
|
||||
'admin_init',
|
||||
function() use ( $order_types ) {
|
||||
foreach ( $order_types as $order_type ) {
|
||||
remove_submenu_page( 'woocommerce', 'edit.php?post_type=' . $order_type );
|
||||
}
|
||||
}
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Outputs content for the current orders screen.
|
||||
*
|
||||
* @return void
|
||||
*/
|
||||
public function output(): void {
|
||||
switch ( $this->current_action ) {
|
||||
case 'edit_order':
|
||||
case 'new_order':
|
||||
if ( ! isset( $this->order_edit_form ) ) {
|
||||
$this->order_edit_form = new Edit();
|
||||
$this->order_edit_form->setup( $this->order );
|
||||
}
|
||||
$this->order_edit_form->set_current_action( $this->current_action );
|
||||
$this->order_edit_form->display();
|
||||
break;
|
||||
case 'list_orders':
|
||||
default:
|
||||
$this->orders_table->prepare_items();
|
||||
$this->orders_table->display();
|
||||
break;
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Handles initialization of the orders list table.
|
||||
*
|
||||
* @return void
|
||||
*/
|
||||
private function setup_action_list_orders(): void {
|
||||
$this->orders_table = wc_get_container()->get( ListTable::class );
|
||||
$this->orders_table->setup(
|
||||
array(
|
||||
'order_type' => $this->order_type,
|
||||
)
|
||||
);
|
||||
|
||||
if ( $this->orders_table->current_action() ) {
|
||||
$this->orders_table->handle_bulk_actions();
|
||||
}
|
||||
|
||||
$this->strip_http_referer();
|
||||
}
|
||||
|
||||
/**
|
||||
* Perform a redirect to remove the `_wp_http_referer` and `_wpnonce` strings if present in the URL (see also
|
||||
* wp-admin/edit.php where a similar process takes place), otherwise the size of this field builds to an
|
||||
* unmanageable length over time.
|
||||
*/
|
||||
private function strip_http_referer(): void {
|
||||
$current_url = esc_url_raw( wp_unslash( $_SERVER['REQUEST_URI'] ?? '' ) );
|
||||
$stripped_url = remove_query_arg( array( '_wp_http_referer', '_wpnonce' ), $current_url );
|
||||
|
||||
if ( $stripped_url !== $current_url ) {
|
||||
wp_safe_redirect( $stripped_url );
|
||||
exit;
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Handles initialization of the orders edit form.
|
||||
*
|
||||
* @return void
|
||||
*/
|
||||
private function setup_action_edit_order(): void {
|
||||
global $theorder;
|
||||
$this->order = wc_get_order( absint( isset( $_GET['id'] ) ? $_GET['id'] : 0 ) );
|
||||
$this->verify_edit_permission();
|
||||
$theorder = $this->order;
|
||||
}
|
||||
|
||||
/**
|
||||
* Handles initialization of the orders edit form with a new order.
|
||||
*
|
||||
* @return void
|
||||
*/
|
||||
private function setup_action_new_order(): void {
|
||||
global $theorder;
|
||||
|
||||
$this->verify_create_permission();
|
||||
|
||||
$order_class_name = wc_get_order_type( $this->order_type )['class_name'];
|
||||
if ( ! $order_class_name || ! class_exists( $order_class_name ) ) {
|
||||
wp_die();
|
||||
}
|
||||
|
||||
$this->order = new $order_class_name();
|
||||
$this->order->set_object_read( false );
|
||||
$this->order->set_status( 'pending' );
|
||||
$this->order->save();
|
||||
|
||||
$theorder = $this->order;
|
||||
}
|
||||
|
||||
/**
|
||||
* Returns the current order type.
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
public function get_order_type() {
|
||||
return $this->order_type;
|
||||
}
|
||||
|
||||
/**
|
||||
* Helper method to generate a link to the main orders screen.
|
||||
*
|
||||
* @return string Orders screen URL.
|
||||
*/
|
||||
public function get_orders_url(): string {
|
||||
return wc_get_container()->get( CustomOrdersTableController::class )->custom_orders_table_usage_is_enabled() ?
|
||||
admin_url( 'admin.php?page=wc-orders' ) :
|
||||
admin_url( 'edit.php?post_type=shop_order' );
|
||||
}
|
||||
|
||||
/**
|
||||
* Helper method to generate edit link for an order.
|
||||
*
|
||||
* @param int $order_id Order ID.
|
||||
*
|
||||
* @return string Edit link.
|
||||
*/
|
||||
public function get_edit_url( int $order_id ) : string {
|
||||
if ( ! wc_get_container()->get( CustomOrdersTableController::class )->custom_orders_table_usage_is_enabled() ) {
|
||||
return admin_url( 'post.php?post=' . absint( $order_id ) ) . '&action=edit';
|
||||
}
|
||||
|
||||
$order = wc_get_order( $order_id );
|
||||
|
||||
// Confirm we could obtain the order object (since it's possible it will not exist, due to a sync issue, or may
|
||||
// have been deleted in a separate concurrent request).
|
||||
if ( false === $order ) {
|
||||
wc_get_logger()->debug(
|
||||
sprintf(
|
||||
/* translators: %d order ID. */
|
||||
__( 'Attempted to determine the edit URL for order %d, however the order does not exist.', 'woocommerce' ),
|
||||
$order_id
|
||||
)
|
||||
);
|
||||
$order_type = 'shop_order';
|
||||
} else {
|
||||
$order_type = $order->get_type();
|
||||
}
|
||||
|
||||
return add_query_arg(
|
||||
array(
|
||||
'action' => 'edit',
|
||||
'id' => absint( $order_id ),
|
||||
),
|
||||
$this->get_base_page_url( $order_type )
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Helper method to generate a link for creating order.
|
||||
*
|
||||
* @param string $order_type The order type. Defaults to 'shop_order'.
|
||||
* @return string
|
||||
*/
|
||||
public function get_new_page_url( $order_type = 'shop_order' ) : string {
|
||||
$url = wc_get_container()->get( CustomOrdersTableController::class )->custom_orders_table_usage_is_enabled() ?
|
||||
add_query_arg( 'action', 'new', $this->get_base_page_url( $order_type ) ) :
|
||||
admin_url( 'post-new.php?post_type=' . $order_type );
|
||||
|
||||
return $url;
|
||||
}
|
||||
|
||||
/**
|
||||
* Helper method to generate a link to the main screen for a custom order type.
|
||||
*
|
||||
* @param string $order_type The order type.
|
||||
*
|
||||
* @return string
|
||||
*
|
||||
* @throws \Exception When an invalid order type is passed.
|
||||
*/
|
||||
public function get_base_page_url( $order_type ): string {
|
||||
$order_types_with_ui = wc_get_order_types( 'admin-menu' );
|
||||
|
||||
if ( ! in_array( $order_type, $order_types_with_ui, true ) ) {
|
||||
// translators: %s is a custom order type.
|
||||
throw new \Exception( sprintf( __( 'Invalid order type: %s.', 'woocommerce' ), esc_html( $order_type ) ) );
|
||||
}
|
||||
|
||||
return admin_url( 'admin.php?page=wc-orders' . ( 'shop_order' === $order_type ? '' : '--' . $order_type ) );
|
||||
}
|
||||
|
||||
}
|
||||
@@ -0,0 +1,182 @@
|
||||
<?php
|
||||
namespace Automattic\WooCommerce\Internal\Admin\Orders;
|
||||
|
||||
use Automattic\WooCommerce\Internal\DataStores\Orders\CustomOrdersTableController;
|
||||
|
||||
/**
|
||||
* When {@see OrdersTableDataStore} is in use, this class takes care of redirecting admins from CPT-based URLs
|
||||
* to the new ones.
|
||||
*/
|
||||
class PostsRedirectionController {
|
||||
|
||||
/**
|
||||
* Instance of the PageController class.
|
||||
*
|
||||
* @var PageController
|
||||
*/
|
||||
private $page_controller;
|
||||
|
||||
/**
|
||||
* Constructor.
|
||||
*
|
||||
* @param PageController $page_controller Page controller instance. Used to generate links/URLs.
|
||||
*/
|
||||
public function __construct( PageController $page_controller ) {
|
||||
$this->page_controller = $page_controller;
|
||||
|
||||
if ( ! wc_get_container()->get( CustomOrdersTableController::class )->custom_orders_table_usage_is_enabled() ) {
|
||||
return;
|
||||
}
|
||||
|
||||
add_action(
|
||||
'load-edit.php',
|
||||
function() {
|
||||
$this->maybe_redirect_to_orders_page();
|
||||
}
|
||||
);
|
||||
|
||||
add_action(
|
||||
'load-post-new.php',
|
||||
function() {
|
||||
$this->maybe_redirect_to_new_order_page();
|
||||
}
|
||||
);
|
||||
|
||||
add_action(
|
||||
'load-post.php',
|
||||
function() {
|
||||
$this->maybe_redirect_to_edit_order_page();
|
||||
}
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* If needed, performs a redirection to the main orders page.
|
||||
*
|
||||
* @return void
|
||||
*/
|
||||
private function maybe_redirect_to_orders_page(): void {
|
||||
$post_type = $_GET['post_type'] ?? ''; // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.MissingUnslash, WordPress.Security.ValidatedSanitizedInput.InputNotSanitized
|
||||
|
||||
if ( ! $post_type || ! in_array( $post_type, wc_get_order_types( 'admin-menu' ), true ) ) {
|
||||
return;
|
||||
}
|
||||
|
||||
// Respect query args, except for 'post_type'.
|
||||
$query_args = wp_unslash( $_GET );
|
||||
$action = $query_args['action'] ?? '';
|
||||
$posts = $query_args['post'] ?? array();
|
||||
unset( $query_args['post_type'], $query_args['post'], $query_args['_wpnonce'], $query_args['_wp_http_referer'], $query_args['action'] );
|
||||
|
||||
// Remap 'post_status' arg.
|
||||
if ( isset( $query_args['post_status'] ) ) {
|
||||
$query_args['status'] = $query_args['post_status'];
|
||||
unset( $query_args['post_status'] );
|
||||
}
|
||||
|
||||
$new_url = $this->page_controller->get_base_page_url( $post_type );
|
||||
$new_url = add_query_arg( $query_args, $new_url );
|
||||
|
||||
// Handle bulk actions.
|
||||
if ( $action && in_array( $action, array( 'trash', 'untrash', 'delete', 'mark_processing', 'mark_on-hold', 'mark_completed', 'mark_cancelled' ), true ) ) {
|
||||
check_admin_referer( 'bulk-posts' );
|
||||
|
||||
$new_url = add_query_arg(
|
||||
array(
|
||||
'action' => $action,
|
||||
'order' => $posts,
|
||||
'_wp_http_referer' => $this->page_controller->get_orders_url(),
|
||||
'_wpnonce' => wp_create_nonce( 'bulk-orders' ),
|
||||
),
|
||||
$new_url
|
||||
);
|
||||
}
|
||||
|
||||
wp_safe_redirect( $new_url, 301 );
|
||||
exit;
|
||||
}
|
||||
|
||||
/**
|
||||
* If needed, performs a redirection to the new order page.
|
||||
*
|
||||
* @return void
|
||||
*/
|
||||
private function maybe_redirect_to_new_order_page(): void {
|
||||
$post_type = $_GET['post_type'] ?? ''; // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.MissingUnslash, WordPress.Security.ValidatedSanitizedInput.InputNotSanitized
|
||||
|
||||
if ( ! $post_type || ! in_array( $post_type, wc_get_order_types( 'admin-menu' ), true ) ) {
|
||||
return;
|
||||
}
|
||||
|
||||
// Respect query args, except for 'post_type'.
|
||||
$query_args = wp_unslash( $_GET );
|
||||
unset( $query_args['post_type'] );
|
||||
|
||||
$new_url = $this->page_controller->get_new_page_url( $post_type );
|
||||
$new_url = add_query_arg( $query_args, $new_url );
|
||||
|
||||
wp_safe_redirect( $new_url, 301 );
|
||||
exit;
|
||||
}
|
||||
|
||||
/**
|
||||
* If needed, performs a redirection to the edit order page.
|
||||
*
|
||||
* @return void
|
||||
*/
|
||||
private function maybe_redirect_to_edit_order_page(): void {
|
||||
$post_id = absint( $_GET['post'] ?? 0 );
|
||||
|
||||
$redirect_from_types = wc_get_order_types( 'admin-menu' );
|
||||
$redirect_from_types[] = 'shop_order_placehold';
|
||||
|
||||
if ( ! $post_id || ! in_array( get_post_type( $post_id ), $redirect_from_types, true ) || ! isset( $_GET['action'] ) ) {
|
||||
return;
|
||||
}
|
||||
|
||||
// Respect query args, except for 'post'.
|
||||
$query_args = wp_unslash( $_GET );
|
||||
$action = $query_args['action'];
|
||||
unset( $query_args['post'], $query_args['_wpnonce'], $query_args['_wp_http_referer'], $query_args['action'] );
|
||||
|
||||
$new_url = '';
|
||||
|
||||
switch ( $action ) {
|
||||
case 'edit':
|
||||
$new_url = $this->page_controller->get_edit_url( $post_id );
|
||||
break;
|
||||
|
||||
case 'trash':
|
||||
case 'untrash':
|
||||
case 'delete':
|
||||
// Re-generate nonce if validation passes.
|
||||
check_admin_referer( $action . '-post_' . $post_id );
|
||||
|
||||
$new_url = add_query_arg(
|
||||
array(
|
||||
'action' => $action,
|
||||
'order' => array( $post_id ),
|
||||
'_wp_http_referer' => $this->page_controller->get_orders_url(),
|
||||
'_wpnonce' => wp_create_nonce( 'bulk-orders' ),
|
||||
),
|
||||
$this->page_controller->get_orders_url()
|
||||
);
|
||||
|
||||
break;
|
||||
|
||||
default:
|
||||
break;
|
||||
}
|
||||
|
||||
if ( ! $new_url ) {
|
||||
return;
|
||||
}
|
||||
|
||||
$new_url = add_query_arg( $query_args, $new_url );
|
||||
|
||||
wp_safe_redirect( $new_url, 301 );
|
||||
exit;
|
||||
}
|
||||
|
||||
}
|
||||
|
||||
@@ -0,0 +1,138 @@
|
||||
<?php
|
||||
/**
|
||||
* Abstract class for product form components.
|
||||
*/
|
||||
|
||||
namespace Automattic\WooCommerce\Internal\Admin\ProductForm;
|
||||
|
||||
/**
|
||||
* Component class.
|
||||
*/
|
||||
abstract class Component {
|
||||
/**
|
||||
* Product Component traits.
|
||||
*/
|
||||
use ComponentTrait;
|
||||
|
||||
/**
|
||||
* Component additional arguments.
|
||||
*
|
||||
* @var array
|
||||
*/
|
||||
protected $additional_args;
|
||||
|
||||
/**
|
||||
* Constructor
|
||||
*
|
||||
* @param string $id Component id.
|
||||
* @param string $plugin_id Plugin id.
|
||||
* @param array $additional_args Array containing additional arguments.
|
||||
*/
|
||||
public function __construct( $id, $plugin_id, $additional_args ) {
|
||||
$this->id = $id;
|
||||
$this->plugin_id = $plugin_id;
|
||||
$this->additional_args = $additional_args;
|
||||
}
|
||||
|
||||
/**
|
||||
* Component arguments.
|
||||
*
|
||||
* @return array
|
||||
*/
|
||||
public function get_additional_args() {
|
||||
return $this->additional_args;
|
||||
}
|
||||
|
||||
/**
|
||||
* Component arguments.
|
||||
*
|
||||
* @param string $key key of argument.
|
||||
* @return mixed
|
||||
*/
|
||||
public function get_additional_argument( $key ) {
|
||||
return self::get_argument_from_path( $this->additional_args, $key );
|
||||
}
|
||||
|
||||
/**
|
||||
* Get the component as JSON.
|
||||
*
|
||||
* @return array
|
||||
*/
|
||||
public function get_json() {
|
||||
return array_merge(
|
||||
array(
|
||||
'id' => $this->get_id(),
|
||||
'plugin_id' => $this->get_plugin_id(),
|
||||
),
|
||||
$this->get_additional_args()
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Sorting function for product form component.
|
||||
*
|
||||
* @param Component $a Component a.
|
||||
* @param Component $b Component b.
|
||||
* @param array $sort_by key and order to sort by.
|
||||
* @return int
|
||||
*/
|
||||
public static function sort( $a, $b, $sort_by = array() ) {
|
||||
$key = $sort_by['key'];
|
||||
$a_val = $a->get_additional_argument( $key );
|
||||
$b_val = $b->get_additional_argument( $key );
|
||||
if ( 'asc' === $sort_by['order'] ) {
|
||||
return $a_val <=> $b_val;
|
||||
} else {
|
||||
return $b_val <=> $a_val;
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Gets argument by dot notation path.
|
||||
*
|
||||
* @param array $arguments Arguments array.
|
||||
* @param string $path Path for argument key.
|
||||
* @param string $delimiter Path delimiter, default: '.'.
|
||||
* @return mixed|null
|
||||
*/
|
||||
public static function get_argument_from_path( $arguments, $path, $delimiter = '.' ) {
|
||||
$path_keys = explode( $delimiter, $path );
|
||||
$num_keys = count( $path_keys );
|
||||
|
||||
$val = $arguments;
|
||||
for ( $i = 0; $i < $num_keys; $i++ ) {
|
||||
$key = $path_keys[ $i ];
|
||||
if ( array_key_exists( $key, $val ) ) {
|
||||
$val = $val[ $key ];
|
||||
} else {
|
||||
$val = null;
|
||||
break;
|
||||
}
|
||||
}
|
||||
return $val;
|
||||
}
|
||||
|
||||
/**
|
||||
* Array of required arguments.
|
||||
*
|
||||
* @var array
|
||||
*/
|
||||
protected $required_arguments = array();
|
||||
|
||||
/**
|
||||
* Get missing arguments of args array.
|
||||
*
|
||||
* @param array $args field arguments.
|
||||
* @return array
|
||||
*/
|
||||
public function get_missing_arguments( $args ) {
|
||||
return array_values(
|
||||
array_filter(
|
||||
$this->required_arguments,
|
||||
function( $arg_key ) use ( $args ) {
|
||||
return null === self::get_argument_from_path( $args, $arg_key );
|
||||
}
|
||||
)
|
||||
);
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,59 @@
|
||||
<?php
|
||||
/**
|
||||
* Product Form Traits
|
||||
*/
|
||||
|
||||
namespace Automattic\WooCommerce\Internal\Admin\ProductForm;
|
||||
|
||||
defined( 'ABSPATH' ) || exit;
|
||||
|
||||
/**
|
||||
* ComponentTrait class.
|
||||
*/
|
||||
trait ComponentTrait {
|
||||
/**
|
||||
* Component ID.
|
||||
*
|
||||
* @var string
|
||||
*/
|
||||
protected $id;
|
||||
|
||||
/**
|
||||
* Plugin ID.
|
||||
*
|
||||
* @var string
|
||||
*/
|
||||
protected $plugin_id;
|
||||
|
||||
/**
|
||||
* Product form component location.
|
||||
*
|
||||
* @var string
|
||||
*/
|
||||
protected $location;
|
||||
|
||||
/**
|
||||
* Product form component order.
|
||||
*
|
||||
* @var number
|
||||
*/
|
||||
protected $order;
|
||||
|
||||
/**
|
||||
* Return id.
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
public function get_id() {
|
||||
return $this->id;
|
||||
}
|
||||
|
||||
/**
|
||||
* Return plugin id.
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
public function get_plugin_id() {
|
||||
return $this->plugin_id;
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,47 @@
|
||||
<?php
|
||||
/**
|
||||
* Handles product form field related methods.
|
||||
*/
|
||||
|
||||
namespace Automattic\WooCommerce\Internal\Admin\ProductForm;
|
||||
|
||||
/**
|
||||
* Field class.
|
||||
*/
|
||||
class Field extends Component {
|
||||
|
||||
/**
|
||||
* Constructor
|
||||
*
|
||||
* @param string $id Field id.
|
||||
* @param string $plugin_id Plugin id.
|
||||
* @param array $additional_args Array containing the necessary arguments.
|
||||
* $args = array(
|
||||
* 'type' => (string) Field type. Required.
|
||||
* 'section' => (string) Field location. Required.
|
||||
* 'order' => (int) Field order.
|
||||
* 'properties' => (array) Field properties.
|
||||
* ).
|
||||
* @throws \Exception If there are missing arguments.
|
||||
*/
|
||||
public function __construct( $id, $plugin_id, $additional_args ) {
|
||||
parent::__construct( $id, $plugin_id, $additional_args );
|
||||
$this->required_arguments = array(
|
||||
'type',
|
||||
'section',
|
||||
'properties.name',
|
||||
'properties.label',
|
||||
);
|
||||
|
||||
$missing_arguments = self::get_missing_arguments( $additional_args );
|
||||
if ( count( $missing_arguments ) > 0 ) {
|
||||
throw new \Exception(
|
||||
sprintf(
|
||||
/* translators: 1: Missing arguments list. */
|
||||
esc_html__( 'You are missing required arguments of WooCommerce ProductForm Field: %1$s', 'woocommerce' ),
|
||||
join( ', ', $missing_arguments )
|
||||
)
|
||||
);
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,289 @@
|
||||
<?php
|
||||
/**
|
||||
* WooCommerce Product Form Factory
|
||||
*
|
||||
* @package Woocommerce ProductForm
|
||||
*/
|
||||
|
||||
namespace Automattic\WooCommerce\Internal\Admin\ProductForm;
|
||||
|
||||
use WP_Error;
|
||||
|
||||
/**
|
||||
* Factory that contains logic for the WooCommerce Product Form.
|
||||
*/
|
||||
class FormFactory {
|
||||
/**
|
||||
* Class instance.
|
||||
*
|
||||
* @var Form instance
|
||||
*/
|
||||
protected static $instance = null;
|
||||
|
||||
/**
|
||||
* Store form fields.
|
||||
*
|
||||
* @var array
|
||||
*/
|
||||
protected static $form_fields = array();
|
||||
|
||||
/**
|
||||
* Store form cards.
|
||||
*
|
||||
* @var array
|
||||
*/
|
||||
protected static $form_subsections = array();
|
||||
|
||||
/**
|
||||
* Store form sections.
|
||||
*
|
||||
* @var array
|
||||
*/
|
||||
protected static $form_sections = array();
|
||||
|
||||
/**
|
||||
* Store form tabs.
|
||||
*
|
||||
* @var array
|
||||
*/
|
||||
protected static $form_tabs = array();
|
||||
|
||||
/**
|
||||
* Get class instance.
|
||||
*/
|
||||
final public static function instance() {
|
||||
if ( ! static::$instance ) {
|
||||
static::$instance = new static();
|
||||
}
|
||||
return static::$instance;
|
||||
}
|
||||
|
||||
/**
|
||||
* Init.
|
||||
*/
|
||||
public function init() { }
|
||||
|
||||
/**
|
||||
* Adds a field to the product form.
|
||||
*
|
||||
* @param string $id Field id.
|
||||
* @param string $plugin_id Plugin id.
|
||||
* @param array $args Array containing the necessary arguments.
|
||||
* $args = array(
|
||||
* 'type' => (string) Field type. Required.
|
||||
* 'section' => (string) Field location. Required.
|
||||
* 'order' => (int) Field order.
|
||||
* 'properties' => (array) Field properties.
|
||||
* 'name' => (string) Field name.
|
||||
* ).
|
||||
* @return Field|WP_Error New field or WP_Error.
|
||||
*/
|
||||
public static function add_field( $id, $plugin_id, $args ) {
|
||||
$new_field = self::create_item( 'field', 'Field', $id, $plugin_id, $args );
|
||||
if ( is_wp_error( $new_field ) ) {
|
||||
return $new_field;
|
||||
}
|
||||
self::$form_fields[ $id ] = $new_field;
|
||||
return $new_field;
|
||||
}
|
||||
|
||||
/**
|
||||
* Adds a Subsection to the product form.
|
||||
*
|
||||
* @param string $id Subsection id.
|
||||
* @param string $plugin_id Plugin id.
|
||||
* @param array $args Array containing the necessary arguments.
|
||||
* @return Subsection|WP_Error New subsection or WP_Error.
|
||||
*/
|
||||
public static function add_subsection( $id, $plugin_id, $args = array() ) {
|
||||
$new_subsection = self::create_item( 'subsection', 'Subsection', $id, $plugin_id, $args );
|
||||
if ( is_wp_error( $new_subsection ) ) {
|
||||
return $new_subsection;
|
||||
}
|
||||
self::$form_subsections[ $id ] = $new_subsection;
|
||||
return $new_subsection;
|
||||
}
|
||||
|
||||
/**
|
||||
* Adds a section to the product form.
|
||||
*
|
||||
* @param string $id Card id.
|
||||
* @param string $plugin_id Plugin id.
|
||||
* @param array $args Array containing the necessary arguments.
|
||||
* @return Section|WP_Error New section or WP_Error.
|
||||
*/
|
||||
public static function add_section( $id, $plugin_id, $args ) {
|
||||
$new_section = self::create_item( 'section', 'Section', $id, $plugin_id, $args );
|
||||
if ( is_wp_error( $new_section ) ) {
|
||||
return $new_section;
|
||||
}
|
||||
self::$form_sections[ $id ] = $new_section;
|
||||
return $new_section;
|
||||
}
|
||||
|
||||
/**
|
||||
* Adds a tab to the product form.
|
||||
*
|
||||
* @param string $id Card id.
|
||||
* @param string $plugin_id Plugin id.
|
||||
* @param array $args Array containing the necessary arguments.
|
||||
* @return Tab|WP_Error New section or WP_Error.
|
||||
*/
|
||||
public static function add_tab( $id, $plugin_id, $args ) {
|
||||
$new_tab = self::create_item( 'tab', 'Tab', $id, $plugin_id, $args );
|
||||
if ( is_wp_error( $new_tab ) ) {
|
||||
return $new_tab;
|
||||
}
|
||||
self::$form_tabs[ $id ] = $new_tab;
|
||||
return $new_tab;
|
||||
}
|
||||
|
||||
/**
|
||||
* Returns list of registered fields.
|
||||
*
|
||||
* @param array $sort_by key and order to sort by.
|
||||
* @return array list of registered fields.
|
||||
*/
|
||||
public static function get_fields( $sort_by = array(
|
||||
'key' => 'order',
|
||||
'order' => 'asc',
|
||||
) ) {
|
||||
return self::get_items( 'field', 'Field', $sort_by );
|
||||
}
|
||||
|
||||
/**
|
||||
* Returns list of registered cards.
|
||||
*
|
||||
* @param array $sort_by key and order to sort by.
|
||||
* @return array list of registered cards.
|
||||
*/
|
||||
public static function get_subsections( $sort_by = array(
|
||||
'key' => 'order',
|
||||
'order' => 'asc',
|
||||
) ) {
|
||||
return self::get_items( 'subsection', 'Subsection', $sort_by );
|
||||
}
|
||||
|
||||
/**
|
||||
* Returns list of registered sections.
|
||||
*
|
||||
* @param array $sort_by key and order to sort by.
|
||||
* @return array list of registered sections.
|
||||
*/
|
||||
public static function get_sections( $sort_by = array(
|
||||
'key' => 'order',
|
||||
'order' => 'asc',
|
||||
) ) {
|
||||
return self::get_items( 'section', 'Section', $sort_by );
|
||||
}
|
||||
|
||||
/**
|
||||
* Returns list of registered tabs.
|
||||
*
|
||||
* @param array $sort_by key and order to sort by.
|
||||
* @return array list of registered tabs.
|
||||
*/
|
||||
public static function get_tabs( $sort_by = array(
|
||||
'key' => 'order',
|
||||
'order' => 'asc',
|
||||
) ) {
|
||||
return self::get_items( 'tab', 'Tab', $sort_by );
|
||||
}
|
||||
|
||||
/**
|
||||
* Returns list of registered items.
|
||||
*
|
||||
* @param string $type Form component type.
|
||||
* @return array List of registered items.
|
||||
*/
|
||||
private static function get_item_list( $type ) {
|
||||
$mapping = array(
|
||||
'field' => self::$form_fields,
|
||||
'subsection' => self::$form_subsections,
|
||||
'section' => self::$form_sections,
|
||||
'tab' => self::$form_tabs,
|
||||
);
|
||||
if ( array_key_exists( $type, $mapping ) ) {
|
||||
return $mapping[ $type ];
|
||||
}
|
||||
return array();
|
||||
}
|
||||
|
||||
/**
|
||||
* Returns list of registered items.
|
||||
*
|
||||
* @param string $type Form component type.
|
||||
* @param class-string $class_name Class of component type.
|
||||
* @param array $sort_by key and order to sort by.
|
||||
* @return array list of registered items.
|
||||
*/
|
||||
private static function get_items( $type, $class_name, $sort_by = array(
|
||||
'key' => 'order',
|
||||
'order' => 'asc',
|
||||
) ) {
|
||||
$item_list = self::get_item_list( $type );
|
||||
$class = 'Automattic\\WooCommerce\\Internal\\Admin\\ProductForm\\' . $class_name;
|
||||
$items = array_values( $item_list );
|
||||
if ( class_exists( $class ) && method_exists( $class, 'sort' ) ) {
|
||||
usort(
|
||||
$items,
|
||||
function ( $a, $b ) use ( $sort_by, $class ) {
|
||||
return $class::sort( $a, $b, $sort_by );
|
||||
}
|
||||
);
|
||||
}
|
||||
return $items;
|
||||
}
|
||||
|
||||
/**
|
||||
* Creates a new item.
|
||||
*
|
||||
* @param string $type Form component type.
|
||||
* @param class-string $class_name Class of component type.
|
||||
* @param string $id Item id.
|
||||
* @param string $plugin_id Plugin id.
|
||||
* @param array $args additional arguments for item.
|
||||
* @return Field|Card|Section|Tab|WP_Error New product form item or WP_Error.
|
||||
*/
|
||||
private static function create_item( $type, $class_name, $id, $plugin_id, $args ) {
|
||||
$item_list = self::get_item_list( $type );
|
||||
$class = 'Automattic\\WooCommerce\\Internal\\Admin\\ProductForm\\' . $class_name;
|
||||
if ( ! class_exists( $class ) ) {
|
||||
return new WP_Error(
|
||||
'wc_product_form_' . $type . '_missing_form_class',
|
||||
sprintf(
|
||||
/* translators: 1: missing class name. */
|
||||
esc_html__( '%1$s class does not exist.', 'woocommerce' ),
|
||||
$class
|
||||
)
|
||||
);
|
||||
}
|
||||
if ( isset( $item_list[ $id ] ) ) {
|
||||
return new WP_Error(
|
||||
'wc_product_form_' . $type . '_duplicate_field_id',
|
||||
sprintf(
|
||||
/* translators: 1: Item type 2: Duplicate registered item id. */
|
||||
esc_html__( 'You have attempted to register a duplicate form %1$s with WooCommerce Form: %2$s', 'woocommerce' ),
|
||||
$type,
|
||||
'`' . $id . '`'
|
||||
)
|
||||
);
|
||||
}
|
||||
|
||||
$defaults = array(
|
||||
'order' => 20,
|
||||
);
|
||||
|
||||
$item_arguments = wp_parse_args( $args, $defaults );
|
||||
|
||||
try {
|
||||
return new $class( $id, $plugin_id, $item_arguments );
|
||||
} catch ( \Exception $e ) {
|
||||
return new WP_Error(
|
||||
'wc_product_form_' . $type . '_class_creation',
|
||||
$e->getMessage()
|
||||
);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
@@ -0,0 +1,42 @@
|
||||
<?php
|
||||
/**
|
||||
* Handles product form section related methods.
|
||||
*/
|
||||
|
||||
namespace Automattic\WooCommerce\Internal\Admin\ProductForm;
|
||||
|
||||
/**
|
||||
* Section class.
|
||||
*/
|
||||
class Section extends Component {
|
||||
|
||||
/**
|
||||
* Constructor
|
||||
*
|
||||
* @param string $id Section id.
|
||||
* @param string $plugin_id Plugin id.
|
||||
* @param array $additional_args Array containing additional arguments.
|
||||
* $args = array(
|
||||
* 'order' => (int) Section order.
|
||||
* 'title' => (string) Section description.
|
||||
* 'description' => (string) Section description.
|
||||
* ).
|
||||
* @throws \Exception If there are missing arguments.
|
||||
*/
|
||||
public function __construct( $id, $plugin_id, $additional_args ) {
|
||||
parent::__construct( $id, $plugin_id, $additional_args );
|
||||
$this->required_arguments = array(
|
||||
'title',
|
||||
);
|
||||
$missing_arguments = self::get_missing_arguments( $additional_args );
|
||||
if ( count( $missing_arguments ) > 0 ) {
|
||||
throw new \Exception(
|
||||
sprintf(
|
||||
/* translators: 1: Missing arguments list. */
|
||||
esc_html__( 'You are missing required arguments of WooCommerce ProductForm Section: %1$s', 'woocommerce' ),
|
||||
join( ', ', $missing_arguments )
|
||||
)
|
||||
);
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,11 @@
|
||||
<?php
|
||||
/**
|
||||
* Handles product form SubSection related methods.
|
||||
*/
|
||||
|
||||
namespace Automattic\WooCommerce\Internal\Admin\ProductForm;
|
||||
|
||||
/**
|
||||
* SubSection class.
|
||||
*/
|
||||
class Subsection extends Component {}
|
||||
@@ -0,0 +1,47 @@
|
||||
<?php
|
||||
/**
|
||||
* Handles product form tab related methods.
|
||||
*/
|
||||
|
||||
namespace Automattic\WooCommerce\Internal\Admin\ProductForm;
|
||||
|
||||
/**
|
||||
* Field class.
|
||||
*/
|
||||
class Tab extends Component {
|
||||
|
||||
/**
|
||||
* Constructor
|
||||
*
|
||||
* @param string $id Field id.
|
||||
* @param string $plugin_id Plugin id.
|
||||
* @param array $additional_args Array containing the necessary arguments.
|
||||
* $args = array(
|
||||
* 'name' => (string) Tab name. Required.
|
||||
* 'title' => (string) Tab title. Required.
|
||||
* 'order' => (int) Tab order.
|
||||
* 'properties' => (array) Tab properties.
|
||||
* ).
|
||||
* @throws \Exception If there are missing arguments.
|
||||
*/
|
||||
public function __construct( $id, $plugin_id, $additional_args ) {
|
||||
parent::__construct( $id, $plugin_id, $additional_args );
|
||||
|
||||
$this->required_arguments = array(
|
||||
'name',
|
||||
'title',
|
||||
);
|
||||
|
||||
$missing_arguments = self::get_missing_arguments( $additional_args );
|
||||
if ( count( $missing_arguments ) > 0 ) {
|
||||
throw new \Exception(
|
||||
sprintf(
|
||||
/* translators: 1: Missing arguments list. */
|
||||
esc_html__( 'You are missing required arguments of WooCommerce ProductForm Tab: %1$s', 'woocommerce' ),
|
||||
join( ', ', $missing_arguments )
|
||||
)
|
||||
);
|
||||
}
|
||||
}
|
||||
|
||||
}
|
||||
@@ -0,0 +1,626 @@
|
||||
<?php
|
||||
/**
|
||||
* Products > Reviews
|
||||
*/
|
||||
|
||||
namespace Automattic\WooCommerce\Internal\Admin\ProductReviews;
|
||||
|
||||
use Automattic\WooCommerce\Internal\Traits\AccessiblePrivateMethods;
|
||||
use WP_Ajax_Response;
|
||||
use WP_Comment;
|
||||
use WP_Screen;
|
||||
|
||||
/**
|
||||
* Handles backend logic for the Reviews component.
|
||||
*/
|
||||
class Reviews {
|
||||
|
||||
use AccessiblePrivateMethods;
|
||||
|
||||
/**
|
||||
* Admin page identifier.
|
||||
*/
|
||||
const MENU_SLUG = 'product-reviews';
|
||||
|
||||
/**
|
||||
* Reviews page hook name.
|
||||
*
|
||||
* @var string|null
|
||||
*/
|
||||
protected $reviews_page_hook = null;
|
||||
|
||||
/**
|
||||
* Reviews list table instance.
|
||||
*
|
||||
* @var ReviewsListTable|null
|
||||
*/
|
||||
protected $reviews_list_table;
|
||||
|
||||
/**
|
||||
* Constructor.
|
||||
*/
|
||||
public function __construct() {
|
||||
|
||||
self::add_action( 'admin_menu', [ $this, 'add_reviews_page' ] );
|
||||
self::add_action( 'admin_enqueue_scripts', [ $this, 'load_javascript' ] );
|
||||
|
||||
// These ajax callbacks need a low priority to ensure they run before their WordPress core counterparts.
|
||||
self::add_action( 'wp_ajax_edit-comment', [ $this, 'handle_edit_review' ], -1 );
|
||||
self::add_action( 'wp_ajax_replyto-comment', [ $this, 'handle_reply_to_review' ], -1 );
|
||||
|
||||
self::add_filter( 'parent_file', [ $this, 'edit_review_parent_file' ] );
|
||||
self::add_filter( 'gettext', [ $this, 'edit_comments_screen_text' ], 10, 2 );
|
||||
self::add_action( 'admin_notices', [ $this, 'display_notices' ] );
|
||||
}
|
||||
|
||||
/**
|
||||
* Gets the required capability to access the reviews page and manage product reviews.
|
||||
*
|
||||
* @param string $context The context for which the capability is needed (e.g. `view` or `moderate`).
|
||||
* @return string
|
||||
*/
|
||||
public static function get_capability( string $context = 'view' ) : string {
|
||||
|
||||
/**
|
||||
* Filters whether the current user can manage product reviews.
|
||||
*
|
||||
* This is aligned to {@see \wc_rest_check_product_reviews_permissions()}
|
||||
*
|
||||
* @since 6.7.0
|
||||
*
|
||||
* @param string $capability The capability (defaults to `moderate_comments` for viewing and `edit_products` for editing).
|
||||
* @param string $context The context for which the capability is needed.
|
||||
*/
|
||||
return (string) apply_filters( 'woocommerce_product_reviews_page_capability', $context === 'view' ? 'moderate_comments' : 'edit_products', $context );
|
||||
}
|
||||
|
||||
/**
|
||||
* Registers the Product Reviews submenu page.
|
||||
*
|
||||
* @return void
|
||||
*/
|
||||
private function add_reviews_page() : void {
|
||||
|
||||
$this->reviews_page_hook = add_submenu_page(
|
||||
'edit.php?post_type=product',
|
||||
__( 'Reviews', 'woocommerce' ),
|
||||
__( 'Reviews', 'woocommerce' ) . $this->get_pending_count_bubble(),
|
||||
static::get_capability(),
|
||||
static::MENU_SLUG,
|
||||
[ $this, 'render_reviews_list_table' ]
|
||||
);
|
||||
|
||||
self::add_action( "load-{$this->reviews_page_hook}", array( $this, 'load_reviews_screen' ) );
|
||||
}
|
||||
|
||||
/**
|
||||
* Retrieves the URL to the product reviews page.
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
public static function get_reviews_page_url() : string {
|
||||
return add_query_arg(
|
||||
[
|
||||
'post_type' => 'product',
|
||||
'page' => static::MENU_SLUG,
|
||||
],
|
||||
admin_url( 'edit.php' )
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Determines whether the current page is the reviews page.
|
||||
*
|
||||
* @global WP_Screen $current_screen
|
||||
*
|
||||
* @return bool
|
||||
*/
|
||||
public function is_reviews_page() : bool {
|
||||
global $current_screen;
|
||||
|
||||
return isset( $current_screen->base ) && $current_screen->base === 'product_page_' . static::MENU_SLUG;
|
||||
}
|
||||
|
||||
/**
|
||||
* Loads the JavaScript required for inline replies and quick edit.
|
||||
*
|
||||
* @return void
|
||||
*/
|
||||
private function load_javascript() : void {
|
||||
if ( $this->is_reviews_page() ) {
|
||||
wp_enqueue_script( 'admin-comments' );
|
||||
enqueue_comment_hotkeys_js();
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Determines if the object is a review or a reply to a review.
|
||||
*
|
||||
* @param WP_Comment|mixed $object Object to check.
|
||||
* @return bool
|
||||
*/
|
||||
protected function is_review_or_reply( $object ) : bool {
|
||||
|
||||
$is_review_or_reply = $object instanceof WP_Comment && in_array( $object->comment_type, [ 'review', 'comment' ], true ) && get_post_type( $object->comment_post_ID ) === 'product';
|
||||
|
||||
/**
|
||||
* Filters whether the object is a review or a reply to a review.
|
||||
*
|
||||
* @since 6.7.0
|
||||
*
|
||||
* @param bool $is_review_or_reply Whether the object in context is a review or a reply to a review.
|
||||
* @param WP_Comment|mixed $object The object in context.
|
||||
*/
|
||||
return (bool) apply_filters( 'woocommerce_product_reviews_is_product_review_or_reply', $is_review_or_reply, $object );
|
||||
}
|
||||
|
||||
/**
|
||||
* Ajax callback for editing a review.
|
||||
*
|
||||
* This functionality is taken from {@see wp_ajax_edit_comment()} and is largely copy and pasted. The only thing
|
||||
* we want to change is the review row HTML in the response. WordPress core uses a comment list table and we need
|
||||
* to use our own {@see ReviewsListTable} class to support our custom columns.
|
||||
*
|
||||
* This ajax callback is registered with a lower priority than WordPress core's so that our code can run
|
||||
* first. If the supplied comment ID is not a review or a reply to a review, then we `return` early from this method
|
||||
* to allow the WordPress core callback to take over.
|
||||
*
|
||||
* @return void
|
||||
*/
|
||||
private function handle_edit_review(): void {
|
||||
// Don't interfere with comment functionality relating to the reviews meta box within the product editor.
|
||||
if ( sanitize_text_field( wp_unslash( $_POST['mode'] ?? '' ) ) === 'single' ) {
|
||||
return;
|
||||
}
|
||||
|
||||
check_ajax_referer( 'replyto-comment', '_ajax_nonce-replyto-comment' );
|
||||
|
||||
$comment_id = isset( $_POST['comment_ID'] ) ? (int) sanitize_text_field( wp_unslash( $_POST['comment_ID'] ) ) : 0;
|
||||
|
||||
if ( empty( $comment_id ) || ! current_user_can( 'edit_comment', $comment_id ) ) {
|
||||
wp_die( -1 );
|
||||
}
|
||||
|
||||
$review = get_comment( $comment_id );
|
||||
|
||||
// Bail silently if this is not a review, or a reply to a review. That allows `wp_ajax_edit_comment()` to handle any further actions.
|
||||
if ( ! $this->is_review_or_reply( $review ) ) {
|
||||
return;
|
||||
}
|
||||
|
||||
if ( empty( $review->comment_ID ) ) {
|
||||
wp_die( -1 );
|
||||
}
|
||||
|
||||
if ( empty( $_POST['content'] ) ) {
|
||||
wp_die( esc_html__( 'Error: Please type your review text.', 'woocommerce' ) );
|
||||
}
|
||||
|
||||
if ( isset( $_POST['status'] ) ) {
|
||||
$_POST['comment_status'] = sanitize_text_field( wp_unslash( $_POST['status'] ) );
|
||||
}
|
||||
|
||||
$updated = edit_comment();
|
||||
if ( is_wp_error( $updated ) ) {
|
||||
wp_die( esc_html( $updated->get_error_message() ) );
|
||||
}
|
||||
|
||||
$position = isset( $_POST['position'] ) ? (int) sanitize_text_field( wp_unslash( $_POST['position'] ) ) : -1;
|
||||
$wp_list_table = $this->make_reviews_list_table();
|
||||
|
||||
ob_start();
|
||||
$wp_list_table->single_row( $review );
|
||||
$review_list_item = ob_get_clean();
|
||||
|
||||
$x = new WP_Ajax_Response();
|
||||
|
||||
$x->add(
|
||||
array(
|
||||
'what' => 'edit_comment',
|
||||
'id' => $review->comment_ID,
|
||||
'data' => $review_list_item,
|
||||
'position' => $position,
|
||||
)
|
||||
);
|
||||
|
||||
$x->send();
|
||||
}
|
||||
|
||||
/**
|
||||
* Ajax callback for replying to a review inline.
|
||||
*
|
||||
* This functionality is taken from {@see wp_ajax_replyto_comment()} and is largely copy and pasted. The only thing
|
||||
* we want to change is the review row HTML in the response. WordPress core uses a comment list table and we need
|
||||
* to use our own {@see ReviewsListTable} class to support our custom columns.
|
||||
*
|
||||
* This ajax callback is registered with a lower priority than WordPress core's so that our code can run
|
||||
* first. If the supplied comment ID is not a review or a reply to a review, then we `return` early from this method
|
||||
* to allow the WordPress core callback to take over.
|
||||
*
|
||||
* @return void
|
||||
*/
|
||||
private function handle_reply_to_review() : void {
|
||||
// Don't interfere with comment functionality relating to the reviews meta box within the product editor.
|
||||
if ( sanitize_text_field( wp_unslash( $_POST['mode'] ?? '' ) ) === 'single' ) {
|
||||
return;
|
||||
}
|
||||
|
||||
check_ajax_referer( 'replyto-comment', '_ajax_nonce-replyto-comment' );
|
||||
|
||||
$comment_post_ID = isset( $_POST['comment_post_ID'] ) ? (int) sanitize_text_field( wp_unslash( $_POST['comment_post_ID'] ) ) : 0; // phpcs:ignore WordPress.NamingConventions.ValidVariableName.VariableNotSnakeCase
|
||||
$post = get_post( $comment_post_ID ); // phpcs:ignore WordPress.NamingConventions.ValidVariableName.VariableNotSnakeCase
|
||||
|
||||
if ( ! $post ) {
|
||||
wp_die( -1 );
|
||||
}
|
||||
|
||||
// Inline Review replies will use the `detail` mode. If that's not what we have, then let WordPress core take over.
|
||||
if ( isset( $_REQUEST['mode'] ) && $_REQUEST['mode'] === 'dashboard' ) {
|
||||
return;
|
||||
}
|
||||
|
||||
// If this is not a a reply to a review, bail silently to let WordPress core take over.
|
||||
if ( get_post_type( $post ) !== 'product' ) {
|
||||
return;
|
||||
}
|
||||
|
||||
if ( ! current_user_can( 'edit_post', $comment_post_ID ) ) { // phpcs:ignore WordPress.NamingConventions.ValidVariableName.VariableNotSnakeCase
|
||||
wp_die( -1 );
|
||||
}
|
||||
|
||||
if ( empty( $post->post_status ) ) {
|
||||
wp_die( 1 );
|
||||
} elseif ( in_array( $post->post_status, array( 'draft', 'pending', 'trash' ), true ) ) {
|
||||
wp_die( esc_html__( 'Error: You can\'t reply to a review on a draft product.', 'woocommerce' ) );
|
||||
}
|
||||
|
||||
$user = wp_get_current_user();
|
||||
|
||||
if ( $user->exists() ) {
|
||||
$user_ID = $user->ID;
|
||||
$comment_author = wp_slash( $user->display_name );
|
||||
$comment_author_email = wp_slash( $user->user_email );
|
||||
$comment_author_url = wp_slash( $user->user_url );
|
||||
// WordPress core already sanitizes `content` during the `pre_comment_content` hook, which is why it's not needed here, {@see wp_filter_comment()} and {@see kses_init_filters()}.
|
||||
$comment_content = isset( $_POST['content'] ) ? wp_unslash( $_POST['content'] ) : ''; // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized
|
||||
$comment_type = isset( $_POST['comment_type'] ) ? sanitize_text_field( wp_unslash( $_POST['comment_type'] ) ) : 'comment';
|
||||
|
||||
if ( current_user_can( 'unfiltered_html' ) ) {
|
||||
if ( ! isset( $_POST['_wp_unfiltered_html_comment'] ) ) {
|
||||
$_POST['_wp_unfiltered_html_comment'] = '';
|
||||
}
|
||||
|
||||
if ( wp_create_nonce( 'unfiltered-html-comment' ) != $_POST['_wp_unfiltered_html_comment'] ) {
|
||||
kses_remove_filters(); // Start with a clean slate.
|
||||
kses_init_filters(); // Set up the filters.
|
||||
remove_filter( 'pre_comment_content', 'wp_filter_post_kses' );
|
||||
add_filter( 'pre_comment_content', 'wp_filter_kses' );
|
||||
}
|
||||
}
|
||||
} else {
|
||||
wp_die( esc_html__( 'Sorry, you must be logged in to reply to a review.', 'woocommerce' ) );
|
||||
}
|
||||
|
||||
if ( $comment_content === '' ) {
|
||||
wp_die( esc_html__( 'Error: Please type your reply text.', 'woocommerce' ) );
|
||||
}
|
||||
|
||||
$comment_parent = 0;
|
||||
|
||||
if ( isset( $_POST['comment_ID'] ) ) {
|
||||
$comment_parent = absint( wp_unslash( $_POST['comment_ID'] ) );
|
||||
}
|
||||
|
||||
$comment_auto_approved = false;
|
||||
$commentdata = compact( 'comment_post_ID', 'comment_author', 'comment_author_email', 'comment_author_url', 'comment_content', 'comment_type', 'comment_parent', 'user_ID' );
|
||||
|
||||
// Automatically approve parent comment.
|
||||
if ( ! empty( $_POST['approve_parent'] ) ) {
|
||||
$parent = get_comment( $comment_parent );
|
||||
|
||||
if ( $parent && $parent->comment_approved === '0' && $parent->comment_post_ID === $comment_post_ID ) { // phpcs:ignore WordPress.NamingConventions.ValidVariableName.VariableNotSnakeCase
|
||||
if ( ! current_user_can( 'edit_comment', $parent->comment_ID ) ) {
|
||||
wp_die( -1 );
|
||||
}
|
||||
|
||||
if ( wp_set_comment_status( $parent, 'approve' ) ) {
|
||||
$comment_auto_approved = true;
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
$comment_id = wp_new_comment( $commentdata );
|
||||
|
||||
if ( is_wp_error( $comment_id ) ) {
|
||||
wp_die( esc_html( $comment_id->get_error_message() ) );
|
||||
}
|
||||
|
||||
$comment = get_comment( $comment_id );
|
||||
|
||||
if ( ! $comment ) {
|
||||
wp_die( 1 );
|
||||
}
|
||||
|
||||
$position = ( isset( $_POST['position'] ) && (int) $_POST['position'] ) ? (int) $_POST['position'] : '-1';
|
||||
|
||||
ob_start();
|
||||
$wp_list_table = $this->make_reviews_list_table();
|
||||
$wp_list_table->single_row( $comment );
|
||||
$comment_list_item = ob_get_clean();
|
||||
|
||||
$response = array(
|
||||
'what' => 'comment',
|
||||
'id' => $comment->comment_ID,
|
||||
'data' => $comment_list_item,
|
||||
'position' => $position,
|
||||
);
|
||||
|
||||
$counts = wp_count_comments();
|
||||
$response['supplemental'] = array(
|
||||
'in_moderation' => $counts->moderated,
|
||||
'i18n_comments_text' => sprintf(
|
||||
/* translators: %s: Number of reviews. */
|
||||
_n( '%s Review', '%s Reviews', $counts->approved, 'woocommerce' ),
|
||||
number_format_i18n( $counts->approved )
|
||||
),
|
||||
'i18n_moderation_text' => sprintf(
|
||||
/* translators: %s: Number of reviews. */
|
||||
_n( '%s Review in moderation', '%s Reviews in moderation', $counts->moderated, 'woocommerce' ),
|
||||
number_format_i18n( $counts->moderated )
|
||||
),
|
||||
);
|
||||
|
||||
if ( $comment_auto_approved && isset( $parent ) ) {
|
||||
$response['supplemental']['parent_approved'] = $parent->comment_ID;
|
||||
$response['supplemental']['parent_post_id'] = $parent->comment_post_ID;
|
||||
}
|
||||
|
||||
$x = new WP_Ajax_Response();
|
||||
$x->add( $response );
|
||||
$x->send();
|
||||
}
|
||||
|
||||
/**
|
||||
* Displays notices on the Reviews page.
|
||||
*
|
||||
* @return void
|
||||
*/
|
||||
protected function display_notices() : void {
|
||||
|
||||
if ( $this->is_reviews_page() ) {
|
||||
$this->maybe_display_reviews_bulk_action_notice();
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* May display the bulk action admin notice.
|
||||
*
|
||||
* @return void
|
||||
*/
|
||||
protected function maybe_display_reviews_bulk_action_notice() : void {
|
||||
|
||||
$messages = $this->get_bulk_action_notice_messages();
|
||||
|
||||
echo ! empty( $messages ) ? '<div id="moderated" class="updated"><p>' . implode( "<br/>\n", $messages ) . '</p></div>' : ''; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
|
||||
}
|
||||
|
||||
/**
|
||||
* Gets the applicable bulk action admin notice messages.
|
||||
*
|
||||
* @return array
|
||||
*/
|
||||
protected function get_bulk_action_notice_messages() : array {
|
||||
|
||||
$approved = isset( $_REQUEST['approved'] ) ? (int) $_REQUEST['approved'] : 0;
|
||||
$unapproved = isset( $_REQUEST['unapproved'] ) ? (int) $_REQUEST['unapproved'] : 0;
|
||||
$deleted = isset( $_REQUEST['deleted'] ) ? (int) $_REQUEST['deleted'] : 0;
|
||||
$trashed = isset( $_REQUEST['trashed'] ) ? (int) $_REQUEST['trashed'] : 0;
|
||||
$untrashed = isset( $_REQUEST['untrashed'] ) ? (int) $_REQUEST['untrashed'] : 0;
|
||||
$spammed = isset( $_REQUEST['spammed'] ) ? (int) $_REQUEST['spammed'] : 0;
|
||||
$unspammed = isset( $_REQUEST['unspammed'] ) ? (int) $_REQUEST['unspammed'] : 0;
|
||||
|
||||
$messages = [];
|
||||
|
||||
if ( $approved > 0 ) {
|
||||
/* translators: %s is an integer higher than 0 (1, 2, 3...) */
|
||||
$messages[] = sprintf( _n( '%s review approved', '%s reviews approved', $approved, 'woocommerce' ), $approved );
|
||||
}
|
||||
|
||||
if ( $unapproved > 0 ) {
|
||||
/* translators: %s is an integer higher than 0 (1, 2, 3...) */
|
||||
$messages[] = sprintf( _n( '%s review unapproved', '%s reviews unapproved', $unapproved, 'woocommerce' ), $unapproved );
|
||||
}
|
||||
|
||||
if ( $spammed > 0 ) {
|
||||
$ids = isset( $_REQUEST['ids'] ) ? sanitize_text_field( wp_unslash( $_REQUEST['ids'] ) ) : 0;
|
||||
/* translators: %s is an integer higher than 0 (1, 2, 3...) */
|
||||
$messages[] = sprintf( _n( '%s review marked as spam.', '%s reviews marked as spam.', $spammed, 'woocommerce' ), $spammed ) . ' <a href="' . esc_url( wp_nonce_url( "edit-comments.php?doaction=undo&action=unspam&ids=$ids", 'bulk-comments' ) ) . '">' . __( 'Undo', 'woocommerce' ) . '</a><br />';
|
||||
}
|
||||
|
||||
if ( $unspammed > 0 ) {
|
||||
/* translators: %s is an integer higher than 0 (1, 2, 3...) */
|
||||
$messages[] = sprintf( _n( '%s review restored from the spam', '%s reviews restored from the spam', $unspammed, 'woocommerce' ), $unspammed );
|
||||
}
|
||||
|
||||
if ( $trashed > 0 ) {
|
||||
$ids = isset( $_REQUEST['ids'] ) ? sanitize_text_field( wp_unslash( $_REQUEST['ids'] ) ) : 0;
|
||||
/* translators: %s is an integer higher than 0 (1, 2, 3...) */
|
||||
$messages[] = sprintf( _n( '%s review moved to the Trash.', '%s reviews moved to the Trash.', $trashed, 'woocommerce' ), $trashed ) . ' <a href="' . esc_url( wp_nonce_url( "edit-comments.php?doaction=undo&action=untrash&ids=$ids", 'bulk-comments' ) ) . '">' . __( 'Undo', 'woocommerce' ) . '</a><br />';
|
||||
}
|
||||
|
||||
if ( $untrashed > 0 ) {
|
||||
/* translators: %s is an integer higher than 0 (1, 2, 3...) */
|
||||
$messages[] = sprintf( _n( '%s review restored from the Trash', '%s reviews restored from the Trash', $untrashed, 'woocommerce' ), $untrashed );
|
||||
}
|
||||
|
||||
if ( $deleted > 0 ) {
|
||||
/* translators: %s is an integer higher than 0 (1, 2, 3...) */
|
||||
$messages[] = sprintf( _n( '%s review permanently deleted', '%s reviews permanently deleted', $deleted, 'woocommerce' ), $deleted );
|
||||
}
|
||||
|
||||
return $messages;
|
||||
}
|
||||
|
||||
/**
|
||||
* Counts the number of pending product reviews/replies, and returns the notification bubble if there's more than zero.
|
||||
*
|
||||
* @return string Empty string if there are no pending reviews, or bubble HTML if there are.
|
||||
*/
|
||||
protected function get_pending_count_bubble() : string {
|
||||
$count = (int) get_comments(
|
||||
[
|
||||
'type__in' => [ 'review', 'comment' ],
|
||||
'status' => '0',
|
||||
'post_type' => 'product',
|
||||
'count' => true,
|
||||
]
|
||||
);
|
||||
|
||||
/**
|
||||
* Provides an opportunity to alter the pending comment count used within
|
||||
* the product reviews admin list table.
|
||||
*
|
||||
* @since 7.0.0
|
||||
*
|
||||
* @param array $count Current count of comments pending review.
|
||||
*/
|
||||
$count = apply_filters( 'woocommerce_product_reviews_pending_count', $count );
|
||||
|
||||
if ( empty( $count ) ) {
|
||||
return '';
|
||||
}
|
||||
|
||||
return ' <span class="awaiting-mod count-' . esc_attr( $count ) . '"><span class="pending-count">' . esc_html( $count ) . '</span></span>';
|
||||
}
|
||||
|
||||
/**
|
||||
* Highlights Product -> Reviews admin menu item when editing a review or a reply to a review.
|
||||
*
|
||||
* @global string $submenu_file
|
||||
*
|
||||
* @param string|mixed $parent_file Parent menu item.
|
||||
* @return string
|
||||
*/
|
||||
protected function edit_review_parent_file( $parent_file ) {
|
||||
global $submenu_file, $current_screen;
|
||||
|
||||
if ( isset( $current_screen->id, $_GET['c'] ) && $current_screen->id === 'comment' ) {
|
||||
|
||||
$comment_id = absint( $_GET['c'] );
|
||||
$comment = get_comment( $comment_id );
|
||||
|
||||
if ( isset( $comment->comment_parent ) && $comment->comment_parent > 0 ) {
|
||||
$comment = get_comment( $comment->comment_parent );
|
||||
}
|
||||
|
||||
if ( isset( $comment->comment_post_ID ) && get_post_type( $comment->comment_post_ID ) === 'product' ) {
|
||||
$parent_file = 'edit.php?post_type=product';
|
||||
$submenu_file = 'product-reviews'; // phpcs:ignore WordPress.WP.GlobalVariablesOverride.Prohibited
|
||||
}
|
||||
}
|
||||
|
||||
return $parent_file;
|
||||
}
|
||||
|
||||
/**
|
||||
* Replaces Edit/Moderate Comment title/headline with Edit Review, when editing/moderating a review.
|
||||
*
|
||||
* @param string|mixed $translation Translated text.
|
||||
* @param string|mixed $text Text to translate.
|
||||
* @return string|mixed Translated text.
|
||||
*/
|
||||
protected function edit_comments_screen_text( $translation, $text ) {
|
||||
global $comment;
|
||||
|
||||
// Bail out if not a text we should replace.
|
||||
if ( ! in_array( $text, [ 'Edit Comment', 'Moderate Comment' ], true ) ) {
|
||||
return $translation;
|
||||
}
|
||||
|
||||
// Try to get comment from query params when not in context already.
|
||||
if ( ! $comment && isset( $_GET['action'], $_GET['c'] ) && $_GET['action'] === 'editcomment' ) {
|
||||
$comment_id = absint( $_GET['c'] );
|
||||
$comment = get_comment( $comment_id ); // phpcs:ignore WordPress.WP.GlobalVariablesOverride.Prohibited
|
||||
}
|
||||
|
||||
$is_reply = isset( $comment->comment_parent ) && $comment->comment_parent > 0;
|
||||
|
||||
// Only replace the translated text if we are editing a comment left on a product (ie. a review).
|
||||
if ( isset( $comment->comment_post_ID ) && get_post_type( $comment->comment_post_ID ) === 'product' ) {
|
||||
if ( $text === 'Edit Comment' ) {
|
||||
$translation = $is_reply
|
||||
? __( 'Edit Review Reply', 'woocommerce' )
|
||||
: __( 'Edit Review', 'woocommerce' );
|
||||
} elseif ( $text === 'Moderate Comment' ) {
|
||||
$translation = $is_reply
|
||||
? __( 'Moderate Review Reply', 'woocommerce' )
|
||||
: __( 'Moderate Review', 'woocommerce' );
|
||||
}
|
||||
}
|
||||
|
||||
return $translation;
|
||||
}
|
||||
|
||||
/**
|
||||
* Returns a new instance of `ReviewsListTable`, with the screen argument specified.
|
||||
*
|
||||
* @return ReviewsListTable
|
||||
*/
|
||||
protected function make_reviews_list_table() : ReviewsListTable {
|
||||
return new ReviewsListTable( [ 'screen' => $this->reviews_page_hook ? $this->reviews_page_hook : 'product_page_product-reviews' ] );
|
||||
}
|
||||
|
||||
/**
|
||||
* Initializes the list table.
|
||||
*
|
||||
* @return void
|
||||
*/
|
||||
protected function load_reviews_screen() : void {
|
||||
$this->reviews_list_table = $this->make_reviews_list_table();
|
||||
$this->reviews_list_table->process_bulk_action();
|
||||
}
|
||||
|
||||
/**
|
||||
* Renders the Reviews page.
|
||||
*
|
||||
* @return void
|
||||
*/
|
||||
public function render_reviews_list_table() : void {
|
||||
|
||||
$this->reviews_list_table->prepare_items();
|
||||
|
||||
ob_start();
|
||||
|
||||
?>
|
||||
<div class="wrap">
|
||||
<h2><?php echo esc_html( get_admin_page_title() ); ?></h2>
|
||||
|
||||
<?php $this->reviews_list_table->views(); ?>
|
||||
|
||||
<form id="reviews-filter" method="get">
|
||||
<?php $page = isset( $_REQUEST['page'] ) ? sanitize_text_field( wp_unslash( $_REQUEST['page'] ) ) : static::MENU_SLUG; ?>
|
||||
|
||||
<input type="hidden" name="page" value="<?php echo esc_attr( $page ); ?>" />
|
||||
<input type="hidden" name="post_type" value="product" />
|
||||
<input type="hidden" name="pagegen_timestamp" value="<?php echo esc_attr( current_time( 'mysql', true ) ); ?>" />
|
||||
|
||||
<?php $this->reviews_list_table->search_box( __( 'Search Reviews', 'woocommerce' ), 'reviews' ); ?>
|
||||
|
||||
<?php $this->reviews_list_table->display(); ?>
|
||||
</form>
|
||||
</div>
|
||||
<?php
|
||||
wp_comment_reply( '-1', true, 'detail' );
|
||||
wp_comment_trashnotice();
|
||||
|
||||
/**
|
||||
* Filters the contents of the product reviews list table output.
|
||||
*
|
||||
* @since 6.7.0
|
||||
*
|
||||
* @param string $output The HTML output of the list table.
|
||||
* @param ReviewsListTable $reviews_list_table The reviews list table instance.
|
||||
*/
|
||||
echo apply_filters( 'woocommerce_product_reviews_list_table', ob_get_clean(), $this->reviews_list_table ); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,148 @@
|
||||
<?php
|
||||
|
||||
namespace Automattic\WooCommerce\Internal\Admin\ProductReviews;
|
||||
|
||||
use Automattic\WooCommerce\Internal\Traits\AccessiblePrivateMethods;
|
||||
use WP_Comment_Query;
|
||||
use WP_Screen;
|
||||
|
||||
/**
|
||||
* Tweaks the WordPress comments page to exclude reviews.
|
||||
*/
|
||||
class ReviewsCommentsOverrides {
|
||||
|
||||
use AccessiblePrivateMethods;
|
||||
|
||||
const REVIEWS_MOVED_NOTICE_ID = 'product_reviews_moved';
|
||||
|
||||
/**
|
||||
* Constructor.
|
||||
*/
|
||||
public function __construct() {
|
||||
self::add_action( 'admin_notices', array( $this, 'display_notices' ) );
|
||||
self::add_filter( 'woocommerce_dismiss_admin_notice_capability', array( $this, 'get_dismiss_capability' ), 10, 2 );
|
||||
self::add_filter( 'comments_list_table_query_args', array( $this, 'exclude_reviews_from_comments' ) );
|
||||
}
|
||||
|
||||
/**
|
||||
* Renders admin notices.
|
||||
*/
|
||||
protected function display_notices() : void {
|
||||
$screen = get_current_screen();
|
||||
|
||||
if ( empty( $screen ) || $screen->base !== 'edit-comments' ) {
|
||||
return;
|
||||
}
|
||||
|
||||
$this->maybe_display_reviews_moved_notice();
|
||||
}
|
||||
|
||||
/**
|
||||
* May render an admin notice informing the user that reviews were moved to a new page.
|
||||
*
|
||||
* @return void
|
||||
*/
|
||||
protected function maybe_display_reviews_moved_notice() : void {
|
||||
if ( $this->should_display_reviews_moved_notice() ) {
|
||||
$this->display_reviews_moved_notice();
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Checks if the admin notice informing the user that reviews were moved to a new page should be displayed.
|
||||
*
|
||||
* @return bool
|
||||
*/
|
||||
protected function should_display_reviews_moved_notice() : bool {
|
||||
// Do not display if the user does not have the capability to see the new page.
|
||||
if ( ! WC()->call_function( 'current_user_can', Reviews::get_capability() ) ) {
|
||||
return false;
|
||||
}
|
||||
|
||||
// Do not display if the current user has dismissed this notice.
|
||||
if ( WC()->call_function( 'get_user_meta', get_current_user_id(), 'dismissed_' . static::REVIEWS_MOVED_NOTICE_ID . '_notice', true ) ) {
|
||||
return false;
|
||||
}
|
||||
|
||||
return true;
|
||||
}
|
||||
|
||||
/**
|
||||
* Renders an admin notice informing the user that reviews were moved to a new page.
|
||||
*
|
||||
* @return void
|
||||
*/
|
||||
protected function display_reviews_moved_notice() : void {
|
||||
$dismiss_url = wp_nonce_url(
|
||||
add_query_arg(
|
||||
[
|
||||
'wc-hide-notice' => urlencode( static::REVIEWS_MOVED_NOTICE_ID ),
|
||||
]
|
||||
),
|
||||
'woocommerce_hide_notices_nonce',
|
||||
'_wc_notice_nonce'
|
||||
);
|
||||
?>
|
||||
|
||||
<div class="notice notice-info is-dismissible">
|
||||
<p><strong><?php esc_html_e( 'Product reviews have moved!', 'woocommerce' ); ?></strong></p>
|
||||
<p><?php esc_html_e( 'Product reviews can now be managed from Products > Reviews.', 'woocommerce' ); ?></p>
|
||||
<p class="submit">
|
||||
<a href="<?php echo esc_url( admin_url( 'edit.php?post_type=product&page=product-reviews' ) ); ?>" class="button-primary"><?php esc_html_e( 'Visit new location', 'woocommerce' ); ?></a>
|
||||
</p>
|
||||
<button type="button" class="notice-dismiss" onclick="window.location = '<?php echo esc_url( $dismiss_url ); ?>';"><span class="screen-reader-text"><?php esc_html_e( 'Dismiss this notice.', 'woocommerce' ); ?></span></button>
|
||||
</div>
|
||||
|
||||
<?php
|
||||
}
|
||||
|
||||
/**
|
||||
* Gets the capability required to dismiss the notice.
|
||||
*
|
||||
* This is required so that users who do not have the manage_woocommerce capability (e.g. Editors) can still dismiss
|
||||
* the notice displayed in the Comments page.
|
||||
*
|
||||
* @param string|mixed $default_capability The default required capability.
|
||||
* @param string|mixed $notice_name The notice name.
|
||||
* @return string
|
||||
*/
|
||||
protected function get_dismiss_capability( $default_capability, $notice_name ) {
|
||||
return $notice_name === self::REVIEWS_MOVED_NOTICE_ID ? Reviews::get_capability() : $default_capability;
|
||||
}
|
||||
|
||||
/**
|
||||
* Excludes product reviews from showing in the comments page.
|
||||
*
|
||||
* @param array|mixed $args {@see WP_Comment_Query} query args.
|
||||
* @return array
|
||||
*/
|
||||
protected function exclude_reviews_from_comments( $args ) : array {
|
||||
$screen = get_current_screen();
|
||||
|
||||
// We only wish to intervene if the edit comments screen has been requested.
|
||||
if ( ! $screen instanceof WP_Screen || 'edit-comments' !== $screen->id ) {
|
||||
return $args;
|
||||
}
|
||||
|
||||
if ( ! empty( $args['post_type'] ) && $args['post_type'] !== 'any' ) {
|
||||
$post_types = (array) $args['post_type'];
|
||||
} else {
|
||||
$post_types = get_post_types();
|
||||
}
|
||||
|
||||
$index = array_search( 'product', $post_types );
|
||||
|
||||
if ( $index !== false ) {
|
||||
unset( $post_types[ $index ] );
|
||||
}
|
||||
|
||||
if ( ! is_array( $args ) ) {
|
||||
$args = [];
|
||||
}
|
||||
|
||||
$args['post_type'] = $post_types;
|
||||
|
||||
return $args;
|
||||
}
|
||||
|
||||
}
|
||||
File diff suppressed because it is too large
Load Diff
@@ -0,0 +1,26 @@
|
||||
<?php
|
||||
|
||||
namespace Automattic\WooCommerce\Internal\Admin\ProductReviews;
|
||||
|
||||
/**
|
||||
* A utility class for handling comments that are product reviews.
|
||||
*/
|
||||
class ReviewsUtil {
|
||||
|
||||
/**
|
||||
* Removes product reviews from the edit-comments page to fix the "Mine" tab counter.
|
||||
*
|
||||
* @param array|mixed $clauses A compacted array of comment query clauses.
|
||||
* @return array|mixed
|
||||
*/
|
||||
public static function comments_clauses_without_product_reviews( $clauses ) {
|
||||
global $wpdb, $current_screen;
|
||||
|
||||
if ( isset( $current_screen->base ) && 'edit-comments' === $current_screen->base ) {
|
||||
$clauses['join'] .= " LEFT JOIN {$wpdb->posts} AS wp_posts_to_exclude_reviews ON comment_post_ID = wp_posts_to_exclude_reviews.ID ";
|
||||
$clauses['where'] .= ( $clauses['where'] ? ' AND ' : '' ) . " wp_posts_to_exclude_reviews.post_type NOT IN ('product') ";
|
||||
}
|
||||
|
||||
return $clauses;
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,788 @@
|
||||
<?php
|
||||
/**
|
||||
* Gets a list of fallback methods if remote fetching is disabled.
|
||||
*/
|
||||
|
||||
namespace Automattic\WooCommerce\Internal\Admin\RemoteFreeExtensions;
|
||||
|
||||
use Automattic\WooCommerce\Admin\Features\PaymentGatewaySuggestions\DefaultPaymentGateways;
|
||||
|
||||
defined( 'ABSPATH' ) || exit;
|
||||
|
||||
|
||||
/**
|
||||
* Default Free Extensions
|
||||
*/
|
||||
class DefaultFreeExtensions {
|
||||
|
||||
/**
|
||||
* Get default specs.
|
||||
*
|
||||
* @return array Default specs.
|
||||
*/
|
||||
public static function get_all() {
|
||||
$bundles = [
|
||||
[
|
||||
'key' => 'obw/basics',
|
||||
'title' => __( 'Get the basics', 'woocommerce' ),
|
||||
'plugins' => [
|
||||
self::get_plugin( 'woocommerce-payments' ),
|
||||
self::get_plugin( 'woocommerce-services:shipping' ),
|
||||
self::get_plugin( 'woocommerce-services:tax' ),
|
||||
self::get_plugin( 'jetpack' ),
|
||||
],
|
||||
],
|
||||
[
|
||||
'key' => 'obw/grow',
|
||||
'title' => __( 'Grow your store', 'woocommerce' ),
|
||||
'plugins' => [
|
||||
self::get_plugin( 'mailpoet' ),
|
||||
self::get_plugin( 'codistoconnect' ),
|
||||
self::get_plugin( 'google-listings-and-ads' ),
|
||||
self::get_plugin( 'pinterest-for-woocommerce' ),
|
||||
self::get_plugin( 'facebook-for-woocommerce' ),
|
||||
self::get_plugin( 'tiktok-for-business:alt' ),
|
||||
],
|
||||
],
|
||||
[
|
||||
'key' => 'task-list/reach',
|
||||
'title' => __( 'Reach out to customers', 'woocommerce' ),
|
||||
'plugins' => [
|
||||
self::get_plugin( 'mailpoet:alt' ),
|
||||
self::get_plugin( 'mailchimp-for-woocommerce' ),
|
||||
self::get_plugin( 'creative-mail-by-constant-contact' ),
|
||||
],
|
||||
],
|
||||
[
|
||||
'key' => 'task-list/grow',
|
||||
'title' => __( 'Grow your store', 'woocommerce' ),
|
||||
'plugins' => [
|
||||
self::get_plugin( 'google-listings-and-ads:alt' ),
|
||||
self::get_plugin( 'tiktok-for-business' ),
|
||||
self::get_plugin( 'pinterest-for-woocommerce:alt' ),
|
||||
self::get_plugin( 'facebook-for-woocommerce:alt' ),
|
||||
self::get_plugin( 'codistoconnect:alt' ),
|
||||
],
|
||||
],
|
||||
];
|
||||
|
||||
$bundles = wp_json_encode( $bundles );
|
||||
return json_decode( $bundles );
|
||||
}
|
||||
|
||||
/**
|
||||
* Get the plugin arguments by slug.
|
||||
*
|
||||
* @param string $slug Slug.
|
||||
* @return array
|
||||
*/
|
||||
public static function get_plugin( $slug ) {
|
||||
$plugins = array(
|
||||
'google-listings-and-ads' => [
|
||||
'min_php_version' => '7.4',
|
||||
'name' => __( 'Google Listings & Ads', 'woocommerce' ),
|
||||
'description' => sprintf(
|
||||
/* translators: 1: opening product link tag. 2: closing link tag */
|
||||
__( 'Drive sales with %1$sGoogle Listings and Ads%2$s', 'woocommerce' ),
|
||||
'<a href="https://woocommerce.com/products/google-listings-and-ads" target="_blank">',
|
||||
'</a>'
|
||||
),
|
||||
'image_url' => plugins_url( '/assets/images/onboarding/google.svg', WC_PLUGIN_FILE ),
|
||||
'manage_url' => 'admin.php?page=wc-admin&path=%2Fgoogle%2Fstart',
|
||||
'is_built_by_wc' => true,
|
||||
'is_visible' => [
|
||||
[
|
||||
'type' => 'not',
|
||||
'operand' => [
|
||||
[
|
||||
'type' => 'plugins_activated',
|
||||
'plugins' => [ 'google-listings-and-ads' ],
|
||||
],
|
||||
],
|
||||
],
|
||||
],
|
||||
],
|
||||
'google-listings-and-ads:alt' => [
|
||||
'name' => __( 'Google Listings & Ads', 'woocommerce' ),
|
||||
'description' => __( 'Reach more shoppers and drive sales for your store. Integrate with Google to list your products for free and launch paid ad campaigns.', 'woocommerce' ),
|
||||
'image_url' => plugins_url( '/assets/images/onboarding/google.svg', WC_PLUGIN_FILE ),
|
||||
'manage_url' => 'admin.php?page=wc-admin&path=%2Fgoogle%2Fstart',
|
||||
'is_built_by_wc' => true,
|
||||
],
|
||||
'facebook-for-woocommerce' => [
|
||||
'name' => __( 'Facebook for WooCommerce', 'woocommerce' ),
|
||||
'description' => __( 'List products and create ads on Facebook and Instagram with <a href="https://woocommerce.com/products/facebook/">Facebook for WooCommerce</a>', 'woocommerce' ),
|
||||
'image_url' => plugins_url( '/assets/images/onboarding/facebook.png', WC_PLUGIN_FILE ),
|
||||
'manage_url' => 'admin.php?page=wc-facebook',
|
||||
'is_visible' => false,
|
||||
'is_built_by_wc' => false,
|
||||
],
|
||||
'facebook-for-woocommerce:alt' => [
|
||||
'name' => __( 'Facebook for WooCommerce', 'woocommerce' ),
|
||||
'description' => __( 'List products and create ads on Facebook and Instagram.', 'woocommerce' ),
|
||||
'image_url' => plugins_url( '/assets/images/onboarding/facebook.png', WC_PLUGIN_FILE ),
|
||||
'manage_url' => 'admin.php?page=wc-facebook',
|
||||
'is_visible' => false,
|
||||
'is_built_by_wc' => false,
|
||||
],
|
||||
'pinterest-for-woocommerce' => [
|
||||
'name' => __( 'Pinterest for WooCommerce', 'woocommerce' ),
|
||||
'description' => __( 'Get your products in front of Pinners searching for ideas and things to buy.', 'woocommerce' ),
|
||||
'image_url' => plugins_url( '/assets/images/onboarding/pinterest.png', WC_PLUGIN_FILE ),
|
||||
'manage_url' => 'admin.php?page=wc-admin&path=%2Fpinterest%2Flanding',
|
||||
'is_built_by_wc' => true,
|
||||
'min_php_version' => '7.3',
|
||||
],
|
||||
'pinterest-for-woocommerce:alt' => [
|
||||
'name' => __( 'Pinterest for WooCommerce', 'woocommerce' ),
|
||||
'description' => __( 'Get your products in front of Pinterest users searching for ideas and things to buy. Get started with Pinterest and make your entire product catalog browsable.', 'woocommerce' ),
|
||||
'image_url' => plugins_url( '/assets/images/onboarding/pinterest.png', WC_PLUGIN_FILE ),
|
||||
'manage_url' => 'admin.php?page=wc-admin&path=%2Fpinterest%2Flanding',
|
||||
'is_built_by_wc' => true,
|
||||
],
|
||||
'mailpoet' => [
|
||||
'name' => __( 'MailPoet', 'woocommerce' ),
|
||||
'description' => __( 'Create and send purchase follow-up emails, newsletters, and promotional campaigns straight from your dashboard.', 'woocommerce' ),
|
||||
'image_url' => plugins_url( '/assets/images/onboarding/mailpoet.png', WC_PLUGIN_FILE ),
|
||||
'manage_url' => 'admin.php?page=mailpoet-newsletters',
|
||||
'is_built_by_wc' => true,
|
||||
],
|
||||
'mailchimp-for-woocommerce' => [
|
||||
'name' => __( 'Mailchimp', 'woocommerce' ),
|
||||
'description' => __( 'Send targeted campaigns, recover abandoned carts and much more with Mailchimp.', 'woocommerce' ),
|
||||
'image_url' => plugins_url( '/assets/images/onboarding/mailchimp-for-woocommerce.png', WC_PLUGIN_FILE ),
|
||||
'manage_url' => 'admin.php?page=mailchimp-woocommerce',
|
||||
'is_built_by_wc' => false,
|
||||
],
|
||||
'creative-mail-by-constant-contact' => [
|
||||
'name' => __( 'Creative Mail for WooCommerce', 'woocommerce' ),
|
||||
'description' => __( 'Create on-brand store campaigns, fast email promotions and customer retargeting with Creative Mail.', 'woocommerce' ),
|
||||
'image_url' => plugins_url( '/assets/images/onboarding/creative-mail-by-constant-contact.png', WC_PLUGIN_FILE ),
|
||||
'manage_url' => 'admin.php?page=creativemail',
|
||||
'is_built_by_wc' => false,
|
||||
],
|
||||
'codistoconnect' => [
|
||||
'name' => __( 'Codisto for WooCommerce', 'woocommerce' ),
|
||||
'description' => sprintf(
|
||||
/* translators: 1: opening product link tag. 2: closing link tag */
|
||||
__( 'Sell on Amazon, eBay, Walmart and more directly from WooCommerce with %1$sCodisto%2$s', 'woocommerce' ),
|
||||
'<a href="https://woocommerce.com/pt-br/products/amazon-ebay-integration/?quid=c247a85321c9e93e7c3c6f1eb072e6e5" target="_blank">',
|
||||
'</a>'
|
||||
),
|
||||
'image_url' => plugins_url( '/assets/images/onboarding/codistoconnect.png', WC_PLUGIN_FILE ),
|
||||
'manage_url' => 'admin.php?page=codisto-settings',
|
||||
'is_built_by_wc' => true,
|
||||
],
|
||||
'codistoconnect:alt' => [
|
||||
'name' => __( 'Codisto for WooCommerce', 'woocommerce' ),
|
||||
'description' => __( 'Sell on Amazon, eBay, Walmart and more directly from WooCommerce.', 'woocommerce' ),
|
||||
'image_url' => plugins_url( '/assets/images/onboarding/codistoconnect.png', WC_PLUGIN_FILE ),
|
||||
'manage_url' => 'admin.php?page=codisto-settings',
|
||||
'is_built_by_wc' => true,
|
||||
],
|
||||
'woocommerce-payments' => [
|
||||
'description' => sprintf(
|
||||
/* translators: 1: opening product link tag. 2: closing link tag */
|
||||
__( 'Accept credit cards and other popular payment methods with %1$sWooCommerce Payments%2$s', 'woocommerce' ),
|
||||
'<a href="https://woocommerce.com/products/woocommerce-payments" target="_blank">',
|
||||
'</a>'
|
||||
),
|
||||
'is_visible' => [
|
||||
[
|
||||
'type' => 'or',
|
||||
'operands' => [
|
||||
[
|
||||
'type' => 'base_location_country',
|
||||
'value' => 'US',
|
||||
'operation' => '=',
|
||||
],
|
||||
[
|
||||
'type' => 'base_location_country',
|
||||
'value' => 'PR',
|
||||
'operation' => '=',
|
||||
],
|
||||
[
|
||||
'type' => 'base_location_country',
|
||||
'value' => 'AU',
|
||||
'operation' => '=',
|
||||
],
|
||||
[
|
||||
'type' => 'base_location_country',
|
||||
'value' => 'CA',
|
||||
'operation' => '=',
|
||||
],
|
||||
[
|
||||
'type' => 'base_location_country',
|
||||
'value' => 'DE',
|
||||
'operation' => '=',
|
||||
],
|
||||
[
|
||||
'type' => 'base_location_country',
|
||||
'value' => 'ES',
|
||||
'operation' => '=',
|
||||
],
|
||||
[
|
||||
'type' => 'base_location_country',
|
||||
'value' => 'FR',
|
||||
'operation' => '=',
|
||||
],
|
||||
[
|
||||
'type' => 'base_location_country',
|
||||
'value' => 'GB',
|
||||
'operation' => '=',
|
||||
],
|
||||
[
|
||||
'type' => 'base_location_country',
|
||||
'value' => 'IE',
|
||||
'operation' => '=',
|
||||
],
|
||||
[
|
||||
'type' => 'base_location_country',
|
||||
'value' => 'IT',
|
||||
'operation' => '=',
|
||||
],
|
||||
[
|
||||
'type' => 'base_location_country',
|
||||
'value' => 'NZ',
|
||||
'operation' => '=',
|
||||
],
|
||||
[
|
||||
'type' => 'base_location_country',
|
||||
'value' => 'AT',
|
||||
'operation' => '=',
|
||||
],
|
||||
[
|
||||
'type' => 'base_location_country',
|
||||
'value' => 'BE',
|
||||
'operation' => '=',
|
||||
],
|
||||
[
|
||||
'type' => 'base_location_country',
|
||||
'value' => 'NL',
|
||||
'operation' => '=',
|
||||
],
|
||||
[
|
||||
'type' => 'base_location_country',
|
||||
'value' => 'PL',
|
||||
'operation' => '=',
|
||||
],
|
||||
[
|
||||
'type' => 'base_location_country',
|
||||
'value' => 'PT',
|
||||
'operation' => '=',
|
||||
],
|
||||
[
|
||||
'type' => 'base_location_country',
|
||||
'value' => 'CH',
|
||||
'operation' => '=',
|
||||
],
|
||||
[
|
||||
'type' => 'base_location_country',
|
||||
'value' => 'HK',
|
||||
'operation' => '=',
|
||||
],
|
||||
[
|
||||
'type' => 'base_location_country',
|
||||
'value' => 'SG',
|
||||
'operation' => '=',
|
||||
],
|
||||
[
|
||||
'type' => 'base_location_country',
|
||||
'value' => 'CY',
|
||||
'operation' => '=',
|
||||
],
|
||||
[
|
||||
'type' => 'base_location_country',
|
||||
'value' => 'DK',
|
||||
'operation' => '=',
|
||||
],
|
||||
[
|
||||
'type' => 'base_location_country',
|
||||
'value' => 'EE',
|
||||
'operation' => '=',
|
||||
],
|
||||
[
|
||||
'type' => 'base_location_country',
|
||||
'value' => 'FI',
|
||||
'operation' => '=',
|
||||
],
|
||||
[
|
||||
'type' => 'base_location_country',
|
||||
'value' => 'GR',
|
||||
'operation' => '=',
|
||||
],
|
||||
[
|
||||
'type' => 'base_location_country',
|
||||
'value' => 'LU',
|
||||
'operation' => '=',
|
||||
],
|
||||
[
|
||||
'type' => 'base_location_country',
|
||||
'value' => 'LT',
|
||||
'operation' => '=',
|
||||
],
|
||||
[
|
||||
'type' => 'base_location_country',
|
||||
'value' => 'LV',
|
||||
'operation' => '=',
|
||||
],
|
||||
[
|
||||
'type' => 'base_location_country',
|
||||
'value' => 'NO',
|
||||
'operation' => '=',
|
||||
],
|
||||
[
|
||||
'type' => 'base_location_country',
|
||||
'value' => 'MT',
|
||||
'operation' => '=',
|
||||
],
|
||||
[
|
||||
'type' => 'base_location_country',
|
||||
'value' => 'SI',
|
||||
'operation' => '=',
|
||||
],
|
||||
[
|
||||
'type' => 'base_location_country',
|
||||
'value' => 'SK',
|
||||
'operation' => '=',
|
||||
],
|
||||
],
|
||||
],
|
||||
DefaultPaymentGateways::get_rules_for_cbd( false ),
|
||||
],
|
||||
'is_built_by_wc' => true,
|
||||
'min_wp_version' => '5.9',
|
||||
],
|
||||
'woocommerce-services:shipping' => [
|
||||
'description' => sprintf(
|
||||
/* translators: 1: opening product link tag. 2: closing link tag */
|
||||
__( 'Print shipping labels with %1$sWooCommerce Shipping%2$s', 'woocommerce' ),
|
||||
'<a href="https://woocommerce.com/products/shipping" target="_blank">',
|
||||
'</a>'
|
||||
),
|
||||
'is_visible' => [
|
||||
[
|
||||
'type' => 'base_location_country',
|
||||
'value' => 'US',
|
||||
'operation' => '=',
|
||||
],
|
||||
[
|
||||
'type' => 'not',
|
||||
'operand' => [
|
||||
[
|
||||
'type' => 'plugins_activated',
|
||||
'plugins' => [ 'woocommerce-services' ],
|
||||
],
|
||||
],
|
||||
],
|
||||
[
|
||||
'type' => 'or',
|
||||
'operands' => [
|
||||
[
|
||||
[
|
||||
'type' => 'option',
|
||||
'transformers' => [
|
||||
[
|
||||
'use' => 'dot_notation',
|
||||
'arguments' => [
|
||||
'path' => 'product_types',
|
||||
],
|
||||
],
|
||||
[
|
||||
'use' => 'count',
|
||||
],
|
||||
],
|
||||
'option_name' => 'woocommerce_onboarding_profile',
|
||||
'value' => 1,
|
||||
'default' => array(),
|
||||
'operation' => '!=',
|
||||
],
|
||||
],
|
||||
[
|
||||
[
|
||||
'type' => 'option',
|
||||
'transformers' => [
|
||||
[
|
||||
'use' => 'dot_notation',
|
||||
'arguments' => [
|
||||
'path' => 'product_types.0',
|
||||
],
|
||||
],
|
||||
],
|
||||
'option_name' => 'woocommerce_onboarding_profile',
|
||||
'value' => 'downloads',
|
||||
'default' => '',
|
||||
'operation' => '!=',
|
||||
],
|
||||
],
|
||||
],
|
||||
],
|
||||
],
|
||||
'is_built_by_wc' => true,
|
||||
],
|
||||
'woocommerce-services:tax' => [
|
||||
'description' => sprintf(
|
||||
/* translators: 1: opening product link tag. 2: closing link tag */
|
||||
__( 'Get automated sales tax with %1$sWooCommerce Tax%2$s', 'woocommerce' ),
|
||||
'<a href="https://woocommerce.com/products/tax" target="_blank">',
|
||||
'</a>'
|
||||
),
|
||||
'is_visible' => [
|
||||
[
|
||||
'type' => 'or',
|
||||
'operands' => [
|
||||
[
|
||||
'type' => 'base_location_country',
|
||||
'value' => 'US',
|
||||
'operation' => '=',
|
||||
],
|
||||
[
|
||||
'type' => 'base_location_country',
|
||||
'value' => 'FR',
|
||||
'operation' => '=',
|
||||
],
|
||||
[
|
||||
'type' => 'base_location_country',
|
||||
'value' => 'GB',
|
||||
'operation' => '=',
|
||||
],
|
||||
[
|
||||
'type' => 'base_location_country',
|
||||
'value' => 'DE',
|
||||
'operation' => '=',
|
||||
],
|
||||
[
|
||||
'type' => 'base_location_country',
|
||||
'value' => 'CA',
|
||||
'operation' => '=',
|
||||
],
|
||||
[
|
||||
'type' => 'base_location_country',
|
||||
'value' => 'AU',
|
||||
'operation' => '=',
|
||||
],
|
||||
[
|
||||
'type' => 'base_location_country',
|
||||
'value' => 'GR',
|
||||
'operation' => '=',
|
||||
],
|
||||
[
|
||||
'type' => 'base_location_country',
|
||||
'value' => 'BE',
|
||||
'operation' => '=',
|
||||
],
|
||||
[
|
||||
'type' => 'base_location_country',
|
||||
'value' => 'PT',
|
||||
'operation' => '=',
|
||||
],
|
||||
[
|
||||
'type' => 'base_location_country',
|
||||
'value' => 'DK',
|
||||
'operation' => '=',
|
||||
],
|
||||
[
|
||||
'type' => 'base_location_country',
|
||||
'value' => 'SE',
|
||||
'operation' => '=',
|
||||
],
|
||||
],
|
||||
],
|
||||
[
|
||||
'type' => 'not',
|
||||
'operand' => [
|
||||
[
|
||||
'type' => 'plugins_activated',
|
||||
'plugins' => [ 'woocommerce-services' ],
|
||||
],
|
||||
],
|
||||
],
|
||||
],
|
||||
'is_built_by_wc' => true,
|
||||
],
|
||||
'jetpack' => [
|
||||
'description' => sprintf(
|
||||
/* translators: 1: opening product link tag. 2: closing link tag */
|
||||
__( 'Enhance speed and security with %1$sJetpack%2$s', 'woocommerce' ),
|
||||
'<a href="https://woocommerce.com/products/jetpack" target="_blank">',
|
||||
'</a>'
|
||||
),
|
||||
'is_visible' => [
|
||||
[
|
||||
'type' => 'not',
|
||||
'operand' => [
|
||||
[
|
||||
'type' => 'plugins_activated',
|
||||
'plugins' => [ 'jetpack' ],
|
||||
],
|
||||
],
|
||||
],
|
||||
],
|
||||
'is_built_by_wc' => false,
|
||||
'min_wp_version' => '6.0',
|
||||
],
|
||||
'mailpoet' => [
|
||||
'name' => __( 'MailPoet', 'woocommerce' ),
|
||||
'description' => sprintf(
|
||||
/* translators: 1: opening product link tag. 2: closing link tag */
|
||||
__( 'Level up your email marketing with %1$sMailPoet%2$s', 'woocommerce' ),
|
||||
'<a href="https://woocommerce.com/products/mailpoet" target="_blank">',
|
||||
'</a>'
|
||||
),
|
||||
'manage_url' => 'admin.php?page=mailpoet-newsletters',
|
||||
'is_visible' => [
|
||||
[
|
||||
'type' => 'not',
|
||||
'operand' => [
|
||||
[
|
||||
'type' => 'plugins_activated',
|
||||
'plugins' => [ 'mailpoet' ],
|
||||
],
|
||||
],
|
||||
],
|
||||
],
|
||||
'is_built_by_wc' => true,
|
||||
],
|
||||
'mailpoet:alt' => [
|
||||
'name' => __( 'MailPoet', 'woocommerce' ),
|
||||
'description' => __( 'Create and send purchase follow-up emails, newsletters, and promotional campaigns straight from your dashboard.', 'woocommerce' ),
|
||||
'image_url' => plugins_url( '/assets/images/onboarding/mailpoet.png', WC_PLUGIN_FILE ),
|
||||
'manage_url' => 'admin.php?page=mailpoet-newsletters',
|
||||
'is_built_by_wc' => true,
|
||||
],
|
||||
'tiktok-for-business' => [
|
||||
'name' => __( 'TikTok for WooCommerce', 'woocommerce' ),
|
||||
'image_url' => plugins_url( '/assets/images/onboarding/tiktok.svg', WC_PLUGIN_FILE ),
|
||||
'description' =>
|
||||
__( 'Grow your online sales by promoting your products on TikTok to over one billion monthly active users around the world.', 'woocommerce' ),
|
||||
'manage_url' => 'admin.php?page=tiktok',
|
||||
'is_visible' => [
|
||||
[
|
||||
'type' => 'or',
|
||||
'operands' => [
|
||||
[
|
||||
'type' => 'base_location_country',
|
||||
'value' => 'US',
|
||||
'operation' => '=',
|
||||
],
|
||||
[
|
||||
'type' => 'base_location_country',
|
||||
'value' => 'CA',
|
||||
'operation' => '=',
|
||||
],
|
||||
[
|
||||
'type' => 'base_location_country',
|
||||
'value' => 'MX',
|
||||
'operation' => '=',
|
||||
],
|
||||
[
|
||||
'type' => 'base_location_country',
|
||||
'value' => 'AT',
|
||||
'operation' => '=',
|
||||
],
|
||||
[
|
||||
'type' => 'base_location_country',
|
||||
'value' => 'BE',
|
||||
'operation' => '=',
|
||||
],
|
||||
[
|
||||
'type' => 'base_location_country',
|
||||
'value' => 'CZ',
|
||||
'operation' => '=',
|
||||
],
|
||||
[
|
||||
'type' => 'base_location_country',
|
||||
'value' => 'DK',
|
||||
'operation' => '=',
|
||||
],
|
||||
[
|
||||
'type' => 'base_location_country',
|
||||
'value' => 'FI',
|
||||
'operation' => '=',
|
||||
],
|
||||
[
|
||||
'type' => 'base_location_country',
|
||||
'value' => 'FR',
|
||||
'operation' => '=',
|
||||
],
|
||||
[
|
||||
'type' => 'base_location_country',
|
||||
'value' => 'DE',
|
||||
'operation' => '=',
|
||||
],
|
||||
[
|
||||
'type' => 'base_location_country',
|
||||
'value' => 'GR',
|
||||
'operation' => '=',
|
||||
],
|
||||
[
|
||||
'type' => 'base_location_country',
|
||||
'value' => 'HU',
|
||||
'operation' => '=',
|
||||
],
|
||||
[
|
||||
'type' => 'base_location_country',
|
||||
'value' => 'IE',
|
||||
'operation' => '=',
|
||||
],
|
||||
[
|
||||
'type' => 'base_location_country',
|
||||
'value' => 'IT',
|
||||
'operation' => '=',
|
||||
],
|
||||
[
|
||||
'type' => 'base_location_country',
|
||||
'value' => 'NL',
|
||||
'operation' => '=',
|
||||
],
|
||||
[
|
||||
'type' => 'base_location_country',
|
||||
'value' => 'PL',
|
||||
'operation' => '=',
|
||||
],
|
||||
[
|
||||
'type' => 'base_location_country',
|
||||
'value' => 'PT',
|
||||
'operation' => '=',
|
||||
],
|
||||
[
|
||||
'type' => 'base_location_country',
|
||||
'value' => 'RO',
|
||||
'operation' => '=',
|
||||
],
|
||||
[
|
||||
'type' => 'base_location_country',
|
||||
'value' => 'ES',
|
||||
'operation' => '=',
|
||||
],
|
||||
[
|
||||
'type' => 'base_location_country',
|
||||
'value' => 'SE',
|
||||
'operation' => '=',
|
||||
],
|
||||
[
|
||||
'type' => 'base_location_country',
|
||||
'value' => 'GB',
|
||||
'operation' => '=',
|
||||
],
|
||||
[
|
||||
'type' => 'base_location_country',
|
||||
'value' => 'CH',
|
||||
'operation' => '=',
|
||||
],
|
||||
[
|
||||
'type' => 'base_location_country',
|
||||
'value' => 'NO',
|
||||
'operation' => '=',
|
||||
],
|
||||
[
|
||||
'type' => 'base_location_country',
|
||||
'value' => 'AU',
|
||||
'operation' => '=',
|
||||
],
|
||||
[
|
||||
'type' => 'base_location_country',
|
||||
'value' => 'NZ',
|
||||
'operation' => '=',
|
||||
],
|
||||
[
|
||||
'type' => 'base_location_country',
|
||||
'value' => 'SG',
|
||||
'operation' => '=',
|
||||
],
|
||||
[
|
||||
'type' => 'base_location_country',
|
||||
'value' => 'MY',
|
||||
'operation' => '=',
|
||||
],
|
||||
[
|
||||
'type' => 'base_location_country',
|
||||
'value' => 'PH',
|
||||
'operation' => '=',
|
||||
],
|
||||
[
|
||||
'type' => 'base_location_country',
|
||||
'value' => 'ID',
|
||||
'operation' => '=',
|
||||
],
|
||||
[
|
||||
'type' => 'base_location_country',
|
||||
'value' => 'VN',
|
||||
'operation' => '=',
|
||||
],
|
||||
[
|
||||
'type' => 'base_location_country',
|
||||
'value' => 'TH',
|
||||
'operation' => '=',
|
||||
],
|
||||
[
|
||||
'type' => 'base_location_country',
|
||||
'value' => 'KR',
|
||||
'operation' => '=',
|
||||
],
|
||||
[
|
||||
'type' => 'base_location_country',
|
||||
'value' => 'IL',
|
||||
'operation' => '=',
|
||||
],
|
||||
[
|
||||
'type' => 'base_location_country',
|
||||
'value' => 'AE',
|
||||
'operation' => '=',
|
||||
],
|
||||
[
|
||||
'type' => 'base_location_country',
|
||||
'value' => 'RU',
|
||||
'operation' => '=',
|
||||
],
|
||||
[
|
||||
'type' => 'base_location_country',
|
||||
'value' => 'UA',
|
||||
'operation' => '=',
|
||||
],
|
||||
[
|
||||
'type' => 'base_location_country',
|
||||
'value' => 'TR',
|
||||
'operation' => '=',
|
||||
],
|
||||
[
|
||||
'type' => 'base_location_country',
|
||||
'value' => 'SA',
|
||||
'operation' => '=',
|
||||
],
|
||||
[
|
||||
'type' => 'base_location_country',
|
||||
'value' => 'BR',
|
||||
'operation' => '=',
|
||||
],
|
||||
[
|
||||
'type' => 'base_location_country',
|
||||
'value' => 'JP',
|
||||
'operation' => '=',
|
||||
],
|
||||
],
|
||||
],
|
||||
],
|
||||
'is_built_by_wc' => false,
|
||||
],
|
||||
'tiktok-for-business:alt' => [
|
||||
'name' => __( 'TikTok for WooCommerce', 'woocommerce' ),
|
||||
'image_url' => plugins_url( '/assets/images/onboarding/tiktok.svg', WC_PLUGIN_FILE ),
|
||||
'description' => sprintf(
|
||||
/* translators: 1: opening product link tag. 2: closing link tag */
|
||||
__( 'Create ad campaigns and reach one billion global users with %1$sTikTok for WooCommerce%2$s', 'woocommerce' ),
|
||||
'<a href="https://woocommerce.com/products/tiktok-for-woocommerce" target="_blank">',
|
||||
'</a>'
|
||||
),
|
||||
'manage_url' => 'admin.php?page=tiktok',
|
||||
'is_built_by_wc' => false,
|
||||
'is_visible' => false,
|
||||
],
|
||||
);
|
||||
|
||||
$plugin = $plugins[ $slug ];
|
||||
$plugin['key'] = $slug;
|
||||
|
||||
return $plugin;
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,52 @@
|
||||
<?php
|
||||
/**
|
||||
* Evaluates the spec and returns a status.
|
||||
*/
|
||||
|
||||
namespace Automattic\WooCommerce\Internal\Admin\RemoteFreeExtensions;
|
||||
|
||||
defined( 'ABSPATH' ) || exit;
|
||||
|
||||
use Automattic\WooCommerce\Admin\PluginsHelper;
|
||||
use Automattic\WooCommerce\Admin\RemoteInboxNotifications\RuleEvaluator;
|
||||
|
||||
/**
|
||||
* Evaluates the extension and returns it.
|
||||
*/
|
||||
class EvaluateExtension {
|
||||
/**
|
||||
* Evaluates the extension and returns it.
|
||||
*
|
||||
* @param object $extension The extension to evaluate.
|
||||
* @return object The evaluated extension.
|
||||
*/
|
||||
public static function evaluate( $extension ) {
|
||||
global $wp_version;
|
||||
$rule_evaluator = new RuleEvaluator();
|
||||
|
||||
if ( isset( $extension->is_visible ) ) {
|
||||
$is_visible = $rule_evaluator->evaluate( $extension->is_visible );
|
||||
$extension->is_visible = $is_visible;
|
||||
} else {
|
||||
$extension->is_visible = true;
|
||||
}
|
||||
|
||||
// Run PHP and WP version chcecks.
|
||||
if ( true === $extension->is_visible ) {
|
||||
if ( isset( $extension->min_php_version ) && ! version_compare( PHP_VERSION, $extension->min_php_version, '>=' ) ) {
|
||||
$extension->is_visible = false;
|
||||
}
|
||||
|
||||
if ( isset( $extension->min_wp_version ) && ! version_compare( $wp_version, $extension->min_wp_version, '>=' ) ) {
|
||||
$extension->is_visible = false;
|
||||
}
|
||||
}
|
||||
|
||||
$installed_plugins = PluginsHelper::get_installed_plugin_slugs();
|
||||
$activated_plugins = PluginsHelper::get_active_plugin_slugs();
|
||||
$extension->is_installed = in_array( explode( ':', $extension->key )[0], $installed_plugins, true );
|
||||
$extension->is_activated = in_array( explode( ':', $extension->key )[0], $activated_plugins, true );
|
||||
|
||||
return $extension;
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,81 @@
|
||||
<?php
|
||||
/**
|
||||
* Handles running payment method specs
|
||||
*/
|
||||
|
||||
namespace Automattic\WooCommerce\Internal\Admin\RemoteFreeExtensions;
|
||||
|
||||
defined( 'ABSPATH' ) || exit;
|
||||
|
||||
use Automattic\WooCommerce\Internal\Admin\RemoteFreeExtensions\DefaultFreeExtensions;
|
||||
|
||||
/**
|
||||
* Remote Payment Methods engine.
|
||||
* This goes through the specs and gets eligible payment methods.
|
||||
*/
|
||||
class Init {
|
||||
|
||||
/**
|
||||
* Constructor.
|
||||
*/
|
||||
public function __construct() {
|
||||
add_action( 'woocommerce_updated', array( __CLASS__, 'delete_specs_transient' ) );
|
||||
}
|
||||
|
||||
/**
|
||||
* Go through the specs and run them.
|
||||
*
|
||||
* @param array $allowed_bundles Optional array of allowed bundles to be returned.
|
||||
* @return array
|
||||
*/
|
||||
public static function get_extensions( $allowed_bundles = array() ) {
|
||||
$bundles = array();
|
||||
$specs = self::get_specs();
|
||||
|
||||
foreach ( $specs as $spec ) {
|
||||
$spec = (object) $spec;
|
||||
$bundle = (array) $spec;
|
||||
$bundle['plugins'] = array();
|
||||
|
||||
if ( ! empty( $allowed_bundles ) && ! in_array( $spec->key, $allowed_bundles, true ) ) {
|
||||
continue;
|
||||
}
|
||||
|
||||
foreach ( $spec->plugins as $plugin ) {
|
||||
$extension = EvaluateExtension::evaluate( (object) $plugin );
|
||||
|
||||
if ( ! property_exists( $extension, 'is_visible' ) || $extension->is_visible ) {
|
||||
$bundle['plugins'][] = $extension;
|
||||
}
|
||||
}
|
||||
|
||||
$bundles[] = $bundle;
|
||||
}
|
||||
|
||||
return $bundles;
|
||||
}
|
||||
|
||||
/**
|
||||
* Delete the specs transient.
|
||||
*/
|
||||
public static function delete_specs_transient() {
|
||||
RemoteFreeExtensionsDataSourcePoller::get_instance()->delete_specs_transient();
|
||||
}
|
||||
|
||||
/**
|
||||
* Get specs or fetch remotely if they don't exist.
|
||||
*/
|
||||
public static function get_specs() {
|
||||
if ( 'no' === get_option( 'woocommerce_show_marketplace_suggestions', 'yes' ) ) {
|
||||
return DefaultFreeExtensions::get_all();
|
||||
}
|
||||
$specs = RemoteFreeExtensionsDataSourcePoller::get_instance()->get_specs_from_data_sources();
|
||||
|
||||
// Fetch specs if they don't yet exist.
|
||||
if ( false === $specs || ! is_array( $specs ) || 0 === count( $specs ) ) {
|
||||
return DefaultFreeExtensions::get_all();
|
||||
}
|
||||
|
||||
return $specs;
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,38 @@
|
||||
<?php
|
||||
|
||||
namespace Automattic\WooCommerce\Internal\Admin\RemoteFreeExtensions;
|
||||
|
||||
/**
|
||||
* Specs data source poller class for remote free extensions.
|
||||
*/
|
||||
class RemoteFreeExtensionsDataSourcePoller extends \Automattic\WooCommerce\Admin\DataSourcePoller {
|
||||
|
||||
const ID = 'remote_free_extensions';
|
||||
|
||||
const DATA_SOURCES = array(
|
||||
'https://woocommerce.com/wp-json/wccom/obw-free-extensions/3.0/extensions.json',
|
||||
);
|
||||
|
||||
/**
|
||||
* Class instance.
|
||||
*
|
||||
* @var Analytics instance
|
||||
*/
|
||||
protected static $instance = null;
|
||||
|
||||
/**
|
||||
* Get class instance.
|
||||
*/
|
||||
public static function get_instance() {
|
||||
if ( ! self::$instance ) {
|
||||
self::$instance = new self(
|
||||
self::ID,
|
||||
self::DATA_SOURCES,
|
||||
array(
|
||||
'spec_key' => 'key',
|
||||
)
|
||||
);
|
||||
}
|
||||
return self::$instance;
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,45 @@
|
||||
<?php
|
||||
/**
|
||||
* Remote Inbox Notifications feature.
|
||||
*/
|
||||
|
||||
namespace Automattic\WooCommerce\Internal\Admin;
|
||||
|
||||
use Automattic\WooCommerce\Admin\Features\Features;
|
||||
use Automattic\WooCommerce\Admin\RemoteInboxNotifications\RemoteInboxNotificationsEngine;
|
||||
|
||||
/**
|
||||
* Remote Inbox Notifications feature logic.
|
||||
*/
|
||||
class RemoteInboxNotifications {
|
||||
/**
|
||||
* Option name used to toggle this feature.
|
||||
*/
|
||||
const TOGGLE_OPTION_NAME = 'woocommerce_show_marketplace_suggestions';
|
||||
|
||||
/**
|
||||
* Class instance.
|
||||
*
|
||||
* @var RemoteInboxNotifications 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() {
|
||||
if ( Features::is_enabled( 'remote-inbox-notifications' ) ) {
|
||||
RemoteInboxNotificationsEngine::init();
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,146 @@
|
||||
<?php
|
||||
/**
|
||||
* Customer syncing related functions and actions.
|
||||
*/
|
||||
|
||||
namespace Automattic\WooCommerce\Internal\Admin\Schedulers;
|
||||
|
||||
defined( 'ABSPATH' ) || exit;
|
||||
|
||||
use Automattic\WooCommerce\Admin\API\Reports\Cache as ReportsCache;
|
||||
use Automattic\WooCommerce\Admin\API\Reports\Customers\DataStore as CustomersDataStore;
|
||||
|
||||
/**
|
||||
* CustomersScheduler Class.
|
||||
*/
|
||||
class CustomersScheduler extends ImportScheduler {
|
||||
/**
|
||||
* Slug to identify the scheduler.
|
||||
*
|
||||
* @var string
|
||||
*/
|
||||
public static $name = 'customers';
|
||||
|
||||
/**
|
||||
* Attach customer lookup update hooks.
|
||||
*
|
||||
* @internal
|
||||
*/
|
||||
public static function init() {
|
||||
CustomersDataStore::init();
|
||||
parent::init();
|
||||
}
|
||||
|
||||
/**
|
||||
* Add customer dependencies.
|
||||
*
|
||||
* @internal
|
||||
* @return array
|
||||
*/
|
||||
public static function get_dependencies() {
|
||||
return array(
|
||||
'delete_batch_init' => OrdersScheduler::get_action( 'delete_batch_init' ),
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Get the customer IDs and total count that need to be synced.
|
||||
*
|
||||
* @internal
|
||||
* @param int $limit Number of records to retrieve.
|
||||
* @param int $page Page number.
|
||||
* @param int|bool $days Number of days prior to current date to limit search results.
|
||||
* @param bool $skip_existing Skip already imported customers.
|
||||
*/
|
||||
public static function get_items( $limit = 10, $page = 1, $days = false, $skip_existing = false ) {
|
||||
$customer_roles = apply_filters( 'woocommerce_analytics_import_customer_roles', array( 'customer' ) );
|
||||
$query_args = array(
|
||||
'fields' => 'ID',
|
||||
'orderby' => 'ID',
|
||||
'order' => 'ASC',
|
||||
'number' => $limit,
|
||||
'paged' => $page,
|
||||
'role__in' => $customer_roles,
|
||||
);
|
||||
|
||||
if ( is_int( $days ) ) {
|
||||
$query_args['date_query'] = array(
|
||||
'after' => gmdate( 'Y-m-d 00:00:00', time() - ( DAY_IN_SECONDS * $days ) ),
|
||||
);
|
||||
}
|
||||
|
||||
if ( $skip_existing ) {
|
||||
add_action( 'pre_user_query', array( __CLASS__, 'exclude_existing_customers_from_query' ) );
|
||||
}
|
||||
|
||||
$customer_query = new \WP_User_Query( $query_args );
|
||||
|
||||
remove_action( 'pre_user_query', array( __CLASS__, 'exclude_existing_customers_from_query' ) );
|
||||
|
||||
return (object) array(
|
||||
'total' => $customer_query->get_total(),
|
||||
'ids' => $customer_query->get_results(),
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Exclude users that already exist in our customer lookup table.
|
||||
*
|
||||
* Meant to be hooked into 'pre_user_query' action.
|
||||
*
|
||||
* @internal
|
||||
* @param WP_User_Query $wp_user_query WP_User_Query to modify.
|
||||
*/
|
||||
public static function exclude_existing_customers_from_query( $wp_user_query ) {
|
||||
global $wpdb;
|
||||
|
||||
$wp_user_query->query_where .= " AND NOT EXISTS (
|
||||
SELECT ID FROM {$wpdb->prefix}wc_customer_lookup
|
||||
WHERE {$wpdb->prefix}wc_customer_lookup.user_id = {$wpdb->users}.ID
|
||||
)";
|
||||
}
|
||||
|
||||
/**
|
||||
* Get total number of rows imported.
|
||||
*
|
||||
* @internal
|
||||
* @return int
|
||||
*/
|
||||
public static function get_total_imported() {
|
||||
global $wpdb;
|
||||
return $wpdb->get_var( "SELECT COUNT(*) FROM {$wpdb->prefix}wc_customer_lookup" );
|
||||
}
|
||||
|
||||
/**
|
||||
* Imports a single customer.
|
||||
*
|
||||
* @internal
|
||||
* @param int $user_id User ID.
|
||||
* @return void
|
||||
*/
|
||||
public static function import( $user_id ) {
|
||||
CustomersDataStore::update_registered_customer( $user_id );
|
||||
}
|
||||
|
||||
/**
|
||||
* Delete a batch of customers.
|
||||
*
|
||||
* @internal
|
||||
* @param int $batch_size Number of items to delete.
|
||||
* @return void
|
||||
*/
|
||||
public static function delete( $batch_size ) {
|
||||
global $wpdb;
|
||||
|
||||
$customer_ids = $wpdb->get_col(
|
||||
$wpdb->prepare(
|
||||
"SELECT customer_id FROM {$wpdb->prefix}wc_customer_lookup ORDER BY customer_id ASC LIMIT %d",
|
||||
$batch_size
|
||||
)
|
||||
);
|
||||
|
||||
foreach ( $customer_ids as $customer_id ) {
|
||||
CustomersDataStore::delete_customer( $customer_id );
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,28 @@
|
||||
<?php
|
||||
/**
|
||||
* Import related abstract functions.
|
||||
*/
|
||||
|
||||
namespace Automattic\WooCommerce\Internal\Admin\Schedulers;
|
||||
|
||||
interface ImportInterface {
|
||||
/**
|
||||
* Get items based on query and return IDs along with total available.
|
||||
*
|
||||
* @internal
|
||||
* @param int $limit Number of records to retrieve.
|
||||
* @param int $page Page number.
|
||||
* @param int|bool $days Number of days prior to current date to limit search results.
|
||||
* @param bool $skip_existing Skip already imported items.
|
||||
*/
|
||||
public static function get_items( $limit, $page, $days, $skip_existing );
|
||||
|
||||
/**
|
||||
* Get total number of items already imported.
|
||||
*
|
||||
* @internal
|
||||
* @return null
|
||||
*/
|
||||
public static function get_total_imported();
|
||||
|
||||
}
|
||||
@@ -0,0 +1,187 @@
|
||||
<?php
|
||||
/**
|
||||
* Import related functions and actions.
|
||||
*/
|
||||
|
||||
namespace Automattic\WooCommerce\Internal\Admin\Schedulers;
|
||||
|
||||
defined( 'ABSPATH' ) || exit;
|
||||
|
||||
use Automattic\WooCommerce\Admin\API\Reports\Cache as ReportsCache;
|
||||
use Automattic\WooCommerce\Admin\Schedulers\SchedulerTraits;
|
||||
|
||||
/**
|
||||
* ImportScheduler class.
|
||||
*/
|
||||
abstract class ImportScheduler implements ImportInterface {
|
||||
/**
|
||||
* Import stats option name.
|
||||
*/
|
||||
const IMPORT_STATS_OPTION = 'woocommerce_admin_import_stats';
|
||||
|
||||
/**
|
||||
* Scheduler traits.
|
||||
*/
|
||||
use SchedulerTraits {
|
||||
get_batch_sizes as get_scheduler_batch_sizes;
|
||||
}
|
||||
|
||||
/**
|
||||
* Returns true if an import is in progress.
|
||||
*
|
||||
* @internal
|
||||
* @return bool
|
||||
*/
|
||||
public static function is_importing() {
|
||||
$pending_jobs = self::queue()->search(
|
||||
array(
|
||||
'status' => 'pending',
|
||||
'per_page' => 1,
|
||||
'claimed' => false,
|
||||
'search' => 'import',
|
||||
'group' => self::$group,
|
||||
)
|
||||
);
|
||||
if ( empty( $pending_jobs ) ) {
|
||||
$in_progress = self::queue()->search(
|
||||
array(
|
||||
'status' => 'in-progress',
|
||||
'per_page' => 1,
|
||||
'search' => 'import',
|
||||
'group' => self::$group,
|
||||
)
|
||||
);
|
||||
}
|
||||
|
||||
return ! empty( $pending_jobs ) || ! empty( $in_progress );
|
||||
}
|
||||
|
||||
/**
|
||||
* Get batch sizes.
|
||||
*
|
||||
* @internal
|
||||
* @retun array
|
||||
*/
|
||||
public static function get_batch_sizes() {
|
||||
return array_merge(
|
||||
self::get_scheduler_batch_sizes(),
|
||||
array(
|
||||
'delete' => 10,
|
||||
'import' => 25,
|
||||
'queue' => 100,
|
||||
)
|
||||
);
|
||||
|
||||
}
|
||||
|
||||
/**
|
||||
* Get all available scheduling actions.
|
||||
* Used to determine action hook names and clear events.
|
||||
*
|
||||
* @internal
|
||||
* @return array
|
||||
*/
|
||||
public static function get_scheduler_actions() {
|
||||
return array(
|
||||
'import_batch_init' => 'wc-admin_import_batch_init_' . static::$name,
|
||||
'import_batch' => 'wc-admin_import_batch_' . static::$name,
|
||||
'delete_batch_init' => 'wc-admin_delete_batch_init_' . static::$name,
|
||||
'delete_batch' => 'wc-admin_delete_batch_' . static::$name,
|
||||
'import' => 'wc-admin_import_' . static::$name,
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Queue the imports into multiple batches.
|
||||
*
|
||||
* @internal
|
||||
* @param integer|boolean $days Number of days to import.
|
||||
* @param boolean $skip_existing Skip exisiting records.
|
||||
*/
|
||||
public static function import_batch_init( $days, $skip_existing ) {
|
||||
$batch_size = static::get_batch_size( 'import' );
|
||||
$items = static::get_items( 1, 1, $days, $skip_existing );
|
||||
|
||||
if ( 0 === $items->total ) {
|
||||
return;
|
||||
}
|
||||
|
||||
$num_batches = ceil( $items->total / $batch_size );
|
||||
|
||||
self::queue_batches( 1, $num_batches, 'import_batch', array( $days, $skip_existing ) );
|
||||
}
|
||||
|
||||
/**
|
||||
* Imports a batch of items to update.
|
||||
*
|
||||
* @internal
|
||||
* @param int $batch_number Batch number to import (essentially a query page number).
|
||||
* @param int|bool $days Number of days to import.
|
||||
* @param bool $skip_existing Skip exisiting records.
|
||||
* @return void
|
||||
*/
|
||||
public static function import_batch( $batch_number, $days, $skip_existing ) {
|
||||
$batch_size = static::get_batch_size( 'import' );
|
||||
|
||||
$properties = array(
|
||||
'batch_number' => $batch_number,
|
||||
'batch_size' => $batch_size,
|
||||
'type' => static::$name,
|
||||
);
|
||||
wc_admin_record_tracks_event( 'import_job_start', $properties );
|
||||
|
||||
// When we are skipping already imported items, the table of items to import gets smaller in
|
||||
// every batch, so we want to always import the first page.
|
||||
$page = $skip_existing ? 1 : $batch_number;
|
||||
$items = static::get_items( $batch_size, $page, $days, $skip_existing );
|
||||
|
||||
foreach ( $items->ids as $id ) {
|
||||
static::import( $id );
|
||||
}
|
||||
|
||||
$import_stats = get_option( self::IMPORT_STATS_OPTION, array() );
|
||||
$imported_count = absint( $import_stats[ static::$name ]['imported'] ) + count( $items->ids );
|
||||
$import_stats[ static::$name ]['imported'] = $imported_count;
|
||||
update_option( self::IMPORT_STATS_OPTION, $import_stats );
|
||||
|
||||
$properties['imported_count'] = $imported_count;
|
||||
|
||||
wc_admin_record_tracks_event( 'import_job_complete', $properties );
|
||||
}
|
||||
|
||||
/**
|
||||
* Queue item deletion in batches.
|
||||
*
|
||||
* @internal
|
||||
*/
|
||||
public static function delete_batch_init() {
|
||||
global $wpdb;
|
||||
$batch_size = static::get_batch_size( 'delete' );
|
||||
$count = static::get_total_imported();
|
||||
|
||||
if ( 0 === $count ) {
|
||||
return;
|
||||
}
|
||||
|
||||
$num_batches = ceil( $count / $batch_size );
|
||||
|
||||
self::queue_batches( 1, $num_batches, 'delete_batch' );
|
||||
}
|
||||
|
||||
/**
|
||||
* Delete a batch by passing the count to be deleted to the child delete method.
|
||||
*
|
||||
* @internal
|
||||
* @return void
|
||||
*/
|
||||
public static function delete_batch() {
|
||||
wc_admin_record_tracks_event( 'delete_import_data_job_start', array( 'type' => static::$name ) );
|
||||
|
||||
$batch_size = static::get_batch_size( 'delete' );
|
||||
static::delete( $batch_size );
|
||||
|
||||
ReportsCache::invalidate();
|
||||
|
||||
wc_admin_record_tracks_event( 'delete_import_data_job_complete', array( 'type' => static::$name ) );
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,135 @@
|
||||
<?php
|
||||
|
||||
namespace Automattic\WooCommerce\Internal\Admin\Schedulers;
|
||||
|
||||
/**
|
||||
* Class MailchimpScheduler
|
||||
*
|
||||
* @package Automattic\WooCommerce\Admin\Schedulers
|
||||
*/
|
||||
class MailchimpScheduler {
|
||||
|
||||
const SUBSCRIBE_ENDPOINT = 'https://woocommerce.com/wp-json/wccom/v1/subscribe';
|
||||
const SUBSCRIBE_ENDPOINT_DEV = 'http://woocommerce.test/wp-json/wccom/v1/subscribe';
|
||||
|
||||
const SUBSCRIBED_OPTION_NAME = 'woocommerce_onboarding_subscribed_to_mailchimp';
|
||||
const SUBSCRIBED_ERROR_COUNT_OPTION_NAME = 'woocommerce_onboarding_subscribed_to_mailchimp_error_count';
|
||||
const MAX_ERROR_THRESHOLD = 3;
|
||||
|
||||
const LOGGER_CONTEXT = 'mailchimp_scheduler';
|
||||
|
||||
/**
|
||||
* The logger instance.
|
||||
*
|
||||
* @var \WC_Logger_Interface|null
|
||||
*/
|
||||
private $logger;
|
||||
|
||||
/**
|
||||
* MailchimpScheduler constructor.
|
||||
*
|
||||
* @internal
|
||||
* @param \WC_Logger_Interface|null $logger Logger instance.
|
||||
*/
|
||||
public function __construct( \WC_Logger_Interface $logger = null ) {
|
||||
if ( null === $logger ) {
|
||||
$logger = wc_get_logger();
|
||||
}
|
||||
$this->logger = $logger;
|
||||
}
|
||||
|
||||
/**
|
||||
* Attempt to subscribe store_email to MailChimp.
|
||||
*
|
||||
* @internal
|
||||
*/
|
||||
public function run() {
|
||||
// Abort if we've already subscribed to MailChimp.
|
||||
if ( 'yes' === get_option( self::SUBSCRIBED_OPTION_NAME ) ) {
|
||||
return false;
|
||||
}
|
||||
|
||||
$profile_data = get_option( 'woocommerce_onboarding_profile' );
|
||||
if ( ! isset( $profile_data['is_agree_marketing'] ) || false === $profile_data['is_agree_marketing'] ) {
|
||||
return false;
|
||||
}
|
||||
|
||||
// Abort if store_email doesn't exist.
|
||||
if ( ! isset( $profile_data['store_email'] ) ) {
|
||||
return false;
|
||||
}
|
||||
|
||||
// Abort if failed requests reaches the threshold.
|
||||
if ( intval( get_option( self::SUBSCRIBED_ERROR_COUNT_OPTION_NAME, 0 ) ) >= self::MAX_ERROR_THRESHOLD ) {
|
||||
return false;
|
||||
}
|
||||
|
||||
$response = $this->make_request( $profile_data['store_email'] );
|
||||
if ( is_wp_error( $response ) || ! isset( $response['body'] ) ) {
|
||||
$this->handle_request_error();
|
||||
return false;
|
||||
}
|
||||
|
||||
$body = json_decode( $response['body'] );
|
||||
if ( isset( $body->success ) && true === $body->success ) {
|
||||
update_option( self::SUBSCRIBED_OPTION_NAME, 'yes' );
|
||||
return true;
|
||||
}
|
||||
|
||||
$this->handle_request_error( $body );
|
||||
return false;
|
||||
}
|
||||
|
||||
/**
|
||||
* Make an HTTP request to the API.
|
||||
*
|
||||
* @internal
|
||||
* @param string $store_email Email address to subscribe.
|
||||
*
|
||||
* @return mixed
|
||||
*/
|
||||
public function make_request( $store_email ) {
|
||||
if ( true === defined( 'WP_ENVIRONMENT_TYPE' ) && 'development' === constant( 'WP_ENVIRONMENT_TYPE' ) ) {
|
||||
$subscribe_endpoint = self::SUBSCRIBE_ENDPOINT_DEV;
|
||||
} else {
|
||||
$subscribe_endpoint = self::SUBSCRIBE_ENDPOINT;
|
||||
}
|
||||
|
||||
return wp_remote_post(
|
||||
$subscribe_endpoint,
|
||||
array(
|
||||
'user-agent' => 'WooCommerce/' . WC()->version . '; ' . get_bloginfo( 'url' ),
|
||||
'method' => 'POST',
|
||||
'body' => array(
|
||||
'email' => $store_email,
|
||||
),
|
||||
)
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Reset options.
|
||||
*
|
||||
* @internal
|
||||
*/
|
||||
public static function reset() {
|
||||
delete_option( self::SUBSCRIBED_OPTION_NAME );
|
||||
delete_option( self::SUBSCRIBED_ERROR_COUNT_OPTION_NAME );
|
||||
}
|
||||
|
||||
/**
|
||||
* Handle subscribe API error.
|
||||
*
|
||||
* @internal
|
||||
* @param string $extra_msg Extra message to log.
|
||||
*/
|
||||
private function handle_request_error( $extra_msg = null ) {
|
||||
// phpcs:ignore
|
||||
$msg = isset( $extra_msg ) ? 'Incorrect response from Mailchimp API with: ' . print_r( $extra_msg, true ) : 'Error getting a response from Mailchimp API.';
|
||||
|
||||
$this->logger->error( $msg, array( 'source' => self::LOGGER_CONTEXT ) );
|
||||
|
||||
$accumulated_error_count = intval( get_option( self::SUBSCRIBED_ERROR_COUNT_OPTION_NAME, 0 ) ) + 1;
|
||||
update_option( self::SUBSCRIBED_ERROR_COUNT_OPTION_NAME, $accumulated_error_count );
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,290 @@
|
||||
<?php
|
||||
/**
|
||||
* Order syncing related functions and actions.
|
||||
*/
|
||||
|
||||
namespace Automattic\WooCommerce\Internal\Admin\Schedulers;
|
||||
|
||||
defined( 'ABSPATH' ) || exit;
|
||||
|
||||
use Automattic\WooCommerce\Admin\API\Reports\Coupons\DataStore as CouponsDataStore;
|
||||
use Automattic\WooCommerce\Admin\API\Reports\Orders\Stats\DataStore as OrdersStatsDataStore;
|
||||
use Automattic\WooCommerce\Admin\API\Reports\Products\DataStore as ProductsDataStore;
|
||||
use Automattic\WooCommerce\Admin\API\Reports\Taxes\DataStore as TaxesDataStore;
|
||||
use Automattic\WooCommerce\Admin\API\Reports\Customers\DataStore as CustomersDataStore;
|
||||
use Automattic\WooCommerce\Admin\API\Reports\Cache as ReportsCache;
|
||||
use Automattic\WooCommerce\Admin\Overrides\Order;
|
||||
use Automattic\WooCommerce\Internal\DataStores\Orders\OrdersTableDataStore;
|
||||
use Automattic\WooCommerce\Utilities\OrderUtil;
|
||||
|
||||
/**
|
||||
* OrdersScheduler Class.
|
||||
*/
|
||||
class OrdersScheduler extends ImportScheduler {
|
||||
/**
|
||||
* Slug to identify the scheduler.
|
||||
*
|
||||
* @var string
|
||||
*/
|
||||
public static $name = 'orders';
|
||||
|
||||
/**
|
||||
* Attach order lookup update hooks.
|
||||
*
|
||||
* @internal
|
||||
*/
|
||||
public static function init() {
|
||||
// Activate WC_Order extension.
|
||||
\Automattic\WooCommerce\Admin\Overrides\Order::add_filters();
|
||||
\Automattic\WooCommerce\Admin\Overrides\OrderRefund::add_filters();
|
||||
|
||||
// Order and refund data must be run on these hooks to ensure meta data is set.
|
||||
add_action( 'woocommerce_update_order', array( __CLASS__, 'possibly_schedule_import' ) );
|
||||
add_action( 'woocommerce_create_order', array( __CLASS__, 'possibly_schedule_import' ) );
|
||||
add_action( 'woocommerce_refund_created', array( __CLASS__, 'possibly_schedule_import' ) );
|
||||
|
||||
OrdersStatsDataStore::init();
|
||||
CouponsDataStore::init();
|
||||
ProductsDataStore::init();
|
||||
TaxesDataStore::init();
|
||||
|
||||
parent::init();
|
||||
}
|
||||
|
||||
/**
|
||||
* Add customer dependencies.
|
||||
*
|
||||
* @internal
|
||||
* @return array
|
||||
*/
|
||||
public static function get_dependencies() {
|
||||
return array(
|
||||
'import_batch_init' => \Automattic\WooCommerce\Internal\Admin\Schedulers\CustomersScheduler::get_action( 'import_batch_init' ),
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Get the order/refund IDs and total count that need to be synced.
|
||||
*
|
||||
* @internal
|
||||
* @param int $limit Number of records to retrieve.
|
||||
* @param int $page Page number.
|
||||
* @param int|bool $days Number of days prior to current date to limit search results.
|
||||
* @param bool $skip_existing Skip already imported orders.
|
||||
*/
|
||||
public static function get_items( $limit = 10, $page = 1, $days = false, $skip_existing = false ) {
|
||||
if ( OrderUtil::custom_orders_table_usage_is_enabled() ) {
|
||||
return self::get_items_from_orders_table( $limit, $page, $days, $skip_existing );
|
||||
} else {
|
||||
return self::get_items_from_posts_table( $limit, $page, $days, $skip_existing );
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Helper method to ger order/refund IDS and total count that needs to be synced.
|
||||
*
|
||||
* @internal
|
||||
* @param int $limit Number of records to retrieve.
|
||||
* @param int $page Page number.
|
||||
* @param int|bool $days Number of days prior to current date to limit search results.
|
||||
* @param bool $skip_existing Skip already imported orders.
|
||||
*
|
||||
* @return object Total counts.
|
||||
*/
|
||||
private static function get_items_from_posts_table( $limit, $page, $days, $skip_existing ) {
|
||||
global $wpdb;
|
||||
$where_clause = '';
|
||||
$offset = $page > 1 ? ( $page - 1 ) * $limit : 0;
|
||||
|
||||
if ( is_int( $days ) ) {
|
||||
$days_ago = gmdate( 'Y-m-d 00:00:00', time() - ( DAY_IN_SECONDS * $days ) );
|
||||
$where_clause .= " AND post_date_gmt >= '{$days_ago}'";
|
||||
}
|
||||
|
||||
if ( $skip_existing ) {
|
||||
$where_clause .= " AND NOT EXISTS (
|
||||
SELECT 1 FROM {$wpdb->prefix}wc_order_stats
|
||||
WHERE {$wpdb->prefix}wc_order_stats.order_id = {$wpdb->posts}.ID
|
||||
)";
|
||||
}
|
||||
|
||||
$count = $wpdb->get_var(
|
||||
"SELECT COUNT(*) FROM {$wpdb->posts}
|
||||
WHERE post_type IN ( 'shop_order', 'shop_order_refund' )
|
||||
AND post_status NOT IN ( 'wc-auto-draft', 'auto-draft', 'trash' )
|
||||
{$where_clause}"
|
||||
); // phpcs:ignore unprepared SQL ok.
|
||||
|
||||
$order_ids = absint( $count ) > 0 ? $wpdb->get_col(
|
||||
$wpdb->prepare(
|
||||
"SELECT ID FROM {$wpdb->posts}
|
||||
WHERE post_type IN ( 'shop_order', 'shop_order_refund' )
|
||||
AND post_status NOT IN ( 'wc-auto-draft', 'auto-draft', 'trash' )
|
||||
{$where_clause}
|
||||
ORDER BY post_date_gmt ASC
|
||||
LIMIT %d
|
||||
OFFSET %d",
|
||||
$limit,
|
||||
$offset
|
||||
)
|
||||
) : array(); // phpcs:ignore unprepared SQL ok.
|
||||
|
||||
return (object) array(
|
||||
'total' => absint( $count ),
|
||||
'ids' => $order_ids,
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Helper method to ger order/refund IDS and total count that needs to be synced from HPOS.
|
||||
*
|
||||
* @internal
|
||||
* @param int $limit Number of records to retrieve.
|
||||
* @param int $page Page number.
|
||||
* @param int|bool $days Number of days prior to current date to limit search results.
|
||||
* @param bool $skip_existing Skip already imported orders.
|
||||
*
|
||||
* @return object Total counts.
|
||||
*/
|
||||
private static function get_items_from_orders_table( $limit, $page, $days, $skip_existing ) {
|
||||
global $wpdb;
|
||||
$where_clause = '';
|
||||
$offset = $page > 1 ? ( $page - 1 ) * $limit : 0;
|
||||
$order_table = OrdersTableDataStore::get_orders_table_name();
|
||||
|
||||
if ( is_int( $days ) ) {
|
||||
$days_ago = gmdate( 'Y-m-d 00:00:00', time() - ( DAY_IN_SECONDS * $days ) );
|
||||
$where_clause .= " AND orders.date_created_gmt >= '{$days_ago}'";
|
||||
}
|
||||
|
||||
if ( $skip_existing ) {
|
||||
$where_clause .= "AND NOT EXiSTS (
|
||||
SELECT 1 FROM {$wpdb->prefix}wc_order_stats
|
||||
WHERE {$wpdb->prefix}wc_order_stats.order_id = orders.id
|
||||
)
|
||||
";
|
||||
}
|
||||
|
||||
$count = $wpdb->get_var(
|
||||
"
|
||||
SELECT COUNT(*) FROM {$order_table} AS orders
|
||||
WHERE type in ( 'shop_order', 'shop_order_refund' )
|
||||
AND status NOT IN ( 'wc-auto-draft', 'trash', 'auto-draft' )
|
||||
{$where_clause}
|
||||
"
|
||||
); // phpcs:ignore unprepared SQL ok.
|
||||
|
||||
$order_ids = absint( $count ) > 0 ? $wpdb->get_col(
|
||||
$wpdb->prepare(
|
||||
"SELECT id FROM {$order_table} AS orders
|
||||
WHERE type IN ( 'shop_order', 'shop_order_refund' )
|
||||
AND status NOT IN ( 'wc-auto-draft', 'auto-draft', 'trash' )
|
||||
{$where_clause}
|
||||
ORDER BY date_created_gmt ASC
|
||||
LIMIT %d
|
||||
OFFSET %d",
|
||||
$limit,
|
||||
$offset
|
||||
)
|
||||
) : array(); // phpcs:ignore unprepared SQL ok.
|
||||
|
||||
return (object) array(
|
||||
'total' => absint( $count ),
|
||||
'ids' => $order_ids,
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Get total number of rows imported.
|
||||
*
|
||||
* @internal
|
||||
*/
|
||||
public static function get_total_imported() {
|
||||
global $wpdb;
|
||||
return $wpdb->get_var( "SELECT COUNT(*) FROM {$wpdb->prefix}wc_order_stats" );
|
||||
}
|
||||
|
||||
/**
|
||||
* Schedule this import if the post is an order or refund.
|
||||
*
|
||||
* @param int $order_id Post ID.
|
||||
*
|
||||
* @internal
|
||||
*/
|
||||
public static function possibly_schedule_import( $order_id ) {
|
||||
if ( ! OrderUtil::is_order( $order_id, array( 'shop_order' ) ) && 'woocommerce_refund_created' !== current_filter() ) {
|
||||
return;
|
||||
}
|
||||
|
||||
self::schedule_action( 'import', array( $order_id ) );
|
||||
}
|
||||
|
||||
/**
|
||||
* Imports a single order or refund to update lookup tables for.
|
||||
* If an error is encountered in one of the updates, a retry action is scheduled.
|
||||
*
|
||||
* @internal
|
||||
* @param int $order_id Order or refund ID.
|
||||
* @return void
|
||||
*/
|
||||
public static function import( $order_id ) {
|
||||
$order = wc_get_order( $order_id );
|
||||
|
||||
// If the order isn't found for some reason, skip the sync.
|
||||
if ( ! $order ) {
|
||||
return;
|
||||
}
|
||||
|
||||
$type = $order->get_type();
|
||||
|
||||
// If the order isn't the right type, skip sync.
|
||||
if ( 'shop_order' !== $type && 'shop_order_refund' !== $type ) {
|
||||
return;
|
||||
}
|
||||
|
||||
// If the order has no id or date created, skip sync.
|
||||
if ( ! $order->get_id() || ! $order->get_date_created() ) {
|
||||
return;
|
||||
}
|
||||
|
||||
$results = array(
|
||||
OrdersStatsDataStore::sync_order( $order_id ),
|
||||
ProductsDataStore::sync_order_products( $order_id ),
|
||||
CouponsDataStore::sync_order_coupons( $order_id ),
|
||||
TaxesDataStore::sync_order_taxes( $order_id ),
|
||||
CustomersDataStore::sync_order_customer( $order_id ),
|
||||
);
|
||||
|
||||
if ( 'shop_order' === $type ) {
|
||||
$order_refunds = $order->get_refunds();
|
||||
|
||||
foreach ( $order_refunds as $refund ) {
|
||||
OrdersStatsDataStore::sync_order( $refund->get_id() );
|
||||
}
|
||||
}
|
||||
|
||||
ReportsCache::invalidate();
|
||||
}
|
||||
|
||||
/**
|
||||
* Delete a batch of orders.
|
||||
*
|
||||
* @internal
|
||||
* @param int $batch_size Number of items to delete.
|
||||
* @return void
|
||||
*/
|
||||
public static function delete( $batch_size ) {
|
||||
global $wpdb;
|
||||
|
||||
$order_ids = $wpdb->get_col(
|
||||
$wpdb->prepare(
|
||||
"SELECT order_id FROM {$wpdb->prefix}wc_order_stats ORDER BY order_id ASC LIMIT %d",
|
||||
$batch_size
|
||||
)
|
||||
);
|
||||
|
||||
foreach ( $order_ids as $order_id ) {
|
||||
OrdersStatsDataStore::delete_order( $order_id );
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,324 @@
|
||||
<?php
|
||||
/**
|
||||
* WooCommerce Settings.
|
||||
*/
|
||||
|
||||
namespace Automattic\WooCommerce\Internal\Admin;
|
||||
|
||||
use Automattic\WooCommerce\Admin\API\Plugins;
|
||||
use Automattic\WooCommerce\Admin\PageController;
|
||||
use Automattic\WooCommerce\Admin\API\Reports\Orders\DataStore as OrdersDataStore;
|
||||
use Automattic\WooCommerce\Admin\PluginsHelper;
|
||||
use WC_Marketplace_Suggestions;
|
||||
|
||||
/**
|
||||
* Contains logic in regards to WooCommerce Admin Settings.
|
||||
*/
|
||||
class Settings {
|
||||
|
||||
/**
|
||||
* Class instance.
|
||||
*
|
||||
* @var Settings 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() {
|
||||
// Old settings injection.
|
||||
add_filter( 'woocommerce_components_settings', array( $this, 'add_component_settings' ) );
|
||||
// New settings injection.
|
||||
add_filter( 'woocommerce_admin_shared_settings', array( $this, 'add_component_settings' ) );
|
||||
add_filter( 'woocommerce_settings_groups', array( $this, 'add_settings_group' ) );
|
||||
add_filter( 'woocommerce_settings-wc_admin', array( $this, 'add_settings' ) );
|
||||
}
|
||||
|
||||
/**
|
||||
* Format order statuses by removing a leading 'wc-' if present.
|
||||
*
|
||||
* @param array $statuses Order statuses.
|
||||
* @return array formatted statuses.
|
||||
*/
|
||||
public static function get_order_statuses( $statuses ) {
|
||||
$formatted_statuses = array();
|
||||
foreach ( $statuses as $key => $value ) {
|
||||
$formatted_key = preg_replace( '/^wc-/', '', $key );
|
||||
$formatted_statuses[ $formatted_key ] = $value;
|
||||
}
|
||||
return $formatted_statuses;
|
||||
}
|
||||
|
||||
/**
|
||||
* Get all order statuses present in analytics tables that aren't registered.
|
||||
*
|
||||
* @return array Unregistered order statuses.
|
||||
*/
|
||||
private function get_unregistered_order_statuses() {
|
||||
$registered_statuses = wc_get_order_statuses();
|
||||
$all_synced_statuses = OrdersDataStore::get_all_statuses();
|
||||
$unregistered_statuses = array_diff( $all_synced_statuses, array_keys( $registered_statuses ) );
|
||||
$formatted_status_keys = self::get_order_statuses( array_fill_keys( $unregistered_statuses, '' ) );
|
||||
$formatted_statuses = array_keys( $formatted_status_keys );
|
||||
|
||||
return array_combine( $formatted_statuses, $formatted_statuses );
|
||||
}
|
||||
|
||||
/**
|
||||
* Return an object defining the currecy options for the site's current currency
|
||||
*
|
||||
* @return array Settings for the current currency {
|
||||
* Array of settings.
|
||||
*
|
||||
* @type string $code Currency code.
|
||||
* @type string $precision Number of decimals.
|
||||
* @type string $symbol Symbol for currency.
|
||||
* }
|
||||
*/
|
||||
public static function get_currency_settings() {
|
||||
$code = get_woocommerce_currency();
|
||||
|
||||
//phpcs:ignore
|
||||
return apply_filters(
|
||||
'wc_currency_settings',
|
||||
array(
|
||||
'code' => $code,
|
||||
'precision' => wc_get_price_decimals(),
|
||||
'symbol' => html_entity_decode( get_woocommerce_currency_symbol( $code ) ),
|
||||
'symbolPosition' => get_option( 'woocommerce_currency_pos' ),
|
||||
'decimalSeparator' => wc_get_price_decimal_separator(),
|
||||
'thousandSeparator' => wc_get_price_thousand_separator(),
|
||||
'priceFormat' => html_entity_decode( get_woocommerce_price_format() ),
|
||||
)
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Hooks extra neccessary data into the component settings array already set in WooCommerce core.
|
||||
*
|
||||
* @param array $settings Array of component settings.
|
||||
* @return array Array of component settings.
|
||||
*/
|
||||
public function add_component_settings( $settings ) {
|
||||
if ( ! is_admin() ) {
|
||||
return $settings;
|
||||
}
|
||||
|
||||
if ( ! function_exists( 'wc_blocks_container' ) ) {
|
||||
global $wp_locale;
|
||||
// inject data not available via older versions of wc_blocks/woo.
|
||||
$settings['orderStatuses'] = self::get_order_statuses( wc_get_order_statuses() );
|
||||
$settings['stockStatuses'] = self::get_order_statuses( wc_get_product_stock_status_options() );
|
||||
$settings['currency'] = self::get_currency_settings();
|
||||
$settings['locale'] = array(
|
||||
'siteLocale' => isset( $settings['siteLocale'] )
|
||||
? $settings['siteLocale']
|
||||
: get_locale(),
|
||||
'userLocale' => isset( $settings['l10n']['userLocale'] )
|
||||
? $settings['l10n']['userLocale']
|
||||
: get_user_locale(),
|
||||
'weekdaysShort' => isset( $settings['l10n']['weekdaysShort'] )
|
||||
? $settings['l10n']['weekdaysShort']
|
||||
: array_values( $wp_locale->weekday_abbrev ),
|
||||
);
|
||||
}
|
||||
|
||||
//phpcs:ignore
|
||||
$preload_data_endpoints = apply_filters( 'woocommerce_component_settings_preload_endpoints', array() );
|
||||
if ( class_exists( 'Jetpack' ) ) {
|
||||
$preload_data_endpoints['jetpackStatus'] = '/jetpack/v4/connection';
|
||||
}
|
||||
if ( ! empty( $preload_data_endpoints ) ) {
|
||||
$preload_data = array_reduce(
|
||||
array_values( $preload_data_endpoints ),
|
||||
'rest_preload_api_request'
|
||||
);
|
||||
}
|
||||
|
||||
//phpcs:ignore
|
||||
$preload_options = apply_filters( 'woocommerce_admin_preload_options', array() );
|
||||
if ( ! empty( $preload_options ) ) {
|
||||
foreach ( $preload_options as $option ) {
|
||||
$settings['preloadOptions'][ $option ] = get_option( $option );
|
||||
}
|
||||
}
|
||||
|
||||
//phpcs:ignore
|
||||
$preload_settings = apply_filters( 'woocommerce_admin_preload_settings', array() );
|
||||
if ( ! empty( $preload_settings ) ) {
|
||||
$setting_options = new \WC_REST_Setting_Options_V2_Controller();
|
||||
foreach ( $preload_settings as $group ) {
|
||||
$group_settings = $setting_options->get_group_settings( $group );
|
||||
$preload_settings = array();
|
||||
foreach ( $group_settings as $option ) {
|
||||
if ( array_key_exists( 'id', $option ) && array_key_exists( 'value', $option ) ) {
|
||||
$preload_settings[ $option['id'] ] = $option['value'];
|
||||
}
|
||||
}
|
||||
$settings['preloadSettings'][ $group ] = $preload_settings;
|
||||
}
|
||||
}
|
||||
|
||||
$user_controller = new \WP_REST_Users_Controller();
|
||||
$request = new \WP_REST_Request();
|
||||
$request->set_query_params( array( 'context' => 'edit' ) );
|
||||
$user_response = $user_controller->get_current_item( $request );
|
||||
$current_user_data = is_wp_error( $user_response ) ? (object) array() : $user_response->get_data();
|
||||
|
||||
$settings['currentUserData'] = $current_user_data;
|
||||
$settings['reviewsEnabled'] = get_option( 'woocommerce_enable_reviews' );
|
||||
$settings['manageStock'] = get_option( 'woocommerce_manage_stock' );
|
||||
$settings['commentModeration'] = get_option( 'comment_moderation' );
|
||||
$settings['notifyLowStockAmount'] = get_option( 'woocommerce_notify_low_stock_amount' );
|
||||
|
||||
/**
|
||||
* Deprecate wcAdminAssetUrl as we no longer need it after The Merge.
|
||||
* Use wcAssetUrl instead.
|
||||
*
|
||||
* @deprecated 6.7.0
|
||||
* @var string
|
||||
*/
|
||||
$settings['wcAdminAssetUrl'] = WC_ADMIN_IMAGES_FOLDER_URL;
|
||||
$settings['wcVersion'] = WC_VERSION;
|
||||
$settings['siteUrl'] = site_url();
|
||||
$settings['shopUrl'] = get_permalink( wc_get_page_id( 'shop' ) );
|
||||
$settings['homeUrl'] = home_url();
|
||||
$settings['dateFormat'] = get_option( 'date_format' );
|
||||
$settings['timeZone'] = wc_timezone_string();
|
||||
$settings['plugins'] = array(
|
||||
'installedPlugins' => PluginsHelper::get_installed_plugin_slugs(),
|
||||
'activePlugins' => Plugins::get_active_plugins(),
|
||||
);
|
||||
// Plugins that depend on changing the translation work on the server but not the client -
|
||||
// WooCommerce Branding is an example of this - so pass through the translation of
|
||||
// 'WooCommerce' to wcSettings.
|
||||
$settings['woocommerceTranslation'] = __( 'WooCommerce', 'woocommerce' );
|
||||
// We may have synced orders with a now-unregistered status.
|
||||
// E.g An extension that added statuses is now inactive or removed.
|
||||
$settings['unregisteredOrderStatuses'] = $this->get_unregistered_order_statuses();
|
||||
// The separator used for attributes found in Variation titles.
|
||||
//phpcs:ignore
|
||||
$settings['variationTitleAttributesSeparator'] = apply_filters( 'woocommerce_product_variation_title_attributes_separator', ' - ', new \WC_Product() );
|
||||
|
||||
if ( ! empty( $preload_data_endpoints ) ) {
|
||||
$settings['dataEndpoints'] = isset( $settings['dataEndpoints'] )
|
||||
? $settings['dataEndpoints']
|
||||
: array();
|
||||
foreach ( $preload_data_endpoints as $key => $endpoint ) {
|
||||
// Handle error case: rest_do_request() doesn't guarantee success.
|
||||
if ( empty( $preload_data[ $endpoint ] ) ) {
|
||||
$settings['dataEndpoints'][ $key ] = array();
|
||||
} else {
|
||||
$settings['dataEndpoints'][ $key ] = $preload_data[ $endpoint ]['body'];
|
||||
}
|
||||
}
|
||||
}
|
||||
$settings = $this->get_custom_settings( $settings );
|
||||
if ( PageController::is_embed_page() ) {
|
||||
$settings['embedBreadcrumbs'] = wc_admin_get_breadcrumbs();
|
||||
}
|
||||
|
||||
$settings['allowMarketplaceSuggestions'] = WC_Marketplace_Suggestions::allow_suggestions();
|
||||
$settings['connectNonce'] = wp_create_nonce( 'connect' );
|
||||
$settings['wcpay_welcome_page_connect_nonce'] = wp_create_nonce( 'wcpay-connect' );
|
||||
|
||||
return $settings;
|
||||
}
|
||||
|
||||
/**
|
||||
* Register the admin settings for use in the WC REST API
|
||||
*
|
||||
* @param array $groups Array of setting groups.
|
||||
* @return array
|
||||
*/
|
||||
public function add_settings_group( $groups ) {
|
||||
$groups[] = array(
|
||||
'id' => 'wc_admin',
|
||||
'label' => __( 'WooCommerce Admin', 'woocommerce' ),
|
||||
'description' => __( 'Settings for WooCommerce admin reporting.', 'woocommerce' ),
|
||||
);
|
||||
return $groups;
|
||||
}
|
||||
|
||||
/**
|
||||
* Add WC Admin specific settings
|
||||
*
|
||||
* @param array $settings Array of settings in wc admin group.
|
||||
* @return array
|
||||
*/
|
||||
public function add_settings( $settings ) {
|
||||
$unregistered_statuses = $this->get_unregistered_order_statuses();
|
||||
$registered_statuses = self::get_order_statuses( wc_get_order_statuses() );
|
||||
$all_statuses = array_merge( $unregistered_statuses, $registered_statuses );
|
||||
|
||||
$settings[] = array(
|
||||
'id' => 'woocommerce_excluded_report_order_statuses',
|
||||
'option_key' => 'woocommerce_excluded_report_order_statuses',
|
||||
'label' => __( 'Excluded report order statuses', 'woocommerce' ),
|
||||
'description' => __( 'Statuses that should not be included when calculating report totals.', 'woocommerce' ),
|
||||
'default' => array( 'pending', 'cancelled', 'failed' ),
|
||||
'type' => 'multiselect',
|
||||
'options' => $all_statuses,
|
||||
);
|
||||
$settings[] = array(
|
||||
'id' => 'woocommerce_actionable_order_statuses',
|
||||
'option_key' => 'woocommerce_actionable_order_statuses',
|
||||
'label' => __( 'Actionable order statuses', 'woocommerce' ),
|
||||
'description' => __( 'Statuses that require extra action on behalf of the store admin.', 'woocommerce' ),
|
||||
'default' => array( 'processing', 'on-hold' ),
|
||||
'type' => 'multiselect',
|
||||
'options' => $all_statuses,
|
||||
);
|
||||
$settings[] = array(
|
||||
'id' => 'woocommerce_default_date_range',
|
||||
'option_key' => 'woocommerce_default_date_range',
|
||||
'label' => __( 'Default Date Range', 'woocommerce' ),
|
||||
'description' => __( 'Default Date Range', 'woocommerce' ),
|
||||
'default' => 'period=month&compare=previous_year',
|
||||
'type' => 'text',
|
||||
);
|
||||
$settings[] = array(
|
||||
'id' => 'woocommerce_date_type',
|
||||
'option_key' => 'woocommerce_date_type',
|
||||
'label' => __( 'Date Type', 'woocommerce' ),
|
||||
'description' => __( 'Database date field considered for Revenue and Orders reports', 'woocommerce' ),
|
||||
'type' => 'select',
|
||||
'options' => array(
|
||||
'date_created' => 'date_created',
|
||||
'date_paid' => 'date_paid',
|
||||
'date_completed' => 'date_completed',
|
||||
),
|
||||
);
|
||||
return $settings;
|
||||
}
|
||||
|
||||
/**
|
||||
* Gets custom settings used for WC Admin.
|
||||
*
|
||||
* @param array $settings Array of settings to merge into.
|
||||
* @return array
|
||||
*/
|
||||
private function get_custom_settings( $settings ) {
|
||||
$wc_rest_settings_options_controller = new \WC_REST_Setting_Options_Controller();
|
||||
$wc_admin_group_settings = $wc_rest_settings_options_controller->get_group_settings( 'wc_admin' );
|
||||
$settings['wcAdminSettings'] = array();
|
||||
|
||||
foreach ( $wc_admin_group_settings as $setting ) {
|
||||
if ( ! empty( $setting['id'] ) ) {
|
||||
$settings['wcAdminSettings'][ $setting['id'] ] = $setting['value'];
|
||||
}
|
||||
}
|
||||
return $settings;
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,176 @@
|
||||
<?php
|
||||
/**
|
||||
* WooCommerce Settings.
|
||||
*/
|
||||
|
||||
namespace Automattic\WooCommerce\Internal\Admin;
|
||||
|
||||
use Automattic\WooCommerce\Admin\PageController;
|
||||
|
||||
/**
|
||||
* Contains backend logic for the Settings feature.
|
||||
*/
|
||||
class SettingsNavigationFeature {
|
||||
/**
|
||||
* Option name used to toggle this feature.
|
||||
*/
|
||||
const TOGGLE_OPTION_NAME = 'woocommerce_settings_enabled';
|
||||
|
||||
/**
|
||||
* Class instance.
|
||||
*
|
||||
* @var Settings 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() {
|
||||
if ( ! is_admin() ) {
|
||||
return;
|
||||
}
|
||||
|
||||
add_filter( 'woocommerce_settings_features', array( $this, 'add_feature_toggle' ) );
|
||||
|
||||
if ( 'yes' !== get_option( 'woocommerce_settings_enabled', 'no' ) ) {
|
||||
return;
|
||||
}
|
||||
|
||||
add_filter( 'woocommerce_admin_shared_settings', array( __CLASS__, 'add_component_settings' ) );
|
||||
// Run this after the original WooCommerce settings have been added.
|
||||
add_action( 'admin_menu', array( $this, 'register_pages' ), 60 );
|
||||
add_action( 'init', array( $this, 'redirect_core_settings_pages' ) );
|
||||
}
|
||||
|
||||
/**
|
||||
* Add the necessary data to initially load the WooCommerce Settings pages.
|
||||
*
|
||||
* @param array $settings Array of component settings.
|
||||
* @return array Array of component settings.
|
||||
*/
|
||||
public static function add_component_settings( $settings ) {
|
||||
if ( ! is_admin() ) {
|
||||
return $settings;
|
||||
}
|
||||
|
||||
$setting_pages = \WC_Admin_Settings::get_settings_pages();
|
||||
$pages = array();
|
||||
foreach ( $setting_pages as $setting_page ) {
|
||||
$pages = $setting_page->add_settings_page( $pages );
|
||||
}
|
||||
|
||||
$settings['settingsPages'] = $pages;
|
||||
|
||||
return $settings;
|
||||
}
|
||||
|
||||
/**
|
||||
* Add the feature toggle to the features settings.
|
||||
*
|
||||
* @param array $features Feature sections.
|
||||
* @return array
|
||||
*/
|
||||
public static function add_feature_toggle( $features ) {
|
||||
$features[] = array(
|
||||
'title' => __( 'Settings', 'woocommerce' ),
|
||||
'desc' => __(
|
||||
'Adds the new WooCommerce settings UI.',
|
||||
'woocommerce'
|
||||
),
|
||||
'id' => 'woocommerce_settings_enabled',
|
||||
'type' => 'checkbox',
|
||||
);
|
||||
|
||||
return $features;
|
||||
}
|
||||
|
||||
/**
|
||||
* Registers settings pages.
|
||||
*/
|
||||
public function register_pages() {
|
||||
$controller = PageController::get_instance();
|
||||
|
||||
$setting_pages = \WC_Admin_Settings::get_settings_pages();
|
||||
$settings = array();
|
||||
foreach ( $setting_pages as $setting_page ) {
|
||||
$settings = $setting_page->add_settings_page( $settings );
|
||||
}
|
||||
|
||||
$order = 0;
|
||||
foreach ( $settings as $key => $setting ) {
|
||||
$order += 10;
|
||||
$settings_page = array(
|
||||
'parent' => 'woocommerce-settings',
|
||||
'title' => $setting,
|
||||
'id' => 'settings-' . $key,
|
||||
'path' => "/settings/$key",
|
||||
'nav_args' => array(
|
||||
'capability' => 'manage_woocommerce',
|
||||
'order' => $order,
|
||||
'parent' => 'woocommerce-settings',
|
||||
),
|
||||
);
|
||||
|
||||
// Replace the old menu with the first settings item.
|
||||
if ( 10 === $order ) {
|
||||
$this->replace_settings_page( $settings_page );
|
||||
}
|
||||
|
||||
$controller->register_page( $settings_page );
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Replace the Settings page in the original WooCommerce menu.
|
||||
*
|
||||
* @param array $page Page used to replace the original.
|
||||
*/
|
||||
protected function replace_settings_page( $page ) {
|
||||
global $submenu;
|
||||
|
||||
// Check if WooCommerce parent menu has been registered.
|
||||
if ( ! isset( $submenu['woocommerce'] ) ) {
|
||||
return;
|
||||
}
|
||||
|
||||
foreach ( $submenu['woocommerce'] as &$item ) {
|
||||
// The "slug" (aka the path) is the third item in the array.
|
||||
if ( 0 === strpos( $item[2], 'wc-settings' ) ) {
|
||||
$item[2] = wc_admin_url( "&path={$page['path']}" );
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Redirect the old settings page URLs to the new ones.
|
||||
*/
|
||||
public function redirect_core_settings_pages() {
|
||||
/* phpcs:disable WordPress.Security.NonceVerification */
|
||||
if ( ! isset( $_GET['page'] ) || 'wc-settings' !== $_GET['page'] ) {
|
||||
return;
|
||||
}
|
||||
|
||||
if ( ! current_user_can( 'manage_woocommerce' ) ) {
|
||||
return;
|
||||
}
|
||||
|
||||
$setting_pages = \WC_Admin_Settings::get_settings_pages();
|
||||
$default_setting = isset( $setting_pages[0] ) ? $setting_pages[0]->get_id() : '';
|
||||
$setting = isset( $_GET['tab'] ) ? sanitize_text_field( wp_unslash( $_GET['tab'] ) ) : $default_setting;
|
||||
/* phpcs:enable */
|
||||
|
||||
wp_safe_redirect( wc_admin_url( "&path=/settings/$setting" ) );
|
||||
exit;
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,163 @@
|
||||
<?php
|
||||
/**
|
||||
* WooCommerce Shipping Label banner.
|
||||
*/
|
||||
|
||||
namespace Automattic\WooCommerce\Internal\Admin;
|
||||
|
||||
use Automattic\Jetpack\Connection\Manager as Jetpack_Connection_Manager;
|
||||
|
||||
/**
|
||||
* Shows print shipping label banner on edit order page.
|
||||
*/
|
||||
class ShippingLabelBanner {
|
||||
|
||||
/**
|
||||
* Singleton for the display rules class
|
||||
*
|
||||
* @var ShippingLabelBannerDisplayRules
|
||||
*/
|
||||
private $shipping_label_banner_display_rules;
|
||||
|
||||
/**
|
||||
* Constructor
|
||||
*/
|
||||
public function __construct() {
|
||||
if ( ! is_admin() ) {
|
||||
return;
|
||||
}
|
||||
add_action( 'add_meta_boxes', array( $this, 'add_meta_boxes' ), 6, 2 );
|
||||
}
|
||||
|
||||
/**
|
||||
* Check if WooCommerce Shipping makes sense for this merchant.
|
||||
*
|
||||
* @return bool
|
||||
*/
|
||||
private function should_show_meta_box() {
|
||||
if ( ! $this->shipping_label_banner_display_rules ) {
|
||||
$jetpack_version = null;
|
||||
$jetpack_connected = null;
|
||||
$wcs_version = null;
|
||||
$wcs_tos_accepted = null;
|
||||
|
||||
if ( defined( 'JETPACK__VERSION' ) ) {
|
||||
$jetpack_version = JETPACK__VERSION;
|
||||
}
|
||||
|
||||
if ( class_exists( Jetpack_Connection_Manager::class ) ) {
|
||||
$jetpack_connected = ( new Jetpack_Connection_Manager() )->has_connected_owner();
|
||||
}
|
||||
|
||||
if ( class_exists( '\WC_Connect_Loader' ) ) {
|
||||
$wcs_version = \WC_Connect_Loader::get_wcs_version();
|
||||
}
|
||||
|
||||
if ( class_exists( '\WC_Connect_Options' ) ) {
|
||||
$wcs_tos_accepted = \WC_Connect_Options::get_option( 'tos_accepted' );
|
||||
}
|
||||
|
||||
$incompatible_plugins = class_exists( '\WC_Shipping_Fedex_Init' ) ||
|
||||
class_exists( '\WC_Shipping_UPS_Init' ) ||
|
||||
class_exists( '\WC_Integration_ShippingEasy' ) ||
|
||||
class_exists( '\WC_ShipStation_Integration' );
|
||||
|
||||
$this->shipping_label_banner_display_rules =
|
||||
new ShippingLabelBannerDisplayRules(
|
||||
$jetpack_version,
|
||||
$jetpack_connected,
|
||||
$wcs_version,
|
||||
$wcs_tos_accepted,
|
||||
$incompatible_plugins
|
||||
);
|
||||
}
|
||||
|
||||
return $this->shipping_label_banner_display_rules->should_display_banner();
|
||||
}
|
||||
|
||||
/**
|
||||
* Add metabox to order page.
|
||||
*
|
||||
* @param string $post_type current post type.
|
||||
* @param \WP_Post $post Current post object.
|
||||
*/
|
||||
public function add_meta_boxes( $post_type, $post ) {
|
||||
if ( 'shop_order' !== $post_type ) {
|
||||
return;
|
||||
}
|
||||
$order = wc_get_order( $post );
|
||||
if ( $this->should_show_meta_box() ) {
|
||||
add_meta_box(
|
||||
'woocommerce-admin-print-label',
|
||||
__( 'Shipping Label', 'woocommerce' ),
|
||||
array( $this, 'meta_box' ),
|
||||
null,
|
||||
'normal',
|
||||
'high',
|
||||
array(
|
||||
'context' => 'shipping_label',
|
||||
'order' => $post->ID,
|
||||
'items' => $this->count_shippable_items( $order ),
|
||||
)
|
||||
);
|
||||
add_action( 'admin_enqueue_scripts', array( $this, 'add_print_shipping_label_script' ) );
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Count shippable items
|
||||
*
|
||||
* @param \WC_Order $order Current order.
|
||||
* @return int
|
||||
*/
|
||||
private function count_shippable_items( \WC_Order $order ) {
|
||||
$count = 0;
|
||||
foreach ( $order->get_items() as $item ) {
|
||||
if ( $item instanceof \WC_Order_Item_Product ) {
|
||||
$product = $item->get_product();
|
||||
if ( $product && $product->needs_shipping() ) {
|
||||
$count += $item->get_quantity();
|
||||
}
|
||||
}
|
||||
}
|
||||
return $count;
|
||||
}
|
||||
/**
|
||||
* Adds JS to order page to render shipping banner.
|
||||
*
|
||||
* @param string $hook current page hook.
|
||||
*/
|
||||
public function add_print_shipping_label_script( $hook ) {
|
||||
$rtl = is_rtl() ? '.rtl' : '';
|
||||
wp_enqueue_style(
|
||||
'print-shipping-label-banner-style',
|
||||
WCAdminAssets::get_url( "print-shipping-label-banner/style{$rtl}", 'css' ),
|
||||
array( 'wp-components' ),
|
||||
WCAdminAssets::get_file_version( 'css' )
|
||||
);
|
||||
|
||||
WCAdminAssets::register_script( 'wp-admin-scripts', 'print-shipping-label-banner', true );
|
||||
|
||||
$payload = array(
|
||||
'nonce' => wp_create_nonce( 'wp_rest' ),
|
||||
'baseURL' => get_rest_url(),
|
||||
'wcs_server_connection' => true,
|
||||
);
|
||||
|
||||
wp_localize_script( 'print-shipping-label-banner', 'wcConnectData', $payload );
|
||||
}
|
||||
|
||||
/**
|
||||
* Render placeholder metabox.
|
||||
*
|
||||
* @param \WP_Post $post current post.
|
||||
* @param array $args empty args.
|
||||
*/
|
||||
public function meta_box( $post, $args ) {
|
||||
|
||||
?>
|
||||
<div id="wc-admin-shipping-banner-root" class="woocommerce <?php echo esc_attr( 'wc-admin-shipping-banner' ); ?>" data-args="<?php echo esc_attr( wp_json_encode( $args['args'] ) ); ?>">
|
||||
</div>
|
||||
<?php
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,207 @@
|
||||
<?php
|
||||
/**
|
||||
* WooCommerce Shipping Label Banner Display Rules.
|
||||
*/
|
||||
|
||||
namespace Automattic\WooCommerce\Internal\Admin;
|
||||
|
||||
/**
|
||||
* Determines whether or not the Shipping Label Banner should be displayed
|
||||
*/
|
||||
class ShippingLabelBannerDisplayRules {
|
||||
|
||||
/**
|
||||
* Holds the installed Jetpack version.
|
||||
*
|
||||
* @var string
|
||||
*/
|
||||
private $jetpack_version;
|
||||
|
||||
|
||||
/**
|
||||
* Whether or not the installed Jetpack is connected.
|
||||
*
|
||||
* @var bool
|
||||
*/
|
||||
private $jetpack_connected;
|
||||
|
||||
/**
|
||||
* Holds the installed WooCommerce Shipping & Tax version.
|
||||
*
|
||||
* @var string
|
||||
*/
|
||||
private $wcs_version;
|
||||
|
||||
/**
|
||||
* Whether or not there're plugins installed incompatible with the banner.
|
||||
*
|
||||
* @var bool
|
||||
*/
|
||||
private $no_incompatible_plugins_installed;
|
||||
|
||||
/**
|
||||
* Whether or not the WooCommerce Shipping & Tax ToS has been accepted.
|
||||
*
|
||||
* @var bool
|
||||
*/
|
||||
private $wcs_tos_accepted;
|
||||
|
||||
/**
|
||||
* Minimum supported Jetpack version.
|
||||
*
|
||||
* @var string
|
||||
*/
|
||||
private $min_jetpack_version = '4.4';
|
||||
|
||||
/**
|
||||
* Minimum supported WooCommerce Shipping & Tax version.
|
||||
*
|
||||
* @var string
|
||||
*/
|
||||
private $min_wcs_version = '1.22.5';
|
||||
|
||||
/**
|
||||
* Supported countries by USPS, see: https://webpmt.usps.gov/pmt010.cfm
|
||||
*
|
||||
* @var array
|
||||
*/
|
||||
private $supported_countries = array( 'US', 'AS', 'PR', 'VI', 'GU', 'MP', 'UM', 'FM', 'MH' );
|
||||
|
||||
/**
|
||||
* Array of supported currency codes.
|
||||
*
|
||||
* @var array
|
||||
*/
|
||||
private $supported_currencies = array( 'USD' );
|
||||
|
||||
|
||||
/**
|
||||
* Constructor.
|
||||
*
|
||||
* @param string $jetpack_version Installed Jetpack version to check.
|
||||
* @param bool $jetpack_connected Is Jetpack connected?.
|
||||
* @param string $wcs_version Installed WooCommerce Shipping & Tax version to check.
|
||||
* @param bool $wcs_tos_accepted WooCommerce Shipping & Tax Terms of Service accepted?.
|
||||
* @param bool $incompatible_plugins_installed Are there any incompatible plugins installed?.
|
||||
*/
|
||||
public function __construct( $jetpack_version, $jetpack_connected, $wcs_version, $wcs_tos_accepted, $incompatible_plugins_installed ) {
|
||||
$this->jetpack_version = $jetpack_version;
|
||||
$this->jetpack_connected = $jetpack_connected;
|
||||
$this->wcs_version = $wcs_version;
|
||||
$this->wcs_tos_accepted = $wcs_tos_accepted;
|
||||
$this->no_incompatible_plugins_installed = ! $incompatible_plugins_installed;
|
||||
}
|
||||
|
||||
/**
|
||||
* Determines whether banner is eligible for display (does not include a/b logic).
|
||||
*/
|
||||
public function should_display_banner() {
|
||||
return $this->banner_not_dismissed() &&
|
||||
$this->jetpack_installed_and_active() &&
|
||||
$this->jetpack_up_to_date() &&
|
||||
$this->jetpack_connected &&
|
||||
$this->no_incompatible_plugins_installed &&
|
||||
$this->order_has_shippable_products() &&
|
||||
$this->store_in_us_and_usd() &&
|
||||
( $this->wcs_not_installed() || (
|
||||
$this->wcs_up_to_date() && ! $this->wcs_tos_accepted
|
||||
) );
|
||||
}
|
||||
|
||||
/**
|
||||
* Checks if the banner was not dismissed by the user.
|
||||
*
|
||||
* @return bool
|
||||
*/
|
||||
private function banner_not_dismissed() {
|
||||
$dismissed_timestamp_ms = get_option( 'woocommerce_shipping_dismissed_timestamp' );
|
||||
|
||||
if ( ! is_numeric( $dismissed_timestamp_ms ) ) {
|
||||
return true;
|
||||
}
|
||||
$dismissed_timestamp_ms = intval( $dismissed_timestamp_ms );
|
||||
$dismissed_timestamp = intval( round( $dismissed_timestamp_ms / 1000 ) );
|
||||
$expired_timestamp = $dismissed_timestamp + 24 * 60 * 60; // 24 hours from click time
|
||||
|
||||
$dismissed_for_good = -1 === $dismissed_timestamp_ms;
|
||||
$dismissed_24h = time() < $expired_timestamp;
|
||||
|
||||
return ! $dismissed_for_good && ! $dismissed_24h;
|
||||
}
|
||||
|
||||
/**
|
||||
* Checks if jetpack is installed and active.
|
||||
*
|
||||
* @return bool
|
||||
*/
|
||||
private function jetpack_installed_and_active() {
|
||||
return ! ! $this->jetpack_version;
|
||||
}
|
||||
|
||||
/**
|
||||
* Checks if Jetpack version is supported.
|
||||
*
|
||||
* @return bool
|
||||
*/
|
||||
private function jetpack_up_to_date() {
|
||||
return version_compare( $this->jetpack_version, $this->min_jetpack_version, '>=' );
|
||||
}
|
||||
|
||||
/**
|
||||
* Checks if there's a shippable product in the current order.
|
||||
*
|
||||
* @return bool
|
||||
*/
|
||||
private function order_has_shippable_products() {
|
||||
$post = get_post();
|
||||
if ( ! $post ) {
|
||||
return false;
|
||||
}
|
||||
|
||||
$order = wc_get_order( get_post()->ID );
|
||||
|
||||
if ( ! $order ) {
|
||||
return false;
|
||||
}
|
||||
// At this point (no packaging data), only show if there's at least one existing and shippable product.
|
||||
foreach ( $order->get_items() as $item ) {
|
||||
if ( $item instanceof \WC_Order_Item_Product ) {
|
||||
$product = $item->get_product();
|
||||
|
||||
if ( $product && $product->needs_shipping() ) {
|
||||
return true;
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
return false;
|
||||
}
|
||||
|
||||
/**
|
||||
* Checks if the store is in the US and has its default currency set to USD.
|
||||
*
|
||||
* @return bool
|
||||
*/
|
||||
private function store_in_us_and_usd() {
|
||||
$base_currency = get_woocommerce_currency();
|
||||
$base_location = wc_get_base_location();
|
||||
|
||||
return in_array( $base_currency, $this->supported_currencies, true ) && in_array( $base_location['country'], $this->supported_countries, true );
|
||||
}
|
||||
|
||||
/**
|
||||
* Checks if WooCommerce Shipping & Tax is not installed.
|
||||
*
|
||||
* @return bool
|
||||
*/
|
||||
private function wcs_not_installed() {
|
||||
return ! $this->wcs_version;
|
||||
}
|
||||
|
||||
/**
|
||||
* Checks if WooCommerce Shipping & Tax is up to date.
|
||||
*/
|
||||
private function wcs_up_to_date() {
|
||||
return $this->wcs_version && version_compare( $this->wcs_version, $this->min_wcs_version, '>=' );
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,103 @@
|
||||
<?php
|
||||
/**
|
||||
* Customize Site Health recommendations for WooCommerce.
|
||||
*/
|
||||
|
||||
namespace Automattic\WooCommerce\Internal\Admin;
|
||||
|
||||
defined( 'ABSPATH' ) || exit;
|
||||
|
||||
/**
|
||||
* SiteHealth class.
|
||||
*/
|
||||
class SiteHealth {
|
||||
/**
|
||||
* Class instance.
|
||||
*
|
||||
* @var SiteHealth 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_filter( 'site_status_should_suggest_persistent_object_cache', array( $this, 'should_suggest_persistent_object_cache' ) );
|
||||
}
|
||||
|
||||
/**
|
||||
* Counts specific types of WooCommerce entities to determine if a persistent object cache would be beneficial.
|
||||
*
|
||||
* Note that if all measured WooCommerce entities are below their thresholds, this will return null so that the
|
||||
* other normal WordPress checks will still be run.
|
||||
*
|
||||
* @param true|null $check A non-null value will short-circuit WP's normal tests for this.
|
||||
*
|
||||
* @return true|null True if the store would benefit from a persistent object cache. Otherwise null.
|
||||
*/
|
||||
public function should_suggest_persistent_object_cache( $check ) {
|
||||
// Skip this if some other filter has already determined yes.
|
||||
if ( true === $check ) {
|
||||
return $check;
|
||||
}
|
||||
|
||||
$thresholds = array(
|
||||
'orders' => 100,
|
||||
'products' => 100,
|
||||
);
|
||||
|
||||
foreach ( $thresholds as $key => $threshold ) {
|
||||
try {
|
||||
switch ( $key ) {
|
||||
case 'orders':
|
||||
$orders_query = new \WC_Order_Query(
|
||||
array(
|
||||
'status' => 'any',
|
||||
'limit' => 1,
|
||||
'paginate' => true,
|
||||
'return' => 'ids',
|
||||
)
|
||||
);
|
||||
$orders_results = $orders_query->get_orders();
|
||||
if ( $orders_results->total >= $threshold ) {
|
||||
$check = true;
|
||||
}
|
||||
break;
|
||||
|
||||
case 'products':
|
||||
$products_query = new \WC_Product_Query(
|
||||
array(
|
||||
'status' => 'any',
|
||||
'limit' => 1,
|
||||
'paginate' => true,
|
||||
'return' => 'ids',
|
||||
)
|
||||
);
|
||||
$products_results = $products_query->get_products();
|
||||
if ( $products_results->total >= $threshold ) {
|
||||
$check = true;
|
||||
}
|
||||
break;
|
||||
}
|
||||
} catch ( \Exception $exception ) {
|
||||
break;
|
||||
}
|
||||
|
||||
if ( ! is_null( $check ) ) {
|
||||
break;
|
||||
}
|
||||
}
|
||||
|
||||
return $check;
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,38 @@
|
||||
<?php
|
||||
/**
|
||||
* Survey helper methods.
|
||||
*/
|
||||
|
||||
namespace Automattic\WooCommerce\Internal\Admin;
|
||||
|
||||
defined( 'ABSPATH' ) || exit;
|
||||
|
||||
/**
|
||||
* Survey Class.
|
||||
*/
|
||||
class Survey {
|
||||
/**
|
||||
* Survey URL.
|
||||
*/
|
||||
const SURVEY_URL = 'https://automattic.survey.fm';
|
||||
|
||||
/**
|
||||
* Get a survey's URL from a path.
|
||||
*
|
||||
* @param string $path Path of the survey.
|
||||
* @param array $query Query arguments as key value pairs.
|
||||
* @return string Full URL to survey.
|
||||
*/
|
||||
public static function get_url( $path, $query = array() ) {
|
||||
$url = self::SURVEY_URL . $path;
|
||||
|
||||
$query_args = apply_filters( 'woocommerce_admin_survey_query', $query );
|
||||
|
||||
if ( ! empty( $query_args ) ) {
|
||||
$query_string = http_build_query( $query_args );
|
||||
$url = $url . '?' . $query_string;
|
||||
}
|
||||
|
||||
return $url;
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,217 @@
|
||||
<?php
|
||||
/**
|
||||
* Add additional system status report sections.
|
||||
*/
|
||||
|
||||
namespace Automattic\WooCommerce\Internal\Admin;
|
||||
|
||||
use Automattic\WooCommerce\Admin\Notes\Notes;
|
||||
defined( 'ABSPATH' ) || exit;
|
||||
|
||||
/**
|
||||
* SystemStatusReport class.
|
||||
*/
|
||||
class SystemStatusReport {
|
||||
/**
|
||||
* Class instance.
|
||||
*
|
||||
* @var SystemStatus 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_system_status_report', array( $this, 'system_status_report' ) );
|
||||
}
|
||||
|
||||
/**
|
||||
* Hooks extra necessary sections into the system status report template
|
||||
*/
|
||||
public function system_status_report() {
|
||||
?>
|
||||
<table class="wc_status_table widefat" cellspacing="0">
|
||||
<thead>
|
||||
<tr>
|
||||
<th colspan="5" data-export-label="Admin">
|
||||
<h2>
|
||||
<?php esc_html_e( 'Admin', 'woocommerce' ); ?><?php echo wc_help_tip( esc_html__( 'This section shows details of WC Admin.', 'woocommerce' ) ); ?>
|
||||
</h2>
|
||||
</th>
|
||||
</tr>
|
||||
</thead>
|
||||
<tbody>
|
||||
<?php
|
||||
$this->render_features();
|
||||
$this->render_daily_cron();
|
||||
$this->render_options();
|
||||
$this->render_notes();
|
||||
$this->render_onboarding_state();
|
||||
?>
|
||||
</tbody>
|
||||
</table>
|
||||
<?php
|
||||
}
|
||||
|
||||
/**
|
||||
* Render features rows.
|
||||
*/
|
||||
public function render_features() {
|
||||
/**
|
||||
* Filter the admin feature configs.
|
||||
*
|
||||
* @since 6.5.0
|
||||
*/
|
||||
$features = apply_filters( 'woocommerce_admin_get_feature_config', wc_admin_get_feature_config() );
|
||||
$enabled_features = array_filter( $features );
|
||||
$disabled_features = array_filter(
|
||||
$features,
|
||||
function( $feature ) {
|
||||
return empty( $feature );
|
||||
}
|
||||
);
|
||||
|
||||
?>
|
||||
<tr>
|
||||
<td data-export-label="Enabled Features">
|
||||
<?php esc_html_e( 'Enabled Features', 'woocommerce' ); ?>:
|
||||
</td>
|
||||
<td class="help"><?php echo wc_help_tip( esc_html__( 'Which features are enabled?', 'woocommerce' ) ); /* phpcs:ignore WordPress.XSS.EscapeOutput.OutputNotEscaped */ ?></td>
|
||||
<td>
|
||||
<?php
|
||||
echo esc_html( implode( ', ', array_keys( $enabled_features ) ) )
|
||||
?>
|
||||
</td>
|
||||
</tr>
|
||||
|
||||
<tr>
|
||||
<td data-export-label="Disabled Features">
|
||||
<?php esc_html_e( 'Disabled Features', 'woocommerce' ); ?>:
|
||||
</td>
|
||||
<td class="help"><?php echo wc_help_tip( esc_html__( 'Which features are disabled?', 'woocommerce' ) ); /* phpcs:ignore WordPress.XSS.EscapeOutput.OutputNotEscaped */ ?></td>
|
||||
<td>
|
||||
<?php
|
||||
echo esc_html( implode( ', ', array_keys( $disabled_features ) ) )
|
||||
?>
|
||||
</td>
|
||||
</tr>
|
||||
<?php
|
||||
}
|
||||
|
||||
|
||||
/**
|
||||
* Render daily cron row.
|
||||
*/
|
||||
public function render_daily_cron() {
|
||||
$next_daily_cron = wp_next_scheduled( 'wc_admin_daily' );
|
||||
?>
|
||||
<tr>
|
||||
<td data-export-label="Daily Cron">
|
||||
<?php esc_html_e( 'Daily Cron', 'woocommerce' ); ?>:
|
||||
</td>
|
||||
<td class="help"><?php echo wc_help_tip( esc_html__( 'Is the daily cron job active, when does it next run?', 'woocommerce' ) ); /* phpcs:ignore WordPress.XSS.EscapeOutput.OutputNotEscaped */ ?></td>
|
||||
<td>
|
||||
<?php
|
||||
if ( empty( $next_daily_cron ) ) {
|
||||
echo '<mark class="error"><span class="dashicons dashicons-warning"></span> ' . esc_html__( 'Not scheduled', 'woocommerce' ) . '</mark>';
|
||||
} else {
|
||||
echo '<mark class="yes"><span class="dashicons dashicons-yes"></span> Next scheduled: ' . esc_html( date_i18n( 'Y-m-d H:i:s P', $next_daily_cron ) ) . '</mark>';
|
||||
}
|
||||
?>
|
||||
</td>
|
||||
</tr>
|
||||
<?php
|
||||
}
|
||||
|
||||
/**
|
||||
* Render option row.
|
||||
*/
|
||||
public function render_options() {
|
||||
$woocommerce_admin_install_timestamp = get_option( 'woocommerce_admin_install_timestamp' );
|
||||
|
||||
$all_options_expected = is_numeric( $woocommerce_admin_install_timestamp )
|
||||
&& 0 < (int) $woocommerce_admin_install_timestamp
|
||||
&& is_array( get_option( 'woocommerce_onboarding_profile', array() ) );
|
||||
|
||||
?>
|
||||
<tr>
|
||||
<td data-export-label="Options">
|
||||
<?php esc_html_e( 'Options', 'woocommerce' ); ?>:
|
||||
</td>
|
||||
<td class="help"><?php echo wc_help_tip( esc_html__( 'Do the important options return expected values?', 'woocommerce' ) ); /* phpcs:ignore WordPress.XSS.EscapeOutput.OutputNotEscaped */ ?></td>
|
||||
<td>
|
||||
<?php
|
||||
if ( $all_options_expected ) {
|
||||
echo '<mark class="yes"><span class="dashicons dashicons-yes"></mark>';
|
||||
} else {
|
||||
echo '<mark class="error"><span class="dashicons dashicons-warning"></span> ' . esc_html__( 'Not all expected', 'woocommerce' ) . '</mark>';
|
||||
}
|
||||
?>
|
||||
</td>
|
||||
</tr>
|
||||
<?php
|
||||
}
|
||||
|
||||
/**
|
||||
* Render the notes row.
|
||||
*/
|
||||
public function render_notes() {
|
||||
$notes_count = Notes::get_notes_count();
|
||||
|
||||
?>
|
||||
<tr>
|
||||
<td data-export-label="Notes">
|
||||
<?php esc_html_e( 'Notes', 'woocommerce' ); ?>:
|
||||
</td>
|
||||
<td class="help"><?php echo wc_help_tip( esc_html__( 'How many notes in the database?', 'woocommerce' ) ); /* phpcs:ignore WordPress.XSS.EscapeOutput.OutputNotEscaped */ ?></td>
|
||||
<td>
|
||||
<?php
|
||||
echo esc_html( $notes_count )
|
||||
?>
|
||||
</td>
|
||||
</tr>
|
||||
<?php
|
||||
}
|
||||
|
||||
/**
|
||||
* Render the onboarding state row.
|
||||
*/
|
||||
public function render_onboarding_state() {
|
||||
$onboarding_profile = get_option( 'woocommerce_onboarding_profile', array() );
|
||||
$onboarding_state = '-';
|
||||
|
||||
if ( isset( $onboarding_profile['skipped'] ) && $onboarding_profile['skipped'] ) {
|
||||
$onboarding_state = 'skipped';
|
||||
}
|
||||
|
||||
if ( isset( $onboarding_profile['completed'] ) && $onboarding_profile['completed'] ) {
|
||||
$onboarding_state = 'completed';
|
||||
}
|
||||
|
||||
?>
|
||||
<tr>
|
||||
<td data-export-label="Onboarding">
|
||||
<?php esc_html_e( 'Onboarding', 'woocommerce' ); ?>:
|
||||
</td>
|
||||
<td class="help"><?php echo wc_help_tip( esc_html__( 'Was onboarding completed or skipped?', 'woocommerce' ) ); /* phpcs:ignore WordPress.XSS.EscapeOutput.OutputNotEscaped */ ?></td>
|
||||
<td>
|
||||
<?php
|
||||
echo esc_html( $onboarding_state )
|
||||
?>
|
||||
</td>
|
||||
</tr>
|
||||
<?php
|
||||
}
|
||||
|
||||
}
|
||||
@@ -0,0 +1,362 @@
|
||||
<?php
|
||||
/**
|
||||
* Register the scripts, and handles items needed for managing translations within WooCommerce Admin.
|
||||
*/
|
||||
|
||||
namespace Automattic\WooCommerce\Internal\Admin;
|
||||
|
||||
use Automattic\WooCommerce\Admin\PageController;
|
||||
use Automattic\WooCommerce\Internal\Admin\Loader;
|
||||
|
||||
/**
|
||||
* Translations Class.
|
||||
*/
|
||||
class Translations {
|
||||
|
||||
/**
|
||||
* Class instance.
|
||||
*
|
||||
* @var Translations instance
|
||||
*/
|
||||
protected static $instance = null;
|
||||
|
||||
/**
|
||||
* Get class instance.
|
||||
*/
|
||||
public static function get_instance() {
|
||||
if ( ! self::$instance ) {
|
||||
self::$instance = new self();
|
||||
}
|
||||
return self::$instance;
|
||||
}
|
||||
|
||||
/**
|
||||
* Constructor.
|
||||
* Hooks added here should be removed in `wc_admin_initialize` via the feature plugin.
|
||||
*/
|
||||
public function __construct() {
|
||||
add_action( 'admin_enqueue_scripts', array( $this, 'potentially_load_translation_script_file' ), 15 );
|
||||
|
||||
// Combine JSON translation files (from chunks) when language packs are updated.
|
||||
add_action( 'upgrader_process_complete', array( $this, 'combine_translation_chunk_files' ), 10, 2 );
|
||||
|
||||
// Handler for WooCommerce and WooCommerce Admin plugin activation.
|
||||
add_action( 'woocommerce_activated_plugin', array( $this, 'potentially_generate_translation_strings' ) );
|
||||
add_action( 'activated_plugin', array( $this, 'potentially_generate_translation_strings' ) );
|
||||
}
|
||||
|
||||
/**
|
||||
* Generate a filename to cache translations from JS chunks.
|
||||
*
|
||||
* @param string $domain Text domain.
|
||||
* @param string $locale Locale being retrieved.
|
||||
* @return string Filename.
|
||||
*/
|
||||
private function get_combined_translation_filename( $domain, $locale ) {
|
||||
$filename = implode( '-', array( $domain, $locale, WC_ADMIN_APP ) ) . '.json';
|
||||
|
||||
return $filename;
|
||||
}
|
||||
|
||||
/**
|
||||
* Combines data from translation chunk files based on officially downloaded file format.
|
||||
*
|
||||
* @param array $json_i18n_filenames List of JSON chunk files.
|
||||
* @return array Combined translation chunk data.
|
||||
*/
|
||||
private function combine_official_translation_chunks( $json_i18n_filenames ) {
|
||||
// the filesystem object should be hooked up.
|
||||
global $wp_filesystem;
|
||||
$combined_translation_data = array();
|
||||
|
||||
foreach ( $json_i18n_filenames as $json_filename ) {
|
||||
if ( ! $wp_filesystem->is_readable( $json_filename ) ) {
|
||||
continue;
|
||||
}
|
||||
|
||||
$file_contents = $wp_filesystem->get_contents( $json_filename );
|
||||
$chunk_data = \json_decode( $file_contents, true );
|
||||
|
||||
if ( empty( $chunk_data ) ) {
|
||||
continue;
|
||||
}
|
||||
|
||||
$reference_file = $chunk_data['comment']['reference'];
|
||||
|
||||
// Only combine "app" files (not scripts registered with WP).
|
||||
if (
|
||||
false === strpos( $reference_file, WC_ADMIN_DIST_JS_FOLDER . 'app/index.js' ) &&
|
||||
false === strpos( $reference_file, WC_ADMIN_DIST_JS_FOLDER . 'chunks/' )
|
||||
) {
|
||||
continue;
|
||||
}
|
||||
|
||||
if ( empty( $combined_translation_data ) ) {
|
||||
// Use the first translation file as the base structure.
|
||||
$combined_translation_data = $chunk_data;
|
||||
} else {
|
||||
// Combine all messages from all chunk files.
|
||||
$combined_translation_data['locale_data']['messages'] = array_merge(
|
||||
$combined_translation_data['locale_data']['messages'],
|
||||
$chunk_data['locale_data']['messages']
|
||||
);
|
||||
}
|
||||
}
|
||||
|
||||
// Remove inaccurate reference comment.
|
||||
unset( $combined_translation_data['comment'] );
|
||||
return $combined_translation_data;
|
||||
}
|
||||
|
||||
/**
|
||||
* Combines data from translation chunk files based on user-generated file formats,
|
||||
* such as wp-cli tool or Loco Translate plugin.
|
||||
*
|
||||
* @param array $json_i18n_filenames List of JSON chunk files.
|
||||
* @return array Combined translation chunk data.
|
||||
*/
|
||||
private function combine_user_translation_chunks( $json_i18n_filenames ) {
|
||||
// the filesystem object should be hooked up.
|
||||
global $wp_filesystem;
|
||||
$combined_translation_data = array();
|
||||
|
||||
foreach ( $json_i18n_filenames as $json_filename ) {
|
||||
if ( ! $wp_filesystem->is_readable( $json_filename ) ) {
|
||||
continue;
|
||||
}
|
||||
|
||||
$file_contents = $wp_filesystem->get_contents( $json_filename );
|
||||
$chunk_data = \json_decode( $file_contents, true );
|
||||
|
||||
if ( empty( $chunk_data ) ) {
|
||||
continue;
|
||||
}
|
||||
|
||||
$reference_file = $chunk_data['source'];
|
||||
|
||||
// Only combine "app" files (not scripts registered with WP).
|
||||
if (
|
||||
false === strpos( $reference_file, WC_ADMIN_DIST_JS_FOLDER . 'app/index.js' ) &&
|
||||
false === strpos( $reference_file, WC_ADMIN_DIST_JS_FOLDER . 'chunks/' )
|
||||
) {
|
||||
continue;
|
||||
}
|
||||
|
||||
if ( empty( $combined_translation_data ) ) {
|
||||
// Use the first translation file as the base structure.
|
||||
$combined_translation_data = $chunk_data;
|
||||
} else {
|
||||
// Combine all messages from all chunk files.
|
||||
$combined_translation_data['locale_data']['woocommerce'] = array_merge(
|
||||
$combined_translation_data['locale_data']['woocommerce'],
|
||||
$chunk_data['locale_data']['woocommerce']
|
||||
);
|
||||
}
|
||||
}
|
||||
|
||||
// Remove inaccurate reference comment.
|
||||
unset( $combined_translation_data['source'] );
|
||||
return $combined_translation_data;
|
||||
}
|
||||
|
||||
/**
|
||||
* Find and combine translation chunk files.
|
||||
*
|
||||
* Only targets files that aren't represented by a registered script (e.g. not passed to wp_register_script()).
|
||||
*
|
||||
* @param string $lang_dir Path to language files.
|
||||
* @param string $domain Text domain.
|
||||
* @param string $locale Locale being retrieved.
|
||||
* @return array Combined translation chunk data.
|
||||
*/
|
||||
private function get_translation_chunk_data( $lang_dir, $domain, $locale ) {
|
||||
// So long as this function is called during the 'upgrader_process_complete' action,
|
||||
// the filesystem object should be hooked up.
|
||||
global $wp_filesystem;
|
||||
|
||||
// Grab all JSON files in the current language pack.
|
||||
$json_i18n_filenames = glob( $lang_dir . $domain . '-' . $locale . '-*.json' );
|
||||
$combined_translation_data = array();
|
||||
|
||||
if ( false === $json_i18n_filenames ) {
|
||||
return $combined_translation_data;
|
||||
}
|
||||
|
||||
// Use first JSON file to determine file format. This check is required due to
|
||||
// file format difference between official language files and user translated files.
|
||||
$format_determine_file = reset( $json_i18n_filenames );
|
||||
|
||||
if ( ! $wp_filesystem->is_readable( $format_determine_file ) ) {
|
||||
return $combined_translation_data;
|
||||
}
|
||||
|
||||
$file_contents = $wp_filesystem->get_contents( $format_determine_file );
|
||||
$format_determine_data = \json_decode( $file_contents, true );
|
||||
|
||||
if ( empty( $format_determine_data ) ) {
|
||||
return $combined_translation_data;
|
||||
}
|
||||
|
||||
if ( isset( $format_determine_data['comment'] ) ) {
|
||||
return $this->combine_official_translation_chunks( $json_i18n_filenames );
|
||||
} elseif ( isset( $format_determine_data['source'] ) ) {
|
||||
return $this->combine_user_translation_chunks( $json_i18n_filenames );
|
||||
} else {
|
||||
return $combined_translation_data;
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Combine and save translations for a specific locale.
|
||||
*
|
||||
* Note that this assumes \WP_Filesystem is already initialized with write access.
|
||||
*
|
||||
* @param string $language_dir Path to language files.
|
||||
* @param string $plugin_domain Text domain.
|
||||
* @param string $locale Locale being retrieved.
|
||||
*/
|
||||
private function build_and_save_translations( $language_dir, $plugin_domain, $locale ) {
|
||||
global $wp_filesystem;
|
||||
$translations_from_chunks = $this->get_translation_chunk_data( $language_dir, $plugin_domain, $locale );
|
||||
|
||||
if ( empty( $translations_from_chunks ) ) {
|
||||
return;
|
||||
}
|
||||
|
||||
$cache_filename = $this->get_combined_translation_filename( $plugin_domain, $locale );
|
||||
$chunk_translations_json = wp_json_encode( $translations_from_chunks );
|
||||
|
||||
// Cache combined translations strings to a file.
|
||||
$wp_filesystem->put_contents( $language_dir . $cache_filename, $chunk_translations_json );
|
||||
}
|
||||
|
||||
/**
|
||||
* Combine translation chunks when plugin is activated.
|
||||
*
|
||||
* This function combines JSON translation data auto-extracted by GlotPress
|
||||
* from Webpack-generated JS chunks into a single file. This is necessary
|
||||
* since the JS chunks are not known to WordPress via wp_register_script()
|
||||
* and wp_set_script_translations().
|
||||
*/
|
||||
private function generate_translation_strings() {
|
||||
$plugin_domain = explode( '/', plugin_basename( __FILE__ ) )[0];
|
||||
$locale = determine_locale();
|
||||
$lang_dir = WP_LANG_DIR . '/plugins/';
|
||||
|
||||
// Bail early if not localized.
|
||||
if ( 'en_US' === $locale ) {
|
||||
return;
|
||||
}
|
||||
|
||||
if ( ! function_exists( 'get_filesystem_method' ) ) {
|
||||
require_once ABSPATH . 'wp-admin/includes/file.php';
|
||||
}
|
||||
|
||||
$access_type = get_filesystem_method();
|
||||
if ( 'direct' === $access_type ) {
|
||||
\WP_Filesystem();
|
||||
$this->build_and_save_translations( $lang_dir, $plugin_domain, $locale );
|
||||
} else {
|
||||
// I'm reluctant to add support for other filesystems here as it would require
|
||||
// user's input on activating plugin - which I don't think is common.
|
||||
return;
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Loads the required translation scripts on the correct pages.
|
||||
*/
|
||||
public function potentially_load_translation_script_file() {
|
||||
if ( ! PageController::is_admin_or_embed_page() ) {
|
||||
return;
|
||||
}
|
||||
|
||||
// Grab translation strings from Webpack-generated chunks.
|
||||
add_filter( 'load_script_translation_file', array( $this, 'load_script_translation_file' ), 10, 3 );
|
||||
}
|
||||
|
||||
/**
|
||||
* Load translation strings from language packs for dynamic imports.
|
||||
*
|
||||
* @param string $file File location for the script being translated.
|
||||
* @param string $handle Script handle.
|
||||
* @param string $domain Text domain.
|
||||
*
|
||||
* @return string New file location for the script being translated.
|
||||
*/
|
||||
public function load_script_translation_file( $file, $handle, $domain ) {
|
||||
// Make sure the main app script is being loaded.
|
||||
if ( WC_ADMIN_APP !== $handle ) {
|
||||
return $file;
|
||||
}
|
||||
|
||||
// Make sure we're handing the correct domain (could be woocommerce or woocommerce-admin).
|
||||
$plugin_domain = explode( '/', plugin_basename( __FILE__ ) )[0];
|
||||
if ( $plugin_domain !== $domain ) {
|
||||
return $file;
|
||||
}
|
||||
|
||||
$locale = determine_locale();
|
||||
$cache_filename = $this->get_combined_translation_filename( $domain, $locale );
|
||||
|
||||
return WP_LANG_DIR . '/plugins/' . $cache_filename;
|
||||
}
|
||||
|
||||
/**
|
||||
* Run when plugin is activated (can be WooCommerce or WooCommerce Admin).
|
||||
*
|
||||
* @param string $filename Activated plugin filename.
|
||||
*/
|
||||
public function potentially_generate_translation_strings( $filename ) {
|
||||
$plugin_domain = explode( '/', plugin_basename( __FILE__ ) )[0];
|
||||
$activated_plugin_domain = explode( '/', $filename )[0];
|
||||
|
||||
// Ensure we're only running only on activation hook that originates from our plugin.
|
||||
if ( $plugin_domain === $activated_plugin_domain ) {
|
||||
$this->generate_translation_strings();
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Combine translation chunks when files are updated.
|
||||
*
|
||||
* This function combines JSON translation data auto-extracted by GlotPress
|
||||
* from Webpack-generated JS chunks into a single file that can be used in
|
||||
* subsequent requests. This is necessary since the JS chunks are not known
|
||||
* to WordPress via wp_register_script() and wp_set_script_translations().
|
||||
*
|
||||
* @param Language_Pack_Upgrader $instance Upgrader instance.
|
||||
* @param array $hook_extra Info about the upgraded language packs.
|
||||
*/
|
||||
public function combine_translation_chunk_files( $instance, $hook_extra ) {
|
||||
if (
|
||||
! is_a( $instance, 'Language_Pack_Upgrader' ) ||
|
||||
! isset( $hook_extra['translations'] ) ||
|
||||
! is_array( $hook_extra['translations'] )
|
||||
) {
|
||||
return;
|
||||
}
|
||||
|
||||
// Make sure we're handing the correct domain (could be woocommerce or woocommerce-admin).
|
||||
$plugin_domain = explode( '/', plugin_basename( __FILE__ ) )[0];
|
||||
$locales = array();
|
||||
$language_dir = WP_LANG_DIR . '/plugins/';
|
||||
|
||||
// Gather the locales that were updated in this operation.
|
||||
foreach ( $hook_extra['translations'] as $translation ) {
|
||||
if (
|
||||
'plugin' === $translation['type'] &&
|
||||
$plugin_domain === $translation['slug']
|
||||
) {
|
||||
$locales[] = $translation['language'];
|
||||
}
|
||||
}
|
||||
|
||||
// Build combined translation files for all updated locales.
|
||||
foreach ( $locales as $locale ) {
|
||||
// So long as this function is hooked to the 'upgrader_process_complete' action,
|
||||
// WP_Filesystem should be hooked up to be able to call build_and_save_translations.
|
||||
$this->build_and_save_translations( $language_dir, $plugin_domain, $locale );
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,425 @@
|
||||
<?php
|
||||
/**
|
||||
* Register the scripts, and styles used within WooCommerce Admin.
|
||||
*/
|
||||
|
||||
namespace Automattic\WooCommerce\Internal\Admin;
|
||||
|
||||
use _WP_Dependency;
|
||||
use Automattic\WooCommerce\Admin\Features\Features;
|
||||
use Automattic\WooCommerce\Admin\PageController;
|
||||
use Automattic\WooCommerce\Internal\Admin\Loader;
|
||||
|
||||
/**
|
||||
* WCAdminAssets Class.
|
||||
*/
|
||||
class WCAdminAssets {
|
||||
|
||||
/**
|
||||
* Class instance.
|
||||
*
|
||||
* @var WCAdminAssets instance
|
||||
*/
|
||||
protected static $instance = null;
|
||||
|
||||
/**
|
||||
* Get class instance.
|
||||
*/
|
||||
public static function get_instance() {
|
||||
if ( ! self::$instance ) {
|
||||
self::$instance = new self();
|
||||
}
|
||||
return self::$instance;
|
||||
}
|
||||
|
||||
/**
|
||||
* Constructor.
|
||||
* Hooks added here should be removed in `wc_admin_initialize` via the feature plugin.
|
||||
*/
|
||||
public function __construct() {
|
||||
Features::get_instance();
|
||||
add_action( 'admin_enqueue_scripts', array( $this, 'register_scripts' ) );
|
||||
|
||||
add_action( 'admin_enqueue_scripts', array( $this, 'inject_wc_settings_dependencies' ), 14 );
|
||||
add_action( 'admin_enqueue_scripts', array( $this, 'enqueue_assets' ), 15 );
|
||||
}
|
||||
|
||||
/**
|
||||
* Gets the path for the asset depending on file type.
|
||||
*
|
||||
* @param string $ext File extension.
|
||||
* @return string Folder path of asset.
|
||||
*/
|
||||
public static function get_path( $ext ) {
|
||||
return ( $ext === 'css' ) ? WC_ADMIN_DIST_CSS_FOLDER : WC_ADMIN_DIST_JS_FOLDER;
|
||||
}
|
||||
|
||||
/**
|
||||
* Determines if a minified JS file should be served.
|
||||
*
|
||||
* @param boolean $script_debug Only serve unminified files if script debug is on.
|
||||
* @return boolean If js asset should use minified version.
|
||||
*/
|
||||
public static function should_use_minified_js_file( $script_debug ) {
|
||||
// minified files are only shipped in non-core versions of wc-admin, return false if minified files are not available.
|
||||
if ( ! Features::exists( 'minified-js' ) ) {
|
||||
return false;
|
||||
}
|
||||
|
||||
// Otherwise we will serve un-minified files if SCRIPT_DEBUG is on, or if anything truthy is passed in-lieu of SCRIPT_DEBUG.
|
||||
return ! $script_debug;
|
||||
}
|
||||
|
||||
/**
|
||||
* Gets the URL to an asset file.
|
||||
*
|
||||
* @param string $file File name (without extension).
|
||||
* @param string $ext File extension.
|
||||
* @return string URL to asset.
|
||||
*/
|
||||
public static function get_url( $file, $ext ) {
|
||||
$suffix = '';
|
||||
|
||||
// Potentially enqueue minified JavaScript.
|
||||
if ( $ext === 'js' ) {
|
||||
$script_debug = defined( 'SCRIPT_DEBUG' ) && SCRIPT_DEBUG;
|
||||
$suffix = self::should_use_minified_js_file( $script_debug ) ? '.min' : '';
|
||||
}
|
||||
|
||||
return plugins_url( self::get_path( $ext ) . $file . $suffix . '.' . $ext, WC_ADMIN_PLUGIN_FILE );
|
||||
}
|
||||
|
||||
/**
|
||||
* Gets the file modified time as a cache buster if we're in dev mode, or the plugin version otherwise.
|
||||
*
|
||||
* @param string $ext File extension.
|
||||
* @return string The cache buster value to use for the given file.
|
||||
*/
|
||||
public static function get_file_version( $ext ) {
|
||||
if ( defined( 'SCRIPT_DEBUG' ) && SCRIPT_DEBUG ) {
|
||||
return filemtime( WC_ADMIN_ABSPATH . self::get_path( $ext ) );
|
||||
}
|
||||
return WC_VERSION;
|
||||
}
|
||||
|
||||
/**
|
||||
* Gets a script asset registry filename. The asset registry lists dependencies for the given script.
|
||||
*
|
||||
* @param string $script_path_name Path to where the script asset registry is contained.
|
||||
* @param string $file File name (without extension).
|
||||
* @return string complete asset filename.
|
||||
*
|
||||
* @throws \Exception Throws an exception when a readable asset registry file cannot be found.
|
||||
*/
|
||||
public static function get_script_asset_filename( $script_path_name, $file ) {
|
||||
$minification_supported = Features::exists( 'minified-js' );
|
||||
$script_min_filename = $file . '.min.asset.php';
|
||||
$script_nonmin_filename = $file . '.asset.php';
|
||||
$script_asset_path = WC_ADMIN_ABSPATH . WC_ADMIN_DIST_JS_FOLDER . $script_path_name . '/';
|
||||
|
||||
// Check minification is supported first, to avoid multiple is_readable checks when minification is
|
||||
// not supported.
|
||||
if ( $minification_supported && is_readable( $script_asset_path . $script_min_filename ) ) {
|
||||
return $script_min_filename;
|
||||
} elseif ( is_readable( $script_asset_path . $script_nonmin_filename ) ) {
|
||||
return $script_nonmin_filename;
|
||||
} else {
|
||||
// could not find an asset file, throw an error.
|
||||
throw new \Exception( 'Could not find asset registry for ' . $script_path_name );
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Render a preload link tag for a dependency, optionally
|
||||
* checked against a provided allowlist.
|
||||
*
|
||||
* See: https://macarthur.me/posts/preloading-javascript-in-wordpress
|
||||
*
|
||||
* @param WP_Dependency $dependency The WP_Dependency being preloaded.
|
||||
* @param string $type Dependency type - 'script' or 'style'.
|
||||
* @param array $allowlist Optional. List of allowed dependency handles.
|
||||
*/
|
||||
private function maybe_output_preload_link_tag( $dependency, $type, $allowlist = array() ) {
|
||||
if (
|
||||
(
|
||||
! empty( $allowlist ) &&
|
||||
! in_array( $dependency->handle, $allowlist, true )
|
||||
) ||
|
||||
( ! empty( $this->preloaded_dependencies[ $type ] ) &&
|
||||
in_array( $dependency->handle, $this->preloaded_dependencies[ $type ], true ) )
|
||||
) {
|
||||
return;
|
||||
}
|
||||
|
||||
$this->preloaded_dependencies[ $type ][] = $dependency->handle;
|
||||
|
||||
$source = $dependency->ver ? add_query_arg( 'ver', $dependency->ver, $dependency->src ) : $dependency->src;
|
||||
|
||||
echo '<link rel="preload" href="', esc_url( $source ), '" as="', esc_attr( $type ), '" />', "\n";
|
||||
}
|
||||
|
||||
/**
|
||||
* Output a preload link tag for dependencies (and their sub dependencies)
|
||||
* with an optional allowlist.
|
||||
*
|
||||
* See: https://macarthur.me/posts/preloading-javascript-in-wordpress
|
||||
*
|
||||
* @param string $type Dependency type - 'script' or 'style'.
|
||||
* @param array $allowlist Optional. List of allowed dependency handles.
|
||||
*/
|
||||
private function output_header_preload_tags_for_type( $type, $allowlist = array() ) {
|
||||
if ( $type === 'script' ) {
|
||||
$dependencies_of_type = wp_scripts();
|
||||
} elseif ( $type === 'style' ) {
|
||||
$dependencies_of_type = wp_styles();
|
||||
} else {
|
||||
return;
|
||||
}
|
||||
|
||||
foreach ( $dependencies_of_type->queue as $dependency_handle ) {
|
||||
$dependency = $dependencies_of_type->query( $dependency_handle, 'registered' );
|
||||
|
||||
if ( $dependency === false ) {
|
||||
continue;
|
||||
}
|
||||
|
||||
// Preload the subdependencies first.
|
||||
foreach ( $dependency->deps as $sub_dependency_handle ) {
|
||||
$sub_dependency = $dependencies_of_type->query( $sub_dependency_handle, 'registered' );
|
||||
|
||||
if ( $sub_dependency ) {
|
||||
$this->maybe_output_preload_link_tag( $sub_dependency, $type, $allowlist );
|
||||
}
|
||||
}
|
||||
|
||||
$this->maybe_output_preload_link_tag( $dependency, $type, $allowlist );
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Output preload link tags for all enqueued stylesheets and scripts.
|
||||
*
|
||||
* See: https://macarthur.me/posts/preloading-javascript-in-wordpress
|
||||
*/
|
||||
private function output_header_preload_tags() {
|
||||
$wc_admin_scripts = array(
|
||||
WC_ADMIN_APP,
|
||||
'wc-components',
|
||||
);
|
||||
|
||||
$wc_admin_styles = array(
|
||||
WC_ADMIN_APP,
|
||||
'wc-components',
|
||||
'wc-material-icons',
|
||||
);
|
||||
|
||||
// Preload styles.
|
||||
$this->output_header_preload_tags_for_type( 'style', $wc_admin_styles );
|
||||
|
||||
// Preload scripts.
|
||||
$this->output_header_preload_tags_for_type( 'script', $wc_admin_scripts );
|
||||
}
|
||||
|
||||
/**
|
||||
* Loads the required scripts on the correct pages.
|
||||
*/
|
||||
public function enqueue_assets() {
|
||||
if ( ! PageController::is_admin_or_embed_page() ) {
|
||||
return;
|
||||
}
|
||||
|
||||
wp_enqueue_script( WC_ADMIN_APP );
|
||||
wp_enqueue_style( WC_ADMIN_APP );
|
||||
wp_enqueue_style( 'wc-material-icons' );
|
||||
wp_enqueue_style( 'wc-onboarding' );
|
||||
|
||||
// Preload our assets.
|
||||
$this->output_header_preload_tags();
|
||||
}
|
||||
|
||||
/**
|
||||
* Registers all the neccessary scripts and styles to show the admin experience.
|
||||
*/
|
||||
public function register_scripts() {
|
||||
if ( ! function_exists( 'wp_set_script_translations' ) ) {
|
||||
return;
|
||||
}
|
||||
|
||||
$js_file_version = self::get_file_version( 'js' );
|
||||
$css_file_version = self::get_file_version( 'css' );
|
||||
|
||||
$scripts = array(
|
||||
'wc-admin-layout',
|
||||
'wc-explat',
|
||||
'wc-experimental',
|
||||
'wc-customer-effort-score',
|
||||
// NOTE: This should be removed when Gutenberg is updated and the notices package is removed from WooCommerce Admin.
|
||||
'wc-notices',
|
||||
'wc-number',
|
||||
'wc-tracks',
|
||||
'wc-date',
|
||||
'wc-components',
|
||||
WC_ADMIN_APP,
|
||||
'wc-csv',
|
||||
'wc-store-data',
|
||||
'wc-currency',
|
||||
'wc-navigation',
|
||||
'wc-product-editor',
|
||||
);
|
||||
|
||||
$scripts_map = array(
|
||||
WC_ADMIN_APP => 'app',
|
||||
'wc-csv' => 'csv-export',
|
||||
'wc-store-data' => 'data',
|
||||
);
|
||||
|
||||
$translated_scripts = array(
|
||||
'wc-currency',
|
||||
'wc-date',
|
||||
'wc-components',
|
||||
'wc-customer-effort-score',
|
||||
WC_ADMIN_APP,
|
||||
);
|
||||
|
||||
foreach ( $scripts as $script ) {
|
||||
$script_path_name = isset( $scripts_map[ $script ] ) ? $scripts_map[ $script ] : str_replace( 'wc-', '', $script );
|
||||
|
||||
try {
|
||||
$script_assets_filename = self::get_script_asset_filename( $script_path_name, 'index' );
|
||||
$script_assets = require WC_ADMIN_ABSPATH . WC_ADMIN_DIST_JS_FOLDER . $script_path_name . '/' . $script_assets_filename;
|
||||
|
||||
wp_register_script(
|
||||
$script,
|
||||
self::get_url( $script_path_name . '/index', 'js' ),
|
||||
$script_assets ['dependencies'],
|
||||
$js_file_version,
|
||||
true
|
||||
);
|
||||
|
||||
if ( in_array( $script, $translated_scripts, true ) ) {
|
||||
wp_set_script_translations( $script, 'woocommerce' );
|
||||
}
|
||||
} catch ( \Exception $e ) {
|
||||
// Avoid crashing WordPress if an asset file could not be loaded.
|
||||
wc_caught_exception( $e, __CLASS__ . '::' . __FUNCTION__, $script_path_name );
|
||||
}
|
||||
}
|
||||
|
||||
wp_register_style(
|
||||
'wc-admin-layout',
|
||||
self::get_url( 'admin-layout/style', 'css' ),
|
||||
array(),
|
||||
$css_file_version
|
||||
);
|
||||
wp_style_add_data( 'wc-admin-layout', 'rtl', 'replace' );
|
||||
|
||||
wp_register_style(
|
||||
'wc-components',
|
||||
self::get_url( 'components/style', 'css' ),
|
||||
array(),
|
||||
$css_file_version
|
||||
);
|
||||
wp_style_add_data( 'wc-components', 'rtl', 'replace' );
|
||||
|
||||
wp_register_style(
|
||||
'wc-product-editor',
|
||||
self::get_url( 'product-editor/style', 'css' ),
|
||||
array(),
|
||||
$css_file_version
|
||||
);
|
||||
wp_style_add_data( 'wc-product-editor', 'rtl', 'replace' );
|
||||
|
||||
wp_register_style(
|
||||
'wc-customer-effort-score',
|
||||
self::get_url( 'customer-effort-score/style', 'css' ),
|
||||
array(),
|
||||
$css_file_version
|
||||
);
|
||||
wp_style_add_data( 'wc-customer-effort-score', 'rtl', 'replace' );
|
||||
|
||||
wp_register_style(
|
||||
'wc-experimental',
|
||||
self::get_url( 'experimental/style', 'css' ),
|
||||
array(),
|
||||
$css_file_version
|
||||
);
|
||||
wp_style_add_data( 'wc-experimental', 'rtl', 'replace' );
|
||||
|
||||
wp_localize_script(
|
||||
WC_ADMIN_APP,
|
||||
'wcAdminAssets',
|
||||
array(
|
||||
'path' => plugins_url( self::get_path( 'js' ), WC_ADMIN_PLUGIN_FILE ),
|
||||
'version' => $js_file_version,
|
||||
)
|
||||
);
|
||||
|
||||
wp_register_style(
|
||||
WC_ADMIN_APP,
|
||||
self::get_url( 'app/style', 'css' ),
|
||||
array( 'wc-components', 'wc-admin-layout', 'wc-customer-effort-score', 'wc-product-editor', 'wp-components', 'wc-experimental' ),
|
||||
$css_file_version
|
||||
);
|
||||
wp_style_add_data( WC_ADMIN_APP, 'rtl', 'replace' );
|
||||
|
||||
wp_register_style(
|
||||
'wc-onboarding',
|
||||
self::get_url( 'onboarding/style', 'css' ),
|
||||
array(),
|
||||
$css_file_version
|
||||
);
|
||||
wp_style_add_data( 'wc-onboarding', 'rtl', 'replace' );
|
||||
}
|
||||
|
||||
/**
|
||||
* Injects wp-shared-settings as a dependency if it's present.
|
||||
*/
|
||||
public function inject_wc_settings_dependencies() {
|
||||
if ( wp_script_is( 'wc-settings', 'registered' ) ) {
|
||||
$handles_for_injection = [
|
||||
'wc-admin-layout',
|
||||
'wc-csv',
|
||||
'wc-currency',
|
||||
'wc-customer-effort-score',
|
||||
'wc-navigation',
|
||||
// NOTE: This should be removed when Gutenberg is updated and
|
||||
// the notices package is removed from WooCommerce Admin.
|
||||
'wc-notices',
|
||||
'wc-number',
|
||||
'wc-date',
|
||||
'wc-components',
|
||||
'wc-tracks',
|
||||
'wc-product-editor',
|
||||
];
|
||||
foreach ( $handles_for_injection as $handle ) {
|
||||
$script = wp_scripts()->query( $handle, 'registered' );
|
||||
if ( $script instanceof _WP_Dependency ) {
|
||||
$script->deps[] = 'wc-settings';
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Loads a script
|
||||
*
|
||||
* @param string $script_path_name The script path name.
|
||||
* @param string $script_name Filename of the script to load.
|
||||
* @param bool $need_translation Whether the script need translations.
|
||||
*/
|
||||
public static function register_script( $script_path_name, $script_name, $need_translation = false ) {
|
||||
$script_assets_filename = self::get_script_asset_filename( $script_path_name, $script_name );
|
||||
$script_assets = require WC_ADMIN_ABSPATH . WC_ADMIN_DIST_JS_FOLDER . $script_path_name . '/' . $script_assets_filename;
|
||||
|
||||
wp_enqueue_script(
|
||||
'wc-admin-' . $script_name,
|
||||
self::get_url( $script_path_name . '/' . $script_name, 'js' ),
|
||||
array_merge( array( WC_ADMIN_APP ), $script_assets ['dependencies'] ),
|
||||
self::get_file_version( 'js' ),
|
||||
true
|
||||
);
|
||||
if ( $need_translation ) {
|
||||
wp_set_script_translations( 'wc-admin-' . $script_name, 'woocommerce' );
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,68 @@
|
||||
<?php
|
||||
/**
|
||||
* Manages the WC Admin settings that need to be pre-loaded.
|
||||
*/
|
||||
|
||||
namespace Automattic\WooCommerce\Internal\Admin;
|
||||
|
||||
defined( 'ABSPATH' ) || exit;
|
||||
|
||||
/**
|
||||
* \Automattic\WooCommerce\Internal\Admin\WCAdminSharedSettings class.
|
||||
*/
|
||||
class WCAdminSharedSettings {
|
||||
/**
|
||||
* Settings prefix used for the window.wcSettings object.
|
||||
*
|
||||
* @var string
|
||||
*/
|
||||
private $settings_prefix = 'admin';
|
||||
|
||||
/**
|
||||
* Class instance.
|
||||
*
|
||||
* @var WCAdminSharedSettings instance
|
||||
*/
|
||||
protected static $instance = null;
|
||||
|
||||
/**
|
||||
* Hook into WooCommerce Blocks.
|
||||
*/
|
||||
protected function __construct() {
|
||||
if ( did_action( 'woocommerce_blocks_loaded' ) ) {
|
||||
$this->on_woocommerce_blocks_loaded();
|
||||
} else {
|
||||
add_action( 'woocommerce_blocks_loaded', array( $this, 'on_woocommerce_blocks_loaded' ), 10 );
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Get class instance.
|
||||
*
|
||||
* @return object Instance.
|
||||
*/
|
||||
public static function get_instance() {
|
||||
if ( null === self::$instance ) {
|
||||
self::$instance = new self();
|
||||
}
|
||||
return self::$instance;
|
||||
}
|
||||
|
||||
/**
|
||||
* Adds settings to the Blocks AssetDataRegistry when woocommerce_blocks is loaded.
|
||||
*
|
||||
* @return void
|
||||
*/
|
||||
public function on_woocommerce_blocks_loaded() {
|
||||
if ( class_exists( '\Automattic\WooCommerce\Blocks\Assets\AssetDataRegistry' ) ) {
|
||||
\Automattic\WooCommerce\Blocks\Package::container()->get( \Automattic\WooCommerce\Blocks\Assets\AssetDataRegistry::class )->add(
|
||||
$this->settings_prefix,
|
||||
function() {
|
||||
return apply_filters( 'woocommerce_admin_shared_settings', array() );
|
||||
},
|
||||
true
|
||||
);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
@@ -0,0 +1,152 @@
|
||||
<?php
|
||||
|
||||
namespace Automattic\WooCommerce\Internal\Admin;
|
||||
|
||||
/**
|
||||
* WCAdminUser Class.
|
||||
*/
|
||||
class WCAdminUser {
|
||||
|
||||
/**
|
||||
* Class instance.
|
||||
*
|
||||
* @var WCAdminUser instance
|
||||
*/
|
||||
protected static $instance = null;
|
||||
|
||||
/**
|
||||
* Constructor.
|
||||
*/
|
||||
public function __construct() {
|
||||
add_action( 'rest_api_init', array( $this, 'register_user_data' ) );
|
||||
}
|
||||
|
||||
/**
|
||||
* Get class instance.
|
||||
*
|
||||
* @return object Instance.
|
||||
*/
|
||||
public static function get_instance() {
|
||||
if ( null === self::$instance ) {
|
||||
self::$instance = new self();
|
||||
}
|
||||
return self::$instance;
|
||||
}
|
||||
|
||||
/**
|
||||
* Registers WooCommerce specific user data to the WordPress user API.
|
||||
*/
|
||||
public function register_user_data() {
|
||||
register_rest_field(
|
||||
'user',
|
||||
'is_super_admin',
|
||||
array(
|
||||
'get_callback' => function() {
|
||||
return is_super_admin();
|
||||
},
|
||||
'schema' => null,
|
||||
)
|
||||
);
|
||||
register_rest_field(
|
||||
'user',
|
||||
'woocommerce_meta',
|
||||
array(
|
||||
'get_callback' => array( $this, 'get_user_data_values' ),
|
||||
'update_callback' => array( $this, 'update_user_data_values' ),
|
||||
'schema' => null,
|
||||
)
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* For all the registered user data fields ( Loader::get_user_data_fields ), fetch the data
|
||||
* for returning via the REST API.
|
||||
*
|
||||
* @param WP_User $user Current user.
|
||||
*/
|
||||
public function get_user_data_values( $user ) {
|
||||
$values = array();
|
||||
foreach ( $this->get_user_data_fields() as $field ) {
|
||||
$values[ $field ] = self::get_user_data_field( $user['id'], $field );
|
||||
}
|
||||
return $values;
|
||||
}
|
||||
|
||||
/**
|
||||
* For all the registered user data fields ( Loader::get_user_data_fields ), update the data
|
||||
* for the REST API.
|
||||
*
|
||||
* @param array $values The new values for the meta.
|
||||
* @param WP_User $user The current user.
|
||||
* @param string $field_id The field id for the user meta.
|
||||
*/
|
||||
public function update_user_data_values( $values, $user, $field_id ) {
|
||||
if ( empty( $values ) || ! is_array( $values ) || 'woocommerce_meta' !== $field_id ) {
|
||||
return;
|
||||
}
|
||||
$fields = $this->get_user_data_fields();
|
||||
$updates = array();
|
||||
foreach ( $values as $field => $value ) {
|
||||
if ( in_array( $field, $fields, true ) ) {
|
||||
$updates[ $field ] = $value;
|
||||
self::update_user_data_field( $user->ID, $field, $value );
|
||||
}
|
||||
}
|
||||
return $updates;
|
||||
}
|
||||
|
||||
/**
|
||||
* We store some WooCommerce specific user meta attached to users endpoint,
|
||||
* so that we can track certain preferences or values such as the inbox activity panel last open time.
|
||||
* Additional fields can be added in the function below, and then used via wc-admin's currentUser data.
|
||||
*
|
||||
* @return array Fields to expose over the WP user endpoint.
|
||||
*/
|
||||
public function get_user_data_fields() {
|
||||
/**
|
||||
* Filter user data fields exposed over the WordPress user endpoint.
|
||||
*
|
||||
* @since 4.0.0
|
||||
* @param array $fields Array of fields to expose over the WP user endpoint.
|
||||
*/
|
||||
return apply_filters( 'woocommerce_admin_get_user_data_fields', array( 'variable_product_tour_shown' ) );
|
||||
}
|
||||
|
||||
/**
|
||||
* Helper to update user data fields.
|
||||
*
|
||||
* @param int $user_id User ID.
|
||||
* @param string $field Field name.
|
||||
* @param mixed $value Field value.
|
||||
*/
|
||||
public static function update_user_data_field( $user_id, $field, $value ) {
|
||||
update_user_meta( $user_id, 'woocommerce_admin_' . $field, $value );
|
||||
}
|
||||
|
||||
/**
|
||||
* Helper to retrive user data fields.
|
||||
*
|
||||
* Migrates old key prefixes as well.
|
||||
*
|
||||
* @param int $user_id User ID.
|
||||
* @param string $field Field name.
|
||||
* @return mixed The user field value.
|
||||
*/
|
||||
public static function get_user_data_field( $user_id, $field ) {
|
||||
$meta_value = get_user_meta( $user_id, 'woocommerce_admin_' . $field, true );
|
||||
|
||||
// Migrate old meta values (prefix changed from `wc_admin_` to `woocommerce_admin_`).
|
||||
if ( '' === $meta_value ) {
|
||||
$old_meta_value = get_user_meta( $user_id, 'wc_admin_' . $field, true );
|
||||
|
||||
if ( '' !== $old_meta_value ) {
|
||||
self::update_user_data_field( $user_id, $field, $old_meta_value );
|
||||
delete_user_meta( $user_id, 'wc_admin_' . $field );
|
||||
|
||||
$meta_value = $old_meta_value;
|
||||
}
|
||||
}
|
||||
|
||||
return $meta_value;
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,161 @@
|
||||
<?php
|
||||
/**
|
||||
* Handles wcpay promotion
|
||||
*/
|
||||
|
||||
namespace Automattic\WooCommerce\Internal\Admin\WCPayPromotion;
|
||||
|
||||
defined( 'ABSPATH' ) || exit;
|
||||
|
||||
use Automattic\WooCommerce\Admin\DataSourcePoller;
|
||||
use Automattic\WooCommerce\Admin\Features\PaymentGatewaySuggestions\EvaluateSuggestion;
|
||||
use Automattic\WooCommerce\Admin\Features\PaymentGatewaySuggestions\PaymentGatewaySuggestionsDataSourcePoller as PaymentGatewaySuggestionsDataSourcePoller;
|
||||
use Automattic\WooCommerce\Internal\Admin\WCAdminAssets;
|
||||
|
||||
/**
|
||||
* WC Pay Promotion engine.
|
||||
*/
|
||||
class Init {
|
||||
const EXPLAT_VARIATION_PREFIX = 'woocommerce_wc_pay_promotion_payment_methods_table_';
|
||||
|
||||
/**
|
||||
* Constructor.
|
||||
*/
|
||||
public function __construct() {
|
||||
include_once __DIR__ . '/WCPaymentGatewayPreInstallWCPayPromotion.php';
|
||||
|
||||
$is_payments_page = isset( $_GET['page'] ) && $_GET['page'] === 'wc-settings' && isset( $_GET['tab'] ) && $_GET['tab'] === 'checkout'; // phpcs:ignore WordPress.Security.NonceVerification
|
||||
if ( ! wp_is_json_request() && ! $is_payments_page ) {
|
||||
return;
|
||||
}
|
||||
|
||||
add_filter( 'woocommerce_payment_gateways', array( __CLASS__, 'possibly_register_pre_install_wc_pay_promotion_gateway' ) );
|
||||
add_filter( 'option_woocommerce_gateway_order', [ __CLASS__, 'set_gateway_top_of_list' ] );
|
||||
add_filter( 'default_option_woocommerce_gateway_order', [ __CLASS__, 'set_gateway_top_of_list' ] );
|
||||
|
||||
$rtl = is_rtl() ? '.rtl' : '';
|
||||
|
||||
wp_enqueue_style(
|
||||
'wc-admin-payment-method-promotions',
|
||||
WCAdminAssets::get_url( "payment-method-promotions/style{$rtl}", 'css' ),
|
||||
array( 'wp-components' ),
|
||||
WCAdminAssets::get_file_version( 'css' )
|
||||
);
|
||||
|
||||
WCAdminAssets::register_script( 'wp-admin-scripts', 'payment-method-promotions', true );
|
||||
}
|
||||
|
||||
/**
|
||||
* Possibly registers the pre install wc pay promoted gateway.
|
||||
*
|
||||
* @param array $gateways list of gateway classes.
|
||||
* @return array list of gateway classes.
|
||||
*/
|
||||
public static function possibly_register_pre_install_wc_pay_promotion_gateway( $gateways ) {
|
||||
if ( self::can_show_promotion() && ! WCPaymentGatewayPreInstallWCPayPromotion::is_dismissed() ) {
|
||||
$gateways[] = 'Automattic\WooCommerce\Internal\Admin\WCPayPromotion\WCPaymentGatewayPreInstallWCPayPromotion';
|
||||
}
|
||||
return $gateways;
|
||||
}
|
||||
|
||||
/**
|
||||
* Checks if promoted gateway can be registered.
|
||||
*
|
||||
* @return boolean if promoted gateway should be registered.
|
||||
*/
|
||||
public static function can_show_promotion() {
|
||||
// Check if WC Pay is enabled.
|
||||
if ( class_exists( '\WC_Payments' ) ) {
|
||||
return false;
|
||||
}
|
||||
if ( get_option( 'woocommerce_show_marketplace_suggestions', 'yes' ) === 'no' ) {
|
||||
return false;
|
||||
}
|
||||
if ( ! apply_filters( 'woocommerce_allow_marketplace_suggestions', true ) ) {
|
||||
return false;
|
||||
}
|
||||
|
||||
$wc_pay_spec = self::get_wc_pay_promotion_spec();
|
||||
if ( ! $wc_pay_spec ) {
|
||||
return false;
|
||||
}
|
||||
return true;
|
||||
}
|
||||
|
||||
/**
|
||||
* By default, new payment gateways are put at the bottom of the list on the admin "Payments" settings screen.
|
||||
* For visibility, we want WooCommerce Payments to be at the top of the list.
|
||||
*
|
||||
* @param array $ordering Existing ordering of the payment gateways.
|
||||
*
|
||||
* @return array Modified ordering.
|
||||
*/
|
||||
public static function set_gateway_top_of_list( $ordering ) {
|
||||
$ordering = (array) $ordering;
|
||||
$id = WCPaymentGatewayPreInstallWCPayPromotion::GATEWAY_ID;
|
||||
// Only tweak the ordering if the list hasn't been reordered with WooCommerce Payments in it already.
|
||||
if ( ! isset( $ordering[ $id ] ) || ! is_numeric( $ordering[ $id ] ) ) {
|
||||
$is_empty = empty( $ordering ) || ( count( $ordering ) === 1 && $ordering[0] === false );
|
||||
$ordering[ $id ] = $is_empty ? 0 : ( min( $ordering ) - 1 );
|
||||
}
|
||||
return $ordering;
|
||||
}
|
||||
|
||||
/**
|
||||
* Get WC Pay promotion spec.
|
||||
*/
|
||||
public static function get_wc_pay_promotion_spec() {
|
||||
$promotions = self::get_promotions();
|
||||
$wc_pay_promotion_spec = array_values(
|
||||
array_filter(
|
||||
$promotions,
|
||||
function( $promotion ) {
|
||||
return isset( $promotion->plugins ) && in_array( 'woocommerce-payments', $promotion->plugins, true );
|
||||
}
|
||||
)
|
||||
);
|
||||
|
||||
return current( $wc_pay_promotion_spec );
|
||||
}
|
||||
|
||||
/**
|
||||
* Go through the specs and run them.
|
||||
*/
|
||||
public static function get_promotions() {
|
||||
$suggestions = array();
|
||||
$specs = self::get_specs();
|
||||
|
||||
foreach ( $specs as $spec ) {
|
||||
$suggestion = EvaluateSuggestion::evaluate( $spec );
|
||||
$suggestions[] = $suggestion;
|
||||
}
|
||||
|
||||
return array_values(
|
||||
array_filter(
|
||||
$suggestions,
|
||||
function( $suggestion ) {
|
||||
return ! property_exists( $suggestion, 'is_visible' ) || $suggestion->is_visible;
|
||||
}
|
||||
)
|
||||
);
|
||||
|
||||
}
|
||||
|
||||
/**
|
||||
* Delete the specs transient.
|
||||
*/
|
||||
public static function delete_specs_transient() {
|
||||
WCPayPromotionDataSourcePoller::get_instance()->delete_specs_transient();
|
||||
}
|
||||
|
||||
/**
|
||||
* Get specs or fetch remotely if they don't exist.
|
||||
*/
|
||||
public static function get_specs() {
|
||||
if ( get_option( 'woocommerce_show_marketplace_suggestions', 'yes' ) === 'no' ) {
|
||||
return array();
|
||||
}
|
||||
return WCPayPromotionDataSourcePoller::get_instance()->get_specs_from_data_sources();
|
||||
}
|
||||
}
|
||||
|
||||
@@ -0,0 +1,36 @@
|
||||
<?php
|
||||
namespace Automattic\WooCommerce\Internal\Admin\WCPayPromotion;
|
||||
|
||||
use Automattic\WooCommerce\Admin\DataSourcePoller;
|
||||
|
||||
/**
|
||||
* Specs data source poller class for WooCommerce Payment Promotion.
|
||||
*/
|
||||
class WCPayPromotionDataSourcePoller extends DataSourcePoller {
|
||||
|
||||
const ID = 'payment_method_promotion';
|
||||
|
||||
/**
|
||||
* Default data sources array.
|
||||
*/
|
||||
const DATA_SOURCES = array(
|
||||
'https://woocommerce.com/wp-json/wccom/payment-gateway-suggestions/1.0/payment-method/promotions.json',
|
||||
);
|
||||
|
||||
/**
|
||||
* Class instance.
|
||||
*
|
||||
* @var Analytics instance
|
||||
*/
|
||||
protected static $instance = null;
|
||||
|
||||
/**
|
||||
* Get class instance.
|
||||
*/
|
||||
public static function get_instance() {
|
||||
if ( ! self::$instance ) {
|
||||
self::$instance = new self( self::ID, self::DATA_SOURCES );
|
||||
}
|
||||
return self::$instance;
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,70 @@
|
||||
<?php
|
||||
/**
|
||||
* Class WCPaymentGatewayPreInstallWCPayPromotion
|
||||
*
|
||||
* @package WooCommerce\Admin
|
||||
*/
|
||||
|
||||
namespace Automattic\WooCommerce\Internal\Admin\WCPayPromotion;
|
||||
|
||||
if ( ! defined( 'ABSPATH' ) ) {
|
||||
exit;
|
||||
}
|
||||
|
||||
/**
|
||||
* A Psuedo WCPay gateway class.
|
||||
*
|
||||
* @extends WC_Payment_Gateway
|
||||
*/
|
||||
class WCPaymentGatewayPreInstallWCPayPromotion extends \WC_Payment_Gateway {
|
||||
|
||||
const GATEWAY_ID = 'pre_install_woocommerce_payments_promotion';
|
||||
|
||||
/**
|
||||
* Constructor
|
||||
*/
|
||||
public function __construct() {
|
||||
$wc_pay_spec = Init::get_wc_pay_promotion_spec();
|
||||
if ( ! $wc_pay_spec ) {
|
||||
return;
|
||||
}
|
||||
$this->id = static::GATEWAY_ID;
|
||||
$this->method_title = $wc_pay_spec->title;
|
||||
if ( property_exists( $wc_pay_spec, 'sub_title' ) ) {
|
||||
$this->title = sprintf( '<span class="gateway-subtitle" >%s</span>', $wc_pay_spec->sub_title );
|
||||
}
|
||||
$this->method_description = $wc_pay_spec->content;
|
||||
$this->has_fields = false;
|
||||
|
||||
// Get setting values.
|
||||
$this->enabled = false;
|
||||
|
||||
// Load the settings.
|
||||
$this->init_form_fields();
|
||||
$this->init_settings();
|
||||
}
|
||||
|
||||
/**
|
||||
* Initialise Gateway Settings Form Fields.
|
||||
*/
|
||||
public function init_form_fields() {
|
||||
$this->form_fields = array(
|
||||
'is_dismissed' => array(
|
||||
'title' => __( 'Dismiss', 'woocommerce' ),
|
||||
'type' => 'checkbox',
|
||||
'label' => __( 'Dismiss the gateway', 'woocommerce' ),
|
||||
'default' => 'no',
|
||||
),
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Check if the promotional gateaway has been dismissed.
|
||||
*
|
||||
* @return bool
|
||||
*/
|
||||
public static function is_dismissed() {
|
||||
$settings = get_option( 'woocommerce_' . self::GATEWAY_ID . '_settings', array() );
|
||||
return isset( $settings['is_dismissed'] ) && 'yes' === $settings['is_dismissed'];
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,204 @@
|
||||
<?php
|
||||
|
||||
namespace Automattic\WooCommerce\Internal\Admin;
|
||||
|
||||
use Automattic\WooCommerce\Admin\Features\OnboardingTasks\Tasks\WooCommercePayments;
|
||||
use Automattic\WooCommerce\Admin\WCAdminHelper;
|
||||
|
||||
/**
|
||||
* Class WCPayWelcomePage
|
||||
*
|
||||
* @package Automattic\WooCommerce\Admin\Features
|
||||
*/
|
||||
class WcPayWelcomePage {
|
||||
|
||||
const EXPERIMENT_NAME = 'woocommerce_payments_menu_promo_us_2022';
|
||||
const OTHER_GATEWAYS = [
|
||||
'affirm',
|
||||
'afterpay',
|
||||
'amazon_payments_advanced_express',
|
||||
'amazon_payments_advanced',
|
||||
'authorize_net_cim_credit_card',
|
||||
'authorize_net_cim_echeck',
|
||||
'bacs',
|
||||
'bambora_credit_card',
|
||||
'braintree_credit_card',
|
||||
'braintree_paypal',
|
||||
'chase_paymentech',
|
||||
'cybersource_credit_card',
|
||||
'elavon_converge_credit_card',
|
||||
'elavon_converge_echeck',
|
||||
'gocardless',
|
||||
'intuit_payments_credit_card',
|
||||
'intuit_payments_echeck',
|
||||
'kco',
|
||||
'klarna_payments',
|
||||
'payfast',
|
||||
'paypal',
|
||||
'paytrace',
|
||||
'ppcp-gateway',
|
||||
'psigate',
|
||||
'sagepaymentsusaapi',
|
||||
'square_credit_card',
|
||||
'stripe_alipay',
|
||||
'stripe_multibanco',
|
||||
'stripe',
|
||||
'trustcommerce',
|
||||
'usa_epay_credit_card',
|
||||
];
|
||||
|
||||
/**
|
||||
* WCPayWelcomePage constructor.
|
||||
*/
|
||||
public function __construct() {
|
||||
add_action( 'admin_menu', array( $this, 'register_payments_welcome_page' ) );
|
||||
}
|
||||
|
||||
/**
|
||||
* Registers the WooCommerce Payments welcome page.
|
||||
*/
|
||||
public function register_payments_welcome_page() {
|
||||
global $menu;
|
||||
|
||||
// WC Payment must not be installed.
|
||||
if ( WooCommercePayments::is_installed() ) {
|
||||
return;
|
||||
}
|
||||
|
||||
// Live store for at least 90 days.
|
||||
if ( ! WCAdminHelper::is_wc_admin_active_for( DAY_IN_SECONDS * 90 ) ) {
|
||||
return;
|
||||
}
|
||||
|
||||
// Must be a US based business.
|
||||
if ( WC()->countries->get_base_country() !== 'US' ) {
|
||||
return;
|
||||
}
|
||||
|
||||
// Has another payment gateway installed.
|
||||
if ( ! $this->is_another_payment_gateway_installed() ) {
|
||||
return;
|
||||
}
|
||||
|
||||
// No existing WCPay account.
|
||||
if ( $this->has_wcpay_account() ) {
|
||||
return;
|
||||
}
|
||||
|
||||
// Suggestions may be disabled via a setting.
|
||||
if ( get_option( 'woocommerce_show_marketplace_suggestions', 'yes' ) === 'no' ) {
|
||||
return;
|
||||
}
|
||||
|
||||
/**
|
||||
* Filter allow marketplace suggestions.
|
||||
*
|
||||
* User can disabled all suggestions via filter.
|
||||
*
|
||||
* @since 3.6.0
|
||||
*/
|
||||
if ( ! apply_filters( 'woocommerce_allow_marketplace_suggestions', true ) ) {
|
||||
return;
|
||||
}
|
||||
|
||||
// Manually dismissed.
|
||||
if ( get_option( 'wc_calypso_bridge_payments_dismissed', 'no' ) === 'yes' ) {
|
||||
return;
|
||||
}
|
||||
|
||||
// Users must be in the experiment.
|
||||
if ( ! $this->is_user_in_treatment_mode() ) {
|
||||
return;
|
||||
}
|
||||
|
||||
$menu_icon = 'data:image/svg+xml;base64,PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiIHN0YW5kYWxvbmU9Im5vIj8+CjxzdmcKICAgdmVyc2lvbj0iMS4xIgogICBpZD0ic3ZnNjciCiAgIHNvZGlwb2RpOmRvY25hbWU9IndjcGF5X21lbnVfaWNvbi5zdmciCiAgIHdpZHRoPSI4NTIiCiAgIGhlaWdodD0iNjg0IgogICBpbmtzY2FwZTp2ZXJzaW9uPSIxLjEgKGM0ZThmOWUsIDIwMjEtMDUtMjQpIgogICB4bWxuczppbmtzY2FwZT0iaHR0cDovL3d3dy5pbmtzY2FwZS5vcmcvbmFtZXNwYWNlcy9pbmtzY2FwZSIKICAgeG1sbnM6c29kaXBvZGk9Imh0dHA6Ly9zb2RpcG9kaS5zb3VyY2Vmb3JnZS5uZXQvRFREL3NvZGlwb2RpLTAuZHRkIgogICB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciCiAgIHhtbG5zOnN2Zz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciPgogIDxkZWZzCiAgICAgaWQ9ImRlZnM3MSIgLz4KICA8c29kaXBvZGk6bmFtZWR2aWV3CiAgICAgaWQ9Im5hbWVkdmlldzY5IgogICAgIHBhZ2Vjb2xvcj0iI2ZmZmZmZiIKICAgICBib3JkZXJjb2xvcj0iIzY2NjY2NiIKICAgICBib3JkZXJvcGFjaXR5PSIxLjAiCiAgICAgaW5rc2NhcGU6cGFnZXNoYWRvdz0iMiIKICAgICBpbmtzY2FwZTpwYWdlb3BhY2l0eT0iMC4wIgogICAgIGlua3NjYXBlOnBhZ2VjaGVja2VyYm9hcmQ9IjAiCiAgICAgc2hvd2dyaWQ9ImZhbHNlIgogICAgIGZpdC1tYXJnaW4tdG9wPSIwIgogICAgIGZpdC1tYXJnaW4tbGVmdD0iMCIKICAgICBmaXQtbWFyZ2luLXJpZ2h0PSIwIgogICAgIGZpdC1tYXJnaW4tYm90dG9tPSIwIgogICAgIGlua3NjYXBlOnpvb209IjI1NiIKICAgICBpbmtzY2FwZTpjeD0iLTg0Ljg1NzQyMiIKICAgICBpbmtzY2FwZTpjeT0iLTgzLjI5NDkyMiIKICAgICBpbmtzY2FwZTp3aW5kb3ctd2lkdGg9IjEzMTIiCiAgICAgaW5rc2NhcGU6d2luZG93LWhlaWdodD0iMTA4MSIKICAgICBpbmtzY2FwZTp3aW5kb3cteD0iMTE2IgogICAgIGlua3NjYXBlOndpbmRvdy15PSIyMDIiCiAgICAgaW5rc2NhcGU6d2luZG93LW1heGltaXplZD0iMCIKICAgICBpbmtzY2FwZTpjdXJyZW50LWxheWVyPSJzdmc2NyIgLz4KICA8cGF0aAogICAgIHRyYW5zZm9ybT0ic2NhbGUoLTEsIDEpIHRyYW5zbGF0ZSgtODUwLCAwKSIKICAgICBkPSJNIDc2OCw4NiBWIDU5OCBIIDg0IFYgODYgWiBtIDAsNTk4IGMgNDgsMCA4NCwtMzggODQsLTg2IFYgODYgQyA4NTIsMzggODE2LDAgNzY4LDAgSCA4NCBDIDM2LDAgMCwzOCAwLDg2IHYgNTEyIGMgMCw0OCAzNiw4NiA4NCw4NiB6IE0gMzg0LDEyOCB2IDQ0IGggLTg2IHYgODQgaCAxNzAgdiA0NCBIIDM0MCBjIC0yNCwwIC00MiwxOCAtNDIsNDIgdiAxMjggYyAwLDI0IDE4LDQyIDQyLDQyIGggNDQgdiA0NCBoIDg0IHYgLTQ0IGggODYgViA0MjggSCAzODQgdiAtNDQgaCAxMjggYyAyNCwwIDQyLC0xOCA0MiwtNDIgViAyMTQgYyAwLC0yNCAtMTgsLTQyIC00MiwtNDIgaCAtNDQgdiAtNDQgeiIKICAgICBmaWxsPSIjYTJhYWIyIgogICAgIGlkPSJwYXRoNjUiIC8+Cjwvc3ZnPgo=';
|
||||
|
||||
$menu_data = array(
|
||||
'id' => 'wc-calypso-bridge-payments-welcome-page',
|
||||
'title' => __( 'Payments', 'woocommerce' ),
|
||||
'path' => '/wc-pay-welcome-page',
|
||||
'position' => '56',
|
||||
'nav_args' => [
|
||||
'title' => __( 'WooCommerce Payments', 'woocommerce' ),
|
||||
'is_category' => false,
|
||||
'menuId' => 'plugins',
|
||||
'is_top_level' => true,
|
||||
],
|
||||
'icon' => $menu_icon,
|
||||
);
|
||||
|
||||
wc_admin_register_page( $menu_data );
|
||||
|
||||
// Registering a top level menu via wc_admin_register_page doesn't work when the new
|
||||
// nav is enabled. The new nav disabled everything, except the 'WooCommerce' menu.
|
||||
// We need to register this menu via add_menu_page so that it doesn't become a child of
|
||||
// WooCommerce menu.
|
||||
if ( get_option( 'woocommerce_navigation_enabled', 'no' ) === 'yes' ) {
|
||||
$menu_with_nav_data = array(
|
||||
__( 'Payments', 'woocommerce' ),
|
||||
__( 'Payments', 'woocommerce' ),
|
||||
'view_woocommerce_reports',
|
||||
'admin.php?page=wc-admin&path=/wc-pay-welcome-page',
|
||||
null,
|
||||
$menu_icon,
|
||||
56,
|
||||
);
|
||||
|
||||
call_user_func_array( 'add_menu_page', $menu_with_nav_data );
|
||||
}
|
||||
|
||||
// Add badge.
|
||||
foreach ( $menu as $index => $menu_item ) {
|
||||
if ( 'wc-admin&path=/wc-pay-welcome-page' === $menu_item[2]
|
||||
|| 'admin.php?page=wc-admin&path=/wc-pay-welcome-page' === $menu_item[2] ) {
|
||||
//phpcs:ignore
|
||||
$menu[ $index ][0] .= ' <span class="wcpay-menu-badge awaiting-mod count-1"><span class="plugin-count">1</span></span>';
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Whether a WCPay account exists. By checking account data cache.
|
||||
*
|
||||
* @return boolean
|
||||
*/
|
||||
private function has_wcpay_account(): bool {
|
||||
$account_data = get_option( 'wcpay_account_data' );
|
||||
return isset( $account_data['data'] ) && is_array( $account_data['data'] ) && ! empty( $account_data['data'] );
|
||||
}
|
||||
|
||||
/**
|
||||
* Checks if user is in the experiment.
|
||||
*
|
||||
* @return bool Whether the user is in the treatment group.
|
||||
*/
|
||||
private function is_user_in_treatment_mode() {
|
||||
$anon_id = isset( $_COOKIE['tk_ai'] ) ? sanitize_text_field( wp_unslash( $_COOKIE['tk_ai'] ) ) : '';
|
||||
$allow_tracking = get_option( 'woocommerce_allow_tracking' ) === 'yes';
|
||||
$abtest = new \WooCommerce\Admin\Experimental_Abtest(
|
||||
$anon_id,
|
||||
'woocommerce',
|
||||
$allow_tracking
|
||||
);
|
||||
|
||||
return $abtest->get_variation( self::EXPERIMENT_NAME ) === 'treatment';
|
||||
}
|
||||
|
||||
/**
|
||||
* Checks if there is another payment gateway installed using a static list of US gateways from WC Store.
|
||||
*
|
||||
* @return bool Whether there is another payment gateway installed.
|
||||
*/
|
||||
private function is_another_payment_gateway_installed() {
|
||||
$available_gateways = wp_list_pluck( WC()->payment_gateways()->get_available_payment_gateways(), 'id' );
|
||||
|
||||
foreach ( $available_gateways as $gateway ) {
|
||||
if ( in_array( $gateway, self::OTHER_GATEWAYS, true ) ) {
|
||||
return true;
|
||||
}
|
||||
}
|
||||
|
||||
return false;
|
||||
}
|
||||
|
||||
}
|
||||
Reference in New Issue
Block a user