Add more orders count milestone notifications.
Also avoid notifications for thresholds passed before the plugin was activated.
This commit is contained in:
parent
e5a4a45ae5
commit
0893198f37
|
@ -23,6 +23,16 @@ class WC_Admin_Notes_Order_Milestones {
|
||||||
*/
|
*/
|
||||||
const TEN_ORDERS_NOTE_NAME = 'wc-admin-ten-orders';
|
const TEN_ORDERS_NOTE_NAME = 'wc-admin-ten-orders';
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Name of the "other milestones" note.
|
||||||
|
*/
|
||||||
|
const ORDERS_MILESTONE_NOTE_NAME = 'wc-admin-orders-milestone';
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Option key name to store last order milestone.
|
||||||
|
*/
|
||||||
|
const LAST_ORDER_MILESTONE_OPTION_KEY = 'wc_admin_last_orders_milestone';
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Allowed order statuses for calculating milestones.
|
* Allowed order statuses for calculating milestones.
|
||||||
*
|
*
|
||||||
|
@ -42,12 +52,41 @@ class WC_Admin_Notes_Order_Milestones {
|
||||||
protected $orders_count = null;
|
protected $orders_count = null;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Hook everything up.
|
* Further order milestone thresholds.
|
||||||
|
*
|
||||||
|
* @var array
|
||||||
|
*/
|
||||||
|
protected $milestones = array(
|
||||||
|
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() {
|
public function __construct() {
|
||||||
|
add_action( 'woocommerce_after_register_post_type', array( $this, 'init' ) );
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Hook everything up.
|
||||||
|
*/
|
||||||
|
public function init() {
|
||||||
|
add_action( 'wc_admin_installed', array( $this, 'backfill_last_milestone' ) );
|
||||||
|
|
||||||
if ( 10 <= $this->get_orders_count() ) {
|
if ( 10 <= $this->get_orders_count() ) {
|
||||||
add_action( 'woocommerce_new_order', array( $this, 'first_two_milestones' ) );
|
add_action( 'woocommerce_new_order', array( $this, 'first_two_milestones' ) );
|
||||||
}
|
}
|
||||||
|
|
||||||
|
add_action( 'wc_admin_daily', array( $this, 'other_milestones' ) );
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
|
@ -97,7 +136,13 @@ class WC_Admin_Notes_Order_Milestones {
|
||||||
if ( 10 === $orders_count ) {
|
if ( 10 === $orders_count ) {
|
||||||
// Add the first ten orders note.
|
// Add the first ten orders note.
|
||||||
$note = new WC_Admin_Note();
|
$note = new WC_Admin_Note();
|
||||||
$note->set_title( __( 'Congratulations on processing 10 orders!', 'woocommerce-admin' ) );
|
$note->set_title(
|
||||||
|
sprintf(
|
||||||
|
/* translators: Number of orders processed. */
|
||||||
|
__( 'Congratulations on processing %s orders!', 'woocommerce-admin' ),
|
||||||
|
wc_format_decimal( 10 )
|
||||||
|
)
|
||||||
|
);
|
||||||
$note->set_content(
|
$note->set_content(
|
||||||
__( "You've hit the 10 orders milestone! Look at you go. Browse some WooCommerce success stories for inspiration.", 'woocommerce-admin' )
|
__( "You've hit the 10 orders milestone! Look at you go. Browse some WooCommerce success stories for inspiration.", 'woocommerce-admin' )
|
||||||
);
|
);
|
||||||
|
@ -109,6 +154,86 @@ class WC_Admin_Notes_Order_Milestones {
|
||||||
$note->save();
|
$note->save();
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Backfill the store's current milestone.
|
||||||
|
*
|
||||||
|
* Used to avoid celebrating milestones that were reached before plugin activation.
|
||||||
|
*/
|
||||||
|
public function backfill_last_milestone() {
|
||||||
|
$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;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Add milestone notes for other significant thresholds.
|
||||||
|
*/
|
||||||
|
public function other_milestones() {
|
||||||
|
$last_milestone = $this->get_last_milestone();
|
||||||
|
$current_milestone = $this->get_current_milestone();
|
||||||
|
|
||||||
|
if ( $current_milestone <= $last_milestone ) {
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
$this->set_last_milestone( $current_milestone );
|
||||||
|
|
||||||
|
// Add the milestone note.
|
||||||
|
$note = new WC_Admin_Note();
|
||||||
|
$note->set_title(
|
||||||
|
sprintf(
|
||||||
|
/* translators: Number of orders processed. */
|
||||||
|
__( 'Congratulations on processing %s orders!', 'woocommerce-admin' ),
|
||||||
|
wc_format_decimal( $current_milestone )
|
||||||
|
)
|
||||||
|
);
|
||||||
|
$note->set_content(
|
||||||
|
__( "Another order milestone! Have you shared news with your subscribers lately? Maybe it's time for an update.", 'woocommerce-admin' )
|
||||||
|
);
|
||||||
|
$note->set_type( WC_Admin_Note::E_WC_ADMIN_NOTE_INFORMATIONAL );
|
||||||
|
$note->set_icon( 'trophy' );
|
||||||
|
$note->set_name( self::ORDERS_MILESTONE_NOTE_NAME );
|
||||||
|
$note->set_source( 'woocommerce-admin' );
|
||||||
|
$note->add_action( 'review', __( 'Review processed orders', 'woocommerce-admin' ), '?page=wc-admin#/analytics/orders' );
|
||||||
|
$note->save();
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
new WC_Admin_Notes_Order_Milestones();
|
new WC_Admin_Notes_Order_Milestones();
|
||||||
|
|
|
@ -95,6 +95,8 @@ function wc_admin_build_file_exists() {
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Daily events to run.
|
* Daily events to run.
|
||||||
|
*
|
||||||
|
* Note: WC_Admin_Notes_Order_Milestones::other_milestones is hooked to this as well.
|
||||||
*/
|
*/
|
||||||
function wc_admin_do_wc_admin_daily() {
|
function wc_admin_do_wc_admin_daily() {
|
||||||
WC_Admin_Notes_New_Sales_Record::possibly_add_sales_record_note();
|
WC_Admin_Notes_New_Sales_Record::possibly_add_sales_record_note();
|
||||||
|
|
Loading…
Reference in New Issue