2011-08-09 15:16:18 +00:00
< ? php
/**
* Order
*
2011-08-10 17:11:11 +00:00
* The WooCommerce order class handles order data .
2011-08-09 15:16:18 +00:00
*
2012-01-27 16:38:39 +00:00
* @ class WC_Order
2011-08-10 17:11:11 +00:00
* @ package WooCommerce
* @ category Class
* @ author WooThemes
2011-08-09 15:16:18 +00:00
*/
2012-01-27 16:38:39 +00:00
class WC_Order {
2011-08-09 15:16:18 +00:00
2012-01-13 00:46:56 +00:00
var $id ;
2012-01-17 11:58:12 +00:00
var $status ;
2012-01-13 00:46:56 +00:00
var $order_date ;
var $modified_date ;
var $customer_note ;
var $order_custom_fields ;
var $order_key ;
var $billing_first_name ;
var $billing_last_name ;
var $billing_company ;
var $billing_address_1 ;
var $billing_address_2 ;
var $billing_city ;
var $billing_postcode ;
var $billing_country ;
var $billing_state ;
var $billing_email ;
var $billing_phone ;
var $shipping_first_name ;
var $shipping_last_name ;
var $shipping_company ;
var $shipping_address_1 ;
var $shipping_address_2 ;
var $shipping_city ;
var $shipping_postcode ;
var $shipping_country ;
var $shipping_state ;
var $shipping_method ;
var $shipping_method_title ;
var $payment_method ;
var $payment_method_title ;
var $order_discount ;
var $cart_discount ;
var $order_tax ;
var $order_shipping ;
var $order_shipping_tax ;
var $order_total ;
var $items ;
var $taxes ;
var $customer_user ;
var $user_id ;
var $completed_date ;
var $billing_address ;
var $formatted_billing_address ;
var $shipping_address ;
var $formatted_shipping_address ;
2011-08-09 15:16:18 +00:00
/** Get the order if ID is passed, otherwise the order is new and empty */
2012-01-27 16:38:39 +00:00
function __construct ( $id = '' ) {
2011-11-26 23:33:57 +00:00
$this -> prices_include_tax = ( get_option ( 'woocommerce_prices_include_tax' ) == 'yes' ) ? true : false ;
$this -> display_totals_ex_tax = ( get_option ( 'woocommerce_display_totals_excluding_tax' ) == 'yes' ) ? true : false ;
2011-11-27 00:03:46 +00:00
$this -> display_cart_ex_tax = ( get_option ( 'woocommerce_display_cart_prices_excluding_tax' ) == 'yes' ) ? true : false ;
2011-08-09 15:16:18 +00:00
if ( $id > 0 ) $this -> get_order ( $id );
}
/** Gets an order from the database */
function get_order ( $id = 0 ) {
if ( ! $id ) return false ;
if ( $result = get_post ( $id )) :
$this -> populate ( $result );
return true ;
endif ;
return false ;
}
/** Populates an order from the loaded post data */
function populate ( $result ) {
// Standard post data
$this -> id = $result -> ID ;
$this -> order_date = $result -> post_date ;
$this -> modified_date = $result -> post_modified ;
$this -> customer_note = $result -> post_excerpt ;
2012-01-13 00:46:56 +00:00
$this -> order_custom_fields = get_post_custom ( $this -> id );
2011-08-09 15:16:18 +00:00
2011-08-29 16:09:42 +00:00
// Define the data we're going to load: Key => Default value
2012-01-09 15:42:37 +00:00
$load_data = apply_filters ( 'woocommerce_load_order_data' , array (
2011-08-29 16:09:42 +00:00
'order_key' => '' ,
'billing_first_name' => '' ,
'billing_last_name' => '' ,
'billing_company' => '' ,
'billing_address_1' => '' ,
'billing_address_2' => '' ,
'billing_city' => '' ,
'billing_postcode' => '' ,
'billing_country' => '' ,
'billing_state' => '' ,
'billing_email' => '' ,
'billing_phone' => '' ,
'shipping_first_name' => '' ,
'shipping_last_name' => '' ,
'shipping_company' => '' ,
'shipping_address_1' => '' ,
'shipping_address_2' => '' ,
'shipping_city' => '' ,
'shipping_postcode' => '' ,
'shipping_country' => '' ,
'shipping_state' => '' ,
'shipping_method' => '' ,
2011-12-05 18:16:13 +00:00
'shipping_method_title' => '' ,
2011-08-29 16:09:42 +00:00
'payment_method' => '' ,
2011-12-05 18:16:13 +00:00
'payment_method_title' => '' ,
2011-08-29 16:09:42 +00:00
'order_discount' => '' ,
2011-11-25 19:31:06 +00:00
'cart_discount' => '' ,
2011-08-29 16:09:42 +00:00
'order_tax' => '' ,
2011-09-02 14:42:04 +00:00
'order_shipping' => '' ,
2011-08-29 16:09:42 +00:00
'order_shipping_tax' => '' ,
2012-01-13 00:46:56 +00:00
'order_total' => '' ,
'customer_user' => '' ,
'completed_date' => $this -> modified_date
2012-01-09 15:42:37 +00:00
));
2011-08-09 15:16:18 +00:00
2011-08-29 16:09:42 +00:00
// Load the data from the custom fields
foreach ( $load_data as $key => $default ) :
2012-01-13 00:46:56 +00:00
if ( isset ( $this -> order_custom_fields [ '_' . $key ][ 0 ]) && $this -> order_custom_fields [ '_' . $key ][ 0 ] !== '' ) :
$this -> $key = $this -> order_custom_fields [ '_' . $key ][ 0 ];
2011-08-29 16:09:42 +00:00
else :
$this -> $key = $default ;
endif ;
endforeach ;
2012-01-10 16:43:06 +00:00
2012-01-21 01:15:39 +00:00
// Aliases
2012-01-13 00:46:56 +00:00
$this -> user_id = ( int ) $this -> customer_user ;
2011-11-16 15:25:45 +00:00
2012-01-13 00:46:56 +00:00
// Get status
$terms = wp_get_object_terms ( $this -> id , 'shop_order_status' , array ( 'fields' => 'slugs' ) );
$this -> status = ( isset ( $terms [ 0 ])) ? $terms [ 0 ] : 'pending' ;
}
2012-02-19 17:13:00 +00:00
function key_is_valid ( $key ) {
if ( $key == $this -> order_key ) return true ;
return false ;
}
2012-01-13 00:46:56 +00:00
function get_formatted_billing_address () {
if ( ! $this -> formatted_billing_address ) :
global $woocommerce ;
// Formatted Addresses
2011-12-18 13:41:42 +00:00
$address = array (
2012-01-13 00:46:56 +00:00
'first_name' => $this -> billing_first_name ,
'last_name' => $this -> billing_last_name ,
'company' => $this -> billing_company ,
'address_1' => $this -> billing_address_1 ,
'address_2' => $this -> billing_address_2 ,
'city' => $this -> billing_city ,
'state' => $this -> billing_state ,
'postcode' => $this -> billing_postcode ,
'country' => $this -> billing_country
2011-12-18 13:41:42 +00:00
);
2012-01-13 00:46:56 +00:00
$this -> formatted_billing_address = $woocommerce -> countries -> get_formatted_address ( $address );
endif ;
return $this -> formatted_billing_address ;
}
function get_billing_address () {
if ( ! $this -> billing_address ) :
// Formatted Addresses
$address = array (
'address_1' => $this -> billing_address_1 ,
'address_2' => $this -> billing_address_2 ,
'city' => $this -> billing_city ,
'state' => $this -> billing_state ,
'postcode' => $this -> billing_postcode ,
'country' => $this -> billing_country
);
2011-12-19 17:50:41 +00:00
$joined_address = array ();
2011-12-18 13:41:42 +00:00
foreach ( $address as $part ) if ( ! empty ( $part )) $joined_address [] = $part ;
2012-01-13 00:46:56 +00:00
$this -> billing_address = implode ( ', ' , $joined_address );
2011-08-09 15:16:18 +00:00
endif ;
2012-01-13 00:46:56 +00:00
return $this -> billing_address ;
}
function get_formatted_shipping_address () {
if ( ! $this -> formatted_shipping_address ) :
if ( $this -> shipping_address_1 ) :
global $woocommerce ;
// Formatted Addresses
$address = array (
'first_name' => $this -> shipping_first_name ,
'last_name' => $this -> shipping_last_name ,
'company' => $this -> shipping_company ,
'address_1' => $this -> shipping_address_1 ,
'address_2' => $this -> shipping_address_2 ,
'city' => $this -> shipping_city ,
'state' => $this -> shipping_state ,
'postcode' => $this -> shipping_postcode ,
'country' => $this -> shipping_country
);
$this -> formatted_shipping_address = $woocommerce -> countries -> get_formatted_address ( $address );
endif ;
2011-08-09 15:16:18 +00:00
endif ;
2012-01-13 00:46:56 +00:00
return $this -> formatted_shipping_address ;
}
function get_shipping_address () {
if ( ! $this -> shipping_address ) :
if ( $this -> shipping_address_1 ) :
// Formatted Addresses
$address = array (
'address_1' => $this -> shipping_address_1 ,
'address_2' => $this -> shipping_address_2 ,
'city' => $this -> shipping_city ,
'state' => $this -> shipping_state ,
'postcode' => $this -> shipping_postcode ,
'country' => $this -> shipping_country
);
$joined_address = array ();
foreach ( $address as $part ) if ( ! empty ( $part )) $joined_address [] = $part ;
$this -> shipping_address = implode ( ', ' , $joined_address );
endif ;
endif ;
return $this -> shipping_address ;
}
function get_items () {
if ( ! $this -> items ) :
2012-01-13 11:58:35 +00:00
$this -> items = isset ( $this -> order_custom_fields [ '_order_items' ][ 0 ] ) ? maybe_unserialize ( $this -> order_custom_fields [ '_order_items' ][ 0 ] ) : array ();
2012-01-13 00:46:56 +00:00
endif ;
return $this -> items ;
}
function get_taxes () {
if ( ! $this -> taxes ) :
2012-01-13 11:58:35 +00:00
$this -> taxes = isset ( $this -> order_custom_fields [ '_order_taxes' ][ 0 ] ) ? maybe_unserialize ( $this -> order_custom_fields [ '_order_taxes' ][ 0 ] ) : array ();
2012-01-13 00:46:56 +00:00
endif ;
return $this -> taxes ;
2011-08-09 15:16:18 +00:00
}
/** Gets shipping and product tax */
function get_total_tax () {
return $this -> order_tax + $this -> order_shipping_tax ;
}
2011-11-26 23:33:57 +00:00
/**
* gets the total ( product ) discount amount - these are applied before tax
*/
function get_cart_discount () {
return $this -> cart_discount ;
}
/**
* gets the total ( product ) discount amount - these are applied before tax
*/
function get_order_discount () {
return $this -> order_discount ;
}
2011-11-19 20:59:16 +00:00
2011-11-26 23:33:57 +00:00
/**
* gets the total discount amount - both kinds
*/
2011-11-19 20:59:16 +00:00
function get_total_discount () {
2011-11-26 23:33:57 +00:00
if ( $this -> order_discount || $this -> cart_discount ) :
return $this -> order_discount + $this -> cart_discount ;
endif ;
}
/** Gets shipping */
function get_shipping () {
return $this -> order_shipping ;
}
/** Gets order total */
function get_order_total () {
return $this -> order_total ;
2011-11-19 20:59:16 +00:00
}
2012-01-22 02:36:10 +00:00
/** Get item subtotal - this is the cost before discount */
2012-01-24 16:56:10 +00:00
function get_item_subtotal ( $item , $inc_tax = false , $round = true ) {
2012-01-14 01:23:16 +00:00
if ( $inc_tax ) :
2012-01-24 16:56:10 +00:00
$price = ( $item [ 'line_subtotal' ] + $item [ 'line_subtotal_tax' ] / $item [ 'qty' ] );
2012-01-14 01:23:16 +00:00
else :
2012-01-24 16:56:10 +00:00
$price = ( $item [ 'line_subtotal' ] / $item [ 'qty' ] );
2012-01-14 01:23:16 +00:00
endif ;
2012-01-24 16:56:10 +00:00
return ( $round ) ? number_format ( $price , 2 , '.' , '' ) : $price ;
2012-01-14 01:23:16 +00:00
}
2012-01-22 02:36:10 +00:00
/** Get line subtotal - this is the cost before discount */
2012-01-24 16:56:10 +00:00
function get_line_subtotal ( $item , $inc_tax = false , $round = true ) {
2012-01-14 01:23:16 +00:00
if ( $inc_tax ) :
2012-01-24 16:56:10 +00:00
$price = $item [ 'line_subtotal' ] + $item [ 'line_subtotal_tax' ];
2012-01-14 01:23:16 +00:00
else :
2012-01-24 16:56:10 +00:00
$price = $item [ 'line_subtotal' ];
2012-01-14 01:23:16 +00:00
endif ;
2012-01-24 16:56:10 +00:00
return ( $round ) ? number_format ( $price , 2 , '.' , '' ) : $price ;
2012-01-14 01:23:16 +00:00
}
2011-11-29 00:52:57 +00:00
/** Calculate item cost - useful for gateways */
2012-01-24 16:56:10 +00:00
function get_item_total ( $item , $inc_tax = false , $round = true ) {
2011-11-29 00:52:57 +00:00
if ( $inc_tax ) :
2012-01-24 16:56:10 +00:00
$price = ( ( $item [ 'line_total' ] + $item [ 'line_tax' ] ) / $item [ 'qty' ] );
2011-11-29 00:52:57 +00:00
else :
2012-01-24 16:56:10 +00:00
$price = $item [ 'line_total' ] / $item [ 'qty' ];
2011-11-29 00:52:57 +00:00
endif ;
2012-01-24 16:56:10 +00:00
return ( $round ) ? number_format ( $price , 2 , '.' , '' ) : $price ;
}
/** Calculate item tax - useful for gateways */
function get_item_tax ( $item , $round = true ) {
$price = $item [ 'line_tax' ] / $item [ 'qty' ];
return ( $round ) ? number_format ( $price , 2 , '.' , '' ) : $price ;
2011-11-29 00:52:57 +00:00
}
2012-01-22 02:36:10 +00:00
/** Calculate line total - useful for gateways */
function get_line_total ( $item , $inc_tax = false ) {
2011-11-28 17:03:53 +00:00
if ( $inc_tax ) :
2012-01-22 02:36:10 +00:00
return number_format ( $item [ 'line_total' ] + $item [ 'line_tax' ] , 2 , '.' , '' );
2011-11-28 17:03:53 +00:00
else :
2012-01-22 02:36:10 +00:00
return number_format ( $item [ 'line_total' ] , 2 , '.' , '' );
2011-11-28 17:03:53 +00:00
endif ;
}
2012-01-24 16:56:10 +00:00
/** Calculate line tax - useful for gateways */
function get_line_tax ( $item ) {
return number_format ( $item [ 'line_tax' ], 2 , '.' , '' );
}
/** Depreciated functions */
function get_item_cost ( $item , $inc_tax = false ) {
_deprecated_function ( __FUNCTION__ , '1.4' , 'get_item_total()' );
return $this -> get_item_total ( $item , $inc_tax );
}
function get_row_cost ( $item , $inc_tax = false ) {
_deprecated_function ( __FUNCTION__ , '1.4' , 'get_row_cost()' );
return $this -> get_line_total ( $item , $inc_tax );
}
2012-01-22 02:36:10 +00:00
/** Gets line subtotal - formatted for display */
function get_formatted_line_subtotal ( $item ) {
2012-01-04 23:01:47 +00:00
$subtotal = 0 ;
2012-01-22 02:36:10 +00:00
if ( ! isset ( $item [ 'line_subtotal' ]) || ! isset ( $item [ 'line_subtotal_tax' ])) return ;
2012-01-04 23:01:47 +00:00
if ( $this -> display_cart_ex_tax || ! $this -> prices_include_tax ) :
if ( $this -> prices_include_tax ) $ex_tax_label = 1 ; else $ex_tax_label = 0 ;
2012-01-22 02:36:10 +00:00
$subtotal = woocommerce_price ( $this -> get_line_subtotal ( $item ), array ( 'ex_tax_label' => $ex_tax_label ));
2012-01-04 23:01:47 +00:00
else :
2012-01-22 02:36:10 +00:00
$subtotal = woocommerce_price ( $this -> get_line_subtotal ( $item , true ) );
2012-01-04 23:01:47 +00:00
endif ;
return $subtotal ;
}
2011-11-28 17:03:53 +00:00
2012-01-04 23:01:47 +00:00
/** Gets subtotal - subtotal is shown before discounts, but with localised taxes */
2012-01-02 00:49:00 +00:00
function get_subtotal_to_display ( $compound = false ) {
2011-10-31 10:54:49 +00:00
global $woocommerce ;
2011-08-09 15:16:18 +00:00
2012-01-02 00:49:00 +00:00
$subtotal = 0 ;
2012-01-04 23:01:47 +00:00
if ( ! $compound ) :
2012-01-13 00:46:56 +00:00
foreach ( $this -> get_items () as $item ) :
2012-01-02 00:49:00 +00:00
2012-01-22 02:36:10 +00:00
if ( ! isset ( $item [ 'line_subtotal' ]) || ! isset ( $item [ 'line_subtotal_tax' ])) return ;
2012-01-02 00:49:00 +00:00
2012-01-22 02:36:10 +00:00
$subtotal += $this -> get_line_subtotal ( $item );
2012-01-04 23:01:47 +00:00
if ( ! $this -> display_cart_ex_tax ) :
2012-01-22 02:36:10 +00:00
$subtotal += $item [ 'line_subtotal_tax' ];
2012-01-04 23:01:47 +00:00
endif ;
2012-01-02 00:49:00 +00:00
endforeach ;
2011-11-26 23:33:57 +00:00
2012-01-02 00:49:00 +00:00
$subtotal = woocommerce_price ( $subtotal );
2012-01-04 23:01:47 +00:00
if ( $this -> display_cart_ex_tax && $this -> prices_include_tax ) :
$subtotal .= ' <small>' . $woocommerce -> countries -> ex_tax_or_vat () . '</small>' ;
endif ;
2011-11-26 23:33:57 +00:00
2012-01-04 23:01:47 +00:00
else :
2011-11-26 23:33:57 +00:00
2012-01-04 23:01:47 +00:00
if ( $this -> prices_include_tax ) return ;
2011-11-26 23:33:57 +00:00
2012-01-13 00:46:56 +00:00
foreach ( $this -> get_items () as $item ) :
2012-01-04 23:01:47 +00:00
2012-01-22 02:36:10 +00:00
$subtotal += $item [ 'line_subtotal' ];
2011-11-26 23:33:57 +00:00
2012-01-04 23:01:47 +00:00
endforeach ;
2012-01-02 00:49:00 +00:00
2012-01-04 23:01:47 +00:00
// Add Shipping Costs
$subtotal += $this -> get_shipping ();
2012-01-02 00:49:00 +00:00
2012-01-04 23:01:47 +00:00
// Remove non-compound taxes
2012-01-13 00:46:56 +00:00
foreach ( $this -> get_taxes () as $tax ) :
2012-01-04 23:01:47 +00:00
if ( isset ( $tax [ 'compound' ]) && $tax [ 'compound' ]) continue ;
2012-01-27 15:00:03 +00:00
$subtotal = $subtotal + $tax [ 'cart_tax' ] + $tax [ 'shipping_tax' ];
2012-01-02 00:49:00 +00:00
2012-01-04 23:01:47 +00:00
endforeach ;
$subtotal = woocommerce_price ( $subtotal );
2011-08-29 16:09:42 +00:00
endif ;
2011-08-09 15:16:18 +00:00
return $subtotal ;
}
2011-11-26 23:33:57 +00:00
/** Gets shipping (formatted) */
2011-08-09 15:16:18 +00:00
function get_shipping_to_display () {
2011-10-31 10:54:49 +00:00
global $woocommerce ;
2011-08-09 15:16:18 +00:00
if ( $this -> order_shipping > 0 ) :
2011-11-27 00:03:46 +00:00
$tax_text = '' ;
if ( $this -> display_totals_ex_tax || ! $this -> prices_include_tax ) :
2011-08-09 15:16:18 +00:00
2011-11-27 00:03:46 +00:00
// Show shipping excluding tax
$shipping = woocommerce_price ( $this -> order_shipping );
if ( $this -> order_shipping_tax > 0 && $this -> prices_include_tax ) :
$tax_text = $woocommerce -> countries -> ex_tax_or_vat () . ' ' ;
endif ;
2011-09-02 14:42:04 +00:00
else :
2011-11-27 00:03:46 +00:00
// Show shipping including tax
$shipping = woocommerce_price ( $this -> order_shipping + $this -> order_shipping_tax );
if ( $this -> order_shipping_tax > 0 && ! $this -> prices_include_tax ) :
$tax_text = $woocommerce -> countries -> inc_tax_or_vat () . ' ' ;
endif ;
2011-08-29 16:09:42 +00:00
endif ;
2011-11-27 00:03:46 +00:00
2012-01-05 11:31:22 +00:00
$shipping .= sprintf ( __ ( ' <small>%svia %s</small>' , 'woocommerce' ), $tax_text , ucwords ( $this -> shipping_method_title ));
2011-11-27 00:03:46 +00:00
2011-08-09 15:16:18 +00:00
else :
2012-01-05 11:31:22 +00:00
$shipping = __ ( 'Free!' , 'woocommerce' );
2011-08-09 15:16:18 +00:00
endif ;
return $shipping ;
}
/** Get a product (either product or variation) */
function get_product_from_item ( $item ) {
if ( isset ( $item [ 'variation_id' ]) && $item [ 'variation_id' ] > 0 ) :
2012-01-27 16:38:39 +00:00
$_product = new WC_Product_Variation ( $item [ 'variation_id' ] );
2011-08-09 15:16:18 +00:00
else :
2012-01-27 16:38:39 +00:00
$_product = new WC_Product ( $item [ 'id' ] );
2011-08-09 15:16:18 +00:00
endif ;
return $_product ;
}
2012-01-04 23:01:47 +00:00
/** Get totals for display on pages and in emails */
2012-01-02 17:45:26 +00:00
function get_order_item_totals () {
2012-01-13 21:25:39 +00:00
global $woocommerce ;
2012-01-02 17:45:26 +00:00
$total_rows = array ();
2012-01-04 23:01:47 +00:00
if ( $subtotal = $this -> get_subtotal_to_display ())
2012-01-05 11:31:22 +00:00
$total_rows [ __ ( 'Cart Subtotal:' , 'woocommerce' ) ] = $subtotal ;
2012-01-02 17:45:26 +00:00
if ( $this -> get_cart_discount () > 0 )
2012-01-05 11:31:22 +00:00
$total_rows [ __ ( 'Cart Discount:' , 'woocommerce' ) ] = woocommerce_price ( $this -> get_cart_discount ());
2012-01-02 17:45:26 +00:00
if ( $this -> get_shipping () > 0 )
2012-01-05 11:31:22 +00:00
$total_rows [ __ ( 'Shipping:' , 'woocommerce' ) ] = $this -> get_shipping_to_display ();
2012-01-02 17:45:26 +00:00
if ( $this -> get_total_tax () > 0 ) :
2012-01-13 11:58:35 +00:00
if ( sizeof ( $this -> get_taxes ()) > 0 ) :
2012-01-02 17:45:26 +00:00
$has_compound_tax = false ;
2012-01-14 16:42:04 +00:00
foreach ( $this -> get_taxes () as $tax ) :
if ( $tax [ 'compound' ]) : $has_compound_tax = true ; continue ; endif ;
2012-01-27 15:00:03 +00:00
if (( $tax [ 'cart_tax' ] + $tax [ 'shipping_tax' ]) == 0 ) continue ;
$total_rows [ $tax [ 'label' ] ] = woocommerce_price ( ( $tax [ 'cart_tax' ] + $tax [ 'shipping_tax' ]) );
2012-01-02 17:45:26 +00:00
endforeach ;
if ( $has_compound_tax ) :
2012-01-04 23:01:47 +00:00
if ( $subtotal = $this -> get_subtotal_to_display ( true )) :
2012-01-05 11:31:22 +00:00
$total_rows [ __ ( 'Subtotal:' , 'woocommerce' ) ] = $subtotal ;
2012-01-04 23:01:47 +00:00
endif ;
2012-01-02 17:45:26 +00:00
endif ;
2012-01-14 16:42:04 +00:00
foreach ( $this -> get_taxes () as $tax ) :
if ( ! $tax [ 'compound' ]) continue ;
2012-01-27 15:00:03 +00:00
if (( $tax [ 'cart_tax' ] + $tax [ 'shipping_tax' ]) == 0 ) continue ;
$total_rows [ $tax [ 'label' ] ] = woocommerce_price ( ( $tax [ 'cart_tax' ] + $tax [ 'shipping_tax' ]) );
2012-01-02 17:45:26 +00:00
endforeach ;
else :
$total_rows [ $woocommerce -> countries -> tax_or_vat () ] = woocommerce_price ( $this -> get_total_tax ());
endif ;
2012-03-12 11:26:48 +00:00
2012-03-12 12:50:38 +00:00
elseif ( get_option ( 'woocommerce_display_cart_taxes_if_zero' ) == 'yes' ) :
2012-03-12 11:26:48 +00:00
$total_rows [ $woocommerce -> countries -> tax_or_vat () ] = _x ( 'NA' , 'Relating to tax' , 'woocommerce' );
2012-01-02 17:45:26 +00:00
endif ;
if ( $this -> get_order_discount () > 0 )
2012-01-05 11:31:22 +00:00
$total_rows [ __ ( 'Order Discount:' , 'woocommerce' ) ] = woocommerce_price ( $this -> get_order_discount ());
2012-01-02 17:45:26 +00:00
2012-01-05 11:31:22 +00:00
$total_rows [ __ ( 'Order Total:' , 'woocommerce' ) ] = woocommerce_price ( $this -> get_order_total ());
2012-01-02 17:45:26 +00:00
return apply_filters ( 'woocommerce_get_order_item_totals' , $total_rows , $this );
}
2011-08-16 14:06:08 +00:00
/** Output items for display in html emails */
2012-02-27 17:05:26 +00:00
function email_order_items_table ( $show_download_links = false , $show_sku = false , $show_purchase_note = false , $show_image = false , $image_size = array ( 32 , 32 ) ) {
2011-08-16 14:06:08 +00:00
$return = '' ;
2012-01-13 00:46:56 +00:00
foreach ( $this -> get_items () as $item ) :
2011-08-16 14:06:08 +00:00
$_product = $this -> get_product_from_item ( $item );
2012-02-26 14:45:56 +00:00
$file = $sku = $variation = $image = '' ;
if ( $show_image ) :
$src = wp_get_attachment_image_src ( get_post_thumbnail_id ( $_product -> id ), 'thumbnail' );
2012-02-26 15:19:15 +00:00
$image = apply_filters ( 'woocommerce_order_product_image' , '<img src="' . $src [ 0 ] . '" alt="Product Image" height="' . $image_size [ 1 ] . '" width="' . $image_size [ 0 ] . '" style="vertical-align:middle; margin-right: 10px;" />' , $_product );
2012-02-26 14:45:56 +00:00
endif ;
2011-08-16 14:06:08 +00:00
2012-02-13 00:34:09 +00:00
if ( $show_sku && $_product -> get_sku ()) :
$sku = ' (#' . $_product -> get_sku () . ')' ;
2011-08-16 14:06:08 +00:00
endif ;
2012-01-10 15:11:06 +00:00
$item_meta = new order_item_meta ( $item [ 'item_meta' ] );
2011-11-26 23:33:57 +00:00
$variation = '<br/><small>' . $item_meta -> display ( true , true ) . '</small>' ;
2011-08-16 14:06:08 +00:00
if ( $show_download_links ) :
if ( $_product -> exists ) :
2011-11-05 19:03:03 +00:00
if ( $_product -> is_downloadable ()) :
2012-01-05 11:31:22 +00:00
$file = '<br/><small>' . __ ( 'Download:' , 'woocommerce' ) . ' <a href="' . $this -> get_downloadable_file_url ( $item [ 'id' ], $item [ 'variation_id' ] ) . '">' . $this -> get_downloadable_file_url ( $item [ 'id' ], $item [ 'variation_id' ] ) . '</a></small>' ;
2011-08-16 14:06:08 +00:00
endif ;
endif ;
endif ;
2011-10-05 00:02:13 +00:00
$return .= ' < tr >
2012-02-26 14:45:56 +00:00
< td style = " text-align:left; vertical-align:middle; border: 1px solid #eee; " > '. $image . apply_filters(' woocommerce_order_product_title ', $item[' name '], $_product) . $sku . $file . $variation . ' </ td >
< td style = " text-align:left; vertical-align:middle; border: 1px solid #eee; " > '.$item[' qty '].' </ td >
< td style = " text-align:left; vertical-align:middle; border: 1px solid #eee; " > ' ;
2012-01-14 01:23:16 +00:00
2011-12-23 18:07:44 +00:00
if ( $this -> display_cart_ex_tax || ! $this -> prices_include_tax ) :
$ex_tax_label = ( $this -> prices_include_tax ) ? 1 : 0 ;
2012-01-22 02:36:10 +00:00
$return .= woocommerce_price ( $this -> get_line_subtotal ( $item ), array ( 'ex_tax_label' => $ex_tax_label ));
2011-11-30 00:30:25 +00:00
else :
2012-01-22 02:36:10 +00:00
$return .= woocommerce_price ( $this -> get_line_subtotal ( $item , true ) );
2011-11-30 00:30:25 +00:00
endif ;
2011-11-26 23:33:57 +00:00
$return .= '
</ td >
2011-08-16 14:06:08 +00:00
</ tr > ' ;
2012-02-27 17:05:26 +00:00
// Show any purchase notes
if ( $show_purchase_note ) :
if ( $purchase_note = get_post_meta ( $_product -> id , '_purchase_note' , true )) :
$return .= '<tr><td colspan="3" style="text-align:left; vertical-align:middle; border: 1px solid #eee;">' . apply_filters ( 'the_content' , $purchase_note ) . '</td></tr>' ;
endif ;
endif ;
2011-08-16 14:06:08 +00:00
endforeach ;
2012-02-15 14:06:44 +00:00
$return = apply_filters ( 'woocommerce_email_order_items_table' , $return );
2011-08-09 15:16:18 +00:00
return $return ;
}
2011-10-12 17:32:30 +00:00
/** Returns true if the order contains a downloadable product */
function has_downloadable_item () {
$has_downloadable_item = false ;
2012-01-13 00:46:56 +00:00
foreach ( $this -> get_items () as $item ) :
2011-10-12 17:32:30 +00:00
$_product = $this -> get_product_from_item ( $item );
2011-11-05 19:03:03 +00:00
if ( $_product -> exists && $_product -> is_downloadable ()) :
2011-10-12 17:32:30 +00:00
$has_downloadable_item = true ;
endif ;
endforeach ;
return $has_downloadable_item ;
}
2011-08-09 15:16:18 +00:00
/** Generates a URL so that a customer can checkout/pay for their (unpaid - pending) order via a link */
function get_checkout_payment_url () {
2012-01-06 17:14:31 +00:00
$payment_page = get_permalink ( woocommerce_get_page_id ( 'pay' ));
2011-08-09 15:16:18 +00:00
2011-08-10 17:11:11 +00:00
if ( get_option ( 'woocommerce_force_ssl_checkout' ) == 'yes' || is_ssl ()) $payment_page = str_replace ( 'http:' , 'https:' , $payment_page );
2011-08-09 15:16:18 +00:00
2012-01-06 17:14:31 +00:00
return apply_filters ( 'woocommerce_get_checkout_payment_url' , add_query_arg ( 'pay_for_order' , 'true' , add_query_arg ( 'order' , $this -> order_key , add_query_arg ( 'order_id' , $this -> id , $payment_page ))));
2011-08-09 15:16:18 +00:00
}
/** Generates a URL so that a customer can cancel their (unpaid - pending) order */
function get_cancel_order_url () {
2011-09-06 11:11:22 +00:00
global $woocommerce ;
2012-01-06 17:14:31 +00:00
return apply_filters ( 'woocommerce_get_cancel_order_url' , $woocommerce -> nonce_url ( 'cancel_order' , add_query_arg ( 'cancel_order' , 'true' , add_query_arg ( 'order' , $this -> order_key , add_query_arg ( 'order_id' , $this -> id , trailingslashit ( home_url () ))))));
2011-08-09 15:16:18 +00:00
}
/** Gets a downloadable products file url */
2011-11-09 23:06:17 +00:00
function get_downloadable_file_url ( $item_id , $variation_id ) {
$download_id = ( $variation_id > 0 ) ? $variation_id : $item_id ;
2011-08-09 15:16:18 +00:00
$user_email = $this -> billing_email ;
if ( $this -> user_id > 0 ) :
$user_info = get_userdata ( $this -> user_id );
if ( $user_info -> user_email ) :
$user_email = $user_info -> user_email ;
endif ;
endif ;
2011-11-09 23:06:17 +00:00
return add_query_arg ( 'download_file' , $download_id , add_query_arg ( 'order' , $this -> order_key , add_query_arg ( 'email' , $user_email , trailingslashit ( home_url () ))));
2011-08-09 15:16:18 +00:00
}
/**
* Adds a note ( comment ) to the order
*
* @ param string $note Note to add
2011-09-23 14:22:21 +00:00
* @ param int $is_customer_note Is this a note for the customer ?
2011-08-09 15:16:18 +00:00
*/
2011-09-23 14:22:21 +00:00
function add_order_note ( $note , $is_customer_note = 0 ) {
2011-08-09 15:16:18 +00:00
2012-02-27 15:02:44 +00:00
$comment_post_ID = $this -> id ;
$comment_author = 'WooCommerce' ;
$comment_author_email = 'woocommerce@' . str_replace ( 'www.' , '' , $_SERVER [ 'HTTP_HOST' ]);
$comment_author_url = '' ;
$comment_content = esc_attr ( $note );
$comment_agent = 'WooCommerce' ;
$commentdata = compact ( 'comment_post_ID' , 'comment_author' , 'comment_author_email' , 'comment_author_url' , 'comment_content' , 'comment_agent' );
2011-08-09 15:16:18 +00:00
$comment_id = wp_insert_comment ( $commentdata );
2011-09-23 14:22:21 +00:00
add_comment_meta ( $comment_id , 'is_customer_note' , $is_customer_note );
2012-02-27 15:02:44 +00:00
if ( $is_customer_note ) do_action ( 'woocommerce_new_customer_note' , array ( 'order_id' => $this -> id , 'customer_note' => $note ) );
2011-11-17 01:06:39 +00:00
2011-09-23 14:22:21 +00:00
return $comment_id ;
2011-08-09 15:16:18 +00:00
}
/**
* Adds a note ( comment ) to the order
*
* @ param string $new_status Status to change the order to
* @ param string $note Optional note to add
*/
2012-02-27 15:02:44 +00:00
function update_status ( $new_status_slug , $note = '' ) {
2011-08-09 15:16:18 +00:00
if ( $note ) $note .= ' ' ;
2012-03-01 12:25:23 +00:00
$old_status = get_term_by ( 'slug' , sanitize_title ( $this -> status ), 'shop_order_status' );
2012-02-27 15:02:44 +00:00
$new_status = get_term_by ( 'slug' , sanitize_title ( $new_status_slug ), 'shop_order_status' );
2012-02-14 14:45:35 +00:00
if ( $new_status ) {
2012-02-27 15:02:44 +00:00
wp_set_object_terms ( $this -> id , array ( $new_status -> slug ), 'shop_order_status' , false );
2011-08-09 15:16:18 +00:00
2012-02-14 14:45:35 +00:00
if ( $this -> status != $new_status -> slug ) {
2011-08-09 15:16:18 +00:00
// Status was changed
2012-02-27 15:02:44 +00:00
do_action ( 'woocommerce_order_status_' . $new_status -> slug , $this -> id );
do_action ( 'woocommerce_order_status_' . $this -> status . '_to_' . $new_status -> slug , $this -> id );
2012-03-04 13:23:41 +00:00
$this -> add_order_note ( $note . sprintf ( __ ( 'Order status changed from %s to %s.' , 'woocommerce' ), __ ( $old_status -> name , 'woocommerce' ), __ ( $new_status -> name , 'woocommerce' ) ) );
2012-02-27 15:02:44 +00:00
2011-10-04 11:55:05 +00:00
// Date
2012-02-27 15:02:44 +00:00
if ( $new_status -> slug == 'completed' ) update_post_meta ( $this -> id , '_completed_date' , current_time ( 'mysql' ) );
2011-11-01 15:41:47 +00:00
// Sales
2012-02-27 15:02:44 +00:00
if ( $new_status -> slug == 'processing' || $new_status -> slug == 'completed' || $new_status -> slug == 'on-hold' ) $this -> record_product_sales ();
2011-11-01 15:41:47 +00:00
2012-02-14 14:45:35 +00:00
}
2012-02-27 15:02:44 +00:00
2012-02-14 14:45:35 +00:00
}
2011-08-09 15:16:18 +00:00
}
/**
* Cancel the order and restore the cart ( before payment )
*
* @ param string $note Optional note to add
*/
function cancel_order ( $note = '' ) {
unset ( $_SESSION [ 'order_awaiting_payment' ]);
$this -> update_status ( 'cancelled' , $note );
}
/**
* When a payment is complete this function is called
*
* Most of the time this should mark an order as 'processing' so that admin can process / post the items
* If the cart contains only downloadable items then the order is 'complete' since the admin needs to take no action
* Stock levels are reduced at this point
2011-11-01 15:41:47 +00:00
* Sales are also recorded for products
2011-08-09 15:16:18 +00:00
*/
function payment_complete () {
unset ( $_SESSION [ 'order_awaiting_payment' ]);
2012-01-21 01:15:39 +00:00
if ( $this -> status == 'on-hold' || $this -> status == 'pending' || $this -> status == 'failed' ) :
2011-08-09 15:16:18 +00:00
2011-11-18 11:29:55 +00:00
$downloadable_order = false ;
2011-11-01 15:41:47 +00:00
2012-01-13 00:46:56 +00:00
if ( sizeof ( $this -> get_items ()) > 0 ) foreach ( $this -> get_items () as $item ) :
2011-11-18 11:29:55 +00:00
if ( $item [ 'id' ] > 0 ) :
2011-08-09 15:16:18 +00:00
2011-11-18 11:29:55 +00:00
$_product = $this -> get_product_from_item ( $item );
2012-02-07 12:09:23 +00:00
if ( $_product -> is_downloadable () && $_product -> is_virtual () ) :
2011-11-18 11:29:55 +00:00
$downloadable_order = true ;
continue ;
endif ;
2011-08-09 15:16:18 +00:00
endif ;
2011-11-18 11:29:55 +00:00
$downloadable_order = false ;
break ;
endforeach ;
if ( $downloadable_order ) :
$new_order_status = 'completed' ;
else :
$new_order_status = 'processing' ;
2011-08-09 15:16:18 +00:00
endif ;
2011-11-18 11:29:55 +00:00
$new_order_status = apply_filters ( 'woocommerce_payment_complete_order_status' , $new_order_status , $this -> id );
$this -> update_status ( $new_order_status );
// Payment is complete so reduce stock levels
$this -> reduce_order_stock ();
do_action ( 'woocommerce_payment_complete' , $this -> id );
2011-08-09 15:16:18 +00:00
endif ;
}
2011-11-01 15:41:47 +00:00
/**
* Record sales
*/
function record_product_sales () {
2011-11-18 11:29:55 +00:00
if ( get_post_meta ( $this -> id , '_recorded_sales' , true ) == 'yes' ) return ;
2012-01-13 00:46:56 +00:00
if ( sizeof ( $this -> get_items ()) > 0 ) foreach ( $this -> get_items () as $item ) :
2011-11-01 15:41:47 +00:00
if ( $item [ 'id' ] > 0 ) :
$sales = ( int ) get_post_meta ( $item [ 'id' ], 'total_sales' , true );
$sales += ( int ) $item [ 'qty' ];
if ( $sales ) update_post_meta ( $item [ 'id' ], 'total_sales' , $sales );
endif ;
endforeach ;
2011-11-18 11:29:55 +00:00
update_post_meta ( $this -> id , '_recorded_sales' , 'yes' );
2011-11-01 15:41:47 +00:00
}
2011-08-09 15:16:18 +00:00
/**
* Reduce stock levels
*/
function reduce_order_stock () {
2012-01-13 00:46:56 +00:00
if ( get_option ( 'woocommerce_manage_stock' ) == 'yes' && sizeof ( $this -> get_items ()) > 0 ) :
2011-08-09 15:16:18 +00:00
2011-10-30 11:18:12 +00:00
// Reduce stock levels and do any other actions with products in the cart
2012-01-13 00:46:56 +00:00
foreach ( $this -> get_items () as $item ) :
2011-10-30 11:18:12 +00:00
if ( $item [ 'id' ] > 0 ) :
$_product = $this -> get_product_from_item ( $item );
2011-08-09 15:16:18 +00:00
2012-01-13 00:46:56 +00:00
if ( $_product && $_product -> exists && $_product -> managing_stock () ) :
2011-08-09 15:16:18 +00:00
2011-10-30 11:18:12 +00:00
$old_stock = $_product -> stock ;
$new_quantity = $_product -> reduce_stock ( $item [ 'qty' ] );
2012-01-05 11:31:22 +00:00
$this -> add_order_note ( sprintf ( __ ( 'Item #%s stock reduced from %s to %s.' , 'woocommerce' ), $item [ 'id' ], $old_stock , $new_quantity ) );
2011-10-30 11:18:12 +00:00
if ( $new_quantity < 0 ) :
2012-01-13 00:46:56 +00:00
do_action ( 'woocommerce_product_on_backorder' , array ( 'product' => $_product , 'order_id' => $this -> id , 'quantity' => $item [ 'qty' ]));
2011-10-30 11:18:12 +00:00
endif ;
// stock status notifications
if ( get_option ( 'woocommerce_notify_no_stock_amount' ) && get_option ( 'woocommerce_notify_no_stock_amount' ) >= $new_quantity ) :
2012-01-13 00:46:56 +00:00
do_action ( 'woocommerce_no_stock' , $_product );
2011-10-30 11:18:12 +00:00
elseif ( get_option ( 'woocommerce_notify_low_stock_amount' ) && get_option ( 'woocommerce_notify_low_stock_amount' ) >= $new_quantity ) :
2012-01-13 00:46:56 +00:00
do_action ( 'woocommerce_low_stock' , $_product );
2011-10-30 11:18:12 +00:00
endif ;
2011-08-09 15:16:18 +00:00
endif ;
endif ;
2011-10-30 11:18:12 +00:00
endforeach ;
2012-01-05 11:31:22 +00:00
$this -> add_order_note ( __ ( 'Order item stock reduced successfully.' , 'woocommerce' ) );
2011-08-09 15:16:18 +00:00
2011-10-30 11:18:12 +00:00
endif ;
2011-08-09 15:16:18 +00:00
}
2011-09-23 14:22:21 +00:00
/**
* List order notes ( public ) for the customer
*/
function get_customer_order_notes () {
$notes = array ();
$args = array (
'post_id' => $this -> id ,
'approve' => 'approve' ,
'type' => ''
);
remove_filter ( 'comments_clauses' , 'woocommerce_exclude_order_comments' );
$comments = get_comments ( $args );
foreach ( $comments as $comment ) :
$is_customer_note = get_comment_meta ( $comment -> comment_ID , 'is_customer_note' , true );
2012-02-24 20:20:17 +00:00
$comment -> comment_content = make_clickable ( $comment -> comment_content );
if ( $is_customer_note )
$notes [] = $comment ;
2011-09-23 14:22:21 +00:00
endforeach ;
add_filter ( 'comments_clauses' , 'woocommerce_exclude_order_comments' );
return ( array ) $notes ;
}
2011-11-06 15:45:22 +00:00
}
/**
* Order Item Meta
*
* A Simple class for managing order item meta so plugins add it in the correct format
*/
class order_item_meta {
var $meta ;
/**
* Constructor
*/
function __construct ( $item_meta = '' ) {
$this -> meta = array ();
if ( $item_meta ) $this -> meta = $item_meta ;
}
/**
* Load item meta
*/
function new_order_item ( $item ) {
if ( $item ) :
2011-11-16 10:08:22 +00:00
do_action ( 'woocommerce_order_item_meta' , $this , $item );
2011-11-06 15:45:22 +00:00
endif ;
}
/**
* Add meta
*/
function add ( $name , $value ) {
$this -> meta [] = array (
'meta_name' => $name ,
'meta_value' => $value
);
}
/**
* Display meta in a formatted list
*/
function display ( $flat = false , $return = false ) {
global $woocommerce ;
if ( $this -> meta && is_array ( $this -> meta )) :
if ( ! $flat ) $output = '<dl class="variation">' ; else $output = '' ;
$meta_list = array ();
foreach ( $this -> meta as $meta ) :
$name = $meta [ 'meta_name' ];
$value = $meta [ 'meta_value' ];
if ( ! $value ) continue ;
// If this is a term slug, get the term's nice name
if ( taxonomy_exists ( esc_attr ( str_replace ( 'attribute_' , '' , $name )))) :
$term = get_term_by ( 'slug' , $value , esc_attr ( str_replace ( 'attribute_' , '' , $name )));
if ( ! is_wp_error ( $term ) && $term -> name ) :
$value = $term -> name ;
endif ;
else :
$value = ucfirst ( $value );
endif ;
if ( $flat ) :
$meta_list [] = $woocommerce -> attribute_label ( str_replace ( 'attribute_' , '' , $name )) . ': ' . $value ;
else :
$meta_list [] = '<dt>' . $woocommerce -> attribute_label ( str_replace ( 'attribute_' , '' , $name )) . ':</dt><dd>' . $value . '</dd>' ;
endif ;
endforeach ;
if ( $flat ) :
$output .= implode ( ', ' , $meta_list );
else :
$output .= implode ( '' , $meta_list );
endif ;
if ( ! $flat ) $output .= '</dl>' ;
if ( $return ) return $output ; else echo $output ;
endif ;
}
2012-01-27 16:38:39 +00:00
}
/** Depreciated */
class woocommerce_order extends WC_Order {
public function __construct ( $id = '' ) {
parent :: __construct ( $id );
}
2011-08-09 15:16:18 +00:00
}