woocommerce/includes/class-wc-order-refund.php

229 lines
4.9 KiB
PHP
Raw Normal View History

<?php
/**
2016-06-21 19:06:56 +00:00
* Order refund. Refunds are based on orders (essentially negative orders) and
* contain much of the same data.
*
2018-03-19 18:09:13 +00:00
* @version 3.0.0
2020-08-05 16:36:24 +00:00
* @package WooCommerce\Classes
2018-03-19 18:09:13 +00:00
*/
defined( 'ABSPATH' ) || exit;
/**
2018-03-21 03:50:30 +00:00
* Order refund class.
*/
class WC_Order_Refund extends WC_Abstract_Order {
2016-11-17 16:53:13 +00:00
/**
* Which data store to load.
*
* @var string
*/
protected $data_store_name = 'order-refund';
2016-12-19 17:09:52 +00:00
/**
* This is the name of this object type.
2018-03-19 18:09:13 +00:00
*
2016-12-19 17:09:52 +00:00
* @var string
*/
protected $object_type = 'order_refund';
2016-11-21 14:20:29 +00:00
/**
* Stores product data.
*
* @var array
*/
protected $extra_data = array(
'amount' => '',
'reason' => '',
'refunded_by' => 0,
'refunded_payment' => false,
2016-11-21 14:20:29 +00:00
);
/**
2016-11-17 16:53:13 +00:00
* Get internal type (post type.)
2018-03-19 18:09:13 +00:00
*
2016-11-17 16:53:13 +00:00
* @return string
2016-09-07 09:04:56 +00:00
*/
2016-11-17 16:53:13 +00:00
public function get_type() {
return 'shop_order_refund';
2016-09-07 09:04:56 +00:00
}
2016-08-22 12:04:57 +00:00
/**
* Get status - always completed for refunds.
2016-11-17 16:53:13 +00:00
*
2018-03-19 18:09:13 +00:00
* @param string $context What the value is for. Valid values are view and edit.
2016-08-22 12:04:57 +00:00
* @return string
*/
2016-11-17 16:53:13 +00:00
public function get_status( $context = 'view' ) {
2016-08-22 12:04:57 +00:00
return 'completed';
}
2016-06-21 19:06:56 +00:00
/**
* Get a title for the new post type.
*/
2016-11-17 16:53:13 +00:00
public function get_post_title() {
2016-09-01 20:50:14 +00:00
// @codingStandardsIgnoreStart
2016-06-21 19:06:56 +00:00
return sprintf( __( 'Refund &ndash; %s', 'woocommerce' ), strftime( _x( '%b %d, %Y @ %I:%M %p', 'Order date parsed by strftime', 'woocommerce' ) ) );
2016-09-01 20:50:14 +00:00
// @codingStandardsIgnoreEnd
2016-06-21 19:06:56 +00:00
}
/**
2016-11-17 16:53:13 +00:00
* Get refunded amount.
*
2018-03-19 18:09:13 +00:00
* @param string $context What the value is for. Valid values are view and edit.
2016-11-17 16:53:13 +00:00
* @return int|float
*/
2016-11-17 16:53:13 +00:00
public function get_amount( $context = 'view' ) {
return $this->get_prop( 'amount', $context );
}
/**
2016-11-17 16:53:13 +00:00
* Get refund reason.
*
* @since 2.2
2018-03-19 18:09:13 +00:00
* @param string $context What the value is for. Valid values are view and edit.
* @return int|float
*/
2016-11-17 16:53:13 +00:00
public function get_reason( $context = 'view' ) {
return $this->get_prop( 'reason', $context );
}
/**
* Get ID of user who did the refund.
*
2017-03-15 16:36:53 +00:00
* @since 3.0
2018-03-19 18:09:13 +00:00
* @param string $context What the value is for. Valid values are view and edit.
2016-11-17 16:53:13 +00:00
* @return int
*/
public function get_refunded_by( $context = 'view' ) {
return $this->get_prop( 'refunded_by', $context );
}
2016-11-17 16:53:13 +00:00
/**
* Return if the payment was refunded via API.
*
* @since 3.3
2018-03-19 18:09:13 +00:00
* @param string $context What the value is for. Valid values are view and edit.
* @return bool
*/
public function get_refunded_payment( $context = 'view' ) {
return $this->get_prop( 'refunded_payment', $context );
}
/**
2015-11-03 13:31:20 +00:00
* Get formatted refunded amount.
2016-11-17 16:53:13 +00:00
*
* @since 2.4
* @return string
*/
public function get_formatted_refund_amount() {
2016-08-22 12:04:57 +00:00
return apply_filters( 'woocommerce_formatted_refund_amount', wc_price( $this->get_amount(), array( 'currency' => $this->get_currency() ) ), $this );
}
2015-07-16 19:55:48 +00:00
2016-06-21 19:06:56 +00:00
/**
2016-11-17 16:53:13 +00:00
* Set refunded amount.
*
2018-03-19 18:09:13 +00:00
* @param string $value Value to set.
* @throws WC_Data_Exception Exception if the amount is invalid.
2016-06-21 19:06:56 +00:00
*/
2016-11-17 16:53:13 +00:00
public function set_amount( $value ) {
$this->set_prop( 'amount', wc_format_decimal( $value ) );
2016-06-21 19:06:56 +00:00
}
/**
2016-11-17 16:53:13 +00:00
* Set refund reason.
*
2018-03-19 18:09:13 +00:00
* @param string $value Value to set.
* @throws WC_Data_Exception Exception if the amount is invalid.
*/
2016-11-17 16:53:13 +00:00
public function set_reason( $value ) {
$this->set_prop( 'reason', $value );
2016-06-21 19:06:56 +00:00
}
/**
* Set refunded by.
2016-11-17 16:53:13 +00:00
*
2018-03-19 18:09:13 +00:00
* @param int $value Value to set.
* @throws WC_Data_Exception Exception if the amount is invalid.
2016-06-21 19:06:56 +00:00
*/
public function set_refunded_by( $value ) {
2016-11-17 16:53:13 +00:00
$this->set_prop( 'refunded_by', absint( $value ) );
2016-06-21 19:06:56 +00:00
}
/**
* Set if the payment was refunded via API.
*
* @since 3.3
2018-03-19 18:09:13 +00:00
* @param bool $value Value to set.
*/
public function set_refunded_payment( $value ) {
$this->set_prop( 'refunded_payment', (bool) $value );
}
2016-06-21 19:06:56 +00:00
/**
2016-06-22 15:31:05 +00:00
* Magic __get method for backwards compatibility.
2016-11-17 16:53:13 +00:00
*
2018-03-19 18:09:13 +00:00
* @param string $key Value to get.
2016-06-22 15:31:05 +00:00
* @return mixed
*/
public function __get( $key ) {
2017-03-15 16:36:53 +00:00
wc_doing_it_wrong( $key, 'Refund properties should not be accessed directly.', '3.0' );
2016-06-22 15:31:05 +00:00
/**
* Maps legacy vars to new getters.
*/
if ( 'reason' === $key ) {
2016-08-22 12:04:57 +00:00
return $this->get_reason();
2016-06-21 19:06:56 +00:00
} elseif ( 'refund_amount' === $key ) {
2016-08-22 12:04:57 +00:00
return $this->get_amount();
2016-06-21 19:06:56 +00:00
}
return parent::__get( $key );
}
2016-06-21 19:06:56 +00:00
/**
2016-06-22 15:31:05 +00:00
* Gets an refund from the database.
2018-03-19 18:09:13 +00:00
*
2017-03-15 16:36:53 +00:00
* @deprecated 3.0
2016-06-22 15:31:05 +00:00
* @param int $id (default: 0).
* @return bool
*/
public function get_refund( $id = 0 ) {
2017-03-15 16:36:53 +00:00
wc_deprecated_function( 'get_refund', '3.0', 'read' );
2018-03-19 18:09:13 +00:00
2016-06-22 15:31:05 +00:00
if ( ! $id ) {
return false;
}
2018-03-19 18:09:13 +00:00
$result = get_post( $id );
if ( $result ) {
2016-06-22 15:31:05 +00:00
$this->populate( $result );
return true;
}
2018-03-19 18:09:13 +00:00
2016-06-22 15:31:05 +00:00
return false;
}
2016-08-22 12:04:57 +00:00
/**
* Get refund amount.
2018-03-19 18:09:13 +00:00
*
2017-03-15 16:36:53 +00:00
* @deprecated 3.0
2016-08-22 12:04:57 +00:00
* @return int|float
*/
public function get_refund_amount() {
2017-03-15 16:36:53 +00:00
wc_deprecated_function( 'get_refund_amount', '3.0', 'get_amount' );
2016-08-22 12:04:57 +00:00
return $this->get_amount();
}
/**
* Get refund reason.
2018-03-19 18:09:13 +00:00
*
2017-03-15 16:36:53 +00:00
* @deprecated 3.0
2016-08-22 12:04:57 +00:00
* @return int|float
*/
public function get_refund_reason() {
2017-03-15 16:36:53 +00:00
wc_deprecated_function( 'get_refund_reason', '3.0', 'get_reason' );
2016-08-22 12:04:57 +00:00
return $this->get_reason();
}
}