woocommerce/classes/class-wc-order.php

1594 lines
41 KiB
PHP
Raw Normal View History

2011-08-09 15:16:18 +00:00
<?php
/**
* Order
2012-08-08 08:21:27 +00:00
*
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
2012-08-14 20:19:41 +00:00
* @version 1.6.4
2012-08-14 22:43:48 +00:00
* @package WooCommerce/Classes
2012-08-14 20:19:41 +00:00
* @author WooThemes
2011-08-09 15:16:18 +00:00
*/
2012-01-27 16:38:39 +00:00
class WC_Order {
2012-08-08 08:21:27 +00:00
/** @public int Order (post) ID */
public $id;
2012-08-15 17:08:42 +00:00
/** @public string Order status. */
public $status;
2012-08-15 17:08:42 +00:00
/** @public string Order date (placed). */
public $order_date;
2012-08-15 17:08:42 +00:00
/** @public string Order date (paid). */
public $modified_date;
2012-08-15 17:08:42 +00:00
/** @public string Note added by the customer. */
public $customer_note;
2012-08-15 17:08:42 +00:00
/** @public array Order (post) meta/custom fields. */
public $order_custom_fields;
2012-08-15 17:08:42 +00:00
/** @public string Order unique key. */
public $order_key;
2012-08-15 17:08:42 +00:00
/** @public string */
public $billing_first_name;
2012-08-15 17:08:42 +00:00
/** @public string */
public $billing_last_name;
2012-08-15 17:08:42 +00:00
/** @public string */
public $billing_company;
2012-08-15 17:08:42 +00:00
/** @public string */
public $billing_address_1;
2012-08-15 17:08:42 +00:00
/** @public string */
public $billing_address_2;
2012-08-15 17:08:42 +00:00
/** @public string */
public $billing_city;
2012-08-15 17:08:42 +00:00
/** @public string */
public $billing_postcode;
2012-08-15 17:08:42 +00:00
/** @public string */
public $billing_country;
2012-08-15 17:08:42 +00:00
/** @public string */
public $billing_state;
2012-08-15 17:08:42 +00:00
/** @public string */
public $billing_email;
2012-08-15 17:08:42 +00:00
/** @public string */
public $billing_phone;
2012-08-15 17:08:42 +00:00
/** @public string */
public $shipping_first_name;
2012-08-15 17:08:42 +00:00
/** @public string */
public $shipping_last_name;
2012-08-15 17:08:42 +00:00
/** @public string */
public $shipping_company;
2012-08-15 17:08:42 +00:00
/** @public string */
public $shipping_address_1;
2012-08-15 17:08:42 +00:00
/** @public string */
public $shipping_address_2;
2012-08-15 17:08:42 +00:00
/** @public string */
public $shipping_city;
2012-08-15 17:08:42 +00:00
/** @public string */
public $shipping_postcode;
2012-08-15 17:08:42 +00:00
/** @public string */
public $shipping_country;
2012-08-15 17:08:42 +00:00
/** @public string */
public $shipping_state;
2012-08-15 17:08:42 +00:00
/** @public string Method id of the shipping used */
public $shipping_method;
2012-08-15 17:08:42 +00:00
/** @public string Shipping method title */
public $shipping_method_title;
2012-08-15 17:08:42 +00:00
/** @public string Method id of the payment used */
public $payment_method;
2012-08-15 17:08:42 +00:00
/** @public string Payment method title */
public $payment_method_title;
2012-08-15 17:08:42 +00:00
/** @public string After tax discount total */
public $order_discount;
2012-08-15 17:08:42 +00:00
/** @public string Before tax discount total */
public $cart_discount;
2012-08-15 17:08:42 +00:00
/** @public string Tax for the items total */
public $order_tax;
2012-08-15 17:08:42 +00:00
/** @public string Shipping cost */
public $order_shipping;
2012-08-15 17:08:42 +00:00
/** @public string Shipping tax */
public $order_shipping_tax;
2012-08-15 17:08:42 +00:00
/** @public string Grand total */
public $order_total;
2012-08-15 17:08:42 +00:00
/** @public array Taxes array (tax rows) */
public $taxes;
2012-08-15 17:08:42 +00:00
/** @public int User ID */
public $customer_user;
2012-08-15 17:08:42 +00:00
/** @public int User ID */
public $user_id;
2012-08-15 17:08:42 +00:00
/** @public string */
public $completed_date;
2012-08-15 17:08:42 +00:00
/** @public string */
public $billing_address;
2012-08-15 17:08:42 +00:00
/** @public string */
public $formatted_billing_address;
2012-08-15 17:08:42 +00:00
/** @public string */
public $shipping_address;
2012-08-15 17:08:42 +00:00
/** @public string */
public $formatted_shipping_address;
2012-08-08 08:21:27 +00:00
/** @public string */
public $post_status;
2012-08-14 22:43:48 +00:00
/**
* Get the order if ID is passed, otherwise the order is new and empty.
*
* @access public
* @param string $id (default: '')
* @return void
*/
public function __construct( $id = '' ) {
2012-12-03 16:36:54 +00:00
$this->prices_include_tax = get_option('woocommerce_prices_include_tax') == 'yes' ? true : false;
$this->tax_display_cart = get_option( 'woocommerce_tax_display_cart' );
$this->display_totals_ex_tax = $this->tax_display_cart == 'excl' ? true : false;
$this->display_cart_ex_tax = $this->tax_display_cart == 'excl' ? true : false;
2012-08-14 22:43:48 +00:00
if ( $id > 0 )
$this->get_order( $id );
2011-08-09 15:16:18 +00:00
}
2012-08-08 08:21:27 +00:00
2012-08-14 22:43:48 +00:00
/**
* Gets an order from the database.
*
* @access public
* @param int $id (default: 0)
* @return bool
*/
public function get_order( $id = 0 ) {
2012-08-14 22:43:48 +00:00
if ( ! $id )
return false;
if ( $result = get_post( $id ) ) {
2012-08-08 08:21:27 +00:00
$this->populate( $result );
2011-08-09 15:16:18 +00:00
return true;
2012-08-14 22:43:48 +00:00
}
2011-08-09 15:16:18 +00:00
return false;
}
2012-08-08 08:21:27 +00:00
2012-08-14 22:43:48 +00:00
/**
* Populates an order from the loaded post data.
*
* @access public
* @param mixed $result
* @return void
*/
public function populate( $result ) {
2011-08-09 15:16:18 +00:00
// Standard post data
2012-08-08 08:21:27 +00:00
$this->id = $result->ID;
2011-08-09 15:16:18 +00:00
$this->order_date = $result->post_date;
2012-08-08 08:21:27 +00:00
$this->modified_date = $result->post_modified;
2011-08-09 15:16:18 +00:00
$this->customer_note = $result->post_excerpt;
$this->post_status = $result->post_status;
$this->order_custom_fields = get_post_meta( $this->id );
2012-08-08 08:21:27 +00:00
// Define the data we're going to load: Key => Default value
2012-08-14 22:43:48 +00:00
$load_data = apply_filters( 'woocommerce_load_order_data', array(
'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' => '',
'shipping_method_title' => '',
'payment_method' => '',
'payment_method_title' => '',
'order_discount' => '',
2011-11-25 19:31:06 +00:00
'cart_discount' => '',
'order_tax' => '',
'order_shipping' => '',
'order_shipping_tax' => '',
'order_total' => '',
'customer_user' => '',
'completed_date' => $this->modified_date
2012-08-14 22:43:48 +00:00
) );
2012-08-08 08:21:27 +00:00
// Load the data from the custom fields
2012-08-14 22:43:48 +00:00
foreach ( $load_data as $key => $default ) {
if ( isset( $this->order_custom_fields[ '_' . $key ][0] ) && $this->order_custom_fields[ '_' . $key ][0] !== '' ) {
$this->$key = $this->order_custom_fields[ '_' . $key ][0];
2012-08-14 22:43:48 +00:00
} else {
$this->$key = $default;
2012-08-14 22:43:48 +00:00
}
}
2012-08-08 08:21:27 +00:00
2012-01-21 01:15:39 +00:00
// Aliases
$this->user_id = (int) $this->customer_user;
2012-08-08 08:21:27 +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-08-08 08:21:27 +00:00
2012-08-14 22:43:48 +00:00
/**
* Check if an order key is valid.
*
* @access public
* @param mixed $key
* @return bool
*/
public function key_is_valid( $key ) {
2012-08-14 22:43:48 +00:00
if ( $key == $this->order_key ) return true;
2012-02-19 17:13:00 +00:00
return false;
}
2012-08-08 08:21:27 +00:00
/**
* get_order_number function.
*
* Gets the order number for display (by default, order ID)
2012-08-08 08:21:27 +00:00
*
* @access public
* @return string
*/
public function get_order_number() {
return apply_filters( 'woocommerce_order_number', _x( '#', 'hash before order number', 'woocommerce' ) . $this->id, $this );
}
2012-08-08 08:21:27 +00:00
2012-08-14 22:43:48 +00:00
/**
* Get a formatted billing address for the order.
*
* @access public
* @return string
*/
public function get_formatted_billing_address() {
2012-08-14 22:43:48 +00:00
if ( ! $this->formatted_billing_address ) {
global $woocommerce;
2012-08-08 08:21:27 +00:00
// Formatted Addresses
2011-12-18 13:41:42 +00:00
$address = array(
'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,
2012-08-08 08:21:27 +00:00
'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-08-08 08:21:27 +00:00
$this->formatted_billing_address = $woocommerce->countries->get_formatted_address( $address );
2012-08-14 22:43:48 +00:00
}
return $this->formatted_billing_address;
}
2012-08-08 08:21:27 +00:00
2012-08-14 22:43:48 +00:00
/**
* Get the billing address in an array.
*
* @access public
* @return array
*/
public function get_billing_address() {
2012-08-14 22:43:48 +00:00
if ( ! $this->billing_address ) {
// Formatted Addresses
$address = array(
'address_1' => $this->billing_address_1,
'address_2' => $this->billing_address_2,
2012-08-08 08:21:27 +00:00
'city' => $this->billing_city,
'state' => $this->billing_state,
'postcode' => $this->billing_postcode,
'country' => $this->billing_country
);
$joined_address = array();
2011-12-18 13:41:42 +00:00
foreach ($address as $part) if (!empty($part)) $joined_address[] = $part;
$this->billing_address = implode(', ', $joined_address);
2012-08-14 22:43:48 +00:00
}
return $this->billing_address;
}
2012-08-08 08:21:27 +00:00
2012-08-14 22:43:48 +00:00
/**
* Get a formatted shipping address for the order.
*
* @access public
* @return void
*/
public function get_formatted_shipping_address() {
2012-08-14 22:43:48 +00:00
if ( ! $this->formatted_shipping_address ) {
if ( $this->shipping_address_1 ) {
global $woocommerce;
2012-08-08 08:21:27 +00:00
// 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,
2012-08-08 08:21:27 +00:00
'city' => $this->shipping_city,
'state' => $this->shipping_state,
'postcode' => $this->shipping_postcode,
'country' => $this->shipping_country
);
2012-08-08 08:21:27 +00:00
$this->formatted_shipping_address = $woocommerce->countries->get_formatted_address( $address );
2012-08-14 22:43:48 +00:00
}
}
return $this->formatted_shipping_address;
}
2012-08-08 08:21:27 +00:00
2012-08-14 22:43:48 +00:00
/**
* Get the shipping address in an array.
*
* @access public
* @return array
*/
public function get_shipping_address() {
2012-08-14 22:43:48 +00:00
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,
2012-08-08 08:21:27 +00:00
'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);
2012-08-14 22:43:48 +00:00
}
}
return $this->shipping_address;
}
2012-08-08 08:21:27 +00:00
2012-08-14 22:43:48 +00:00
/**
* Return an array of items/products within this order.
2012-11-27 16:22:47 +00:00
*
2012-08-14 22:43:48 +00:00
* @access public
* @param string $type Types of line items to get (array or string)
* @return void
2012-08-14 22:43:48 +00:00
*/
public function get_items( $type = '' ) {
2012-10-18 13:47:21 +00:00
global $wpdb, $woocommerce;
2012-11-27 16:22:47 +00:00
if ( empty( $type ) )
$type = array( 'line_item' );
2012-11-27 16:22:47 +00:00
if ( ! is_array( $type ) ) {
$type = array( $type );
}
2012-11-27 16:22:47 +00:00
$type = array_map( 'esc_attr', $type );
2012-11-27 16:22:47 +00:00
2012-11-12 17:15:54 +00:00
$line_items = $wpdb->get_results( $wpdb->prepare( "
SELECT order_item_id, order_item_name, order_item_type
FROM {$wpdb->prefix}woocommerce_order_items
WHERE order_id = %d
AND order_item_type IN ( '" . implode( "','", $type ) . "' )
ORDER BY order_item_id
", $this->id ) );
2012-11-27 16:22:47 +00:00
2012-11-12 17:15:54 +00:00
$items = array();
2012-11-27 16:22:47 +00:00
2012-11-12 17:15:54 +00:00
foreach ( $line_items as $item ) {
2012-11-27 16:22:47 +00:00
2012-11-12 17:15:54 +00:00
// Place line item into array to return
$items[ $item->order_item_id ]['name'] = $item->order_item_name;
$items[ $item->order_item_id ]['type'] = $item->order_item_type;
$items[ $item->order_item_id ]['item_meta'] = $this->get_item_meta( $item->order_item_id );
2012-11-27 16:22:47 +00:00
2012-11-12 17:15:54 +00:00
// Put meta into item array
foreach( $items[ $item->order_item_id ]['item_meta'] as $name => $value ) {
$key = substr( $name, 0, 1 ) == '_' ? substr( $name, 1 ) : $name;
$items[ $item->order_item_id ][ $key ] = $value[0];
}
2012-10-18 13:47:21 +00:00
}
2012-11-12 17:15:54 +00:00
return $items;
}
2012-08-08 08:21:27 +00:00
2012-11-12 13:41:54 +00:00
/**
* Return an array of fees within this order.
*
* @access public
* @return array
*/
public function get_fees() {
return $this->get_items( 'fee' );
2012-11-12 13:41:54 +00:00
}
2012-11-27 16:22:47 +00:00
2012-11-13 14:54:34 +00:00
/**
* Return an array of taxes within this order.
2012-11-27 16:22:47 +00:00
*
2012-11-13 14:54:34 +00:00
* @access public
* @return void
*/
public function get_taxes() {
2012-11-13 14:54:34 +00:00
return $this->get_items( 'tax' );
}
2012-11-12 13:41:54 +00:00
/**
* has_meta function for order items.
2012-11-27 16:22:47 +00:00
*
* @access public
* @return array of meta data
*/
public function has_meta( $order_item_id ) {
global $wpdb;
2012-11-27 16:22:47 +00:00
return $wpdb->get_results( $wpdb->prepare("SELECT meta_key, meta_value, meta_id, order_item_id
FROM {$wpdb->prefix}woocommerce_order_itemmeta WHERE order_item_id = %d
ORDER BY meta_key,meta_id", absint( $order_item_id ) ), ARRAY_A );
}
2012-11-27 16:22:47 +00:00
2012-10-18 13:47:21 +00:00
/**
* Get order item meta.
2012-11-27 16:22:47 +00:00
*
2012-10-18 13:47:21 +00:00
* @access public
* @param mixed $item_id
* @param string $key (default: '')
* @param bool $single (default: false)
2012-10-18 13:47:21 +00:00
* @return void
*/
public function get_item_meta( $order_item_id, $key = '', $single = false ) {
return get_metadata( 'order_item', $order_item_id, $key, $single );
2012-10-18 13:47:21 +00:00
}
2012-08-08 08:21:27 +00:00
2012-04-16 17:20:36 +00:00
/** Total Getters *******************************************************/
2012-08-14 22:43:48 +00:00
/**
* Gets shipping and product tax.
*
* @access public
* @return float
*/
public function get_total_tax() {
return apply_filters( 'woocommerce_order_amount_total_tax', number_format( (double) $this->order_tax + (double) $this->order_shipping_tax, 2, '.', '' ) );
2011-08-09 15:16:18 +00:00
}
2012-08-08 08:21:27 +00:00
2012-08-14 22:43:48 +00:00
/**
2012-08-14 22:43:48 +00:00
* Gets the total (product) discount amount - these are applied before tax.
*
* @access public
* @return float
*/
public function get_cart_discount() {
return apply_filters( 'woocommerce_order_amount_cart_discount', number_format( (double) $this->cart_discount, 2, '.', '' ) );
}
2012-08-08 08:21:27 +00:00
2012-08-14 22:43:48 +00:00
/**
2012-08-14 22:43:48 +00:00
* Gets the total (product) discount amount - these are applied before tax.
*
* @access public
* @return float
*/
public function get_order_discount() {
return apply_filters( 'woocommerce_order_amount_order_discount', number_format( (double) $this->order_discount, 2, '.', '' ) );
}
2012-08-08 08:21:27 +00:00
2012-08-14 22:43:48 +00:00
/**
2012-08-14 22:43:48 +00:00
* Gets the total discount amount - both kinds
*
* @access public
* @return float
*/
public function get_total_discount() {
2012-08-14 22:43:48 +00:00
if ( $this->order_discount || $this->cart_discount )
return apply_filters( 'woocommerce_order_amount_total_discount', number_format( (double) $this->order_discount + (double) $this->cart_discount, 2, '.', '' ) );
}
2012-08-08 08:21:27 +00:00
2012-08-14 22:43:48 +00:00
/**
* Gets shipping total.
*
* @access public
* @return float
*/
public function get_shipping() {
return apply_filters( 'woocommerce_order_amount_shipping', number_format( (double) $this->order_shipping, 2, '.', '' ) );
}
2012-08-08 08:21:27 +00:00
2012-08-14 22:43:48 +00:00
/**
* Gets shipping tax amount.
*
* @access public
* @return float
*/
public function get_shipping_tax() {
return apply_filters( 'woocommerce_order_amount_shipping_tax', number_format( (double) $this->order_shipping_tax, 2, '.', '' ) );
}
2012-08-14 22:43:48 +00:00
/**
* Gets order total.
*
* @access public
* @return float
*/
public function get_total() {
return apply_filters( 'woocommerce_order_amount_total', number_format( (double) $this->order_total, 2, '.', '' ) );
}
2012-11-27 16:22:47 +00:00
/**
* get_order_total function. Alias for get_total()
2012-11-27 16:22:47 +00:00
*
* @access public
* @return void
*/
public function get_order_total() {
return $this->get_total();
}
2012-08-14 22:43:48 +00:00
/**
* Gets shipping method title.
*
* @access public
* @return string
*/
public function get_shipping_method() {
2012-06-12 16:22:54 +00:00
return apply_filters( 'woocommerce_order_shipping_method', ucwords( $this->shipping_method_title ) );
}
2012-08-08 08:21:27 +00:00
2012-08-14 22:43:48 +00:00
/**
* Get item subtotal - this is the cost before discount.
*
* @access public
* @param mixed $item
* @param bool $inc_tax (default: false)
* @param bool $round (default: true)
* @return float
*/
public function get_item_subtotal( $item, $inc_tax = false, $round = true ) {
2012-08-14 22:43:48 +00:00
if ( $inc_tax )
2012-01-24 16:56:10 +00:00
$price = ( $item['line_subtotal'] + $item['line_subtotal_tax'] / $item['qty'] );
2012-08-14 22:43:48 +00:00
else
2012-01-24 16:56:10 +00:00
$price = ( $item['line_subtotal'] / $item['qty'] );
2012-05-09 10:09:39 +00:00
return apply_filters( 'woocommerce_order_amount_item_subtotal', ($round) ? number_format( $price, 2, '.', '') : $price );
2012-01-14 01:23:16 +00:00
}
2012-08-08 08:21:27 +00:00
2012-08-14 22:43:48 +00:00
/**
* Get line subtotal - this is the cost before discount.
*
* @access public
* @param mixed $item
* @param bool $inc_tax (default: false)
* @param bool $round (default: true)
* @return float
*/
public function get_line_subtotal( $item, $inc_tax = false, $round = true ) {
2012-08-14 22:43:48 +00:00
if ( $inc_tax )
2012-01-24 16:56:10 +00:00
$price = $item['line_subtotal'] + $item['line_subtotal_tax'];
2012-08-14 22:43:48 +00:00
else
2012-01-24 16:56:10 +00:00
$price = $item['line_subtotal'];
2012-05-09 10:09:39 +00:00
return apply_filters( 'woocommerce_order_amount_line_subtotal', ($round) ? number_format( $price, 2, '.', '') : $price );
2012-01-14 01:23:16 +00:00
}
2012-08-08 08:21:27 +00:00
2012-08-14 22:43:48 +00:00
/**
* Calculate item cost - useful for gateways.
*
* @access public
* @param mixed $item
* @param bool $inc_tax (default: false)
* @param bool $round (default: true)
* @return float
*/
public function get_item_total( $item, $inc_tax = false, $round = true ) {
2012-08-14 22:43:48 +00:00
if ( $inc_tax )
2012-01-24 16:56:10 +00:00
$price = ( ( $item['line_total'] + $item['line_tax'] ) / $item['qty'] );
2012-08-14 22:43:48 +00:00
else
2012-01-24 16:56:10 +00:00
$price = $item['line_total'] / $item['qty'];
2012-05-09 10:09:39 +00:00
return apply_filters( 'woocommerce_order_amount_item_total', ($round) ? number_format( $price, 2, '.', '') : $price );
2012-01-24 16:56:10 +00:00
}
2012-08-08 08:21:27 +00:00
2012-08-14 22:43:48 +00:00
/**
* Calculate item tax - useful for gateways.
*
* @access public
* @param mixed $item
* @param bool $round (default: true)
* @return float
*/
public function get_item_tax( $item, $round = true ) {
2012-01-24 16:56:10 +00:00
$price = $item['line_tax'] / $item['qty'];
2012-05-09 10:09:39 +00:00
return apply_filters( 'woocommerce_order_amount_item_tax', ($round) ? number_format( $price, 2, '.', '') : $price );
2011-11-29 00:52:57 +00:00
}
2012-08-08 08:21:27 +00:00
2012-08-14 22:43:48 +00:00
/**
* Calculate line total - useful for gateways.
*
* @access public
* @param mixed $item
* @param bool $inc_tax (default: false)
* @return float
*/
public function get_line_total( $item, $inc_tax = false ) {
2012-08-14 22:43:48 +00:00
if ( $inc_tax )
2012-05-09 10:09:39 +00:00
return apply_filters( 'woocommerce_order_amount_line_total', number_format( $item['line_total'] + $item['line_tax'] , 2, '.', '') );
2012-08-14 22:43:48 +00:00
else
2012-05-09 10:09:39 +00:00
return apply_filters( 'woocommerce_order_amount_line_total', number_format( $item['line_total'] , 2, '.', '') );
2011-11-28 17:03:53 +00:00
}
2012-08-08 08:21:27 +00:00
2012-08-14 22:43:48 +00:00
/**
* Calculate line tax - useful for gateways.
*
* @access public
* @param mixed $item
* @return float
*/
public function get_line_tax( $item ) {
2012-05-09 10:09:39 +00:00
return apply_filters( 'woocommerce_order_amount_line_tax', number_format( $item['line_tax'], 2, '.', '') );
2012-01-24 16:56:10 +00:00
}
2012-08-08 08:21:27 +00:00
2012-04-16 17:20:36 +00:00
/** End Total Getters *******************************************************/
2012-08-14 22:43:48 +00:00
/**
* Gets line subtotal - formatted for display.
*
* @access public
* @param mixed $item
* @return string
*/
public function get_formatted_line_subtotal( $item, $tax_display = '' ) {
if ( ! $tax_display )
$tax_display = $this->tax_display_cart;
$subtotal = 0;
2012-08-08 08:21:27 +00:00
if (!isset($item['line_subtotal']) || !isset($item['line_subtotal_tax'])) return;
2012-08-08 08:21:27 +00:00
if ( $tax_display == 'excl' ) {
if ( $this->prices_include_tax ) $ex_tax_label = 1; else $ex_tax_label = 0;
2012-12-03 16:36:54 +00:00
$subtotal = woocommerce_price( $this->get_line_subtotal( $item ), array( 'ex_tax_label' => $ex_tax_label ) );
} else {
$subtotal = woocommerce_price( $this->get_line_subtotal( $item, true ) );
2012-12-03 16:36:54 +00:00
}
return apply_filters( 'woocommerce_order_formatted_line_subtotal', $subtotal, $item, $this );
}
2012-08-08 08:21:27 +00:00
2012-08-14 22:43:48 +00:00
/**
* Gets order total - formatted for display.
*
* @access public
* @return string
*/
public function get_formatted_order_total() {
$formatted_total = woocommerce_price( $this->order_total );
return apply_filters( 'woocommerce_get_formatted_order_total', $formatted_total, $this );
}
2012-08-08 08:21:27 +00:00
2012-08-14 22:43:48 +00:00
/**
* Gets subtotal - subtotal is shown before discounts, but with localised taxes.
*
* @access public
* @param bool $compound (default: false)
* @return string
*/
public function get_subtotal_to_display( $compound = false, $tax_display = '' ) {
2011-10-31 10:54:49 +00:00
global $woocommerce;
2012-08-08 08:21:27 +00:00
if ( ! $tax_display )
$tax_display = $this->tax_display_cart;
$subtotal = 0;
2012-08-08 08:21:27 +00:00
2012-12-03 16:36:54 +00:00
if ( ! $compound ) {
2012-12-03 16:36:54 +00:00
foreach ( $this->get_items() as $item ) {
2012-08-08 08:21:27 +00:00
if ( ! isset( $item['line_subtotal'] ) || ! isset( $item['line_subtotal_tax'] ) ) return;
2012-08-08 08:21:27 +00:00
$subtotal += $this->get_line_subtotal( $item );
2012-08-08 08:21:27 +00:00
if ( $tax_display == 'incl' ) {
$subtotal += $item['line_subtotal_tax'];
2012-12-03 16:36:54 +00:00
}
2012-12-03 16:36:54 +00:00
}
2012-08-08 08:21:27 +00:00
$subtotal = woocommerce_price( $subtotal );
2012-08-08 08:21:27 +00:00
if ( $tax_display == 'excl' && $this->prices_include_tax )
2012-12-19 18:43:29 +00:00
$subtotal .= ' <small>' . $woocommerce->countries->ex_tax_or_vat() . '</small>';
2012-08-08 08:21:27 +00:00
2012-12-03 16:36:54 +00:00
} else {
2012-08-08 08:21:27 +00:00
if ( $tax_display == 'incl' )
2012-12-03 16:36:54 +00:00
return;
2012-08-08 08:21:27 +00:00
2012-12-03 16:36:54 +00:00
foreach ( $this->get_items() as $item ) {
2012-08-08 08:21:27 +00:00
$subtotal += $item['line_subtotal'];
2012-08-08 08:21:27 +00:00
2012-12-03 16:36:54 +00:00
}
2012-08-08 08:21:27 +00:00
// Add Shipping Costs
$subtotal += $this->get_shipping();
2012-08-08 08:21:27 +00:00
// Remove non-compound taxes
2012-12-03 16:36:54 +00:00
foreach ( $this->get_taxes() as $tax ) {
2012-08-08 08:21:27 +00:00
2012-11-13 14:54:34 +00:00
if ( ! empty( $tax['compound'] ) ) continue;
2012-08-08 08:21:27 +00:00
2012-11-13 14:54:34 +00:00
$subtotal = $subtotal + $tax['tax_amount'] + $tax['shipping_tax_amount'];
2012-08-08 08:21:27 +00:00
2012-12-03 16:36:54 +00:00
}
2012-08-08 08:21:27 +00:00
// Remove discounts
$subtotal = $subtotal - $this->get_cart_discount();
2012-08-08 08:21:27 +00:00
2012-11-13 14:54:34 +00:00
$subtotal = woocommerce_price( $subtotal );
2012-12-03 16:36:54 +00:00
}
2012-08-08 08:21:27 +00:00
return apply_filters( 'woocommerce_order_subtotal_to_display', $subtotal, $compound, $this );
2011-08-09 15:16:18 +00:00
}
2012-08-14 22:43:48 +00:00
/**
* Gets shipping (formatted).
*
* @access public
* @return string
*/
public function get_shipping_to_display( $tax_display = '' ) {
2011-10-31 10:54:49 +00:00
global $woocommerce;
2012-08-08 08:21:27 +00:00
if ( ! $tax_display )
$tax_display = $this->tax_display_cart;
2012-12-03 16:36:54 +00:00
if ( $this->order_shipping > 0 ) {
2012-08-08 08:21:27 +00:00
2011-11-27 00:03:46 +00:00
$tax_text = '';
2012-08-08 08:21:27 +00:00
if ( $tax_display == 'excl' ) {
2011-08-09 15:16:18 +00:00
2011-11-27 00:03:46 +00:00
// Show shipping excluding tax
2012-12-03 16:36:54 +00:00
$shipping = woocommerce_price( $this->order_shipping );
if ( $this->order_shipping_tax > 0 && $this->prices_include_tax )
2012-08-08 08:21:27 +00:00
$tax_text = $woocommerce->countries->ex_tax_or_vat() . ' ';
2012-12-03 16:36:54 +00:00
} else {
2012-08-08 08:21:27 +00:00
2011-11-27 00:03:46 +00:00
// Show shipping including tax
2012-12-03 16:36:54 +00:00
$shipping = woocommerce_price( $this->order_shipping + $this->order_shipping_tax );
if ( $this->order_shipping_tax > 0 && ! $this->prices_include_tax )
2012-08-08 08:21:27 +00:00
$tax_text = $woocommerce->countries->inc_tax_or_vat() . ' ';
2012-12-03 16:36:54 +00:00
}
2012-08-08 08:21:27 +00:00
2012-10-16 09:45:33 +00:00
$shipping .= sprintf( __( '&nbsp;<small>%svia %s</small>', 'woocommerce' ), $tax_text, $this->get_shipping_method() );
2012-08-08 08:21:27 +00:00
2012-12-03 16:36:54 +00:00
} elseif ( $this->get_shipping_method() ) {
2012-06-12 16:22:54 +00:00
$shipping = $this->get_shipping_method();
2012-12-03 16:36:54 +00:00
} else {
2012-10-16 09:45:33 +00:00
$shipping = __( 'Free!', 'woocommerce' );
2012-12-03 16:36:54 +00:00
}
2012-08-08 08:21:27 +00:00
return apply_filters( 'woocommerce_order_shipping_to_display', $shipping, $this );
2011-08-09 15:16:18 +00:00
}
2012-08-14 22:43:48 +00:00
/**
* Get cart discount (formatted).
*
* @access public
* @return string.
*/
public function get_cart_discount_to_display() {
return apply_filters( 'woocommerce_order_cart_discount_to_display', woocommerce_price( $this->get_cart_discount() ), $this );
}
2012-08-08 08:21:27 +00:00
2012-08-14 22:43:48 +00:00
/**
* Get cart discount (formatted).
*
* @access public
* @return string
*/
public function get_order_discount_to_display() {
return apply_filters( 'woocommerce_order_discount_to_display', woocommerce_price( $this->get_order_discount() ), $this );
}
2012-08-08 08:21:27 +00:00
2012-08-14 22:43:48 +00:00
/**
* Get a product (either product or variation).
*
* @access public
* @param mixed $item
* @return WC_Product
*/
public function get_product_from_item( $item ) {
$_product = get_product( $item['variation_id'] ? $item['variation_id'] : $item['product_id'] );
2012-08-08 08:21:27 +00:00
2011-08-09 15:16:18 +00:00
return $_product;
}
2012-08-08 08:21:27 +00:00
2012-08-14 22:43:48 +00:00
/**
* Get totals for display on pages and in emails.
*
* @access public
* @return array
*/
public function get_order_item_totals( $tax_display = '' ) {
2012-01-13 21:25:39 +00:00
global $woocommerce;
2012-08-08 08:21:27 +00:00
if ( ! $tax_display )
$tax_display = $this->tax_display_cart;
$total_rows = array();
2012-08-08 08:21:27 +00:00
if ( $subtotal = $this->get_subtotal_to_display() )
$total_rows['cart_subtotal'] = array(
'label' => __( 'Cart Subtotal:', 'woocommerce' ),
'value' => $subtotal
);
2012-08-08 08:21:27 +00:00
if ( $this->get_cart_discount() > 0 )
$total_rows['cart_discount'] = array(
'label' => __( 'Cart Discount:', 'woocommerce' ),
'value' => '-' . $this->get_cart_discount_to_display()
);
2012-08-08 08:21:27 +00:00
2012-06-12 16:22:54 +00:00
if ( $this->get_shipping_method() )
$total_rows['shipping'] = array(
'label' => __( 'Shipping:', 'woocommerce' ),
'value' => $this->get_shipping_to_display()
);
2012-11-27 16:22:47 +00:00
if ( $fees = $this->get_fees() )
2012-11-12 17:15:54 +00:00
foreach( $fees as $id => $fee ) {
2012-11-27 16:22:47 +00:00
if ( $tax_display == 'excl' ) {
2012-11-27 16:22:47 +00:00
2012-11-12 17:15:54 +00:00
$total_rows[ 'fee_' . $id ] = array(
'label' => $fee['name'],
'value' => woocommerce_price( $fee['line_total'] )
);
2012-11-27 16:22:47 +00:00
2012-11-12 17:15:54 +00:00
} else {
2012-11-27 16:22:47 +00:00
2012-11-12 17:15:54 +00:00
$total_rows[ 'fee_' . $id ] = array(
'label' => $fee['name'],
'value' => woocommerce_price( $fee['line_total'] + $fee['line_tax'] )
);
}
}
2012-11-27 16:22:47 +00:00
2012-10-12 11:48:06 +00:00
// Tax for tax exclusive prices
if ( $tax_display == 'excl' ) {
if ( sizeof( $this->get_taxes() ) > 0 ) {
2012-11-27 16:22:47 +00:00
$has_compound_tax = false;
2012-11-27 16:22:47 +00:00
foreach ( $this->get_taxes() as $tax ) {
if ( $tax[ 'compound' ] ) {
$has_compound_tax = true;
continue;
}
2012-11-27 16:22:47 +00:00
$total_rows[ sanitize_title( $tax[ 'name' ] ) ] = array(
'label' => isset( $tax[ 'label' ] ) ? $tax[ 'label' ] : $tax[ 'name' ] . ':',
'value' => woocommerce_price( ( $tax[ 'tax_amount' ] + $tax[ 'shipping_tax_amount' ] ) )
);
}
2012-11-27 16:22:47 +00:00
if ( $has_compound_tax ) {
if ( $subtotal = $this->get_subtotal_to_display( true ) ) {
$total_rows['subtotal'] = array(
'label' => __( 'Subtotal:', 'woocommerce' ),
'value' => $subtotal
2012-10-12 11:48:06 +00:00
);
}
}
2012-11-27 16:22:47 +00:00
foreach ( $this->get_taxes() as $tax ) {
if ( ! $tax[ 'compound' ] )
continue;
2012-11-27 16:22:47 +00:00
$total_rows[ sanitize_title( $tax[ 'name' ] ) ] = array(
'label' => isset( $tax[ 'label' ] ) ? $tax[ 'label' ] : $tax[ 'name' ] . ':',
'value' => woocommerce_price( ( $tax[ 'tax_amount' ] + $tax[ 'shipping_tax_amount' ] ) )
);
}
2012-11-27 16:22:47 +00:00
} elseif ( $this->get_total_tax() > 0 ) {
$total_rows['tax'] = array(
'label' => $woocommerce->countries->tax_or_vat(),
'value' => woocommerce_price( $this->get_total_tax() )
);
}
}
2012-08-08 08:21:27 +00:00
if ( $this->get_order_discount() > 0 )
$total_rows['order_discount'] = array(
'label' => __( 'Order Discount:', 'woocommerce' ),
'value' => '-' . $this->get_order_discount_to_display()
);
2012-08-08 08:21:27 +00:00
$total_rows['order_total'] = array(
'label' => __( 'Order Total:', 'woocommerce' ),
'value' => $this->get_formatted_order_total()
);
2012-11-27 16:22:47 +00:00
2012-10-12 11:48:06 +00:00
// Tax for inclusive prices
if ( $tax_display == 'incl' ) {
2012-11-27 16:22:47 +00:00
2012-10-12 11:48:06 +00:00
$tax_string_array = array();
2012-11-27 16:22:47 +00:00
if ( sizeof( $this->get_taxes() ) > 0 ) {
2012-11-27 16:22:47 +00:00
foreach ( $this->get_taxes() as $tax ) {
2012-10-12 11:48:06 +00:00
$tax_string_array[] = sprintf( '%s %s', woocommerce_price( ( $tax[ 'tax_amount' ] + $tax[ 'shipping_tax_amount' ] ) ), $tax[ 'name' ] );
2012-10-12 11:48:06 +00:00
}
2012-11-27 16:22:47 +00:00
} elseif ( $this->get_total_tax() > 0 ) {
2012-11-27 16:22:47 +00:00
$tax_string_array[] = sprintf( '%s %s', woocommerce_price( $this->get_total_tax() ), $woocommerce->countries->tax_or_vat() );
2012-10-12 11:48:06 +00:00
}
2012-11-27 16:22:47 +00:00
2013-02-06 18:07:52 +00:00
if ( ! empty( $tax_string_array ) )
$total_rows['order_total']['value'] .= ' ' . sprintf( __( '(Includes %s)', 'woocommerce' ), implode( ', ', $tax_string_array ) );
2012-10-12 11:48:06 +00:00
}
2012-08-08 08:21:27 +00:00
return apply_filters( 'woocommerce_get_order_item_totals', $total_rows, $this );
}
2012-08-08 08:21:27 +00:00
2012-08-14 22:43:48 +00:00
/**
* Output items for display in html emails.
*
* @access public
* @param bool $show_download_links (default: false)
* @param bool $show_sku (default: false)
* @param bool $show_purchase_note (default: false)
* @param bool $show_image (default: false)
* @param array $image_size (default: array( 32, 32 )
* @param bool plain text
2012-08-14 22:43:48 +00:00
* @return string
*/
public function email_order_items_table( $show_download_links = false, $show_sku = false, $show_purchase_note = false, $show_image = false, $image_size = array( 32, 32 ), $plain_text = false ) {
ob_start();
2012-11-27 16:22:47 +00:00
$template = $plain_text ? 'emails/plain/email-order-items.php' : 'emails/email-order-items.php';
2012-08-08 08:21:27 +00:00
woocommerce_get_template( $template, array(
'order' => $this,
2012-08-08 08:21:27 +00:00
'items' => $this->get_items(),
'show_download_links' => $show_download_links,
'show_sku' => $show_sku,
'show_purchase_note' => $show_purchase_note,
'show_image' => $show_image,
'image_size' => $image_size
) );
2012-08-08 08:21:27 +00:00
$return = apply_filters( 'woocommerce_email_order_items_table', ob_get_clean() );
2012-08-08 08:21:27 +00:00
return $return;
2011-08-09 15:16:18 +00:00
}
2012-08-08 08:21:27 +00:00
/**
* Checks if product download is permitted
2012-11-27 16:22:47 +00:00
*
* @access public
* @return bool
*/
public function is_download_permitted() {
return apply_filters( 'woocommerce_order_is_download_permitted', $this->status == 'completed' || ( get_option( 'woocommerce_downloads_grant_access_after_payment' ) == 'yes' && $this->status == 'processing' ), $this );
}
2012-08-14 22:43:48 +00:00
/**
* Returns true if the order contains a downloadable product.
*
* @access public
* @return bool
*/
public function has_downloadable_item() {
$has_downloadable_item = false;
2012-08-08 08:21:27 +00:00
foreach($this->get_items() as $item) :
$_product = $this->get_product_from_item( $item );
2012-04-20 10:17:40 +00:00
if ($_product->exists() && $_product->is_downloadable()) :
$has_downloadable_item = true;
endif;
2012-08-08 08:21:27 +00:00
endforeach;
return $has_downloadable_item;
}
2012-08-08 08:21:27 +00:00
2012-08-14 22:43:48 +00:00
/**
* Generates a URL so that a customer can checkout/pay for their (unpaid - pending) order via a link.
*
* @access public
* @return string
*/
public function get_checkout_payment_url() {
2012-08-08 08:21:27 +00:00
2012-01-06 17:14:31 +00:00
$payment_page = get_permalink(woocommerce_get_page_id('pay'));
2012-08-08 08:21:27 +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);
2012-08-08 08:21:27 +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
}
2012-08-08 08:21:27 +00:00
2012-08-14 22:43:48 +00:00
/**
* Generates a URL so that a customer can cancel their (unpaid - pending) order.
*
* @access public
* @return string
*/
public function get_cancel_order_url() {
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
}
2012-08-08 08:21:27 +00:00
/**
* Gets any downloadable product file urls.
*
* @access public
* @param int $product_id product identifier
* @param int $variation_id variation identifier, or null
* @param array $item the item
* @return array available downloadable file urls
*/
public function get_downloadable_file_urls( $product_id, $variation_id, $item ) {
global $wpdb;
$download_file = $variation_id > 0 ? $variation_id : $product_id;
$_product = get_product( $download_file );
$user_email = $this->billing_email;
$results = $wpdb->get_results( $wpdb->prepare("
SELECT download_id
FROM " . $wpdb->prefix . "woocommerce_downloadable_product_permissions
WHERE user_email = %s
AND order_key = %s
AND product_id = %s
", $user_email, $this->order_key, $download_file ) );
$file_urls = array();
foreach ( $results as $result ) {
if ( $_product->has_file( $result->download_id ) ) {
$file_urls[] = add_query_arg( array( 'download_file' => $download_file, 'order' => $this->order_key, 'email' => $user_email, 'key' => $result->download_id ), trailingslashit( home_url() ) );
}
}
return apply_filters( 'woocommerce_get_downloadable_file_urls', $file_urls, $product_id, $variation_id, $item );
}
2011-08-09 15:16:18 +00:00
/**
* Adds a note (comment) to the order
*
2012-08-14 22:43:48 +00:00
* @access public
* @param string $note Note to add
* @param int $is_customer_note (default: 0) Is this a note for the customer?
* @return id Comment ID
2011-08-09 15:16:18 +00:00
*/
public function add_order_note( $note, $is_customer_note = 0 ) {
2012-08-08 08:21:27 +00:00
2012-10-18 10:33:47 +00:00
$is_customer_note = intval( $is_customer_note );
2012-12-11 17:05:31 +00:00
if ( isset( $_SERVER['HTTP_HOST'] ) )
$comment_author_email = sanitize_email( strtolower( __( 'WooCommerce', 'woocommerce' ) ) . '@' . str_replace( 'www.', '', $_SERVER['HTTP_HOST'] ) );
else
2012-12-11 17:18:08 +00:00
$comment_author_email = sanitize_email( strtolower( __( 'WooCommerce', 'woocommerce' ) ) . '@noreply.com' );
2012-12-11 17:05:31 +00:00
$comment_post_ID = $this->id;
2012-10-16 09:45:33 +00:00
$comment_author = __( 'WooCommerce', 'woocommerce' );
$comment_author_url = '';
$comment_content = $note;
$comment_agent = 'WooCommerce';
$comment_type = 'order_note';
2012-04-14 23:37:37 +00:00
$comment_parent = 0;
$comment_approved = 1;
$commentdata = compact( 'comment_post_ID', 'comment_author', 'comment_author_email', 'comment_author_url', 'comment_content', 'comment_agent', 'comment_type', 'comment_parent', 'comment_approved' );
2012-08-08 08:21:27 +00:00
2011-08-09 15:16:18 +00:00
$comment_id = wp_insert_comment( $commentdata );
2012-08-08 08:21:27 +00:00
add_comment_meta( $comment_id, 'is_customer_note', $is_customer_note );
2012-08-08 08:21:27 +00:00
if ($is_customer_note) do_action( 'woocommerce_new_customer_note', array( 'order_id' => $this->id, 'customer_note' => $note ) );
2012-08-08 08:21:27 +00:00
return $comment_id;
2011-08-09 15:16:18 +00:00
}
2012-08-14 22:43:48 +00:00
2011-08-09 15:16:18 +00:00
/**
2012-08-01 02:15:37 +00:00
* Updates status of order
2011-08-09 15:16:18 +00:00
*
2012-08-14 22:43:48 +00:00
* @access public
* @param string $new_status_slug Status to change the order to
* @param string $note (default: '') Optional note to add
* @return void
2011-08-09 15:16:18 +00:00
*/
public function update_status( $new_status_slug, $note = '' ) {
2012-08-08 08:21:27 +00:00
2012-11-27 16:22:47 +00:00
if ( $note )
2012-09-12 12:05:53 +00:00
$note .= ' ';
2012-08-08 08:21:27 +00:00
2012-09-12 12:05:53 +00:00
$old_status = get_term_by( 'slug', sanitize_title( $this->status ), 'shop_order_status' );
$new_status = get_term_by( 'slug', sanitize_title( $new_status_slug ), 'shop_order_status' );
2012-11-27 16:22:47 +00:00
2012-09-12 12:05:53 +00:00
if ( $new_status ) {
2012-08-08 08:21:27 +00:00
2012-09-12 12:05:53 +00:00
wp_set_object_terms( $this->id, array( $new_status->slug ), 'shop_order_status', false );
2012-08-08 08:21:27 +00:00
2012-02-14 14:45:35 +00:00
if ( $this->status != $new_status->slug ) {
2012-08-08 08:21:27 +00:00
2011-08-09 15:16:18 +00:00
// Status was changed
2012-09-12 12:05:53 +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-09-12 12:05:53 +00:00
do_action( 'woocommerce_order_status_changed', $this->id, $this->status, $new_status->slug );
2012-11-27 16:22:47 +00:00
2012-10-16 09:45:33 +00:00
$this->add_order_note( $note . sprintf( __( 'Order status changed from %s to %s.', 'woocommerce' ), __( $old_status->name, 'woocommerce' ), __( $new_status->name, 'woocommerce' ) ) );
// Record the completed date of the order
2012-08-08 08:21:27 +00:00
if ( $new_status->slug == 'completed' )
update_post_meta( $this->id, '_completed_date', current_time('mysql') );
2012-08-08 08:21:27 +00:00
if ( $new_status->slug == 'processing' || $new_status->slug == 'completed' || $new_status->slug == 'on-hold' ) {
2012-08-08 08:21:27 +00:00
// Record the sales
$this->record_product_sales();
2012-08-08 08:21:27 +00:00
// Increase coupon usage counts
$this->increase_coupon_usage_counts();
}
2012-08-08 08:21:27 +00:00
// If the order is cancelled, restore used coupons
2012-08-08 08:21:27 +00:00
if ( $new_status->slug == 'cancelled' )
$this->decrease_coupon_usage_counts();
2012-08-08 08:21:27 +00:00
$this->status = $new_status->slug;
2012-02-14 14:45:35 +00:00
}
2012-02-14 14:45:35 +00:00
}
2012-08-08 08:21:27 +00:00
2012-05-28 09:19:29 +00:00
delete_transient( 'woocommerce_processing_order_count' );
2011-08-09 15:16:18 +00:00
}
2012-08-08 08:21:27 +00:00
2012-08-14 22:43:48 +00:00
2011-08-09 15:16:18 +00:00
/**
* Cancel the order and restore the cart (before payment)
*
2012-08-14 22:43:48 +00:00
* @access public
* @param string $note (default: '') Optional note to add
* @return void
2011-08-09 15:16:18 +00:00
*/
public function cancel_order( $note = '' ) {
2012-09-07 17:26:13 +00:00
global $woocommerce;
2012-11-27 16:22:47 +00:00
2012-09-07 17:26:13 +00:00
unset( $woocommerce->session->order_awaiting_payment );
2012-08-08 08:21:27 +00:00
2011-08-09 15:16:18 +00:00
$this->update_status('cancelled', $note);
2012-08-08 08:21:27 +00:00
2011-08-09 15:16:18 +00:00
}
/**
* 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
2012-06-03 12:12:08 +00:00
* Finally, record the date of payment
2012-08-14 22:43:48 +00:00
*
* @access public
* @return void
2011-08-09 15:16:18 +00:00
*/
public function payment_complete() {
2012-09-07 17:26:13 +00:00
global $woocommerce;
2012-11-27 16:22:47 +00:00
2012-09-07 17:26:13 +00:00
unset( $woocommerce->session->order_awaiting_payment );
2012-08-08 08:21:27 +00:00
2012-06-03 12:12:08 +00:00
if ( $this->status == 'on-hold' || $this->status == 'pending' || $this->status == 'failed' ) {
2012-08-08 08:21:27 +00:00
$order_needs_processing = true;
2012-08-08 08:21:27 +00:00
2012-06-03 12:12:08 +00:00
if ( sizeof( $this->get_items() ) > 0 ) {
2012-11-27 16:22:47 +00:00
2012-06-03 12:12:08 +00:00
foreach( $this->get_items() as $item ) {
2012-11-27 16:22:47 +00:00
if ( $item['product_id'] > 0 ) {
2012-08-08 08:21:27 +00:00
2012-06-03 12:12:08 +00:00
$_product = $this->get_product_from_item( $item );
2012-08-08 08:21:27 +00:00
if ( ( $_product->is_downloadable() && $_product->is_virtual() ) || ! apply_filters( 'woocommerce_order_item_needs_processing', true, $_product, $this->id ) ) {
$order_needs_processing = false;
2012-06-03 12:12:08 +00:00
continue;
}
2012-08-08 08:21:27 +00:00
2012-06-03 12:12:08 +00:00
}
$order_needs_processing = true;
2012-06-03 12:12:08 +00:00
break;
}
}
2012-08-08 08:21:27 +00:00
$new_order_status = $order_needs_processing ? 'processing' : 'completed';
2012-08-08 08:21:27 +00:00
$new_order_status = apply_filters( 'woocommerce_payment_complete_order_status', $new_order_status, $this->id );
2012-08-08 08:21:27 +00:00
2012-06-03 12:12:08 +00:00
$this->update_status( $new_order_status );
2012-08-08 08:21:27 +00:00
2012-06-08 10:46:10 +00:00
add_post_meta( $this->id, '_paid_date', current_time('mysql'), true );
2012-08-08 08:21:27 +00:00
2012-06-03 12:12:08 +00:00
$this_order = array(
'ID' => $this->id,
'post_date' => current_time( 'mysql', 0 ),
'post_date_gmt' => current_time( 'mysql', 1 )
);
wp_update_post( $this_order );
$this->reduce_order_stock(); // Payment is complete so reduce stock levels
2012-08-08 08:21:27 +00:00
do_action( 'woocommerce_payment_complete', $this->id );
2012-06-03 12:12:08 +00:00
}
2011-08-09 15:16:18 +00:00
}
2012-08-08 08:21:27 +00:00
2012-08-14 22:43:48 +00:00
2011-11-01 15:41:47 +00:00
/**
* Record sales
2012-08-14 22:43:48 +00:00
*
* @access public
* @return void
2011-11-01 15:41:47 +00:00
*/
public function record_product_sales() {
2012-08-08 08:21:27 +00:00
if ( get_post_meta( $this->id, '_recorded_sales', true ) == 'yes' )
return;
2012-08-08 08:21:27 +00:00
if ( sizeof( $this->get_items() ) > 0 ) {
foreach ( $this->get_items() as $item ) {
if ( $item['product_id'] > 0 ) {
$sales = (int) get_post_meta( $item['product_id'], 'total_sales', true );
$sales += (int) $item['qty'];
2012-08-08 08:21:27 +00:00
if ( $sales )
update_post_meta( $item['product_id'], 'total_sales', $sales );
}
}
}
2012-08-08 08:21:27 +00:00
update_post_meta( $this->id, '_recorded_sales', 'yes' );
}
2012-08-14 22:43:48 +00:00
/**
* Get coupon codes only.
2012-08-14 22:43:48 +00:00
*
* @access public
* @return array
*/
public function get_used_coupons() {
2012-08-08 08:21:27 +00:00
$codes = array();
$coupons = $this->get_items( 'coupon' );
foreach ( $coupons as $item_id => $item ) {
$codes[] = trim( $item['name'] );
}
2012-08-08 08:21:27 +00:00
return $codes;
}
2012-08-08 08:21:27 +00:00
2012-08-14 22:43:48 +00:00
/**
* Increase applied coupon counts
2012-08-14 22:43:48 +00:00
*
* @access public
* @return void
*/
public function increase_coupon_usage_counts() {
global $woocommerce;
2012-08-08 08:21:27 +00:00
if ( get_post_meta( $this->id, '_recorded_coupon_usage_counts', true ) == 'yes' )
return;
2012-08-08 08:21:27 +00:00
if ( sizeof( $this->get_used_coupons() ) > 0 ) {
foreach ( $this->get_used_coupons() as $code ) {
if ( ! $code )
continue;
2012-08-08 08:21:27 +00:00
$coupon = new WC_Coupon( $code );
$coupon->inc_usage_count();
}
}
2012-08-08 08:21:27 +00:00
update_post_meta( $this->id, '_recorded_coupon_usage_counts', 'yes' );
2011-11-01 15:41:47 +00:00
}
2012-08-08 08:21:27 +00:00
2012-08-14 22:43:48 +00:00
/**
* Decrease applied coupon counts
2012-08-14 22:43:48 +00:00
*
* @access public
* @return void
*/
public function decrease_coupon_usage_counts() {
global $woocommerce;
2012-08-08 08:21:27 +00:00
if ( get_post_meta( $this->id, '_recorded_coupon_usage_counts', true ) != 'yes' )
return;
2012-08-08 08:21:27 +00:00
if ( sizeof( $this->get_used_coupons() ) > 0 ) {
foreach ( $this->get_used_coupons() as $code ) {
if ( ! $code )
continue;
2012-08-08 08:21:27 +00:00
$coupon = new WC_Coupon( $code );
$coupon->dcr_usage_count();
}
}
2012-08-08 08:21:27 +00:00
delete_post_meta( $this->id, '_recorded_coupon_usage_counts' );
}
2012-08-08 08:21:27 +00:00
2012-08-14 22:43:48 +00:00
2011-08-09 15:16:18 +00:00
/**
* Reduce stock levels
2012-08-14 22:43:48 +00:00
*
* @access public
* @return void
2011-08-09 15:16:18 +00:00
*/
public function reduce_order_stock() {
2012-08-08 08:21:27 +00:00
2012-04-09 13:58:00 +00:00
if ( get_option('woocommerce_manage_stock') == 'yes' && sizeof( $this->get_items() ) > 0 ) {
2012-08-08 08:21:27 +00:00
// Reduce stock levels and do any other actions with products in the cart
2012-04-09 13:58:00 +00:00
foreach ( $this->get_items() as $item ) {
2012-08-08 08:21:27 +00:00
if ($item['product_id']>0) {
$_product = $this->get_product_from_item( $item );
2012-08-08 08:21:27 +00:00
2012-04-20 10:17:40 +00:00
if ( $_product && $_product->exists() && $_product->managing_stock() ) {
2012-08-08 08:21:27 +00:00
$old_stock = $_product->stock;
2012-08-08 08:21:27 +00:00
$new_quantity = $_product->reduce_stock( $item['qty'] );
2012-08-08 08:21:27 +00:00
$this->add_order_note( sprintf( __( 'Item #%s stock reduced from %s to %s.', 'woocommerce' ), $item['product_id'], $old_stock, $new_quantity) );
2012-08-08 08:21:27 +00:00
2012-04-17 11:53:02 +00:00
$this->send_stock_notifications( $_product, $new_quantity, $item['qty'] );
2012-08-08 08:21:27 +00:00
2012-04-09 13:58:00 +00:00
}
2012-08-08 08:21:27 +00:00
2012-04-09 13:58:00 +00:00
}
2012-08-08 08:21:27 +00:00
2012-04-09 13:58:00 +00:00
}
2012-08-08 08:21:27 +00:00
2012-04-09 13:58:00 +00:00
do_action( 'woocommerce_reduce_order_stock', $this );
2012-08-08 08:21:27 +00:00
2012-10-16 09:45:33 +00:00
$this->add_order_note( __( 'Order item stock reduced successfully.', 'woocommerce' ) );
2012-04-09 13:58:00 +00:00
}
2012-08-08 08:21:27 +00:00
2011-08-09 15:16:18 +00:00
}
2012-08-08 08:21:27 +00:00
2012-08-14 22:43:48 +00:00
2012-04-17 11:53:02 +00:00
/**
* send_stock_notifications function.
2012-08-14 22:43:48 +00:00
*
* @access public
* @param object $product
* @param int $new_stock
* @param int $qty_ordered
* @return void
2012-04-17 11:53:02 +00:00
*/
public function send_stock_notifications( $product, $new_stock, $qty_ordered ) {
2012-08-08 08:21:27 +00:00
2012-04-17 11:53:02 +00:00
// Backorders
if ( $new_stock < 0 )
do_action( 'woocommerce_product_on_backorder', array( 'product' => $product, 'order_id' => $this->id, 'quantity' => $qty_ordered ) );
2012-08-08 08:21:27 +00:00
2012-04-17 11:53:02 +00:00
// stock status notifications
$notification_sent = false;
2012-08-08 08:21:27 +00:00
2012-04-17 11:53:02 +00:00
if ( get_option( 'woocommerce_notify_no_stock' ) == 'yes' && get_option('woocommerce_notify_no_stock_amount') >= $new_stock ) {
do_action( 'woocommerce_no_stock', $product );
$notification_sent = true;
}
if ( ! $notification_sent && get_option( 'woocommerce_notify_low_stock' ) == 'yes' && get_option('woocommerce_notify_low_stock_amount') >= $new_stock ) {
do_action( 'woocommerce_low_stock', $product );
$notification_sent = true;
}
}
2012-08-08 08:21:27 +00:00
2012-08-14 22:43:48 +00:00
/**
* List order notes (public) for the customer
2012-08-14 22:43:48 +00:00
*
* @access public
* @return array
*/
public function get_customer_order_notes() {
2012-08-08 08:21:27 +00:00
$notes = array();
2012-08-08 08:21:27 +00:00
$args = array(
'post_id' => $this->id,
'approve' => 'approve',
'type' => ''
);
2012-08-08 08:21:27 +00:00
remove_filter('comments_clauses', 'woocommerce_exclude_order_comments');
2012-08-08 08:21:27 +00:00
$comments = get_comments( $args );
2012-08-08 08:21:27 +00:00
foreach ($comments as $comment) :
$is_customer_note = get_comment_meta($comment->comment_ID, 'is_customer_note', true);
$comment->comment_content = make_clickable($comment->comment_content);
2012-08-08 08:21:27 +00:00
if ($is_customer_note)
$notes[] = $comment;
endforeach;
2012-08-08 08:21:27 +00:00
add_filter('comments_clauses', 'woocommerce_exclude_order_comments');
2012-08-08 08:21:27 +00:00
return (array) $notes;
2012-08-08 08:21:27 +00:00
}
2011-11-06 15:45:22 +00:00
}
/**
* Order Item Meta
2012-08-08 08:21:27 +00:00
*
2011-11-06 15:45:22 +00:00
* A Simple class for managing order item meta so plugins add it in the correct format
2012-08-14 22:43:48 +00:00
*
* @class order_item_meta
* @version 1.6.4
* @package WooCommerce/Classes
* @author WooThemes
2011-11-06 15:45:22 +00:00
*/
2012-08-15 17:08:42 +00:00
class WC_Order_Item_Meta {
2012-08-08 08:21:27 +00:00
public $meta;
2012-08-08 08:21:27 +00:00
2011-11-06 15:45:22 +00:00
/**
* Constructor
2012-08-14 22:43:48 +00:00
*
* @access public
* @param string $item_meta (default: '')
* @return void
2011-11-06 15:45:22 +00:00
*/
public function __construct( $item_meta = array() ) {
$this->meta = $item_meta;
2011-11-06 15:45:22 +00:00
}
2012-08-08 08:21:27 +00:00
2011-11-06 15:45:22 +00:00
/**
* Display meta in a formatted list
2012-08-14 22:43:48 +00:00
*
* @access public
* @param bool $flat (default: false)
* @param bool $return (default: false)
2012-08-24 17:22:21 +00:00
* @param string $hideprefix (default: _)
2012-08-14 22:43:48 +00:00
* @return void
2011-11-06 15:45:22 +00:00
*/
public function display( $flat = false, $return = false, $hideprefix = '_' ) {
2011-11-06 15:45:22 +00:00
global $woocommerce;
2012-08-08 08:21:27 +00:00
if ( ! empty( $this->meta ) ) {
2012-11-27 16:22:47 +00:00
2012-08-24 17:22:21 +00:00
$output = $flat ? '' : '<dl class="variation">';
2012-08-08 08:21:27 +00:00
2011-11-06 15:45:22 +00:00
$meta_list = array();
2012-08-08 08:21:27 +00:00
foreach ( $this->meta as $meta_key => $meta_value ) {
2012-11-27 16:22:47 +00:00
if ( ! $meta_value || ( ! empty( $hideprefix ) && substr( $meta_key, 0, 1 ) == $hideprefix ) )
2012-08-24 17:22:21 +00:00
continue;
2012-11-27 16:22:47 +00:00
// Get first value
$meta_value = $meta_value[0];
2012-08-08 08:21:27 +00:00
2011-11-06 15:45:22 +00:00
// If this is a term slug, get the term's nice name
if ( taxonomy_exists( esc_attr( str_replace( 'attribute_', '', $meta_key ) ) ) ) {
$term = get_term_by('slug', $meta_value, esc_attr( str_replace( 'attribute_', '', $meta_key ) ) );
2012-08-24 17:22:21 +00:00
if ( ! is_wp_error( $term ) && $term->name )
$meta_value = $term->name;
2012-08-24 17:22:21 +00:00
} else {
$meta_value = ucfirst( $meta_value );
2012-08-24 17:22:21 +00:00
}
2012-08-08 08:21:27 +00:00
2012-08-24 17:22:21 +00:00
if ( $flat )
$meta_list[] = esc_attr( $woocommerce->attribute_label( str_replace( 'attribute_', '', $meta_key ) ) . ': ' . $meta_value );
2012-08-24 17:22:21 +00:00
else
$meta_list[] = '<dt>' . wp_kses_post( $woocommerce->attribute_label( str_replace( 'attribute_', '', $meta_key ) ) ) . ':</dt><dd>' . wp_kses_post( $meta_value ) . '</dd>';
2012-08-08 08:21:27 +00:00
2012-08-24 17:22:21 +00:00
}
2012-08-08 08:21:27 +00:00
2012-08-24 17:22:21 +00:00
if ( $flat )
$output .= implode( ", \n", $meta_list );
else
$output .= implode( '', $meta_list );
2012-08-08 08:21:27 +00:00
2012-11-27 16:22:47 +00:00
if ( ! $flat )
2012-08-24 17:22:21 +00:00
$output .= '</dl>';
2011-11-06 15:45:22 +00:00
2012-11-27 16:22:47 +00:00
if ( $return )
return $output;
else
echo $output;
2012-08-24 17:22:21 +00:00
}
2011-11-06 15:45:22 +00:00
}
2011-08-09 15:16:18 +00:00
}