2016-11-18 11:34:02 +00:00
|
|
|
<?php
|
|
|
|
if ( ! defined( 'ABSPATH' ) ) {
|
|
|
|
exit;
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* WC Order Item Data Store Interface
|
|
|
|
*
|
2016-11-21 19:38:07 +00:00
|
|
|
* Functions that must be defined by the order item data store (for functions).
|
2016-11-18 11:34:02 +00:00
|
|
|
*
|
2017-03-15 16:36:53 +00:00
|
|
|
* @version 3.0.0
|
2016-11-18 11:34:02 +00:00
|
|
|
* @category Interface
|
|
|
|
* @author WooCommerce
|
|
|
|
*/
|
|
|
|
interface WC_Order_Item_Data_Store_Interface {
|
2017-03-20 10:03:14 +00:00
|
|
|
|
2016-11-18 11:34:02 +00:00
|
|
|
/**
|
2016-11-21 19:38:07 +00:00
|
|
|
* Add an order item to an order.
|
|
|
|
* @param int $order_id
|
2017-03-20 10:03:14 +00:00
|
|
|
* @param array $item order_item_name and order_item_type.
|
2017-01-19 17:38:23 +00:00
|
|
|
* @return int Order Item ID
|
2016-11-18 11:34:02 +00:00
|
|
|
*/
|
2016-11-21 19:38:07 +00:00
|
|
|
public function add_order_item( $order_id, $item );
|
2016-11-21 19:45:22 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Update an order item.
|
|
|
|
* @param int $item_id
|
2017-03-20 10:03:14 +00:00
|
|
|
* @param array $item order_item_name or order_item_type.
|
2016-11-21 19:45:22 +00:00
|
|
|
* @return boolean
|
|
|
|
*/
|
|
|
|
public function update_order_item( $item_id, $item );
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Delete an order item.
|
|
|
|
* @param int $item_id
|
|
|
|
*/
|
|
|
|
public function delete_order_item( $item_id );
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Update term meta.
|
2017-01-19 17:38:23 +00:00
|
|
|
* @param int $item_id
|
|
|
|
* @param string $meta_key
|
|
|
|
* @param mixed $meta_value
|
2016-11-21 19:45:22 +00:00
|
|
|
* @param string $prev_value (default: '')
|
|
|
|
* @return bool
|
|
|
|
*/
|
|
|
|
function update_metadata( $item_id, $meta_key, $meta_value, $prev_value = '' );
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Add term meta.
|
2017-01-19 17:38:23 +00:00
|
|
|
* @param int $item_id
|
|
|
|
* @param string $meta_key
|
|
|
|
* @param mixed $meta_value
|
|
|
|
* @param bool $unique (default: false)
|
|
|
|
* @return int New row ID or 0
|
2016-11-21 19:45:22 +00:00
|
|
|
*/
|
|
|
|
function add_metadata( $item_id, $meta_key, $meta_value, $unique = false );
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Delete term meta.
|
2017-01-19 17:38:23 +00:00
|
|
|
* @param int $item_id
|
|
|
|
* @param string $meta_key
|
2016-11-21 19:45:22 +00:00
|
|
|
* @param string $meta_value (default: '')
|
2017-01-19 17:38:23 +00:00
|
|
|
* @param bool $delete_all (default: false)
|
2016-11-21 19:45:22 +00:00
|
|
|
* @return bool
|
|
|
|
*/
|
|
|
|
function delete_metadata( $item_id, $meta_key, $meta_value = '', $delete_all = false );
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Get term meta.
|
2017-01-19 17:38:23 +00:00
|
|
|
* @param int $item_id
|
|
|
|
* @param string $key
|
|
|
|
* @param bool $single (default: true)
|
2016-11-21 19:45:22 +00:00
|
|
|
* @return mixed
|
|
|
|
*/
|
|
|
|
function get_metadata( $item_id, $key, $single = true );
|
2017-01-18 22:05:50 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Get order ID by order item ID.
|
2017-01-19 17:38:23 +00:00
|
|
|
* @param int $item_id
|
2017-01-18 22:05:50 +00:00
|
|
|
* @return int
|
|
|
|
*/
|
|
|
|
function get_order_id_by_order_item_id( $item_id );
|
2017-02-08 19:39:30 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Get the order item type based on Item ID.
|
|
|
|
* @param int $item_id
|
|
|
|
* @return string
|
|
|
|
*/
|
|
|
|
public function get_order_item_type( $item_id );
|
2016-11-18 11:34:02 +00:00
|
|
|
}
|