refund class
This commit is contained in:
Mike Jolley
parent
ece2b5bf57
commit
f70e05441b
|
|
@ -1,113 +1,191 @@
|
||||||
<?php
|
<?php
|
||||||
|
|
||||||
if ( ! defined( 'ABSPATH' ) ) {
|
if ( ! defined( 'ABSPATH' ) ) {
|
||||||
exit; // Exit if accessed directly
|
exit;
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Order refund
|
* Order refund. Refunds are based on orders (essentially negative orders) and
|
||||||
|
* contain much of the same data.
|
||||||
*
|
*
|
||||||
* @class WC_Order_Refund
|
* @version 2.7.0
|
||||||
* @version 2.2.0
|
|
||||||
* @package WooCommerce/Classes
|
* @package WooCommerce/Classes
|
||||||
* @category Class
|
* @category Class
|
||||||
* @author WooThemes
|
* @author WooThemes
|
||||||
*/
|
*/
|
||||||
class WC_Order_Refund extends WC_Abstract_Order {
|
class WC_Order_Refund extends WC_Abstract_Order {
|
||||||
|
|
||||||
/** @public string Order type */
|
/**
|
||||||
public $order_type = 'refund';
|
* Extend the abstract _data properties and then read the order object.
|
||||||
|
*
|
||||||
/** @var string Date */
|
* @param int|object|WC_Order $order Order to init.
|
||||||
public $date;
|
*/
|
||||||
|
public function __construct( $order = 0 ) {
|
||||||
/** @var string Refund reason */
|
$this->_data = array_merge( $this->_data, array(
|
||||||
public $reason;
|
'refund_amount' => '',
|
||||||
|
'refund_reason' => '',
|
||||||
|
'refunded_by' => 0,
|
||||||
|
) );
|
||||||
|
parent::__construct( $order );
|
||||||
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Init/load the refund object. Called from the constructor.
|
* Insert data into the database.
|
||||||
*
|
* @since 2.7.0
|
||||||
* @param string|int|object|WC_Order_Refund $refund Refund to init
|
|
||||||
* @uses WP_POST
|
|
||||||
*/
|
*/
|
||||||
protected function init( $refund ) {
|
public function create() {
|
||||||
if ( is_numeric( $refund ) ) {
|
parent::create();
|
||||||
$this->id = absint( $refund );
|
|
||||||
$this->post = get_post( $refund );
|
// Store additonal order data
|
||||||
$this->get_refund( $this->id );
|
if ( $this->get_id() ) {
|
||||||
} elseif ( $refund instanceof WC_Order_Refund ) {
|
$this->update_post_meta( '_refund_amount', $this->get_refund_amount() );
|
||||||
$this->id = absint( $refund->id );
|
$this->update_post_meta( '_refunded_by', $this->get_refunded_by() );
|
||||||
$this->post = $refund->post;
|
$this->update_post_meta( '_refund_reason', $this->get_refund_reason() );
|
||||||
$this->get_refund( $this->id );
|
|
||||||
} elseif ( isset( $refund->ID ) ) {
|
|
||||||
$this->id = absint( $refund->ID );
|
|
||||||
$this->post = $refund;
|
|
||||||
$this->get_refund( $this->id );
|
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Gets an refund from the database.
|
* Read from the database.
|
||||||
*
|
* @since 2.7.0
|
||||||
* @since 2.2
|
* @param int $id ID of object to read.
|
||||||
* @param int $id
|
*/
|
||||||
* @return bool
|
public function read( $id ) {
|
||||||
*/
|
parent::read( $id );
|
||||||
public function get_refund( $id = 0 ) {
|
|
||||||
if ( ! $id ) {
|
// Read additonal order data
|
||||||
return false;
|
if ( $this->get_id() ) {
|
||||||
|
$post_object = get_post( $id );
|
||||||
|
$this->set_refund_amount( get_post_meta( $this->get_id(), '_refund_amount', true ) );
|
||||||
|
|
||||||
|
// post_author was used before refunded_by meta.
|
||||||
|
$this->set_refunded_by( metadata_exists( 'post', $this->get_id(), '_refunded_by' ) ? get_post_meta( $this->get_id(), '_refunded_by', true ) : absint( $post_object->post_author ) );
|
||||||
|
|
||||||
|
// post_excerpt was used before refund_reason meta.
|
||||||
|
$this->set_refund_reason( metadata_exists( 'post', $this->get_id(), '_refund_reason' ) ? get_post_meta( $this->get_id(), '_refund_reason', true ) : absint( $post_object->post_excerpt ) );
|
||||||
}
|
}
|
||||||
|
|
||||||
if ( $result = get_post( $id ) ) {
|
|
||||||
$this->populate( $result );
|
|
||||||
|
|
||||||
return true;
|
|
||||||
}
|
|
||||||
|
|
||||||
return false;
|
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Populates an refund from the loaded post data.
|
* Update data in the database.
|
||||||
*
|
* @since 2.7.0
|
||||||
* @param mixed $result
|
|
||||||
*/
|
*/
|
||||||
public function populate( $result ) {
|
public function update() {
|
||||||
// Standard post data
|
parent::update();
|
||||||
$this->id = $result->ID;
|
|
||||||
$this->date = $result->post_date;
|
// Store additonal order data
|
||||||
$this->modified_date = $result->post_modified;
|
$this->update_post_meta( '_refund_amount', $this->get_refund_amount() );
|
||||||
$this->reason = $result->post_excerpt;
|
$this->update_post_meta( '_refunded_by', $this->get_refunded_by() );
|
||||||
|
$this->update_post_meta( '_refund_reason', $this->get_refund_reason() );
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get internal type (post type.)
|
||||||
|
* @return string
|
||||||
|
*/
|
||||||
|
public function get_type() {
|
||||||
|
return 'shop_order_refund';
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get a title for the new post type.
|
||||||
|
*/
|
||||||
|
protected function get_post_title() {
|
||||||
|
return sprintf( __( 'Refund – %s', 'woocommerce' ), strftime( _x( '%b %d, %Y @ %I:%M %p', 'Order date parsed by strftime', 'woocommerce' ) ) );
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Set refunded amount.
|
||||||
|
* @param string $value
|
||||||
|
*/
|
||||||
|
public function set_refund_amount( $value ) {
|
||||||
|
$this->_data['refund_amount'] = wc_format_decimal( $value );
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Get refunded amount.
|
* Get refunded amount.
|
||||||
*
|
|
||||||
* @since 2.2
|
* @since 2.2
|
||||||
* @return int|float
|
* @return int|float
|
||||||
*/
|
*/
|
||||||
public function get_refund_amount() {
|
public function get_refund_amount() {
|
||||||
return apply_filters( 'woocommerce_refund_amount', (double) $this->refund_amount, $this );
|
return apply_filters( 'woocommerce_refund_amount', (double) $this->_data['refund_amount'], $this );
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Get formatted refunded amount.
|
* Get formatted refunded amount.
|
||||||
*
|
|
||||||
* @since 2.4
|
* @since 2.4
|
||||||
* @return string
|
* @return string
|
||||||
*/
|
*/
|
||||||
public function get_formatted_refund_amount() {
|
public function get_formatted_refund_amount() {
|
||||||
return apply_filters( 'woocommerce_formatted_refund_amount', wc_price( $this->refund_amount, array('currency' => $this->get_order_currency()) ), $this );
|
return apply_filters( 'woocommerce_formatted_refund_amount', wc_price( $this->get_refund_amount(), array( 'currency' => $this->get_currency() ) ), $this );
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Set refund reason.
|
||||||
|
* @param string $value
|
||||||
|
*/
|
||||||
|
public function set_refund_reason( $value ) {
|
||||||
|
$this->_data['refund_reason'] = $value;
|
||||||
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Get refunded amount.
|
* Get refund reason.
|
||||||
*
|
|
||||||
* @since 2.2
|
* @since 2.2
|
||||||
* @return int|float
|
* @return int|float
|
||||||
*/
|
*/
|
||||||
public function get_refund_reason() {
|
public function get_refund_reason() {
|
||||||
return apply_filters( 'woocommerce_refund_reason', $this->reason, $this );
|
return apply_filters( 'woocommerce_refund_reason', $this->_data['refund_reason'], $this );
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Set refunded by.
|
||||||
|
* @param int $value
|
||||||
|
*/
|
||||||
|
public function set_refunded_by( $value ) {
|
||||||
|
$this->_data['refunded_by'] = absint( $value );
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get ID of user who did the refund.
|
||||||
|
* @since 2.7
|
||||||
|
* @return int
|
||||||
|
*/
|
||||||
|
public function get_refunded_by() {
|
||||||
|
return absint( $this->_data['refunded_by'] );
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Magic __get method for backwards compatibility.
|
||||||
|
* @param string $key
|
||||||
|
* @return mixed
|
||||||
|
*/
|
||||||
|
public function __get( $key ) {
|
||||||
|
_doing_it_wrong( $key, 'Refund properties should not be accessed directly.', '2.7' );
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Maps legacy vars to new getters.
|
||||||
|
*/
|
||||||
|
if ( 'reason' === $key ) {
|
||||||
|
return $this->get_refund_reason();
|
||||||
|
} elseif ( 'refund_amount' === $key ) {
|
||||||
|
return $this->get_refund_amount();
|
||||||
|
}
|
||||||
|
return parent::__get( $key );
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Gets an refund from the database.
|
||||||
|
* @deprecated 2.7
|
||||||
|
* @param int $id (default: 0).
|
||||||
|
* @return bool
|
||||||
|
*/
|
||||||
|
public function get_refund( $id = 0 ) {
|
||||||
|
_deprecated_function( 'get_refund', '2.7', 'read' );
|
||||||
|
if ( ! $id ) {
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
if ( $result = get_post( $id ) ) {
|
||||||
|
$this->populate( $result );
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
return false;
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
|
|
||||||
Loading…
Reference in New Issue