class-wc-order-item-data-store-interface.php 2.09 KB
Newer Older
imac's avatar
imac committed
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92
<?php
if ( ! defined( 'ABSPATH' ) ) {
	exit;
}

/**
 * WC Order Item Data Store Interface
 *
 * Functions that must be defined by the order item data store (for functions).
 *
 * @version  3.0.0
 * @category Interface
 * @author   WooCommerce
 */
interface WC_Order_Item_Data_Store_Interface {

	/**
	 * Add an order item to an order.
	 * @param  int   $order_id
	 * @param  array $item order_item_name and order_item_type.
	 * @return int   Order Item ID
	 */
	public function add_order_item( $order_id, $item );

	/**
	 * Update an order item.
	 * @param  int   $item_id
	 * @param  array $item order_item_name or order_item_type.
	 * @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.
	 * @param  int    $item_id
	 * @param  string $meta_key
	 * @param  mixed  $meta_value
	 * @param  string $prev_value (default: '')
	 * @return bool
	 */
	function update_metadata( $item_id, $meta_key, $meta_value, $prev_value = '' );

	/**
	 * Add term meta.
	 * @param  int    $item_id
	 * @param  string $meta_key
	 * @param  mixed  $meta_value
	 * @param  bool   $unique (default: false)
	 * @return int    New row ID or 0
	 */
	function add_metadata( $item_id, $meta_key, $meta_value, $unique = false );


	/**
	 * Delete term meta.
	 * @param  int    $item_id
	 * @param  string $meta_key
	 * @param  string $meta_value (default: '')
	 * @param  bool   $delete_all (default: false)
	 * @return bool
	 */
	function delete_metadata( $item_id, $meta_key, $meta_value = '', $delete_all = false );

	/**
	 * Get term meta.
	 * @param  int    $item_id
	 * @param  string $key
	 * @param  bool   $single (default: true)
	 * @return mixed
	 */
	function get_metadata( $item_id, $key, $single = true );

	/**
	 * Get order ID by order item ID.
	 * @param  int $item_id
	 * @return int
	 */
	function get_order_id_by_order_item_id( $item_id );

	/**
	 * Get the order item type based on Item ID.
	 * @param  int $item_id
	 * @return string
	 */
	public function get_order_item_type( $item_id );
}