2011-08-09 15:16:18 +00:00
|
|
|
<?php
|
2016-03-08 21:44:28 +00:00
|
|
|
include_once( 'legacy/class-wc-legacy-customer.php' );
|
2015-11-06 09:22:19 +00:00
|
|
|
|
|
|
|
if ( ! defined( 'ABSPATH' ) ) {
|
2016-03-08 21:44:28 +00:00
|
|
|
exit;
|
2015-11-06 09:22:19 +00:00
|
|
|
}
|
|
|
|
|
2011-08-09 15:16:18 +00:00
|
|
|
/**
|
2011-12-08 19:45:24 +00:00
|
|
|
* The WooCommerce customer class handles storage of the current customer's data, such as location.
|
2011-08-09 15:16:18 +00:00
|
|
|
*
|
2014-11-18 14:32:48 +00:00
|
|
|
* @class WC_Customer
|
2016-03-08 21:44:28 +00:00
|
|
|
* @version 2.7.0
|
2014-11-18 14:32:48 +00:00
|
|
|
* @package WooCommerce/Classes
|
|
|
|
* @category Class
|
|
|
|
* @author WooThemes
|
2011-08-09 15:16:18 +00:00
|
|
|
*/
|
2016-03-17 17:30:20 +00:00
|
|
|
class WC_Customer extends WC_Legacy_Customer {
|
2012-11-27 16:22:47 +00:00
|
|
|
|
2014-11-18 14:32:48 +00:00
|
|
|
/**
|
2015-11-03 13:31:20 +00:00
|
|
|
* Stores customer data.
|
2014-11-18 14:32:48 +00:00
|
|
|
* @var array
|
|
|
|
*/
|
2016-03-08 21:44:28 +00:00
|
|
|
protected $_data = array(
|
|
|
|
'id' => 0,
|
2016-03-09 20:49:02 +00:00
|
|
|
'email' => '',
|
2016-03-10 16:22:47 +00:00
|
|
|
'first_name' => '',
|
|
|
|
'last_name' => '',
|
2016-03-11 18:28:34 +00:00
|
|
|
'role' => 'customer',
|
|
|
|
'last_order_id' => null, // read only
|
|
|
|
'last_order_date' => null, // read only
|
|
|
|
'orders_count' => 0, // read only
|
|
|
|
'total_spent' => 0, // read only
|
|
|
|
'username' => '', // read only on existing users
|
2016-03-09 20:49:02 +00:00
|
|
|
'password' => '', // write only
|
2016-03-10 16:22:47 +00:00
|
|
|
'date_created' => '', // read only
|
|
|
|
'date_modified' => '', // read only
|
2016-03-17 19:39:29 +00:00
|
|
|
'billing_postcode' => '',
|
|
|
|
'billing_city' => '',
|
|
|
|
'billing_address_1' => '',
|
|
|
|
'billing_address_2' => '',
|
|
|
|
'billing_state' => '',
|
|
|
|
'billing_country' => '',
|
2016-03-08 21:44:28 +00:00
|
|
|
'shipping_postcode' => '',
|
|
|
|
'shipping_city' => '',
|
|
|
|
'shipping_address_1' => '',
|
|
|
|
'shipping_address_2' => '',
|
|
|
|
'shipping_state' => '',
|
|
|
|
'shipping_country' => '',
|
2016-03-09 20:49:02 +00:00
|
|
|
'is_paying_customer' => false,
|
|
|
|
'is_vat_exempt' => false, // session only.
|
|
|
|
'calculated_shipping' => false, // session only
|
2016-03-08 21:44:28 +00:00
|
|
|
);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Keys which are also stored in a session (so we can make sure they get updated...)
|
|
|
|
* @var array
|
|
|
|
*/
|
|
|
|
protected $_session_keys = array(
|
2016-03-17 19:39:29 +00:00
|
|
|
'billing_postcode', 'billing_city', 'billing_address_1', 'billing_address', 'billing_address_2',
|
|
|
|
'billing_state', 'billing_country', 'shipping_postcode', 'shipping_city', 'shipping_address_1', 'shipping_address',
|
2016-03-15 18:37:42 +00:00
|
|
|
'shipping_address_2', 'shipping_state', 'shipping_country', 'is_vat_exempt', 'calculated_shipping',
|
2016-03-08 21:44:28 +00:00
|
|
|
);
|
2012-11-27 16:22:47 +00:00
|
|
|
|
2016-03-17 19:03:23 +00:00
|
|
|
/**
|
2016-08-04 20:13:07 +00:00
|
|
|
* Data stored in meta keys, but not considered "meta"
|
2016-03-17 19:03:23 +00:00
|
|
|
* @since 2.7.0
|
|
|
|
* @var array
|
|
|
|
*/
|
|
|
|
protected $_internal_meta_keys = array(
|
|
|
|
'billing_postcode', 'billing_city', 'billing_address_1', 'billing_address_2', 'billing_state',
|
|
|
|
'billing_country', 'shipping_postcode', 'shipping_city', 'shipping_address_1',
|
|
|
|
'shipping_address_2', 'shipping_state', 'shipping_country', 'paying_customer',
|
2016-08-15 12:17:43 +00:00
|
|
|
'last_update', 'first_name', 'last_name', 'show_admin_bar_front',
|
|
|
|
'use_ssl', 'admin_color', 'rich_editing', 'comment_shortcuts', 'dismissed_wp_pointers', 'show_welcome_panel',
|
|
|
|
'_woocommerce_persistent_cart', 'session_tokens',
|
2016-03-17 19:03:23 +00:00
|
|
|
);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Internal meta type used to store user data.
|
|
|
|
* @var string
|
|
|
|
*/
|
|
|
|
protected $_meta_type = 'user';
|
|
|
|
|
2014-11-18 14:32:48 +00:00
|
|
|
/**
|
2016-03-08 21:44:28 +00:00
|
|
|
* Was data changed in the database for this class?
|
|
|
|
* @var boolean
|
2014-11-18 14:32:48 +00:00
|
|
|
*/
|
2016-03-09 20:49:02 +00:00
|
|
|
protected $_changed = false;
|
2013-01-12 13:02:47 +00:00
|
|
|
|
2012-08-14 19:42:38 +00:00
|
|
|
/**
|
2016-08-15 12:17:43 +00:00
|
|
|
* If this is the customer session, this is true. When true, guest accounts will not be saved to the DB.
|
2016-03-08 21:44:28 +00:00
|
|
|
* @var boolean
|
2012-08-14 19:42:38 +00:00
|
|
|
*/
|
2016-08-15 12:17:43 +00:00
|
|
|
protected $_is_session = false;
|
2012-11-27 16:22:47 +00:00
|
|
|
|
2016-03-08 21:44:28 +00:00
|
|
|
/**
|
|
|
|
* Load customer data based on how WC_Customer is called.
|
2016-08-15 12:17:43 +00:00
|
|
|
*
|
|
|
|
* If $customer is 'new', you can build a new WC_Customer object. If it's empty, some
|
2016-03-09 20:49:02 +00:00
|
|
|
* data will be pulled from the session for the current user/customer.
|
2016-08-15 12:17:43 +00:00
|
|
|
*
|
|
|
|
* @param int $customer_id Customer ID
|
|
|
|
* @param bool $is_session True if this is the customer session
|
2016-03-08 21:44:28 +00:00
|
|
|
*/
|
2016-08-15 12:17:43 +00:00
|
|
|
public function __construct( $customer_id = 0, $is_session = false ) {
|
|
|
|
if ( $customer_id > 0 ) {
|
|
|
|
$this->read( $customer_id );
|
2012-08-14 19:42:38 +00:00
|
|
|
}
|
2016-08-15 12:17:43 +00:00
|
|
|
if ( $is_session ) {
|
|
|
|
$this->_is_session = true;
|
|
|
|
$this->load_session();
|
2016-03-09 20:49:02 +00:00
|
|
|
add_action( 'shutdown', array( $this, 'save_session_if_changed' ), 10 );
|
2016-03-08 21:44:28 +00:00
|
|
|
}
|
2012-09-07 18:28:27 +00:00
|
|
|
}
|
2012-09-23 16:16:39 +00:00
|
|
|
|
2013-01-12 13:02:47 +00:00
|
|
|
/**
|
2016-03-08 21:44:28 +00:00
|
|
|
* Saves customer information to the current session if any data changed.
|
|
|
|
* @since 2.7.0
|
2013-01-12 13:02:47 +00:00
|
|
|
*/
|
2016-03-09 20:49:02 +00:00
|
|
|
public function save_session_if_changed() {
|
2016-08-15 12:17:43 +00:00
|
|
|
if ( $this->_is_session && $this->_changed ) {
|
2016-03-09 20:49:02 +00:00
|
|
|
$this->save_to_session();
|
2014-05-08 09:35:51 +00:00
|
|
|
}
|
2013-01-12 13:02:47 +00:00
|
|
|
}
|
|
|
|
|
2016-03-14 19:14:50 +00:00
|
|
|
/**
|
|
|
|
* Loads a WC session into the customer class.
|
|
|
|
*/
|
|
|
|
public function load_session() {
|
2016-08-15 12:17:43 +00:00
|
|
|
$data = (array) WC()->session->get( 'customer' );
|
|
|
|
if ( ! empty( $data ) ) {
|
|
|
|
foreach ( $this->_session_keys as $session_key ) {
|
|
|
|
$function_key = $session_key;
|
|
|
|
if ( 'billing_' === substr( $session_key, 0, 8 ) ) {
|
|
|
|
$session_key = str_replace( 'billing_', '', $session_key );
|
|
|
|
}
|
|
|
|
if ( ! empty( $data[ $session_key ] ) && is_callable( array( $this, "set_{$function_key}" ) ) ) {
|
|
|
|
$this->{"set_{$function_key}"}( $data[ $session_key ] );
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
$this->load_defaults();
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Load default values if props are unset.
|
|
|
|
*/
|
|
|
|
protected function load_defaults() {
|
|
|
|
$default = wc_get_customer_default_location();
|
|
|
|
|
|
|
|
// Set some defaults if some of our values are still not set.
|
|
|
|
if ( empty( $this->get_billing_country() ) ) {
|
|
|
|
$this->set_billing_country( $default['country'] );
|
|
|
|
}
|
|
|
|
|
|
|
|
if ( empty( $this->get_shipping_country() ) ) {
|
|
|
|
$this->set_shipping_country( $this->get_billing_country() );
|
|
|
|
}
|
|
|
|
|
|
|
|
if ( empty( $this->get_billing_state() ) ) {
|
|
|
|
$this->set_billing_state( $default['state'] );
|
|
|
|
}
|
|
|
|
|
|
|
|
if ( empty( $this->get_shipping_state() ) ) {
|
|
|
|
$this->set_shipping_state( $this->get_billing_state() );
|
2016-03-11 18:28:34 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2016-03-09 20:49:02 +00:00
|
|
|
/*
|
|
|
|
|--------------------------------------------------------------------------
|
|
|
|
| Getters
|
|
|
|
|--------------------------------------------------------------------------
|
|
|
|
| Methods for getting data from the customer object.
|
2013-11-27 09:03:47 +00:00
|
|
|
*/
|
2014-09-22 12:23:28 +00:00
|
|
|
|
|
|
|
/**
|
2016-08-15 12:17:43 +00:00
|
|
|
* Return a customer's user ID. Logged out users have ID 0.
|
2016-03-08 21:44:28 +00:00
|
|
|
* @since 2.7.0
|
2016-08-15 12:17:43 +00:00
|
|
|
* @return int
|
2014-09-22 12:23:28 +00:00
|
|
|
*/
|
2016-03-09 20:49:02 +00:00
|
|
|
public function get_id() {
|
|
|
|
return $this->_data['id'];
|
2014-09-22 12:23:28 +00:00
|
|
|
}
|
|
|
|
|
2014-11-18 13:32:44 +00:00
|
|
|
/**
|
2016-03-09 20:49:02 +00:00
|
|
|
* Return the customer's username.
|
|
|
|
* @since 2.7.0
|
2014-11-18 13:32:44 +00:00
|
|
|
* @return string
|
|
|
|
*/
|
2016-03-09 20:49:02 +00:00
|
|
|
public function get_username() {
|
|
|
|
return $this->_data['username'];
|
2014-09-22 12:23:28 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
2016-03-09 20:49:02 +00:00
|
|
|
* Return the customer's email.
|
|
|
|
* @since 2.7.0
|
2014-09-22 12:23:28 +00:00
|
|
|
* @return string
|
|
|
|
*/
|
2016-03-09 20:49:02 +00:00
|
|
|
public function get_email() {
|
2016-08-09 10:16:54 +00:00
|
|
|
return $this->_data['email'];
|
2014-04-04 07:38:56 +00:00
|
|
|
}
|
2012-08-14 19:42:38 +00:00
|
|
|
|
2016-03-10 16:22:47 +00:00
|
|
|
/**
|
|
|
|
* Return customer's first name.
|
|
|
|
* @since 2.7.0
|
|
|
|
* @return string
|
|
|
|
*/
|
2016-03-11 18:28:34 +00:00
|
|
|
public function get_first_name() {
|
|
|
|
return $this->_data['first_name'];
|
|
|
|
}
|
2016-03-10 16:22:47 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Return customer's last name.
|
|
|
|
* @since 2.7.0
|
|
|
|
* @return string
|
|
|
|
*/
|
2016-03-11 18:28:34 +00:00
|
|
|
public function get_last_name() {
|
|
|
|
return $this->_data['last_name'];
|
|
|
|
}
|
2016-03-10 16:22:47 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Return customer's user role.
|
|
|
|
* @since 2.7.0
|
|
|
|
* @return string
|
|
|
|
*/
|
2016-03-11 18:28:34 +00:00
|
|
|
public function get_role() {
|
|
|
|
return $this->_data['role'];
|
|
|
|
}
|
2016-03-10 16:22:47 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Return customer's last order ID.
|
|
|
|
* @since 2.7.0
|
2016-03-11 18:28:34 +00:00
|
|
|
* @return integer|null
|
2016-03-10 16:22:47 +00:00
|
|
|
*/
|
2016-03-11 18:28:34 +00:00
|
|
|
public function get_last_order_id() {
|
|
|
|
return ( is_null( $this->_data['last_order_id'] ) ? null : intval( $this->_data['last_order_id'] ) );
|
|
|
|
}
|
2016-03-10 16:22:47 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Return the date of the customer's last order.
|
|
|
|
* @since 2.7.0
|
2016-03-11 18:28:34 +00:00
|
|
|
* @return integer|null
|
2016-03-10 16:22:47 +00:00
|
|
|
*/
|
2016-03-11 18:28:34 +00:00
|
|
|
public function get_last_order_date() {
|
|
|
|
return ( is_null( $this->_data['last_order_date'] ) ? null : intval( $this->_data['last_order_date'] ) );
|
|
|
|
}
|
2016-03-10 16:22:47 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Return the number of orders this customer has.
|
|
|
|
* @since 2.7.0
|
|
|
|
* @return integer
|
|
|
|
*/
|
2016-03-11 18:28:34 +00:00
|
|
|
public function get_orders_count() {
|
|
|
|
return intval( $this->_data['orders_count'] );
|
|
|
|
}
|
2016-03-10 16:22:47 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Return how much money this customer has spent.
|
|
|
|
* @since 2.7.0
|
|
|
|
* @return float
|
|
|
|
*/
|
2016-03-11 18:28:34 +00:00
|
|
|
public function get_total_spent() {
|
|
|
|
return wc_format_decimal( $this->_data['total_spent'] );
|
|
|
|
}
|
2016-03-10 16:22:47 +00:00
|
|
|
|
|
|
|
/**
|
2016-03-11 18:28:34 +00:00
|
|
|
* Return this customer's avatar.
|
2016-03-10 16:22:47 +00:00
|
|
|
* @since 2.7.0
|
|
|
|
* @return string
|
|
|
|
*/
|
2016-03-11 18:28:34 +00:00
|
|
|
public function get_avatar_url() {
|
|
|
|
$avatar_html = get_avatar( $this->get_email() );
|
|
|
|
|
|
|
|
// Get the URL of the avatar from the provided HTML
|
|
|
|
preg_match( '/src=["|\'](.+)[\&|"|\']/U', $avatar_html, $matches );
|
|
|
|
|
|
|
|
if ( isset( $matches[1] ) && ! empty( $matches[1] ) ) {
|
|
|
|
return esc_url( $matches[1] );
|
|
|
|
}
|
|
|
|
|
|
|
|
return '';
|
|
|
|
}
|
2016-03-10 16:22:47 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Return the date this customer was created.
|
|
|
|
* @since 2.7.0
|
|
|
|
* @return integer
|
|
|
|
*/
|
|
|
|
public function get_date_created() {
|
|
|
|
return absint( $this->_data['date_created'] );
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Return the date this customer was last updated.
|
|
|
|
* @since 2.7.0
|
|
|
|
* @return integer
|
|
|
|
*/
|
|
|
|
public function get_date_modified() {
|
|
|
|
return absint( $this->_data['date_modified'] );
|
|
|
|
}
|
|
|
|
|
2012-08-14 19:42:38 +00:00
|
|
|
/**
|
2016-03-09 20:49:02 +00:00
|
|
|
* Gets customer postcode.
|
2012-08-14 19:42:38 +00:00
|
|
|
* @return string
|
|
|
|
*/
|
2016-03-17 19:39:29 +00:00
|
|
|
public function get_billing_postcode() {
|
|
|
|
return wc_format_postcode( $this->_data['billing_postcode'], $this->get_billing_country() );
|
2011-08-09 15:16:18 +00:00
|
|
|
}
|
2012-08-14 19:42:38 +00:00
|
|
|
|
|
|
|
/**
|
2016-03-09 20:49:02 +00:00
|
|
|
* Get customer city.
|
2012-08-14 19:42:38 +00:00
|
|
|
* @return string
|
|
|
|
*/
|
2016-03-17 19:39:29 +00:00
|
|
|
public function get_billing_city() {
|
|
|
|
return $this->_data['billing_city'];
|
2011-08-09 15:16:18 +00:00
|
|
|
}
|
2012-08-14 19:42:38 +00:00
|
|
|
|
|
|
|
/**
|
2016-03-09 20:49:02 +00:00
|
|
|
* Get customer address.
|
2012-08-14 19:42:38 +00:00
|
|
|
* @return string
|
|
|
|
*/
|
2016-03-17 19:39:29 +00:00
|
|
|
public function get_billing_address() {
|
|
|
|
return $this->_data['billing_address_1'];
|
2012-09-23 16:16:39 +00:00
|
|
|
}
|
2012-11-27 16:22:47 +00:00
|
|
|
|
2016-03-15 18:37:42 +00:00
|
|
|
/**
|
|
|
|
* Get customer address.
|
|
|
|
* @return string
|
|
|
|
*/
|
2016-03-17 19:39:29 +00:00
|
|
|
public function get_billing_address_1() {
|
|
|
|
return $this->get_billing_address();
|
2016-03-15 18:37:42 +00:00
|
|
|
}
|
|
|
|
|
2012-09-23 16:16:39 +00:00
|
|
|
/**
|
2016-03-09 20:49:02 +00:00
|
|
|
* Get customer's second address.
|
2013-11-27 09:03:47 +00:00
|
|
|
* @return string
|
2012-09-23 16:16:39 +00:00
|
|
|
*/
|
2016-03-17 19:39:29 +00:00
|
|
|
public function get_billing_address_2() {
|
|
|
|
return $this->_data['billing_address_2'];
|
2011-08-09 15:16:18 +00:00
|
|
|
}
|
2012-08-14 19:42:38 +00:00
|
|
|
|
2012-11-27 01:56:48 +00:00
|
|
|
/**
|
2016-03-09 20:49:02 +00:00
|
|
|
* Get customer state.
|
2013-11-27 09:03:47 +00:00
|
|
|
* @return string
|
2012-11-27 01:56:48 +00:00
|
|
|
*/
|
2016-03-17 19:39:29 +00:00
|
|
|
public function get_billing_state() {
|
|
|
|
return $this->_data['billing_state'];
|
2012-11-27 01:56:48 +00:00
|
|
|
}
|
2012-11-27 16:22:47 +00:00
|
|
|
|
2012-11-27 01:56:48 +00:00
|
|
|
/**
|
2016-03-09 20:49:02 +00:00
|
|
|
* Get customer country.
|
2013-11-27 09:03:47 +00:00
|
|
|
* @return string
|
2012-11-27 01:56:48 +00:00
|
|
|
*/
|
2016-03-17 19:39:29 +00:00
|
|
|
public function get_billing_country() {
|
|
|
|
return $this->_data['billing_country'];
|
2012-11-27 01:56:48 +00:00
|
|
|
}
|
2012-08-14 19:42:38 +00:00
|
|
|
|
|
|
|
/**
|
2016-03-09 20:49:02 +00:00
|
|
|
* Get customer's shipping state.
|
2012-08-14 19:42:38 +00:00
|
|
|
* @return string
|
|
|
|
*/
|
2012-12-14 21:43:45 +00:00
|
|
|
public function get_shipping_state() {
|
2016-03-09 20:49:02 +00:00
|
|
|
return $this->_data['shipping_state'];
|
2011-08-09 15:16:18 +00:00
|
|
|
}
|
2012-08-14 19:42:38 +00:00
|
|
|
|
|
|
|
/**
|
2016-03-09 20:49:02 +00:00
|
|
|
* Get customer's shipping country.
|
2012-08-14 19:42:38 +00:00
|
|
|
* @return string
|
|
|
|
*/
|
2012-12-14 21:43:45 +00:00
|
|
|
public function get_shipping_country() {
|
2016-03-09 20:49:02 +00:00
|
|
|
return $this->_data['shipping_country'];
|
2011-08-09 15:16:18 +00:00
|
|
|
}
|
2012-08-14 19:42:38 +00:00
|
|
|
|
|
|
|
/**
|
2016-03-09 20:49:02 +00:00
|
|
|
* Get customer's shipping postcode.
|
2012-08-14 19:42:38 +00:00
|
|
|
* @return string
|
|
|
|
*/
|
2012-12-14 21:43:45 +00:00
|
|
|
public function get_shipping_postcode() {
|
2016-03-09 20:49:02 +00:00
|
|
|
return wc_format_postcode( $this->_data['shipping_postcode'], $this->get_shipping_country() );
|
2012-09-23 16:16:39 +00:00
|
|
|
}
|
2012-11-27 16:22:47 +00:00
|
|
|
|
2012-09-23 16:16:39 +00:00
|
|
|
/**
|
2016-03-09 20:49:02 +00:00
|
|
|
* Get customer's shipping city.
|
2013-11-27 09:03:47 +00:00
|
|
|
* @return string
|
2012-09-23 16:16:39 +00:00
|
|
|
*/
|
2012-12-14 21:43:45 +00:00
|
|
|
public function get_shipping_city() {
|
2016-03-09 20:49:02 +00:00
|
|
|
return $this->_data['shipping_city'];
|
2011-08-09 15:16:18 +00:00
|
|
|
}
|
2012-11-27 16:22:47 +00:00
|
|
|
|
2012-11-27 01:56:48 +00:00
|
|
|
/**
|
2016-03-09 20:49:02 +00:00
|
|
|
* Get customer's shipping address.
|
2013-11-27 09:03:47 +00:00
|
|
|
* @return string
|
2012-11-27 01:56:48 +00:00
|
|
|
*/
|
2012-12-14 21:43:45 +00:00
|
|
|
public function get_shipping_address() {
|
2016-03-09 20:49:02 +00:00
|
|
|
return $this->_data['shipping_address_1'];
|
2012-11-27 01:56:48 +00:00
|
|
|
}
|
2012-11-27 16:22:47 +00:00
|
|
|
|
2016-03-15 18:37:42 +00:00
|
|
|
/**
|
|
|
|
* Get customer address.
|
|
|
|
* @return string
|
|
|
|
*/
|
|
|
|
public function get_shipping_address_1() {
|
|
|
|
return $this->get_shipping_address();
|
|
|
|
}
|
|
|
|
|
2012-11-27 01:56:48 +00:00
|
|
|
/**
|
2016-03-09 20:49:02 +00:00
|
|
|
* Get customer's second shipping address.
|
2013-11-27 09:03:47 +00:00
|
|
|
* @return string
|
2012-11-27 01:56:48 +00:00
|
|
|
*/
|
2012-12-14 21:43:45 +00:00
|
|
|
public function get_shipping_address_2() {
|
2016-03-09 20:49:02 +00:00
|
|
|
return $this->_data['shipping_address_2'];
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Get if customer is VAT exempt?
|
|
|
|
* @since 2.7.0
|
|
|
|
* @return bool
|
|
|
|
*/
|
|
|
|
public function get_is_vat_exempt() {
|
|
|
|
return ( ! empty( $this->_data['is_vat_exempt'] ) ) ? true : false;
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Has customer calculated shipping?
|
|
|
|
* @return bool
|
|
|
|
*/
|
|
|
|
public function get_calculated_shipping() {
|
|
|
|
return ! empty( $this->_data['calculated_shipping'] );
|
2012-11-27 01:56:48 +00:00
|
|
|
}
|
2012-11-27 16:22:47 +00:00
|
|
|
|
2012-10-01 09:45:07 +00:00
|
|
|
/**
|
2016-01-06 14:56:25 +00:00
|
|
|
* Get taxable address.
|
2013-11-27 09:03:47 +00:00
|
|
|
* @return array
|
2012-10-01 09:45:07 +00:00
|
|
|
*/
|
2012-12-14 21:43:45 +00:00
|
|
|
public function get_taxable_address() {
|
2012-12-03 15:13:59 +00:00
|
|
|
$tax_based_on = get_option( 'woocommerce_tax_based_on' );
|
|
|
|
|
2013-09-03 15:26:02 +00:00
|
|
|
// Check shipping method at this point to see if we need special handling
|
2016-06-29 14:23:39 +00:00
|
|
|
if ( true === apply_filters( 'woocommerce_apply_base_tax_for_local_pickup', true ) && sizeof( array_intersect( wc_get_chosen_shipping_method_ids(), apply_filters( 'woocommerce_local_pickup_methods', array( 'legacy_local_pickup', 'local_pickup' ) ) ) ) > 0 ) {
|
2013-09-03 15:26:02 +00:00
|
|
|
$tax_based_on = 'base';
|
|
|
|
}
|
|
|
|
|
2015-06-22 14:30:34 +00:00
|
|
|
if ( 'base' === $tax_based_on ) {
|
2015-06-23 10:50:15 +00:00
|
|
|
$country = WC()->countries->get_base_country();
|
|
|
|
$state = WC()->countries->get_base_state();
|
|
|
|
$postcode = WC()->countries->get_base_postcode();
|
|
|
|
$city = WC()->countries->get_base_city();
|
2015-06-17 14:19:04 +00:00
|
|
|
} elseif ( 'billing' === $tax_based_on ) {
|
2016-03-17 19:39:29 +00:00
|
|
|
$country = $this->get_billing_country();
|
|
|
|
$state = $this->get_billing_state();
|
|
|
|
$postcode = $this->get_billing_postcode();
|
|
|
|
$city = $this->get_billing_city();
|
2012-12-03 15:13:59 +00:00
|
|
|
} else {
|
2014-11-18 14:32:48 +00:00
|
|
|
$country = $this->get_shipping_country();
|
|
|
|
$state = $this->get_shipping_state();
|
|
|
|
$postcode = $this->get_shipping_postcode();
|
|
|
|
$city = $this->get_shipping_city();
|
2012-10-01 09:45:07 +00:00
|
|
|
}
|
2012-12-03 15:13:59 +00:00
|
|
|
|
2012-10-01 09:45:07 +00:00
|
|
|
return apply_filters( 'woocommerce_customer_taxable_address', array( $country, $state, $postcode, $city ) );
|
|
|
|
}
|
2012-08-14 19:42:38 +00:00
|
|
|
|
2015-03-27 16:43:04 +00:00
|
|
|
/**
|
2016-03-09 20:49:02 +00:00
|
|
|
* Gets a customer's downloadable products.
|
|
|
|
* @return array Array of downloadable products
|
|
|
|
*/
|
|
|
|
public function get_downloadable_products() {
|
|
|
|
$downloads = array();
|
2016-08-15 12:17:43 +00:00
|
|
|
if ( $this->get_id() ) {
|
2016-03-09 20:49:02 +00:00
|
|
|
$downloads = wc_get_customer_available_downloads( $this->get_id() );
|
2015-03-27 16:43:04 +00:00
|
|
|
}
|
2016-03-09 20:49:02 +00:00
|
|
|
return apply_filters( 'woocommerce_customer_get_downloadable_products', $downloads );
|
|
|
|
}
|
2015-03-27 16:43:04 +00:00
|
|
|
|
2016-03-09 20:49:02 +00:00
|
|
|
/**
|
|
|
|
* Is the user a paying customer?
|
|
|
|
* @since 2.7.0
|
|
|
|
* @return bool
|
|
|
|
*/
|
|
|
|
function get_is_paying_customer() {
|
|
|
|
return (bool) $this->_data['is_paying_customer'];
|
|
|
|
}
|
2015-03-27 16:52:21 +00:00
|
|
|
|
2016-03-09 20:49:02 +00:00
|
|
|
/*
|
|
|
|
|--------------------------------------------------------------------------
|
|
|
|
| Setters
|
|
|
|
|--------------------------------------------------------------------------
|
|
|
|
| Functions for setting customer data. These should not update anything in the
|
|
|
|
| database itself and should only change what is stored in the class
|
|
|
|
| object.
|
|
|
|
*/
|
2015-03-27 16:52:21 +00:00
|
|
|
|
2016-03-09 20:49:02 +00:00
|
|
|
/**
|
|
|
|
* Set customer's username.
|
|
|
|
* @since 2.7.0
|
|
|
|
* @param string $username
|
|
|
|
*/
|
|
|
|
public function set_username( $username ) {
|
|
|
|
$this->_data['username'] = $username;
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Set customer's email.
|
|
|
|
* @since 2.7.0
|
|
|
|
* @param string $email
|
|
|
|
*/
|
|
|
|
public function set_email( $email ) {
|
|
|
|
$this->_data['email'] = sanitize_email( $email );
|
|
|
|
}
|
|
|
|
|
2016-03-10 16:22:47 +00:00
|
|
|
/**
|
|
|
|
* Set customer's first name.
|
|
|
|
* @since 2.7.0
|
|
|
|
* @param string $first_name
|
|
|
|
*/
|
2016-03-11 18:28:34 +00:00
|
|
|
public function set_first_name( $first_name ) {
|
|
|
|
$this->_data['first_name'] = $first_name;
|
|
|
|
}
|
2016-03-10 16:22:47 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Set customer's last name.
|
|
|
|
* @since 2.7.0
|
|
|
|
* @param string $last_name
|
|
|
|
*/
|
2016-03-11 18:28:34 +00:00
|
|
|
public function set_last_name( $last_name ) {
|
|
|
|
$this->_data['last_name'] = $last_name;
|
|
|
|
}
|
2016-03-10 16:22:47 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Set customer's user role(s).
|
|
|
|
* @since 2.7.0
|
2016-03-11 18:28:34 +00:00
|
|
|
* @param mixed $role
|
2016-03-10 16:22:47 +00:00
|
|
|
*/
|
2016-03-11 18:28:34 +00:00
|
|
|
public function set_role( $role ) {
|
|
|
|
$this->_data['role'] = $role;
|
|
|
|
}
|
2016-03-10 16:22:47 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Set customer's last order ID.
|
|
|
|
* @since 2.7.0
|
2016-03-11 18:28:34 +00:00
|
|
|
* @param integer|null $last_order_id
|
2016-03-10 16:22:47 +00:00
|
|
|
*/
|
2016-03-11 18:28:34 +00:00
|
|
|
public function set_last_order_id( $last_order_id ) {
|
|
|
|
$this->_data['last_order_id'] = $last_order_id;
|
|
|
|
}
|
2016-03-10 16:22:47 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Set the date of the customer's last order.
|
|
|
|
* @since 2.7.0
|
2016-03-11 18:28:34 +00:00
|
|
|
* @param string|null $last_order_date
|
2016-03-10 16:22:47 +00:00
|
|
|
*/
|
2016-03-11 18:28:34 +00:00
|
|
|
public function set_last_order_date( $last_order_date ) {
|
|
|
|
$this->_data['last_order_date'] = $last_order_date;
|
|
|
|
}
|
2016-03-10 16:22:47 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Set the number of orders this customer has.
|
|
|
|
* @since 2.7.0
|
2016-03-11 18:28:34 +00:00
|
|
|
* @param integer $order_count
|
2016-03-10 16:22:47 +00:00
|
|
|
*/
|
2016-03-11 18:28:34 +00:00
|
|
|
public function set_orders_count( $orders_count ) {
|
|
|
|
$this->_data['orders_count'] = $orders_count;
|
|
|
|
}
|
2016-03-10 16:22:47 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Return how much money this customer has spent.
|
|
|
|
* @since 2.7.0
|
|
|
|
* @param float $total_spent
|
|
|
|
*/
|
2016-03-11 18:28:34 +00:00
|
|
|
public function set_total_spent( $total_spent ) {
|
|
|
|
$this->_data['total_spent'] = $total_spent;
|
|
|
|
}
|
2016-03-10 16:22:47 +00:00
|
|
|
|
2016-03-09 20:49:02 +00:00
|
|
|
/**
|
|
|
|
* Set customer's password.
|
|
|
|
* @since 2.7.0
|
|
|
|
* @param string $password
|
|
|
|
*/
|
|
|
|
public function set_password( $password ) {
|
|
|
|
$this->_data['password'] = wc_clean( $password );
|
|
|
|
}
|
|
|
|
|
2016-03-10 16:22:47 +00:00
|
|
|
/**
|
2016-03-15 18:37:42 +00:00
|
|
|
* Set the date this customer was last updated.
|
2016-03-10 16:22:47 +00:00
|
|
|
* @since 2.7.0
|
|
|
|
* @param integer $timestamp
|
|
|
|
*/
|
2016-03-15 18:37:42 +00:00
|
|
|
public function set_date_modified( $timestamp ) {
|
2016-03-10 16:22:47 +00:00
|
|
|
$this->_data['date_modified'] = is_numeric( $timestamp ) ? $timestamp : strtotime( $timestamp );
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
2016-03-15 18:37:42 +00:00
|
|
|
* Set the date this customer was last updated.
|
2016-03-10 16:22:47 +00:00
|
|
|
* @since 2.7.0
|
|
|
|
* @param integer $timestamp
|
|
|
|
*/
|
2016-03-15 18:37:42 +00:00
|
|
|
public function set_date_created( $timestamp ) {
|
2016-03-11 18:28:34 +00:00
|
|
|
$this->_data['date_created'] = is_numeric( $timestamp ) ? $timestamp : strtotime( $timestamp );
|
2016-03-10 16:22:47 +00:00
|
|
|
}
|
|
|
|
|
2016-03-09 20:49:02 +00:00
|
|
|
/**
|
|
|
|
* Set customer address to match shop base address.
|
|
|
|
* @since 2.7.0
|
|
|
|
*/
|
2016-03-17 19:39:29 +00:00
|
|
|
public function set_billing_address_to_base() {
|
2016-03-09 20:49:02 +00:00
|
|
|
$base = wc_get_customer_default_location();
|
2016-03-17 19:39:29 +00:00
|
|
|
$this->_data['billing_country'] = $base['country'];
|
|
|
|
$this->_data['billing_state'] = $base['state'];
|
|
|
|
$this->_data['billing_postcode'] = '';
|
|
|
|
$this->_data['billing_city'] = '';
|
2016-03-09 20:49:02 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Set customer shipping address to base address.
|
|
|
|
* @since 2.7.0
|
|
|
|
*/
|
2016-03-15 18:37:42 +00:00
|
|
|
public function set_shipping_address_to_base() {
|
2016-03-09 20:49:02 +00:00
|
|
|
$base = wc_get_customer_default_location();
|
|
|
|
$this->_data['shipping_country'] = $base['country'];
|
|
|
|
$this->_data['shipping_state'] = $base['state'];
|
|
|
|
$this->_data['shipping_postcode'] = '';
|
|
|
|
$this->_data['shipping_city'] = '';
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Sets all shipping info at once.
|
|
|
|
* @param string $country
|
|
|
|
* @param string $state
|
|
|
|
* @param string $postcode
|
|
|
|
* @param string $city
|
|
|
|
*/
|
|
|
|
public function set_shipping_location( $country, $state = '', $postcode = '', $city = '' ) {
|
|
|
|
$this->_data['shipping_country'] = $country;
|
|
|
|
$this->_data['shipping_state'] = $state;
|
|
|
|
$this->_data['shipping_postcode'] = $postcode;
|
|
|
|
$this->_data['shipping_city'] = $city;
|
2015-03-27 16:43:04 +00:00
|
|
|
}
|
|
|
|
|
2012-08-14 19:42:38 +00:00
|
|
|
/**
|
2016-03-09 20:49:02 +00:00
|
|
|
* Sets all address info at once.
|
2014-09-07 23:37:55 +00:00
|
|
|
* @param string $country
|
|
|
|
* @param string $state
|
2016-03-09 20:49:02 +00:00
|
|
|
* @param string $postcode
|
|
|
|
* @param string $city
|
2012-08-14 19:42:38 +00:00
|
|
|
*/
|
2016-03-17 19:39:29 +00:00
|
|
|
public function set_billing_location( $country, $state, $postcode = '', $city = '' ) {
|
|
|
|
$this->_data['billing_country'] = $country;
|
|
|
|
$this->_data['billing_state'] = $state;
|
|
|
|
$this->_data['billing_postcode'] = $postcode;
|
|
|
|
$this->_data['billing_city'] = $city;
|
2011-08-09 15:16:18 +00:00
|
|
|
}
|
2012-08-14 19:42:38 +00:00
|
|
|
|
|
|
|
/**
|
2016-03-09 20:49:02 +00:00
|
|
|
* Set customer country.
|
2012-08-14 19:42:38 +00:00
|
|
|
* @param mixed $country
|
|
|
|
*/
|
2016-03-17 19:39:29 +00:00
|
|
|
public function set_billing_country( $country ) {
|
|
|
|
$this->_data['billing_country'] = $country;
|
2011-08-09 15:16:18 +00:00
|
|
|
}
|
2012-08-14 19:42:38 +00:00
|
|
|
|
|
|
|
/**
|
2016-03-09 20:49:02 +00:00
|
|
|
* Set customer state.
|
2012-08-14 19:42:38 +00:00
|
|
|
* @param mixed $state
|
|
|
|
*/
|
2016-03-17 19:39:29 +00:00
|
|
|
public function set_billing_state( $state ) {
|
|
|
|
$this->_data['billing_state'] = $state;
|
2011-08-09 15:16:18 +00:00
|
|
|
}
|
2012-08-14 19:42:38 +00:00
|
|
|
|
|
|
|
/**
|
2016-03-09 20:49:02 +00:00
|
|
|
* Sets customer postcode.
|
2012-08-14 19:42:38 +00:00
|
|
|
* @param mixed $postcode
|
|
|
|
*/
|
2016-03-17 19:39:29 +00:00
|
|
|
public function set_billing_postcode( $postcode ) {
|
|
|
|
$this->_data['billing_postcode'] = $postcode;
|
2011-08-09 15:16:18 +00:00
|
|
|
}
|
2012-08-14 19:42:38 +00:00
|
|
|
|
2012-09-23 16:16:39 +00:00
|
|
|
/**
|
2016-03-09 20:49:02 +00:00
|
|
|
* Sets customer city.
|
2014-09-02 19:50:19 +00:00
|
|
|
* @param mixed $city
|
2012-09-23 16:16:39 +00:00
|
|
|
*/
|
2016-03-17 19:39:29 +00:00
|
|
|
public function set_billing_city( $city ) {
|
|
|
|
$this->_data['billing_city'] = $city;
|
2012-09-23 16:16:39 +00:00
|
|
|
}
|
|
|
|
|
2012-11-27 01:56:48 +00:00
|
|
|
/**
|
2016-03-09 20:49:02 +00:00
|
|
|
* Set customer address.
|
2012-11-27 01:56:48 +00:00
|
|
|
* @param mixed $address
|
|
|
|
*/
|
2016-03-17 19:39:29 +00:00
|
|
|
public function set_billing_address( $address ) {
|
|
|
|
$this->_data['billing_address_1'] = $address;
|
2012-11-27 01:56:48 +00:00
|
|
|
}
|
|
|
|
|
2016-03-14 19:14:50 +00:00
|
|
|
/**
|
|
|
|
* Set customer address.
|
|
|
|
* @param mixed $address
|
|
|
|
*/
|
2016-03-17 19:39:29 +00:00
|
|
|
public function set_billing_address_1( $address ) {
|
|
|
|
$this->set_billing_address( $address );
|
2016-03-14 19:14:50 +00:00
|
|
|
}
|
|
|
|
|
2012-11-27 01:56:48 +00:00
|
|
|
/**
|
2016-03-09 20:49:02 +00:00
|
|
|
* Set customer's second address.
|
2015-08-05 13:05:00 +00:00
|
|
|
* @param mixed $address
|
2012-11-27 01:56:48 +00:00
|
|
|
*/
|
2016-03-17 19:39:29 +00:00
|
|
|
public function set_billing_address_2( $address ) {
|
|
|
|
$this->_data['billing_address_2'] = $address;
|
2011-08-09 15:16:18 +00:00
|
|
|
}
|
2012-08-14 19:42:38 +00:00
|
|
|
|
|
|
|
/**
|
2016-03-09 20:49:02 +00:00
|
|
|
* Set shipping country.
|
2014-05-15 12:27:13 +00:00
|
|
|
* @param string $country
|
2012-08-14 19:42:38 +00:00
|
|
|
*/
|
2012-12-14 21:43:45 +00:00
|
|
|
public function set_shipping_country( $country ) {
|
2016-03-09 20:49:02 +00:00
|
|
|
$this->_data['shipping_country'] = $country;
|
2011-08-09 15:16:18 +00:00
|
|
|
}
|
2012-08-14 19:42:38 +00:00
|
|
|
|
|
|
|
/**
|
2016-03-09 20:49:02 +00:00
|
|
|
* Set shipping state.
|
2014-05-15 12:27:13 +00:00
|
|
|
* @param string $state
|
2012-08-14 19:42:38 +00:00
|
|
|
*/
|
2012-12-14 21:43:45 +00:00
|
|
|
public function set_shipping_state( $state ) {
|
2016-03-09 20:49:02 +00:00
|
|
|
$this->_data['shipping_state'] = $state;
|
2011-08-09 15:16:18 +00:00
|
|
|
}
|
2012-08-14 19:42:38 +00:00
|
|
|
|
|
|
|
/**
|
2016-03-09 20:49:02 +00:00
|
|
|
* Set shipping postcode.
|
2014-05-15 12:27:13 +00:00
|
|
|
* @param string $postcode
|
2012-08-14 19:42:38 +00:00
|
|
|
*/
|
2012-12-14 21:43:45 +00:00
|
|
|
public function set_shipping_postcode( $postcode ) {
|
2016-03-09 20:49:02 +00:00
|
|
|
$this->_data['shipping_postcode'] = $postcode;
|
2012-09-23 16:16:39 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
2016-03-09 20:49:02 +00:00
|
|
|
* Sets shipping city.
|
2014-09-02 19:50:19 +00:00
|
|
|
* @param string $city
|
2012-09-23 16:16:39 +00:00
|
|
|
*/
|
2012-12-14 21:43:45 +00:00
|
|
|
public function set_shipping_city( $city ) {
|
2016-03-09 20:49:02 +00:00
|
|
|
$this->_data['shipping_city'] = $city;
|
2011-08-09 15:16:18 +00:00
|
|
|
}
|
2012-08-14 19:42:38 +00:00
|
|
|
|
2012-11-27 01:56:48 +00:00
|
|
|
/**
|
2016-03-09 20:49:02 +00:00
|
|
|
* Set shipping address.
|
2014-05-15 12:27:13 +00:00
|
|
|
* @param string $address
|
2012-11-27 01:56:48 +00:00
|
|
|
*/
|
2012-12-14 21:43:45 +00:00
|
|
|
public function set_shipping_address( $address ) {
|
2016-03-09 20:49:02 +00:00
|
|
|
$this->_data['shipping_address_1'] = $address;
|
2012-11-27 01:56:48 +00:00
|
|
|
}
|
|
|
|
|
2016-03-14 19:14:50 +00:00
|
|
|
/**
|
|
|
|
* Set customer shipping address.
|
|
|
|
* @param mixed $address
|
|
|
|
*/
|
|
|
|
public function set_shipping_address_1( $address ) {
|
|
|
|
$this->set_shipping_address( $address );
|
|
|
|
}
|
|
|
|
|
2012-11-27 01:56:48 +00:00
|
|
|
/**
|
2016-03-09 20:49:02 +00:00
|
|
|
* Set second shipping address.
|
2015-08-05 13:05:00 +00:00
|
|
|
* @param string $address
|
2012-11-27 01:56:48 +00:00
|
|
|
*/
|
2015-08-05 13:05:00 +00:00
|
|
|
public function set_shipping_address_2( $address ) {
|
2016-03-09 20:49:02 +00:00
|
|
|
$this->_data['shipping_address_2'] = $address;
|
2012-11-27 01:56:48 +00:00
|
|
|
}
|
|
|
|
|
2012-08-14 19:42:38 +00:00
|
|
|
/**
|
2016-03-09 20:49:02 +00:00
|
|
|
* Set if customer has tax exemption.
|
2014-05-15 12:27:13 +00:00
|
|
|
* @param bool $is_vat_exempt
|
2012-08-14 19:42:38 +00:00
|
|
|
*/
|
2012-12-14 21:43:45 +00:00
|
|
|
public function set_is_vat_exempt( $is_vat_exempt ) {
|
2016-03-09 20:49:02 +00:00
|
|
|
$this->_data['is_vat_exempt'] = $is_vat_exempt;
|
2011-09-14 14:55:03 +00:00
|
|
|
}
|
2012-08-14 19:42:38 +00:00
|
|
|
|
2012-09-07 18:28:27 +00:00
|
|
|
/**
|
2016-03-09 20:49:02 +00:00
|
|
|
* Calculated shipping?
|
2014-09-07 23:37:55 +00:00
|
|
|
* @param boolean $calculated
|
2012-09-07 18:28:27 +00:00
|
|
|
*/
|
2016-03-09 20:49:02 +00:00
|
|
|
public function set_calculated_shipping( $calculated = true ) {
|
|
|
|
$this->_data['calculated_shipping'] = $calculated;
|
2012-09-07 18:28:27 +00:00
|
|
|
}
|
2012-11-27 16:22:47 +00:00
|
|
|
|
2011-08-09 15:16:18 +00:00
|
|
|
/**
|
2016-03-09 20:49:02 +00:00
|
|
|
* Set if the user a paying customer.
|
|
|
|
* @since 2.7.0
|
|
|
|
* @param boolean $is_paying_customer
|
2011-08-09 15:16:18 +00:00
|
|
|
*/
|
2016-03-09 20:49:02 +00:00
|
|
|
function set_is_paying_customer( $is_paying_customer ) {
|
|
|
|
$this->_data['is_paying_customer'] = (bool) $is_paying_customer;
|
|
|
|
}
|
2014-02-17 11:58:14 +00:00
|
|
|
|
2016-03-09 20:49:02 +00:00
|
|
|
/*
|
|
|
|
|--------------------------------------------------------------------------
|
|
|
|
| Other methods
|
|
|
|
|--------------------------------------------------------------------------
|
|
|
|
| Other functions for interacting with customers.
|
|
|
|
*/
|
2012-08-28 15:21:54 +00:00
|
|
|
|
2016-03-09 20:49:02 +00:00
|
|
|
/**
|
|
|
|
* Is customer outside base country (for tax purposes)?
|
|
|
|
* @return bool
|
|
|
|
*/
|
|
|
|
public function is_customer_outside_base() {
|
|
|
|
list( $country, $state ) = $this->get_taxable_address();
|
|
|
|
if ( $country ) {
|
|
|
|
$default = wc_get_base_location();
|
|
|
|
if ( $default['country'] !== $country ) {
|
|
|
|
return true;
|
|
|
|
}
|
|
|
|
if ( $default['state'] && $default['state'] !== $state ) {
|
|
|
|
return true;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
return false;
|
2012-08-14 19:42:38 +00:00
|
|
|
}
|
2016-03-08 21:44:28 +00:00
|
|
|
|
|
|
|
/*
|
|
|
|
|--------------------------------------------------------------------------
|
|
|
|
| CRUD methods
|
|
|
|
|--------------------------------------------------------------------------
|
|
|
|
| Methods which create, read, update and delete from the database.
|
|
|
|
|
|
|
|
|
| A save method is included for convenience (chooses update or create based
|
|
|
|
| on if the order exists yet).
|
|
|
|
*/
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Create a customer.
|
|
|
|
* @since 2.7.0.
|
|
|
|
*/
|
|
|
|
public function create() {
|
2016-03-09 20:49:02 +00:00
|
|
|
$customer_id = wc_create_new_customer( $this->get_email(), $this->get_username(), $this->_data['password'] );
|
2016-03-11 18:28:34 +00:00
|
|
|
unset( $this->_data['password'] );
|
2016-03-09 20:49:02 +00:00
|
|
|
if ( $customer_id ) {
|
|
|
|
$this->_data['id'] = $customer_id;
|
2016-03-17 19:39:29 +00:00
|
|
|
update_user_meta( $this->get_id(), 'billing_postcode', $this->get_billing_postcode() );
|
|
|
|
update_user_meta( $this->get_id(), 'billing_city', $this->get_billing_city() );
|
|
|
|
update_user_meta( $this->get_id(), 'billing_address_1', $this->get_billing_address() );
|
|
|
|
update_user_meta( $this->get_id(), 'billing_address_2', $this->get_billing_address_2() );
|
|
|
|
update_user_meta( $this->get_id(), 'billing_state', $this->get_billing_state() );
|
|
|
|
update_user_meta( $this->get_id(), 'billing_country', $this->get_billing_country() );
|
2016-03-09 20:49:02 +00:00
|
|
|
update_user_meta( $this->get_id(), 'shipping_postcode', $this->get_shipping_postcode() );
|
|
|
|
update_user_meta( $this->get_id(), 'shipping_city', $this->get_shipping_city() );
|
|
|
|
update_user_meta( $this->get_id(), 'shipping_address_1', $this->get_shipping_address() );
|
|
|
|
update_user_meta( $this->get_id(), 'shipping_address_2', $this->get_shipping_address_2() );
|
|
|
|
update_user_meta( $this->get_id(), 'shipping_state', $this->get_shipping_state() );
|
|
|
|
update_user_meta( $this->get_id(), 'shipping_country', $this->get_shipping_country() );
|
|
|
|
update_user_meta( $this->get_id(), 'paying_customer', $this->get_is_paying_customer() );
|
2016-03-10 16:22:47 +00:00
|
|
|
update_user_meta( $this->get_id(), 'last_update', $this->get_date_modified() );
|
2016-03-11 18:28:34 +00:00
|
|
|
update_user_meta( $this->get_id(), 'first_name', $this->get_first_name() );
|
|
|
|
update_user_meta( $this->get_id(), 'last_name', $this->get_last_name() );
|
2016-08-15 12:17:43 +00:00
|
|
|
$this->set_date_modified( time() );
|
2016-03-11 18:28:34 +00:00
|
|
|
wp_update_user( array( 'ID' => $this->get_id(), 'role' => $this->get_role() ) );
|
2016-03-17 19:03:23 +00:00
|
|
|
$wp_user = new WP_User( $this->get_id() );
|
|
|
|
$this->set_date_created( strtotime( $wp_user->user_registered ) );
|
2016-08-15 12:17:43 +00:00
|
|
|
$this->read_meta_data();
|
2016-03-09 20:49:02 +00:00
|
|
|
}
|
2016-03-08 21:44:28 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Read a customer from the database.
|
|
|
|
* @since 2.7.0
|
|
|
|
* @param integer $id
|
|
|
|
*/
|
|
|
|
public function read( $id ) {
|
2016-03-11 18:28:34 +00:00
|
|
|
global $wpdb;
|
2016-03-14 21:51:32 +00:00
|
|
|
|
2016-08-15 12:17:43 +00:00
|
|
|
if ( $id ) {
|
2016-03-14 21:51:32 +00:00
|
|
|
// Only continue reading if the customer exists.
|
|
|
|
$user_object = get_userdata( $id );
|
2016-08-15 12:17:43 +00:00
|
|
|
|
|
|
|
if ( empty( $user_object ) || empty( $user_object->ID ) ) {
|
2016-03-14 21:51:32 +00:00
|
|
|
$this->_data['id'] = 0;
|
|
|
|
return;
|
|
|
|
}
|
|
|
|
|
2016-08-15 12:17:43 +00:00
|
|
|
$this->_data['id'] = $id;
|
2016-03-17 19:03:23 +00:00
|
|
|
|
2016-08-15 12:17:43 +00:00
|
|
|
foreach ( array_keys( $this->_data ) as $key ) {
|
2016-03-17 19:39:29 +00:00
|
|
|
$meta_value = get_user_meta( $id, $key, true );
|
2016-03-10 16:22:47 +00:00
|
|
|
if ( $meta_value && is_callable( array( $this, "set_{$key}" ) ) ) {
|
|
|
|
$this->{"set_{$key}"}( $meta_value );
|
|
|
|
}
|
2016-03-08 21:44:28 +00:00
|
|
|
}
|
|
|
|
|
2016-03-10 16:22:47 +00:00
|
|
|
$this->set_is_paying_customer( get_user_meta( $id, 'paying_customer', true ) );
|
2016-03-09 20:49:02 +00:00
|
|
|
$wp_user = new WP_User( $id );
|
2016-03-10 16:22:47 +00:00
|
|
|
$this->set_email( $wp_user->user_email );
|
|
|
|
$this->set_username( $wp_user->user_login );
|
2016-03-11 18:28:34 +00:00
|
|
|
$this->set_date_created( strtotime( $wp_user->user_registered ) );
|
2016-03-10 16:22:47 +00:00
|
|
|
$this->set_date_modified( get_user_meta( $id, 'last_update', true ) );
|
2016-03-17 19:03:23 +00:00
|
|
|
$this->set_role( ( ! empty ( $wp_user->roles[0] ) ? $wp_user->roles[0] : 'customer' ) );
|
2016-03-11 18:28:34 +00:00
|
|
|
|
|
|
|
// Get info about user's last order
|
|
|
|
$last_order = $wpdb->get_row( "SELECT id, post_date_gmt
|
|
|
|
FROM $wpdb->posts AS posts
|
|
|
|
LEFT JOIN {$wpdb->postmeta} AS meta on posts.ID = meta.post_id
|
|
|
|
WHERE meta.meta_key = '_customer_user'
|
|
|
|
AND meta.meta_value = {$id}
|
|
|
|
AND posts.post_type = 'shop_order'
|
|
|
|
AND posts.post_status IN ( '" . implode( "','", array_keys( wc_get_order_statuses() ) ) . "' )
|
|
|
|
ORDER BY posts.ID DESC
|
|
|
|
" );
|
|
|
|
|
|
|
|
$this->set_last_order_id( is_object( $last_order ) ? $last_order->id : null );
|
|
|
|
$this->set_last_order_date( is_object( $last_order ) ? strtotime( $last_order->post_date_gmt ) : null );
|
2016-03-14 19:14:50 +00:00
|
|
|
|
|
|
|
// WC_Customer can't use wc_get_customer_order_count because get_order_types might not be loaded by the time a customer/session is
|
|
|
|
|
|
|
|
$count = $wpdb->get_var( "SELECT COUNT(*)
|
|
|
|
FROM $wpdb->posts as posts
|
|
|
|
|
|
|
|
LEFT JOIN {$wpdb->postmeta} AS meta ON posts.ID = meta.post_id
|
|
|
|
|
|
|
|
WHERE meta.meta_key = '_customer_user'
|
|
|
|
AND posts.post_type = 'shop_order'
|
|
|
|
AND posts.post_status IN ('" . implode( "','", array_keys( wc_get_order_statuses() ) ) . "')
|
|
|
|
AND meta_value = $id
|
|
|
|
" );
|
|
|
|
|
|
|
|
$spent = $wpdb->get_var( "SELECT SUM(meta2.meta_value)
|
|
|
|
FROM $wpdb->posts as posts
|
|
|
|
|
|
|
|
LEFT JOIN {$wpdb->postmeta} AS meta ON posts.ID = meta.post_id
|
|
|
|
LEFT JOIN {$wpdb->postmeta} AS meta2 ON posts.ID = meta2.post_id
|
|
|
|
|
|
|
|
WHERE meta.meta_key = '_customer_user'
|
|
|
|
AND meta.meta_value = $id
|
|
|
|
AND posts.post_type = 'shop_order'
|
|
|
|
AND posts.post_status IN ( 'wc-completed', 'wc-processing' )
|
|
|
|
AND meta2.meta_key = '_order_total'
|
|
|
|
" );
|
2016-03-15 18:37:42 +00:00
|
|
|
if ( ! $spent ) {
|
|
|
|
$spent = 0;
|
|
|
|
}
|
2016-03-14 19:14:50 +00:00
|
|
|
|
|
|
|
$this->set_orders_count( $count );
|
|
|
|
$this->set_total_spent( $spent );
|
2016-03-17 19:03:23 +00:00
|
|
|
$this->read_meta_data();
|
2016-03-09 20:49:02 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
unset( $this->_data['password'] ); // password is write only, never ever read it
|
2016-03-08 21:44:28 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Update a customer.
|
|
|
|
* @since 2.7.0
|
|
|
|
*/
|
|
|
|
public function update() {
|
2016-03-09 20:49:02 +00:00
|
|
|
$customer_ID = $this->get_id();
|
2016-03-08 21:44:28 +00:00
|
|
|
|
2016-03-09 20:49:02 +00:00
|
|
|
wp_update_user( array( 'ID' => $customer_ID, 'user_email' => $this->get_email() ) );
|
|
|
|
// Only update password if a new one was set with set_password
|
|
|
|
if ( isset( $this->_data['password'] ) ) {
|
2016-03-11 18:28:34 +00:00
|
|
|
wp_update_user( array( 'ID' => $customer_ID, 'user_pass' => $this->_data['password'] ) );
|
|
|
|
unset( $this->_data['password'] );
|
2016-03-09 20:49:02 +00:00
|
|
|
}
|
|
|
|
|
2016-03-17 19:39:29 +00:00
|
|
|
update_user_meta( $this->get_id(), 'billing_postcode', $this->get_billing_postcode() );
|
|
|
|
update_user_meta( $this->get_id(), 'billing_city', $this->get_billing_city() );
|
|
|
|
update_user_meta( $this->get_id(), 'billing_address_1', $this->get_billing_address() );
|
|
|
|
update_user_meta( $this->get_id(), 'billing_address_2', $this->get_billing_address_2() );
|
|
|
|
update_user_meta( $this->get_id(), 'billing_state', $this->get_billing_state() );
|
|
|
|
update_user_meta( $this->get_id(), 'billing_country', $this->get_billing_country() );
|
2016-03-09 20:49:02 +00:00
|
|
|
update_user_meta( $this->get_id(), 'shipping_postcode', $this->get_shipping_postcode() );
|
|
|
|
update_user_meta( $this->get_id(), 'shipping_city', $this->get_shipping_city() );
|
|
|
|
update_user_meta( $this->get_id(), 'shipping_address_1', $this->get_shipping_address() );
|
|
|
|
update_user_meta( $this->get_id(), 'shipping_address_2', $this->get_shipping_address_2() );
|
|
|
|
update_user_meta( $this->get_id(), 'shipping_state', $this->get_shipping_state() );
|
|
|
|
update_user_meta( $this->get_id(), 'shipping_country', $this->get_shipping_country() );
|
|
|
|
update_user_meta( $this->get_id(), 'paying_customer', $this->get_is_paying_customer() );
|
2016-03-10 16:22:47 +00:00
|
|
|
$this->set_date_modified( time() );
|
|
|
|
update_user_meta( $this->get_id(), 'last_update', $this->get_date_modified() );
|
2016-03-17 19:03:23 +00:00
|
|
|
update_user_meta( $this->get_id(), 'first_name', $this->get_first_name() );
|
|
|
|
update_user_meta( $this->get_id(), 'last_name', $this->get_last_name() );
|
2016-03-11 18:28:34 +00:00
|
|
|
wp_update_user( array( 'ID' => $this->get_id(), 'role' => $this->get_role() ) );
|
2016-03-17 19:03:23 +00:00
|
|
|
$this->save_meta_data();
|
2016-03-08 21:44:28 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Delete a customer.
|
|
|
|
* @since 2.7.0
|
|
|
|
*/
|
|
|
|
public function delete() {
|
2016-03-09 20:49:02 +00:00
|
|
|
if ( ! $this->get_id() ) {
|
|
|
|
return;
|
|
|
|
}
|
|
|
|
wp_delete_user( $this->get_id() );
|
2016-03-08 21:44:28 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
2016-08-04 18:39:34 +00:00
|
|
|
* Save data. Create when creating a new user/class, update when editing
|
|
|
|
* an existing user, and save session when working on a logged out guest
|
|
|
|
* session.
|
2016-03-08 21:44:28 +00:00
|
|
|
* @since 2.7.0
|
|
|
|
*/
|
|
|
|
public function save() {
|
2016-08-15 12:17:43 +00:00
|
|
|
if ( $this->_is_session ) {
|
2016-08-04 18:39:34 +00:00
|
|
|
$this->save_session_if_changed();
|
2016-08-15 12:17:43 +00:00
|
|
|
} elseif ( ! $this->get_id() ) {
|
2016-03-09 20:49:02 +00:00
|
|
|
$this->create();
|
|
|
|
} else {
|
2016-08-15 12:17:43 +00:00
|
|
|
$this->update();
|
2016-03-09 20:49:02 +00:00
|
|
|
}
|
|
|
|
}
|
2016-03-08 21:44:28 +00:00
|
|
|
|
2016-03-09 20:49:02 +00:00
|
|
|
/**
|
|
|
|
* Saves data to the session only (does not overwrite DB values).
|
|
|
|
* @since 2.7.0
|
|
|
|
*/
|
|
|
|
public function save_to_session() {
|
2016-08-15 12:17:43 +00:00
|
|
|
if ( ! $this->_is_session ) {
|
2016-03-09 20:49:02 +00:00
|
|
|
return;
|
|
|
|
}
|
|
|
|
$data = array();
|
|
|
|
foreach ( $this->_session_keys as $session_key ) {
|
2016-03-17 20:26:33 +00:00
|
|
|
$function_key = $session_key;
|
|
|
|
if ( 'billing_' === substr( $session_key, 0, 8 ) ) {
|
|
|
|
$session_key = str_replace( 'billing_', '', $session_key );
|
|
|
|
}
|
|
|
|
$data[ $session_key ] = $this->{"get_$function_key"}();
|
2016-03-09 20:49:02 +00:00
|
|
|
}
|
|
|
|
WC()->session->set( 'customer', $data );
|
2016-03-08 21:44:28 +00:00
|
|
|
}
|
|
|
|
|
2014-05-28 17:05:19 +00:00
|
|
|
}
|