FM / includes

/home/techb158/balacoffee.com/wp-content/plugins/woocommerce/includes/

/home/techb158/balacoffee.com/wp-content/plugins/woocommerce/includes

Name	Size	Mode	Actions
abstracts/	-	0755	rm
admin/	-	0755	rm
blocks/	-	0755	rm
cli/	-	0755	rm
customizer/	-	0755	rm
data-stores/	-	0755	rm
emails/	-	0755	rm
export/	-	0755	rm
gateways/	-	0755	rm
import/	-	0755	rm
integrations/	-	0755	rm
interfaces/	-	0755	rm
legacy/	-	0755	rm
libraries/	-	0755	rm
log-handlers/	-	0755	rm
payment-tokens/	-	0755	rm
product-usage/	-	0755	rm
queue/	-	0755	rm
react-admin/	-	0755	rm
rest-api/	-	0755	rm
shipping/	-	0755	rm
shortcodes/	-	0755	rm
theme-support/	-	0755	rm
tracks/	-	0755	rm
traits/	-	0755	rm
walkers/	-	0755	rm
wccom-site/	-	0755	rm
widgets/	-	0755	rm
class-wc-ajax.php	134598	0644	edit dl rm
class-wc-auth.php	12995	0644	edit dl rm
class-wc-autoloader.php	5394	0644	edit dl rm
class-wc-background-emailer.php	4685	0644	edit dl rm
class-wc-background-updater.php	3535	0644	edit dl rm
class-wc-brands-brand-settings-manager.php	1826	0644	edit dl rm
class-wc-brands-coupons.php	7059	0644	edit dl rm
class-wc-brands.php	35635	0644	edit dl rm
class-wc-breadcrumb.php	10660	0644	edit dl rm
class-wc-cache-helper.php	12998	0644	edit dl rm
class-wc-cart-fees.php	3448	0644	edit dl rm
class-wc-cart-session.php	25975	0644	edit dl rm
class-wc-cart-totals.php	29163	0644	edit dl rm
class-wc-cart.php	77386	0644	edit dl rm
class-wc-checkout.php	51349	0644	edit dl rm
class-wc-cli.php	3419	0644	edit dl rm
class-wc-comments.php	23631	0644	edit dl rm
class-wc-countries.php	51881	0644	edit dl rm
class-wc-coupon.php	44920	0644	edit dl rm
class-wc-customer-download-log.php	3452	0644	edit dl rm
class-wc-customer-download.php	10587	0644	edit dl rm
class-wc-customer.php	34000	0644	edit dl rm
class-wc-data-exception.php	1321	0644	edit dl rm
class-wc-data-store.php	6752	0644	edit dl rm
class-wc-datetime.php	2310	0644	edit dl rm
class-wc-deprecated-action-hooks.php	6746	0644	edit dl rm
class-wc-deprecated-filter-hooks.php	7518	0644	edit dl rm
class-wc-discounts.php	37523	0644	edit dl rm
class-wc-download-handler.php	29053	0644	edit dl rm
class-wc-emails.php	40244	0644	edit dl rm
class-wc-embed.php	4342	0644	edit dl rm
class-wc-form-handler.php	49327	0644	edit dl rm
class-wc-frontend-scripts.php	35185	0644	edit dl rm
class-wc-geo-ip.php	31159	0644	edit dl rm
class-wc-geolite-integration.php	2036	0644	edit dl rm
class-wc-geolocation.php	11615	0644	edit dl rm
class-wc-https.php	4439	0644	edit dl rm
class-wc-install.php	119017	0644	edit dl rm
class-wc-integrations.php	1308	0644	edit dl rm
class-wc-log-levels.php	3992	0644	edit dl rm
class-wc-logger.php	9639	0644	edit dl rm
class-wc-meta-data.php	2260	0644	edit dl rm
class-wc-order-factory.php	8951	0644	edit dl rm
class-wc-order-item-coupon.php	4175	0644	edit dl rm
class-wc-order-item-fee.php	10228	0644	edit dl rm
class-wc-order-item-meta.php	5942	0644	edit dl rm
class-wc-order-item-product.php	17962	0644	edit dl rm
class-wc-order-item-shipping.php	9815	0644	edit dl rm
class-wc-order-item-tax.php	6644	0644	edit dl rm
class-wc-order-item.php	21907	0644	edit dl rm
class-wc-order-query.php	2613	0644	edit dl rm
class-wc-order-refund.php	6135	0644	edit dl rm
class-wc-order.php	79423	0644	edit dl rm
class-wc-payment-gateways.php	14601	0644	edit dl rm
class-wc-payment-tokens.php	6390	0644	edit dl rm
class-wc-post-data.php	39617	0644	edit dl rm
class-wc-post-types.php	33680	0644	edit dl rm
class-wc-privacy-background-process.php	1833	0644	edit dl rm
class-wc-privacy-erasers.php	13941	0644	edit dl rm
class-wc-privacy-exporters.php	15044	0644	edit dl rm
class-wc-privacy.php	17629	0644	edit dl rm
class-wc-product-attribute.php	8057	0644	edit dl rm
class-wc-product-download.php	13494	0644	edit dl rm
class-wc-product-external.php	5104	0644	edit dl rm
class-wc-product-factory.php	4698	0644	edit dl rm
class-wc-product-grouped.php	6974	0644	edit dl rm
class-wc-product-query.php	2328	0644	edit dl rm
class-wc-product-simple.php	2765	0644	edit dl rm
class-wc-product-variable.php	24334	0644	edit dl rm
class-wc-product-variation.php	20661	0644	edit dl rm
class-wc-query.php	34299	0644	edit dl rm
class-wc-rate-limiter.php	4100	0644	edit dl rm
class-wc-regenerate-images-request.php	7923	0644	edit dl rm
class-wc-regenerate-images.php	15806	0644	edit dl rm
class-wc-register-wp-admin-settings.php	5171	0644	edit dl rm
class-wc-rest-authentication.php	22068	0644	edit dl rm
class-wc-rest-exception.php	276	0644	edit dl rm
class-wc-session-handler.php	25162	0644	edit dl rm
class-wc-shipping-rate.php	9566	0644	edit dl rm
class-wc-shipping-zone.php	13392	0644	edit dl rm
class-wc-shipping-zones.php	5115	0644	edit dl rm
class-wc-shipping.php	13371	0644	edit dl rm
class-wc-shortcodes.php	19274	0644	edit dl rm
class-wc-structured-data.php	25011	0644	edit dl rm
class-wc-tax.php	40694	0644	edit dl rm
class-wc-template-loader.php	20911	0644	edit dl rm
class-wc-tracker.php	52731	0644	edit dl rm
class-wc-validation.php	5929	0644	edit dl rm
class-wc-webhook.php	30807	0644	edit dl rm
class-woocommerce.php	63814	0644	edit dl rm
wc-account-functions.php	14485	0644	edit dl rm
wc-attribute-functions.php	22377	0644	edit dl rm
wc-brands-functions.php	4270	0644	edit dl rm
wc-cart-functions.php	21308	0644	edit dl rm
wc-conditional-functions.php	15902	0644	edit dl rm
wc-core-functions.php	80603	0644	edit dl rm
wc-coupon-functions.php	5698	0644	edit dl rm
wc-deprecated-functions.php	40731	0644	edit dl rm
wc-formatting-functions.php	51093	0644	edit dl rm
wc-interactivity-api-functions.php	2219	0644	edit dl rm
wc-notice-functions.php	8696	0644	edit dl rm
wc-order-functions.php	45065	0644	edit dl rm
wc-order-item-functions.php	5153	0644	edit dl rm
wc-order-step-logger-functions.php	6114	0644	edit dl rm
wc-page-functions.php	9657	0644	edit dl rm
wc-product-functions.php	68992	0644	edit dl rm
wc-rest-functions.php	14268	0644	edit dl rm
wc-stock-functions.php	17851	0644	edit dl rm
wc-template-functions.php	145476	0644	edit dl rm
wc-template-hooks.php	13151	0644	edit dl rm
wc-term-functions.php	25158	0644	edit dl rm
wc-update-functions.php	104837	0644	edit dl rm
wc-user-functions.php	36197	0644	edit dl rm
wc-webhook-functions.php	5905	0644	edit dl rm
wc-widget-functions.php	2063	0644	edit dl rm

Edit: /home/techb158/balacoffee.com/wp-content/plugins/woocommerce/includes/wc-rest-functions.php (14268B)

<?php
/**
 * WooCommerce REST Functions
 *
 * Functions for REST specific things.
 *
 * @package WooCommerce\Functions
 * @version 2.6.0
 */

use Automattic\WooCommerce\Internal\Utilities\Users;

defined( 'ABSPATH' ) || exit;

/**
 * Parses and formats a date for ISO8601/RFC3339.
 *
 * Required WP 4.4 or later.
 * See https://developer.wordpress.org/reference/functions/mysql_to_rfc3339/
 *
 * @since  2.6.0
 * @param  string|null|WC_DateTime $date Date.
 * @param  bool                    $utc  Send false to get local/offset time.
 * @return string|null ISO8601/RFC3339 formatted datetime.
 */
function wc_rest_prepare_date_response( $date, $utc = true ) {
	if ( is_numeric( $date ) ) {
		$date = new WC_DateTime( "@$date", new DateTimeZone( 'UTC' ) );
		$date->setTimezone( new DateTimeZone( wc_timezone_string() ) );
	} elseif ( is_string( $date ) ) {
		$date = new WC_DateTime( $date, new DateTimeZone( 'UTC' ) );
		$date->setTimezone( new DateTimeZone( wc_timezone_string() ) );
	}

if ( ! is_a( $date, 'WC_DateTime' ) ) {
		return null;
	}

// Get timestamp before changing timezone to UTC.
	return gmdate( 'Y-m-d\TH:i:s', $utc ? $date->getTimestamp() : $date->getOffsetTimestamp() );
}

/**
 * Returns image mime types users are allowed to upload via the API.
 *
 * @since  2.6.4
 * @return array
 */
function wc_rest_allowed_image_mime_types() {
	return apply_filters(
		'woocommerce_rest_allowed_image_mime_types',
		array(
			'jpg|jpeg|jpe' => 'image/jpeg',
			'gif'          => 'image/gif',
			'png'          => 'image/png',
			'bmp'          => 'image/bmp',
			'tiff|tif'     => 'image/tiff',
			'ico'          => 'image/x-icon',
			'webp'         => 'image/webp',
		)
	);
}

/**
 * Upload image from URL.
 *
 * @since 2.6.0
 * @param string $image_url Image URL.
 * @return array|WP_Error Attachment data or error message.
 */
function wc_rest_upload_image_from_url( $image_url ) {
	$parsed_url = wp_parse_url( $image_url );

// Check parsed URL.
	if ( ! $parsed_url || ! is_array( $parsed_url ) ) {
		/* translators: %s: image URL */
		return new WP_Error( 'woocommerce_rest_invalid_image_url', sprintf( __( 'Invalid URL %s.', 'woocommerce' ), $image_url ), array( 'status' => 400 ) );
	}

// Ensure url is valid.
	$image_url = esc_url_raw( $image_url );

// download_url function is part of wp-admin.
	if ( ! function_exists( 'download_url' ) ) {
		include_once ABSPATH . 'wp-admin/includes/file.php';
	}

$file_array         = array();
	$file_array['name'] = basename( current( explode( '?', $image_url ) ) );

// Download file to temp location.
	$file_array['tmp_name'] = download_url( $image_url );

// If error storing temporarily, return the error.
	if ( is_wp_error( $file_array['tmp_name'] ) ) {
		return new WP_Error(
			'woocommerce_rest_invalid_remote_image_url',
			/* translators: %s: image URL */
			sprintf( __( 'Error getting remote image %s.', 'woocommerce' ), $image_url ) . ' '
			/* translators: %s: error message */
			. sprintf( __( 'Error: %s', 'woocommerce' ), $file_array['tmp_name']->get_error_message() ),
			array( 'status' => 400 )
		);
	}

// Do the validation and storage stuff.
	$file = wp_handle_sideload(
		$file_array,
		array(
			'test_form' => false,
			'mimes'     => wc_rest_allowed_image_mime_types(),
		),
		current_time( 'Y/m' )
	);

if ( isset( $file['error'] ) ) {
		@unlink( $file_array['tmp_name'] ); // @codingStandardsIgnoreLine.

/* translators: %s: error message */
		return new WP_Error( 'woocommerce_rest_invalid_image', sprintf( __( 'Invalid image: %s', 'woocommerce' ), $file['error'] ), array( 'status' => 400 ) );
	}

do_action( 'woocommerce_rest_api_uploaded_image_from_url', $file, $image_url );

return $file;
}

/**
 * Set uploaded image as attachment.
 *
 * @since 2.6.0
 * @param array $upload Upload information from wp_upload_bits.
 * @param int   $id Post ID. Default to 0.
 * @return int Attachment ID
 */
function wc_rest_set_uploaded_image_as_attachment( $upload, $id = 0 ) {
	$info    = wp_check_filetype( $upload['file'] );
	$title   = '';
	$content = '';

if ( ! function_exists( 'wp_generate_attachment_metadata' ) ) {
		include_once ABSPATH . 'wp-admin/includes/image.php';
	}

$image_meta = @wp_read_image_metadata( $upload['file'] );
	if ( $image_meta ) {
		if ( trim( $image_meta['title'] ) && ! is_numeric( sanitize_title( $image_meta['title'] ) ) ) {
			$title = wc_clean( $image_meta['title'] );
		}
		if ( trim( $image_meta['caption'] ) ) {
			$content = wc_clean( $image_meta['caption'] );
		}
	}

$attachment = array(
		'post_mime_type' => $info['type'],
		'guid'           => $upload['url'],
		'post_parent'    => $id,
		'post_title'     => $title ? $title : basename( $upload['file'] ),
		'post_content'   => $content,
	);

$attachment_id = wp_insert_attachment( $attachment, $upload['file'], $id );
	if ( ! is_wp_error( $attachment_id ) ) {
		@wp_update_attachment_metadata( $attachment_id, wp_generate_attachment_metadata( $attachment_id, $upload['file'] ) );
	}

return $attachment_id;
}

/**
 * Validate reports request arguments.
 *
 * @since 2.6.0
 * @param mixed           $value   Value to validate.
 * @param WP_REST_Request $request Request instance.
 * @param string          $param   Param to validate.
 * @return WP_Error|boolean
 */
function wc_rest_validate_reports_request_arg( $value, $request, $param ) {

$attributes = $request->get_attributes();
	if ( ! isset( $attributes['args'][ $param ] ) || ! is_array( $attributes['args'][ $param ] ) ) {
		return true;
	}
	$args = $attributes['args'][ $param ];

if ( 'string' === $args['type'] && ! is_string( $value ) ) {
		/* translators: 1: param 2: type */
		return new WP_Error( 'woocommerce_rest_invalid_param', sprintf( __( '%1$s is not of type %2$s', 'woocommerce' ), $param, 'string' ) );
	}

if ( 'date' === $args['format'] ) {
		$regex = '#^\d{4}-\d{2}-\d{2}$#';

if ( ! preg_match( $regex, $value, $matches ) ) {
			return new WP_Error( 'woocommerce_rest_invalid_date', __( 'The date you provided is invalid.', 'woocommerce' ) );
		}
	}

return true;
}

/**
 * Encodes a value according to RFC 3986.
 * Supports multidimensional arrays.
 *
 * @since 2.6.0
 * @param string|array $value The value to encode.
 * @return string|array       Encoded values.
 */
function wc_rest_urlencode_rfc3986( $value ) {
	if ( is_array( $value ) ) {
		return array_map( 'wc_rest_urlencode_rfc3986', $value );
	}

return str_replace( array( '+', '%7E' ), array( ' ', '~' ), rawurlencode( $value ) );
}

/**
 * Check permissions of posts on REST API.
 *
 * @since 2.6.0
 * @param string $post_type Post type.
 * @param string $context   Request context.
 * @param int    $object_id Post ID.
 * @return bool
 */
function wc_rest_check_post_permissions( $post_type, $context = 'read', $object_id = 0 ) {
	$contexts = array(
		'read'   => 'read_private_posts',
		'create' => 'publish_posts',
		'edit'   => 'edit_post',
		'delete' => 'delete_post',
		'batch'  => 'edit_others_posts',
	);

if ( 'revision' === $post_type ) {
		$permission = false;
	} else {
		$cap              = $contexts[ $context ];
		$post_type_object = get_post_type_object( $post_type );
		$permission       = false;
		if ( $post_type_object instanceof WP_Post_Type ) {
			$permission = current_user_can( $post_type_object->cap->$cap, $object_id );
		}
	}

return apply_filters( 'woocommerce_rest_check_permissions', $permission, $context, $object_id, $post_type );
}

/**
 * Check permissions of users on REST API.
 *
 * @since 2.6.0
 * @since 9.4.0 Became multisite aware. The function now considers whether the user belongs to the current site.
 *
 * @param string $context   Request context.
 * @param int    $object_id User ID.
 * @return bool
 */
function wc_rest_check_user_permissions( $context = 'read', $object_id = 0 ) {
	$contexts = array(
		'read'   => 'list_users',
		'create' => 'create_customers',
		'edit'   => 'edit_users',
		'delete' => 'delete_users',
		'batch'  => 'promote_users',
	);

// Check to allow shop_managers to manage only customers.
	if ( in_array( $context, array( 'edit', 'delete' ), true ) && wc_current_user_has_role( 'shop_manager' ) ) {
		$permission                  = false;
		$user_data                   = get_userdata( $object_id );
		$shop_manager_editable_roles = apply_filters( 'woocommerce_shop_manager_editable_roles', array( 'customer' ) );

if ( isset( $user_data->roles ) ) {
			$can_manage_users = array_intersect( $user_data->roles, array_unique( $shop_manager_editable_roles ) );

// Check if Shop Manager can edit customer or with the is same shop manager.
			if ( 0 < count( $can_manage_users ) || intval( $object_id ) === intval( get_current_user_id() ) ) {
				$permission = current_user_can( $contexts[ $context ], $object_id );
			}
		}
	} else {
		$permission = current_user_can( $contexts[ $context ], $object_id );
	}

// Possibly revoke $permission if the user is 'out of bounds' from a multisite-network perspective.
	if ( $permission && ! Users::get_user_in_current_site( $object_id ) ) {
		$permission = false;
	}

/**
	 * Provides an opportunity to override the permission check made before acting on an object in relation to
	 * REST API requests.
	 *
	 * @since 2.6.0
	 *
	 * @param bool   $permission  If we have permission to act on this object.
	 * @param string $context     Describes the operation being performed: 'read', 'edit', 'delete', etc.
	 * @param int    $object_id   Object ID. This could be a user ID, order ID, post ID, etc.
	 * @param string $object_type Type of object ('user', 'shop_order', etc) for which checks are being made.
	 */
	return apply_filters( 'woocommerce_rest_check_permissions', $permission, $context, $object_id, 'user' );
}

/**
 * Check permissions of product terms on REST API.
 *
 * @since 2.6.0
 * @param string $taxonomy  Taxonomy.
 * @param string $context   Request context.
 * @param int    $object_id Post ID.
 * @return bool
 */
function wc_rest_check_product_term_permissions( $taxonomy, $context = 'read', $object_id = 0 ) {
	$contexts = array(
		'read'   => 'manage_terms',
		'create' => 'edit_terms',
		'edit'   => 'edit_terms',
		'delete' => 'delete_terms',
		'batch'  => 'edit_terms',
	);

$cap             = $contexts[ $context ];
	$taxonomy_object = get_taxonomy( $taxonomy );
	$permission      = current_user_can( $taxonomy_object->cap->$cap, $object_id );

return apply_filters( 'woocommerce_rest_check_permissions', $permission, $context, $object_id, $taxonomy );
}

/**
 * Check manager permissions on REST API.
 *
 * @since 2.6.0
 * @param string $object  Object.
 * @param string $context Request context.
 * @return bool
 */
function wc_rest_check_manager_permissions( $object, $context = 'read' ) {
	$objects = array(
		'reports'          => 'view_woocommerce_reports',
		'settings'         => 'manage_woocommerce',
		'system_status'    => 'manage_woocommerce',
		'attributes'       => 'manage_product_terms',
		'shipping_methods' => 'manage_woocommerce',
		'payment_gateways' => 'manage_woocommerce',
		'webhooks'         => 'manage_woocommerce',
	);

$permission = current_user_can( $objects[ $object ] );

return apply_filters( 'woocommerce_rest_check_permissions', $permission, $context, 0, $object );
}

/**
 * Check product reviews permissions on REST API.
 *
 * @since 3.5.0
 * @param string $context   Request context.
 * @param string $object_id Object ID.
 * @return bool
 */
function wc_rest_check_product_reviews_permissions( $context = 'read', $object_id = 0 ) {
	$permission = false;
	$contexts   = array(
		'read'   => 'moderate_comments',
		'create' => 'edit_products',
		'edit'   => 'edit_products',
		'delete' => 'edit_products',
		'batch'  => 'edit_products',
	);

if ( $object_id > 0 ) {
		$object = get_comment( $object_id );

if ( ! is_a( $object, 'WP_Comment' ) || get_comment_type( $object ) !== 'review' ) {
			return false;
		}
	}

if ( isset( $contexts[ $context ] ) ) {
		$permission = current_user_can( $contexts[ $context ], $object_id );
	}

return apply_filters( 'woocommerce_rest_check_permissions', $permission, $context, $object_id, 'product_review' );
}

/**
 * Returns true if the current REST request is from the product editor.
 *
 * @since 8.9.0
 * @return bool
 */
function wc_rest_is_from_product_editor() {
	return isset( $_SERVER['HTTP_X_WC_FROM_PRODUCT_EDITOR'] ) && '1' === $_SERVER['HTTP_X_WC_FROM_PRODUCT_EDITOR'];
}

/**
 * Check if a REST namespace should be loaded. Useful to maintain site performance even when lots of REST namespaces are registered.
 *
 * @since 9.2.0.
 *
 * @param string $ns The namespace to check.
 * @param string $rest_route (Optional) The REST route being checked.
 *
 * @return bool True if the namespace should be loaded, false otherwise.
 */
function wc_rest_should_load_namespace( string $ns, string $rest_route = '' ): bool {
	if ( '' === $rest_route ) {
		$rest_route = $GLOBALS['wp']->query_vars['rest_route'] ?? '';
	}

if ( '' === $rest_route ) {
		return true;
	}

$rest_route = trailingslashit( ltrim( $rest_route, '/' ) );
	$ns         = trailingslashit( $ns );

/**
	 * Known namespaces that we know are safe to not load if the request is not for them. Namespaces not in this namespace should always be loaded, because we don't know if they won't be making another internal REST request to an unloaded namespace.
	 */
	$known_namespaces = array(
		'wc/v1',
		'wc/v2',
		'wc/v3',
		'wc/v4',
		'wc-telemetry',
		'wc-admin',
		'wc-analytics',
		'wc/store',
		'wc/private',
	);

$known_namespace_request = false;
	foreach ( $known_namespaces as $known_namespace ) {
		if ( str_starts_with( $rest_route, $known_namespace ) ) {
			$known_namespace_request = true;
			break;
		}
	}

if ( ! $known_namespace_request ) {
		return true;
	}

/**
	 * Filters whether a namespace should be loaded.
	 *
	 * @param bool   $should_load True if the namespace should be loaded, false otherwise.
	 * @param string $ns          The namespace to check.
	 * @param string $rest_route  The REST route being checked.
	 * @param array  $known_namespaces Known namespaces that we know are safe to not load if the request is not for them.
	 *
	 * @since 9.4
	 */
	return apply_filters( 'wc_rest_should_load_namespace', str_starts_with( $rest_route, $ns ), $ns, $rest_route, $known_namespaces );
}

cmd: