166 lines
4.4 KiB
PHP
166 lines
4.4 KiB
PHP
<?php
|
|
/**
|
|
* WooCommerce Order Item Functions
|
|
*
|
|
* Functions for order specific things.
|
|
*
|
|
* @package WooCommerce/Functions
|
|
* @version 3.4.0
|
|
*/
|
|
|
|
defined( 'ABSPATH' ) || exit;
|
|
|
|
/**
|
|
* Add a item to an order (for example a line item).
|
|
*
|
|
* @param int $order_id Order ID.
|
|
* @param array $item_array Items list.
|
|
* @return int|bool Item ID or false
|
|
*/
|
|
function wc_add_order_item( $order_id, $item_array ) {
|
|
$order_id = absint( $order_id );
|
|
|
|
if ( ! $order_id ) {
|
|
return false;
|
|
}
|
|
|
|
$defaults = array(
|
|
'order_item_name' => '',
|
|
'order_item_type' => 'line_item',
|
|
);
|
|
|
|
$item_array = wp_parse_args( $item_array, $defaults );
|
|
$data_store = WC_Data_Store::load( 'order-item' );
|
|
$item_id = $data_store->add_order_item( $order_id, $item_array );
|
|
$item = WC_Order_Factory::get_order_item( $item_id );
|
|
|
|
do_action( 'woocommerce_new_order_item', $item_id, $item, $order_id );
|
|
|
|
return $item_id;
|
|
}
|
|
|
|
/**
|
|
* Update an item for an order.
|
|
*
|
|
* @since 2.2
|
|
* @param int $item_id Item ID.
|
|
* @param array $args Either `order_item_type` or `order_item_name`.
|
|
* @return bool True if successfully updated, false otherwise.
|
|
*/
|
|
function wc_update_order_item( $item_id, $args ) {
|
|
$data_store = WC_Data_Store::load( 'order-item' );
|
|
$update = $data_store->update_order_item( $item_id, $args );
|
|
|
|
if ( false === $update ) {
|
|
return false;
|
|
}
|
|
|
|
do_action( 'woocommerce_update_order_item', $item_id, $args );
|
|
|
|
return true;
|
|
}
|
|
|
|
/**
|
|
* Delete an item from the order it belongs to based on item id.
|
|
*
|
|
* @param int $item_id Item ID.
|
|
* @return bool
|
|
*/
|
|
function wc_delete_order_item( $item_id ) {
|
|
$item_id = absint( $item_id );
|
|
|
|
if ( ! $item_id ) {
|
|
return false;
|
|
}
|
|
|
|
$data_store = WC_Data_Store::load( 'order-item' );
|
|
|
|
do_action( 'woocommerce_before_delete_order_item', $item_id );
|
|
|
|
$data_store->delete_order_item( $item_id );
|
|
|
|
do_action( 'woocommerce_delete_order_item', $item_id );
|
|
|
|
return true;
|
|
}
|
|
|
|
/**
|
|
* WooCommerce Order Item Meta API - Update term meta.
|
|
*
|
|
* @param int $item_id Item ID.
|
|
* @param string $meta_key Meta key.
|
|
* @param string $meta_value Meta value.
|
|
* @param string $prev_value Previous value (default: '').
|
|
* @return bool
|
|
*/
|
|
function wc_update_order_item_meta( $item_id, $meta_key, $meta_value, $prev_value = '' ) {
|
|
$data_store = WC_Data_Store::load( 'order-item' );
|
|
if ( $data_store->update_metadata( $item_id, $meta_key, $meta_value, $prev_value ) ) {
|
|
WC_Cache_Helper::incr_cache_prefix( 'object_' . $item_id ); // Invalidate cache.
|
|
return true;
|
|
}
|
|
return false;
|
|
}
|
|
|
|
/**
|
|
* WooCommerce Order Item Meta API - Add term meta.
|
|
*
|
|
* @param int $item_id Item ID.
|
|
* @param string $meta_key Meta key.
|
|
* @param string $meta_value Meta value.
|
|
* @param bool $unique If meta data should be unique (default: false).
|
|
* @return int New row ID or 0.
|
|
*/
|
|
function wc_add_order_item_meta( $item_id, $meta_key, $meta_value, $unique = false ) {
|
|
$data_store = WC_Data_Store::load( 'order-item' );
|
|
$meta_id = $data_store->add_metadata( $item_id, $meta_key, $meta_value, $unique );
|
|
|
|
if ( $meta_id ) {
|
|
WC_Cache_Helper::incr_cache_prefix( 'object_' . $item_id ); // Invalidate cache.
|
|
return $meta_id;
|
|
}
|
|
return 0;
|
|
}
|
|
|
|
/**
|
|
* WooCommerce Order Item Meta API - Delete term meta.
|
|
*
|
|
* @param int $item_id Item ID.
|
|
* @param string $meta_key Meta key.
|
|
* @param string $meta_value Meta value (default: '').
|
|
* @param bool $delete_all Delete all meta data, defaults to `false`.
|
|
* @return bool
|
|
*/
|
|
function wc_delete_order_item_meta( $item_id, $meta_key, $meta_value = '', $delete_all = false ) {
|
|
$data_store = WC_Data_Store::load( 'order-item' );
|
|
if ( $data_store->delete_metadata( $item_id, $meta_key, $meta_value, $delete_all ) ) {
|
|
WC_Cache_Helper::incr_cache_prefix( 'object_' . $item_id ); // Invalidate cache.
|
|
return true;
|
|
}
|
|
return false;
|
|
}
|
|
|
|
/**
|
|
* WooCommerce Order Item Meta API - Get term meta.
|
|
*
|
|
* @param int $item_id Item ID.
|
|
* @param string $key Meta key.
|
|
* @param bool $single Whether to return a single value. (default: true).
|
|
* @return mixed
|
|
*/
|
|
function wc_get_order_item_meta( $item_id, $key, $single = true ) {
|
|
$data_store = WC_Data_Store::load( 'order-item' );
|
|
return $data_store->get_metadata( $item_id, $key, $single );
|
|
}
|
|
|
|
/**
|
|
* Get order ID by order item ID.
|
|
*
|
|
* @param int $item_id Item ID.
|
|
* @return int
|
|
*/
|
|
function wc_get_order_id_by_order_item_id( $item_id ) {
|
|
$data_store = WC_Data_Store::load( 'order-item' );
|
|
return $data_store->get_order_id_by_order_item_id( $item_id );
|
|
}
|