REDROOM

Navigation

Breadcrumbs

/ / home / certprox / zang.certproxywizard.com / wp / wp-content / plugins / woocommerce / includes

Create

Create File | Create Folder | Upload Files | Run Command

Edit File Size: 5.03 KB

/home/certprox/zang.certproxywizard.com/wp/wp-content/plugins/woocommerce/includes/wc-order-item-functions.php

Text Base64

<?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.
 *
 * @throws Exception        When `WC_Data_Store::load` validation fails.
 * @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`.
 *
 * @throws Exception     When `WC_Data_Store::load` validation fails.
 * @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.
 *
 * @throws Exception    When `WC_Data_Store::load` validation fails.
 * @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 mixed  $meta_value Meta value.
 * @param string $prev_value Previous value (default: '').
 *
 * @throws Exception         When `WC_Data_Store::load` validation fails.
 * @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::invalidate_cache_group( '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 mixed  $meta_value Meta value.
 * @param bool   $unique     If meta data should be unique (default: false).
 *
 * @throws Exception         When `WC_Data_Store::load` validation fails.
 * @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::invalidate_cache_group( '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 mixed  $meta_value Meta value (default: '').
 * @param bool   $delete_all Delete all meta data, defaults to `false`.
 *
 * @throws Exception         When `WC_Data_Store::load` validation fails.
 * @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::invalidate_cache_group( '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).
 *
 * @throws Exception      When `WC_Data_Store::load` validation fails.
 * @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.
 *
 * @throws Exception    When `WC_Data_Store::load` validation fails.
 * @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 );
}

Exit & Reset Text mode: syntax highlighting auto-detects file type.

Directory Contents

Dirs: 28 × Files: 115

Sort:

Enable drag-to-move

Name	Size	Perms	Modified	Actions
abstracts DIR	-	drwxr-xr-x	2026-03-30 10:22:29	Edit Download recursive recursive
admin DIR	-	drwxr-xr-x	2026-03-30 10:22:31	Edit Download recursive recursive
blocks DIR	-	drwxr-xr-x	2026-03-30 10:22:31	Edit Download recursive recursive
cli DIR	-	drwxr-xr-x	2026-03-30 10:22:33	Edit Download recursive recursive
customizer DIR	-	drwxr-xr-x	2026-03-30 10:22:33	Edit Download recursive recursive
data-stores DIR	-	drwxr-xr-x	2026-03-30 10:22:34	Edit Download recursive recursive
emails DIR	-	drwxr-xr-x	2026-03-30 10:22:34	Edit Download recursive recursive
export DIR	-	drwxr-xr-x	2026-03-30 10:22:34	Edit Download recursive recursive
gateways DIR	-	drwxr-xr-x	2026-03-30 10:22:34	Edit Download recursive recursive
import DIR	-	drwxr-xr-x	2026-03-30 10:22:34	Edit Download recursive recursive
integrations DIR	-	drwxr-xr-x	2026-03-30 10:21:54	Edit Download recursive recursive
interfaces DIR	-	drwxr-xr-x	2026-03-30 10:22:34	Edit Download recursive recursive
legacy DIR	-	drwxr-xr-x	2026-03-30 10:22:35	Edit Download recursive recursive
libraries DIR	-	drwxr-xr-x	2026-03-30 10:22:35	Edit Download recursive recursive
log-handlers DIR	-	drwxr-xr-x	2026-03-30 10:22:35	Edit Download recursive recursive
payment-tokens DIR	-	drwxr-xr-x	2026-03-30 10:22:35	Edit Download recursive recursive
product-usage DIR	-	drwxr-xr-x	2026-03-30 10:22:35	Edit Download recursive recursive
queue DIR	-	drwxr-xr-x	2026-03-30 10:22:35	Edit Download recursive recursive
react-admin DIR	-	drwxr-xr-x	2026-03-30 10:22:35	Edit Download recursive recursive
rest-api DIR	-	drwxr-xr-x	2026-03-30 10:22:36	Edit Download recursive recursive
shipping DIR	-	drwxr-xr-x	2026-03-30 10:21:54	Edit Download recursive recursive
shortcodes DIR	-	drwxr-xr-x	2026-03-30 10:22:36	Edit Download recursive recursive
theme-support DIR	-	drwxr-xr-x	2026-03-30 10:22:36	Edit Download recursive recursive
tracks DIR	-	drwxr-xr-x	2026-03-30 10:22:36	Edit Download recursive recursive
traits DIR	-	drwxr-xr-x	2026-03-30 10:22:37	Edit Download recursive recursive
walkers DIR	-	drwxr-xr-x	2026-03-30 10:22:37	Edit Download recursive recursive
wccom-site DIR	-	drwxr-xr-x	2026-03-30 10:22:37	Edit Download recursive recursive
widgets DIR	-	drwxr-xr-x	2026-03-30 10:22:38	Edit Download recursive recursive
class-wc-ajax.php	123.43 KB	lrw-r--r--	2026-03-30 10:22:31	Edit Download recursive recursive
class-wc-auth.php	12.69 KB	lrw-r--r--	2026-03-30 10:22:31	Edit Download recursive recursive
class-wc-autoloader.php	5.27 KB	lrw-r--r--	2026-03-30 10:22:31	Edit Download recursive recursive
class-wc-background-emailer.php	4.58 KB	lrw-r--r--	2026-03-30 10:22:32	Edit Download recursive recursive
class-wc-background-updater.php	3.45 KB	lrw-r--r--	2026-03-30 10:22:32	Edit Download recursive recursive
class-wc-brands-brand-settings-manager.php	1.78 KB	lrw-r--r--	2026-03-30 10:22:32	Edit Download recursive recursive
class-wc-brands-coupons.php	6.89 KB	lrw-r--r--	2026-03-30 10:22:32	Edit Download recursive recursive
class-wc-brands.php	34.80 KB	lrw-r--r--	2026-03-30 10:22:32	Edit Download recursive recursive
class-wc-breadcrumb.php	10.41 KB	lrw-r--r--	2026-03-30 10:22:32	Edit Download recursive recursive
class-wc-cache-helper.php	12.69 KB	lrw-r--r--	2026-03-30 10:22:32	Edit Download recursive recursive
class-wc-cart-fees.php	3.37 KB	lrw-r--r--	2026-03-30 10:22:32	Edit Download recursive recursive
class-wc-cart-session.php	25.38 KB	lrw-r--r--	2026-03-30 10:22:32	Edit Download recursive recursive
class-wc-cart-totals.php	28.48 KB	lrw-r--r--	2026-03-30 10:22:32	Edit Download recursive recursive
class-wc-cart.php	74.21 KB	lrw-r--r--	2026-03-30 10:22:32	Edit Download recursive recursive
class-wc-checkout.php	50.15 KB	lrw-r--r--	2026-03-30 10:22:32	Edit Download recursive recursive
class-wc-cli.php	3.34 KB	lrw-r--r--	2026-03-30 10:22:32	Edit Download recursive recursive
class-wc-comments.php	23.08 KB	lrw-r--r--	2026-03-30 10:22:32	Edit Download recursive recursive
class-wc-countries.php	50.67 KB	lrw-r--r--	2026-03-30 10:22:32	Edit Download recursive recursive
class-wc-coupon.php	43.87 KB	lrw-r--r--	2026-03-30 10:22:32	Edit Download recursive recursive
class-wc-customer-download-log.php	3.37 KB	lrw-r--r--	2026-03-30 10:22:32	Edit Download recursive recursive
class-wc-customer-download.php	10.34 KB	lrw-r--r--	2026-03-30 10:22:32	Edit Download recursive recursive
class-wc-customer.php	33.20 KB	lrw-r--r--	2026-03-30 10:22:32	Edit Download recursive recursive
class-wc-data-exception.php	1.29 KB	lrw-r--r--	2026-03-30 10:22:32	Edit Download recursive recursive
class-wc-data-store.php	6.59 KB	lrw-r--r--	2026-03-30 10:22:32	Edit Download recursive recursive
class-wc-datetime.php	2.26 KB	lrw-r--r--	2026-03-30 10:22:32	Edit Download recursive recursive
class-wc-deprecated-action-hooks.php	6.59 KB	lrw-r--r--	2026-03-30 10:22:32	Edit Download recursive recursive
class-wc-deprecated-filter-hooks.php	7.34 KB	lrw-r--r--	2026-03-30 10:22:32	Edit Download recursive recursive
class-wc-discounts.php	36.64 KB	lrw-r--r--	2026-03-30 10:22:32	Edit Download recursive recursive
class-wc-download-handler.php	28.37 KB	lrw-r--r--	2026-03-30 10:22:32	Edit Download recursive recursive
class-wc-emails.php	39.09 KB	lrw-r--r--	2026-03-30 10:22:32	Edit Download recursive recursive
class-wc-embed.php	4.24 KB	lrw-r--r--	2026-03-30 10:22:32	Edit Download recursive recursive
class-wc-form-handler.php	48.17 KB	lrw-r--r--	2026-03-30 10:22:32	Edit Download recursive recursive
class-wc-frontend-scripts.php	34.36 KB	lrw-r--r--	2026-03-30 10:22:32	Edit Download recursive recursive
class-wc-geo-ip.php	30.43 KB	lrw-r--r--	2026-03-30 10:22:32	Edit Download recursive recursive
class-wc-geolite-integration.php	1.99 KB	lrw-r--r--	2026-03-30 10:22:32	Edit Download recursive recursive
class-wc-geolocation.php	11.34 KB	lrw-r--r--	2026-03-30 10:22:32	Edit Download recursive recursive
class-wc-https.php	4.33 KB	lrw-r--r--	2026-03-30 10:22:32	Edit Download recursive recursive
class-wc-install.php	116.06 KB	lrw-r--r--	2026-03-30 10:22:32	Edit Download recursive recursive
class-wc-integrations.php	1.28 KB	lrw-r--r--	2026-03-30 10:22:32	Edit Download recursive recursive
class-wc-log-levels.php	3.90 KB	lrw-r--r--	2026-03-30 10:22:32	Edit Download recursive recursive
class-wc-logger.php	9.41 KB	lrw-r--r--	2026-03-30 10:22:32	Edit Download recursive recursive
class-wc-meta-data.php	2.21 KB	lrw-r--r--	2026-03-30 10:22:32	Edit Download recursive recursive
class-wc-order-factory.php	8.66 KB	lrw-r--r--	2026-03-30 10:22:32	Edit Download recursive recursive
class-wc-order-item-coupon.php	4.08 KB	lrw-r--r--	2026-03-30 10:22:32	Edit Download recursive recursive
class-wc-order-item-fee.php	9.99 KB	lrw-r--r--	2026-03-30 10:22:32	Edit Download recursive recursive
class-wc-order-item-meta.php	5.80 KB	lrw-r--r--	2026-03-30 10:22:32	Edit Download recursive recursive
class-wc-order-item-product.php	17.54 KB	lrw-r--r--	2026-03-30 10:22:32	Edit Download recursive recursive
class-wc-order-item-shipping.php	9.58 KB	lrw-r--r--	2026-03-30 10:22:32	Edit Download recursive recursive
class-wc-order-item-tax.php	6.49 KB	lrw-r--r--	2026-03-30 10:22:32	Edit Download recursive recursive
class-wc-order-item.php	21.39 KB	lrw-r--r--	2026-03-30 10:22:32	Edit Download recursive recursive
class-wc-order-query.php	2.55 KB	lrw-r--r--	2026-03-30 10:22:33	Edit Download recursive recursive
class-wc-order-refund.php	5.99 KB	lrw-r--r--	2026-03-30 10:22:33	Edit Download recursive recursive
class-wc-order.php	77.53 KB	lrw-r--r--	2026-03-30 10:22:32	Edit Download recursive recursive
class-wc-payment-gateways.php	16.56 KB	lrw-r--r--	2026-03-30 10:22:33	Edit Download recursive recursive
class-wc-payment-tokens.php	6.24 KB	lrw-r--r--	2026-03-30 10:22:33	Edit Download recursive recursive
class-wc-post-data.php	36.87 KB	lrw-r--r--	2026-03-30 10:22:33	Edit Download recursive recursive
class-wc-post-types.php	32.89 KB	lrw-r--r--	2026-03-30 10:22:33	Edit Download recursive recursive
class-wc-privacy-background-process.php	1.79 KB	lrw-r--r--	2026-03-30 10:22:33	Edit Download recursive recursive
class-wc-privacy-erasers.php	13.61 KB	lrw-r--r--	2026-03-30 10:22:33	Edit Download recursive recursive
class-wc-privacy-exporters.php	14.69 KB	lrw-r--r--	2026-03-30 10:22:33	Edit Download recursive recursive
class-wc-privacy.php	17.22 KB	lrw-r--r--	2026-03-30 10:22:33	Edit Download recursive recursive
class-wc-product-attribute.php	7.87 KB	lrw-r--r--	2026-03-30 10:22:33	Edit Download recursive recursive
class-wc-product-download.php	13.18 KB	lrw-r--r--	2026-03-30 10:22:33	Edit Download recursive recursive
class-wc-product-external.php	4.98 KB	lrw-r--r--	2026-03-30 10:22:33	Edit Download recursive recursive
class-wc-product-factory.php	4.54 KB	lrw-r--r--	2026-03-30 10:22:33	Edit Download recursive recursive
class-wc-product-grouped.php	6.75 KB	lrw-r--r--	2026-03-30 10:22:33	Edit Download recursive recursive
class-wc-product-query.php	2.27 KB	lrw-r--r--	2026-03-30 10:22:33	Edit Download recursive recursive
class-wc-product-simple.php	2.70 KB	lrw-r--r--	2026-03-30 10:22:33	Edit Download recursive recursive
class-wc-product-variable.php	23.70 KB	lrw-r--r--	2026-03-30 10:22:33	Edit Download recursive recursive
class-wc-product-variation.php	20.18 KB	lrw-r--r--	2026-03-30 10:22:33	Edit Download recursive recursive
class-wc-query.php	33.50 KB	lrw-r--r--	2026-03-30 10:22:33	Edit Download recursive recursive
class-wc-rate-limiter.php	4.00 KB	lrw-r--r--	2026-03-30 10:22:33	Edit Download recursive recursive
class-wc-regenerate-images-request.php	7.74 KB	lrw-r--r--	2026-03-30 10:22:33	Edit Download recursive recursive
class-wc-regenerate-images.php	15.44 KB	lrw-r--r--	2026-03-30 10:22:33	Edit Download recursive recursive
class-wc-register-wp-admin-settings.php	5.05 KB	lrw-r--r--	2026-03-30 10:22:33	Edit Download recursive recursive
class-wc-rest-authentication.php	21.55 KB	lrw-r--r--	2026-03-30 10:22:33	Edit Download recursive recursive
class-wc-rest-exception.php	276 B	lrw-r--r--	2026-03-30 10:22:33	Edit Download recursive recursive
class-wc-session-handler.php	24.15 KB	lrw-r--r--	2026-03-30 10:22:33	Edit Download recursive recursive
class-wc-shipping-rate.php	9.34 KB	lrw-r--r--	2026-03-30 10:22:33	Edit Download recursive recursive
class-wc-shipping-zone.php	13.08 KB	lrw-r--r--	2026-03-30 10:22:33	Edit Download recursive recursive
class-wc-shipping-zones.php	5.00 KB	lrw-r--r--	2026-03-30 10:22:33	Edit Download recursive recursive
class-wc-shipping.php	12.85 KB	lrw-r--r--	2026-03-30 10:22:33	Edit Download recursive recursive
class-wc-shortcodes.php	18.82 KB	lrw-r--r--	2026-03-30 10:22:33	Edit Download recursive recursive
class-wc-structured-data.php	24.42 KB	lrw-r--r--	2026-03-30 10:22:33	Edit Download recursive recursive
class-wc-tax.php	39.74 KB	lrw-r--r--	2026-03-30 10:22:33	Edit Download recursive recursive
class-wc-template-loader.php	20.42 KB	lrw-r--r--	2026-03-30 10:22:33	Edit Download recursive recursive
class-wc-tracker.php	51.50 KB	lrw-r--r--	2026-03-30 10:22:33	Edit Download recursive recursive
class-wc-validation.php	5.79 KB	lrw-r--r--	2026-03-30 10:22:33	Edit Download recursive recursive
class-wc-webhook.php	30.08 KB	lrw-r--r--	2026-03-30 10:22:33	Edit Download recursive recursive
class-woocommerce.php	62.17 KB	lrw-r--r--	2026-03-30 10:22:33	Edit Download recursive recursive
wc-account-functions.php	14.15 KB	lrw-r--r--	2026-03-30 10:22:37	Edit Download recursive recursive
wc-attribute-functions.php	21.85 KB	lrw-r--r--	2026-03-30 10:22:37	Edit Download recursive recursive
wc-brands-functions.php	4.17 KB	lrw-r--r--	2026-03-30 10:22:37	Edit Download recursive recursive
wc-cart-functions.php	20.81 KB	lrw-r--r--	2026-03-30 10:22:37	Edit Download recursive recursive
wc-conditional-functions.php	15.53 KB	lrw-r--r--	2026-03-30 10:22:37	Edit Download recursive recursive
wc-core-functions.php	78.71 KB	lrw-r--r--	2026-03-30 10:22:37	Edit Download recursive recursive
wc-coupon-functions.php	5.56 KB	lrw-r--r--	2026-03-30 10:22:37	Edit Download recursive recursive
wc-deprecated-functions.php	39.78 KB	lrw-r--r--	2026-03-30 10:22:37	Edit Download recursive recursive
wc-formatting-functions.php	49.90 KB	lrw-r--r--	2026-03-30 10:22:37	Edit Download recursive recursive
wc-interactivity-api-functions.php	2.17 KB	lrw-r--r--	2026-03-30 10:22:37	Edit Download recursive recursive
wc-notice-functions.php	8.49 KB	lrw-r--r--	2026-03-30 10:22:37	Edit Download recursive recursive
wc-order-functions.php	43.41 KB	lrw-r--r--	2026-03-30 10:22:37	Edit Download recursive recursive
wc-order-item-functions.php	5.03 KB	lrw-r--r--	2026-03-30 10:22:37	Edit Download recursive recursive
wc-order-step-logger-functions.php	5.97 KB	lrw-r--r--	2026-03-30 10:22:37	Edit Download recursive recursive
wc-page-functions.php	9.43 KB	lrw-r--r--	2026-03-30 10:22:37	Edit Download recursive recursive
wc-product-functions.php	67.38 KB	lrw-r--r--	2026-03-30 10:22:37	Edit Download recursive recursive
wc-rest-functions.php	13.93 KB	lrw-r--r--	2026-03-30 10:22:37	Edit Download recursive recursive
wc-stock-functions.php	17.43 KB	lrw-r--r--	2026-03-30 10:22:37	Edit Download recursive recursive
wc-template-functions.php	141.89 KB	lrw-r--r--	2026-03-30 10:22:37	Edit Download recursive recursive
wc-template-hooks.php	12.84 KB	lrw-r--r--	2026-03-30 10:22:37	Edit Download recursive recursive
wc-term-functions.php	24.57 KB	lrw-r--r--	2026-03-30 10:22:37	Edit Download recursive recursive
wc-update-functions.php	101.89 KB	lrw-r--r--	2026-03-30 10:22:37	Edit Download recursive recursive
wc-user-functions.php	34.17 KB	lrw-r--r--	2026-03-30 10:22:37	Edit Download recursive recursive
wc-webhook-functions.php	5.77 KB	lrw-r--r--	2026-03-30 10:22:37	Edit Download recursive recursive
wc-widget-functions.php	2.01 KB	lrw-r--r--	2026-03-30 10:22:37	Edit Download recursive recursive