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/class-wc-product-download.php (13494B)

<?php
/**
 * Represents a file which can be downloaded.
 *
 * @package WooCommerce\Classes
 * @version 3.0.0
 * @since   3.0.0
 */

use Automattic\Jetpack\Constants;
use Automattic\WooCommerce\Internal\ProductDownloads\ApprovedDirectories\Register as Download_Directories;
use Automattic\WooCommerce\Internal\Utilities\URL;

defined( 'ABSPATH' ) || exit;

/**
 * Product download class.
 */
class WC_Product_Download implements ArrayAccess {

/**
	 * Data array.
	 *
	 * @since 3.0.0
	 * @var array
	 */
	protected $data = array(
		'id'      => '',
		'name'    => '',
		'file'    => '',
		'enabled' => true,
	);

/**
	 * Extra data array.
	 *
	 * @since 10.6.0
	 * @var array
	 */
	protected $extra_data = array();

/**
	 * Returns all data for this object.
	 *
	 * @return array
	 */
	public function get_data() {
		return array_merge( $this->extra_data, $this->data );
	}

/**
	 * Get allowed mime types.
	 *
	 * @return array
	 */
	public function get_allowed_mime_types() {
		return apply_filters( 'woocommerce_downloadable_file_allowed_mime_types', get_allowed_mime_types() );
	}

/**
	 * Get type of file path set.
	 *
	 * @param  string $file_path optional.
	 * @return string absolute, relative, or shortcode.
	 */
	public function get_type_of_file_path( $file_path = '' ) {
		$file_path  = $file_path ? $file_path : $this->get_file();
		$parsed_url = wp_parse_url( $file_path );
		if (
			$parsed_url &&
			isset( $parsed_url['host'] ) && // Absolute url means that it has a host.
			( // Theoretically we could permit any scheme (like ftp as well), but that has not been the case before. So we allow none or http(s).
				! isset( $parsed_url['scheme'] ) ||
				in_array( $parsed_url['scheme'], array( 'http', 'https' ), true )
			)
		) {
			return 'absolute';
		} elseif ( '[' === substr( $file_path, 0, 1 ) && ']' === substr( $file_path, -1 ) ) {
			return 'shortcode';
		} else {
			return 'relative';
		}
	}

/**
	 * Get file type.
	 *
	 * @return string
	 */
	public function get_file_type() {
		$type = wp_check_filetype( strtok( $this->get_file(), '?' ), $this->get_allowed_mime_types() );
		return $type['type'];
	}

/**
	 * Get file extension.
	 *
	 * @return string
	 */
	public function get_file_extension() {
		$parsed_url = wp_parse_url( $this->get_file(), PHP_URL_PATH );
		return pathinfo( $parsed_url, PATHINFO_EXTENSION );
	}

/**
	 * Confirms that the download is of an allowed filetype, that it exists and that it is
	 * contained within an approved directory. Used before adding to a product's list of
	 * downloads.
	 *
	 * @internal
	 * @throws Exception If the download is determined to be invalid.
	 *
	 * @param bool $auto_add_to_approved_directory_list If the download is not already in the approved directory list, automatically add it if possible.
	 */
	public function check_is_valid( bool $auto_add_to_approved_directory_list = true ) {
		$download_file = $this->get_file();

if ( ! $this->data['enabled'] ) {
			throw new Exception(
				sprintf(
					/* translators: %s: Downloadable file. */
					__( 'The downloadable file %s cannot be used as it has been disabled.', 'woocommerce' ),
					'<code>' . basename( $download_file ) . '</code>'
				)
			);
		}

if ( ! $this->is_allowed_filetype() ) {
			throw new Exception(
				sprintf(
					/* translators: 1: Downloadable file, 2: List of allowed filetypes. */
					__( 'The downloadable file %1$s cannot be used as it does not have an allowed file type. Allowed types include: %2$s', 'woocommerce' ),
					'<code>' . basename( $download_file ) . '</code>',
					'<code>' . implode( ', ', array_keys( $this->get_allowed_mime_types() ) ) . '</code>'
				)
			);
		}

// Validate the file exists.
		if ( ! $this->file_exists() ) {
			$this->raise_invalid_file_exception( $download_file );
		}

$this->approved_directory_checks( $auto_add_to_approved_directory_list );
	}

/**
	 * Check if file is allowed.
	 *
	 * @return boolean
	 */
	public function is_allowed_filetype() {
		$file_path = $this->get_file();

// File types for URL-based files located on the server should get validated.
		$parsed_file_path  = WC_Download_Handler::parse_file_path( $file_path );
		$is_file_on_server = ! $parsed_file_path['remote_file'];
		$file_path_type    = $this->get_type_of_file_path( $file_path );

// Shortcodes are allowed, validations should be done by the shortcode provider in this case.
		if ( 'shortcode' === $file_path_type ) {
			return true;
		}

// Remote paths are allowed.
		if ( ! $is_file_on_server && 'relative' !== $file_path_type ) {
			return true;
		}

// On windows system, local files ending with `.` are not allowed.
		// @link https://docs.microsoft.com/en-us/windows/win32/fileio/naming-a-file?redirectedfrom=MSDN#naming-conventions.
		if ( $is_file_on_server && ! $this->get_file_extension() && 'WIN' === strtoupper( substr( Constants::get_constant( 'PHP_OS' ), 0, 3 ) ) ) {
			if ( '.' === substr( $file_path, -1 ) ) {
				return false;
			}
		}

return ! $this->get_file_extension() || in_array( $this->get_file_type(), $this->get_allowed_mime_types(), true );
	}

/**
	 * Validate file exists.
	 *
	 * @return boolean
	 */
	public function file_exists() {
		if ( 'relative' !== $this->get_type_of_file_path() ) {
			return true;
		}
		$file_url = $this->get_file();
		if ( '..' === substr( $file_url, 0, 2 ) || '/' !== substr( $file_url, 0, 1 ) ) {
			$file_url = realpath( ABSPATH . $file_url );
		} elseif ( substr( WP_CONTENT_DIR, strlen( untrailingslashit( ABSPATH ) ) ) === substr( $file_url, 0, strlen( substr( WP_CONTENT_DIR, strlen( untrailingslashit( ABSPATH ) ) ) ) ) ) {
			$file_url = realpath( WP_CONTENT_DIR . substr( $file_url, 11 ) );
		}
		return apply_filters( 'woocommerce_downloadable_file_exists', file_exists( $file_url ), $this->get_file() );
	}

/**
	 * Confirms that the download exists within an approved directory.
	 *
	 * If it is not within an approved directory but the current user has sufficient
	 * capabilities, then the method will try to add the download's directory to the
	 * approved directory list.
	 *
	 * @throws Exception If the download is not in an approved directory.
	 *
	 * @param bool $auto_add_to_approved_directory_list If the download is not already in the approved directory list, automatically add it if possible.
	 */
	private function approved_directory_checks( bool $auto_add_to_approved_directory_list = true ) {
		$download_directories = wc_get_container()->get( Download_Directories::class );

if ( $download_directories->get_mode() !== Download_Directories::MODE_ENABLED ) {
			return;
		}

$download_file = $this->get_file();

/**
		 * Controls whether shortcodes should be resolved and validated using the Approved Download Directory feature.
		 *
		 * @param bool $should_validate
		 */
		if ( apply_filters( 'woocommerce_product_downloads_approved_directory_validation_for_shortcodes', true ) && 'shortcode' === $this->get_type_of_file_path() ) {
			$download_file = do_shortcode( $download_file );
		}

$is_site_administrator   = is_multisite() ? current_user_can( 'manage_sites' ) : current_user_can( 'manage_options' );
		$valid_storage_directory = $download_directories->is_valid_path( $download_file );

if ( $valid_storage_directory ) {
			return;
		}

if ( $auto_add_to_approved_directory_list ) {
			try {
				// Add the parent URL to the approved directories list, but *do not enable it* unless the current user is a site admin.
				$download_directories->add_approved_directory( ( new URL( $download_file ) )->get_parent_url(), $is_site_administrator );
				$valid_storage_directory = $download_directories->is_valid_path( $download_file );
			} catch ( Exception $e ) { // phpcs:ignore Generic.CodeAnalysis.EmptyStatement.DetectedCatch
				// At this point, $valid_storage_directory will be false. Fall-through so the appropriate exception is
				// triggered (same as if the storage directory was invalid and $auto_add_to_approved_directory_list was false.
			}
		}

if ( ! $valid_storage_directory ) {
			$this->raise_invalid_file_exception( $download_file );
		}
	}

/**
	 * Convenience method, allows us to re-use the same exception messaging from different areas.
	 *
	 * @throws Exception
	 *
	 * @param string $download_file
	 *
	 * @return void
	 */
	private function raise_invalid_file_exception( string $download_file ): void {
		throw new Exception(
			sprintf(
				/* translators: %1$s is the downloadable file path, %2$s is an opening link tag, %3%s is a closing link tag. */
				__( 'The downloadable file %s cannot be used as it does not exist on the server, or is not located within an approved directory. Please contact a site administrator for help. %2$sLearn more.%3$s', 'woocommerce' ),
				'<code>' . $download_file . '</code>',
				'<a href="https://woocommerce.com/document/approved-download-directories">',
				'</a>'
			)
		);
	}

/*
	|--------------------------------------------------------------------------
	| Setters
	|--------------------------------------------------------------------------
	*/

/**
	 * Set extra data by key.
	 *
	 * @since 10.6.0
	 * @param string $key   Extra data key.
	 * @param mixed  $value Extra data value.
	 */
	public function set_extra_data( string $key, $value ): void {
		$this->extra_data[ $key ] = $value;
	}

/**
	 * Set ID.
	 *
	 * @param string $value Download ID.
	 */
	public function set_id( $value ) {
		$this->data['id'] = wc_clean( $value );
	}

/**
	 * Set name.
	 *
	 * @param string $value Download name.
	 */
	public function set_name( $value ) {
		$this->data['name'] = wc_clean( $value );
	}

/**
	 * Set previous_hash.
	 *
	 * @deprecated 3.3.0 No longer using filename based hashing to keep track of files.
	 * @param string $value Previous hash.
	 */
	public function set_previous_hash( $value ) {
		wc_deprecated_function( __FUNCTION__, '3.3' );
		$this->data['previous_hash'] = wc_clean( $value );
	}

/**
	 * Set file.
	 *
	 * @param string $value File URL/Path.
	 */
	public function set_file( $value ) {
		// A `///` is recognized as an "absolute", but on the filesystem, so it bypasses the mime check in `self::is_allowed_filetype`.
		// This will strip extra prepending / to the maximum of 2.
		if ( preg_match( '#^//+(/[^/].+)$#i', $value, $matches ) ) {
			$value = $matches[1];
		}
		switch ( $this->get_type_of_file_path( $value ) ) {
			case 'absolute':
				$this->data['file'] = esc_url_raw( $value );
				break;
			default:
				$this->data['file'] = wc_clean( $value );
				break;
		}
	}

/**
	 * Sets the status of the download to enabled (true) or disabled (false).
	 *
	 * @param bool $enabled True indicates the downloadable file is enabled, false indicates it is disabled.
	 */
	public function set_enabled( bool $enabled = true ) {
		$this->data['enabled'] = $enabled;
	}

/*
	|--------------------------------------------------------------------------
	| Getters
	|--------------------------------------------------------------------------
	*/

/**
	 * Get all extra data.
	 *
	 * @since 10.6.0
	 * @return array
	 */
	public function get_all_extra_data() {
		return $this->extra_data;
	}

/**
	 * Get extra data by key.
	 *
	 * @since 10.6.0
	 * @param string $key Extra data key.
	 * @return mixed
	 */
	public function get_extra_data( string $key ) {
		return $this->extra_data[ $key ] ?? null;
	}

/**
	 * Get id.
	 *
	 * @return string
	 */
	public function get_id() {
		return $this->data['id'];
	}

/**
	 * Get name.
	 *
	 * @return string
	 */
	public function get_name() {
		return $this->data['name'];
	}

/**
	 * Get previous_hash.
	 *
	 * @deprecated 3.3.0 No longer using filename based hashing to keep track of files.
	 * @return string
	 */
	public function get_previous_hash() {
		wc_deprecated_function( __FUNCTION__, '3.3' );
		return $this->data['previous_hash'];
	}

/**
	 * Get file.
	 *
	 * @return string
	 */
	public function get_file() {
		return $this->data['file'];
	}

/**
	 * Get status of the download.
	 *
	 * @return bool
	 */
	public function get_enabled(): bool {
		return $this->data['enabled'];
	}

/*
	|--------------------------------------------------------------------------
	| ArrayAccess/Backwards compatibility.
	|--------------------------------------------------------------------------
	*/

/**
	 * OffsetGet.
	 *
	 * @param string $offset Offset.
	 * @return mixed
	 */
	#[\ReturnTypeWillChange]
	public function offsetGet( $offset ) {
		switch ( $offset ) {
			default:
				if ( is_callable( array( $this, "get_$offset" ) ) ) {
					return $this->{"get_$offset"}();
				}
				if ( isset( $this->extra_data[ $offset ] ) ) {
					return $this->extra_data[ $offset ];
				}
				break;
		}
		return '';
	}

/**
	 * OffsetSet.
	 *
	 * @param string $offset Offset.
	 * @param mixed  $value Offset value.
	 */
	#[\ReturnTypeWillChange]
	public function offsetSet( $offset, $value ) {
		switch ( $offset ) {
			default:
				if ( is_callable( array( $this, "set_$offset" ) ) ) {
					$this->{"set_$offset"}( $value );
					break;
				}
				$this->extra_data[ $offset ] = $value;
				break;
		}
	}

/**
	 * OffsetUnset.
	 *
	 * @param string $offset Offset.
	 */
	#[\ReturnTypeWillChange]
	public function offsetUnset( $offset ) {}

/**
	 * OffsetExists.
	 *
	 * @param string $offset Offset.
	 * @return bool
	 */
	#[\ReturnTypeWillChange]
	public function offsetExists( $offset ) {
		return in_array( $offset, array_merge( array_keys( $this->data ), array_keys( $this->extra_data ) ), true );
	}
}

cmd: