ꦫꦣꦺꦤ꧀ꦄꦤ꧀ꦠꦱꦺꦤ

PATH: home / lab2454c / mact34.com / wp-content / plugins / woocommerce / includes

<?php
/**
 * Class for customer download permissions.
 *
 * @package WooCommerce\Classes
 * @version 3.0.0
 * @since   3.0.0
 */

defined( 'ABSPATH' ) || exit;

/**
 * Customer download class.
 */
class WC_Customer_Download extends WC_Data implements ArrayAccess {

/**
	 * This is the name of this object type.
	 *
	 * @var string
	 */
	protected $object_type = 'customer_download';

/**
	 * Download Data array.
	 *
	 * @since 3.0.0
	 * @var array
	 */
	protected $data = array(
		'download_id'         => '',
		'product_id'          => 0,
		'user_id'             => 0,
		'user_email'          => '',
		'order_id'            => 0,
		'order_key'           => '',
		'downloads_remaining' => '',
		'access_granted'      => null,
		'access_expires'      => null,
		'download_count'      => 0,
	);

/**
	 * Constructor.
	 *
	 * @param int|object|array $download Download ID, instance or data.
	 */
	public function __construct( $download = 0 ) {
		parent::__construct( $download );

if ( is_numeric( $download ) && $download > 0 ) {
			$this->set_id( $download );
		} elseif ( $download instanceof self ) {
			$this->set_id( $download->get_id() );
		} elseif ( is_object( $download ) && ! empty( $download->permission_id ) ) {
			$this->set_id( $download->permission_id );
			$this->set_props( (array) $download );
			$this->set_object_read( true );
		} else {
			$this->set_object_read( true );
		}

$this->data_store = WC_Data_Store::load( 'customer-download' );

if ( $this->get_id() > 0 ) {
			$this->data_store->read( $this );
		}
	}

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

/**
	 * Get download id.
	 *
	 * @param  string $context What the value is for. Valid values are 'view' and 'edit'.
	 * @return string
	 */
	public function get_download_id( $context = 'view' ) {
		return $this->get_prop( 'download_id', $context );
	}

/**
	 * Get product id.
	 *
	 * @param  string $context What the value is for. Valid values are 'view' and 'edit'.
	 * @return integer
	 */
	public function get_product_id( $context = 'view' ) {
		return $this->get_prop( 'product_id', $context );
	}

/**
	 * Get user id.
	 *
	 * @param  string $context What the value is for. Valid values are 'view' and 'edit'.
	 * @return integer
	 */
	public function get_user_id( $context = 'view' ) {
		return $this->get_prop( 'user_id', $context );
	}

/**
	 * Get user_email.
	 *
	 * @param  string $context What the value is for. Valid values are 'view' and 'edit'.
	 * @return string
	 */
	public function get_user_email( $context = 'view' ) {
		return $this->get_prop( 'user_email', $context );
	}

/**
	 * Get order_id.
	 *
	 * @param  string $context What the value is for. Valid values are 'view' and 'edit'.
	 * @return integer
	 */
	public function get_order_id( $context = 'view' ) {
		return $this->get_prop( 'order_id', $context );
	}

/**
	 * Get order_key.
	 *
	 * @param  string $context What the value is for. Valid values are 'view' and 'edit'.
	 * @return string
	 */
	public function get_order_key( $context = 'view' ) {
		return $this->get_prop( 'order_key', $context );
	}

/**
	 * Get downloads_remaining.
	 *
	 * @param  string $context What the value is for. Valid values are 'view' and 'edit'.
	 * @return integer|string
	 */
	public function get_downloads_remaining( $context = 'view' ) {
		return $this->get_prop( 'downloads_remaining', $context );
	}

/**
	 * Get access_granted.
	 *
	 * @param  string $context What the value is for. Valid values are 'view' and 'edit'.
	 * @return WC_DateTime|null Object if the date is set or null if there is no date.
	 */
	public function get_access_granted( $context = 'view' ) {
		return $this->get_prop( 'access_granted', $context );
	}

/**
	 * Get access_expires.
	 *
	 * @param  string $context What the value is for. Valid values are 'view' and 'edit'.
	 * @return WC_DateTime|null Object if the date is set or null if there is no date.
	 */
	public function get_access_expires( $context = 'view' ) {
		return $this->get_prop( 'access_expires', $context );
	}

/**
	 * Get download_count.
	 *
	 * @param  string $context What the value is for. Valid values are 'view' and 'edit'.
	 * @return integer
	 */
	public function get_download_count( $context = 'view' ) {
		// Check for count of download logs.
		$data_store       = WC_Data_Store::load( 'customer-download-log' );
		$download_log_ids = $data_store->get_download_logs_for_permission( $this->get_id() );

$download_log_count = 0;
		if ( ! empty( $download_log_ids ) ) {
			$download_log_count = count( $download_log_ids );
		}

// Check download count in prop.
		$download_count_prop = $this->get_prop( 'download_count', $context );

// Return the larger of the two in case they differ.
		// If logs are removed for some reason, we should still respect the
		// count stored in the prop.
		return max( $download_log_count, $download_count_prop );
	}

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

/**
	 * Set download id.
	 *
	 * @param string $value Download ID.
	 */
	public function set_download_id( $value ) {
		$this->set_prop( 'download_id', $value );
	}
	/**
	 * Set product id.
	 *
	 * @param int $value Product ID.
	 */
	public function set_product_id( $value ) {
		$this->set_prop( 'product_id', absint( $value ) );
	}

/**
	 * Set user id.
	 *
	 * @param int $value User ID.
	 */
	public function set_user_id( $value ) {
		$this->set_prop( 'user_id', absint( $value ) );
	}

/**
	 * Set user_email.
	 *
	 * @param int $value User email.
	 */
	public function set_user_email( $value ) {
		$this->set_prop( 'user_email', sanitize_email( $value ) );
	}

/**
	 * Set order_id.
	 *
	 * @param int $value Order ID.
	 */
	public function set_order_id( $value ) {
		$this->set_prop( 'order_id', absint( $value ) );
	}

/**
	 * Set order_key.
	 *
	 * @param string $value Order key.
	 */
	public function set_order_key( $value ) {
		$this->set_prop( 'order_key', $value );
	}

/**
	 * Set downloads_remaining.
	 *
	 * @param integer|string $value Amount of downloads remaining.
	 */
	public function set_downloads_remaining( $value ) {
		$this->set_prop( 'downloads_remaining', '' === $value ? '' : absint( $value ) );
	}

/**
	 * Set access_granted.
	 *
	 * @param string|integer|null $date UTC timestamp, or ISO 8601 DateTime. If the DateTime string has no timezone or offset, WordPress site timezone will be assumed. Null if their is no date.
	 */
	public function set_access_granted( $date = null ) {
		$this->set_date_prop( 'access_granted', $date );
	}

/**
	 * Set access_expires.
	 *
	 * @param string|integer|null $date UTC timestamp, or ISO 8601 DateTime. If the DateTime string has no timezone or offset, WordPress site timezone will be assumed. Null if their is no date.
	 */
	public function set_access_expires( $date = null ) {
		$this->set_date_prop( 'access_expires', $date );
	}

/**
	 * Set download_count.
	 *
	 * @param int $value Download count.
	 */
	public function set_download_count( $value ) {
		$this->set_prop( 'download_count', absint( $value ) );
	}

/**
	 * Track a download on this permission.
	 *
	 * @since 3.3.0
	 * @throws Exception When permission ID is invalid.
	 * @param int    $user_id         Id of the user performing the download.
	 * @param string $user_ip_address IP Address of the user performing the download.
	 */
	public function track_download( $user_id = null, $user_ip_address = null ) {
		global $wpdb;

// Must have a permission_id to track download log.
		if ( ! ( $this->get_id() > 0 ) ) {
			throw new Exception( __( 'Invalid permission ID.', 'woocommerce' ) );
		}

// Increment download count, and decrement downloads remaining.
		// Use SQL to avoid possible issues with downloads in quick succession.
		// If downloads_remaining is blank, leave it blank (unlimited).
		// Also, ensure downloads_remaining doesn't drop below zero.
		$query = $wpdb->prepare(
			"
UPDATE {$wpdb->prefix}woocommerce_downloadable_product_permissions
SET download_count = download_count + 1,
downloads_remaining = IF( downloads_remaining = '', '', GREATEST( 0, downloads_remaining - 1 ) )
WHERE permission_id = %d",
			$this->get_id()
		);
		$wpdb->query( $query ); // WPCS: unprepared SQL ok.

// Re-read this download from the data store to pull updated counts.
		$this->data_store->read( $this );

// Track download in download log.
		$download_log = new WC_Customer_Download_Log();
		$download_log->set_timestamp( current_time( 'timestamp', true ) );
		$download_log->set_permission_id( $this->get_id() );

if ( ! is_null( $user_id ) ) {
			$download_log->set_user_id( $user_id );
		}

if ( ! is_null( $user_ip_address ) ) {
			$download_log->set_user_ip_address( $user_ip_address );
		}

$download_log->save();
	}

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

/**
	 * OffsetGet.
	 *
	 * @param string $offset Offset.
	 * @return mixed
	 */
	public function offsetGet( $offset ) {
		if ( is_callable( array( $this, "get_$offset" ) ) ) {
			return $this->{"get_$offset"}();
		}
	}

/**
	 * OffsetSet.
	 *
	 * @param string $offset Offset.
	 * @param mixed  $value  Value.
	 */
	public function offsetSet( $offset, $value ) {
		if ( is_callable( array( $this, "set_$offset" ) ) ) {
			$this->{"set_$offset"}( $value );
		}
	}

/**
	 * OffsetUnset
	 *
	 * @param string $offset Offset.
	 */
	public function offsetUnset( $offset ) {
		if ( is_callable( array( $this, "set_$offset" ) ) ) {
			$this->{"set_$offset"}( '' );
		}
	}

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

/**
	 * Magic __isset method for backwards compatibility. Legacy properties which could be accessed directly in the past.
	 *
	 * @param  string $key Key name.
	 * @return bool
	 */
	public function __isset( $key ) {
		return in_array( $key, array_keys( $this->data ), true );
	}

/**
	 * Magic __get method for backwards compatibility. Maps legacy vars to new getters.
	 *
	 * @param  string $key Key name.
	 * @return mixed
	 */
	public function __get( $key ) {
		if ( is_callable( array( $this, "get_$key" ) ) ) {
			return $this->{"get_$key"}( '' );
		}
	}
}

[+] ..
[-] wc-page-functions.php [edit]
[-] class-wc-countries.php [edit]
[-] class-wc-ajax.php [edit]
[-] class-wc-privacy.php [edit]
[+] customizer
[+] gateways
[-] class-wc-order-refund.php [edit]
[-] wc-stock-functions.php [edit]
[-] class-wc-cart.php [edit]
[-] class-wc-tracker.php [edit]
[-] class-wc-frontend-scripts.php [edit]
[-] class-wc-product-download.php [edit]
[+] widgets
[+] admin
[-] class-wc-auth.php [edit]
[-] class-wc-rest-authentication.php [edit]
[-] class-wc-data-exception.php [edit]
[-] class-wc-log-levels.php [edit]
[-] wc-coupon-functions.php [edit]
[-] class-wc-order-item-shipping.php [edit]
[+] integrations
[-] class-wc-payment-gateways.php [edit]
[-] wc-order-functions.php [edit]
[+] shipping
[-] class-wc-order-item-coupon.php [edit]
[-] class-wc-payment-tokens.php [edit]
[-] wc-deprecated-functions.php [edit]
[-] class-wc-product-grouped.php [edit]
[+] tracks
[-] wc-product-functions.php [edit]
[-] class-wc-datetime.php [edit]
[-] wc-user-functions.php [edit]
[-] wc-widget-functions.php [edit]
[-] class-wc-breadcrumb.php [edit]
[-] class-wc-customer-download-log.php [edit]
[-] class-wc-order-query.php [edit]
[-] wc-template-hooks.php [edit]
[-] class-wc-https.php [edit]
[-] class-wc-order.php [edit]
[-] wc-attribute-functions.php [edit]
[-] class-wc-session-handler.php [edit]
[-] class-wc-product-variation.php [edit]
[-] class-wc-query.php [edit]
[-] class-wc-coupon.php [edit]
[-] class-wc-shipping-zone.php [edit]
[-] wc-account-functions.php [edit]
[-] wc-formatting-functions.php [edit]
[-] class-wc-integrations.php [edit]
[-] class-wc-validation.php [edit]
[-] class-wc-webhook.php [edit]
[+] traits
[-] class-wc-checkout.php [edit]
[-] wc-core-functions.php [edit]
[+] emails
[-] wc-cart-functions.php [edit]
[-] class-wc-shipping.php [edit]
[-] class-wc-customer-download.php [edit]
[-] class-wc-geolite-integration.php [edit]
[-] class-wc-data-store.php [edit]
[-] class-wc-order-item-tax.php [edit]
[-] class-wc-customer.php [edit]
[-] class-wc-product-attribute.php [edit]
[+] legacy
[+] import
[-] class-wc-cli.php [edit]
[+] wccom-site
[-] class-wc-form-handler.php [edit]
[-] class-wc-tax.php [edit]
[-] wc-order-item-functions.php [edit]
[+] blocks
[-] class-wc-cache-helper.php [edit]
[-] class-wc-cart-totals.php [edit]
[-] class-wc-emails.php [edit]
[-] class-wc-product-query.php [edit]
[-] class-wc-download-handler.php [edit]
[-] class-wc-product-external.php [edit]
[-] class-woocommerce.php [edit]
[-] class-wc-logger.php [edit]
[-] class-wc-shipping-zones.php [edit]
[-] class-wc-order-item-meta.php [edit]
[+] walkers
[+] shortcodes
[-] class-wc-cart-session.php [edit]
[+] rest-api
[-] class-wc-autoloader.php [edit]
[-] class-wc-meta-data.php [edit]
[-] wc-notice-functions.php [edit]
[+] queue
[-] class-wc-order-item.php [edit]
[-] class-wc-shortcodes.php [edit]
[-] wc-term-functions.php [edit]
[-] wc-webhook-functions.php [edit]
[-] class-wc-privacy-exporters.php [edit]
[-] class-wc-privacy-background-process.php [edit]
[-] class-wc-regenerate-images-request.php [edit]
[-] class-wc-deprecated-filter-hooks.php [edit]
[+] interfaces
[-] class-wc-background-emailer.php [edit]
[-] class-wc-geo-ip.php [edit]
[+] data-stores
[-] class-wc-comments.php [edit]
[-] wc-conditional-functions.php [edit]
[-] class-wc-product-factory.php [edit]
[+] theme-support
[+] libraries
[-] class-wc-structured-data.php [edit]
[-] class-wc-order-factory.php [edit]
[-] class-wc-cart-fees.php [edit]
[-] class-wc-deprecated-action-hooks.php [edit]
[-] class-wc-order-item-fee.php [edit]
[+] cli
[-] class-wc-background-updater.php [edit]
[-] class-wc-discounts.php [edit]
[-] class-wc-rate-limiter.php [edit]
[-] class-wc-geolocation.php [edit]
[-] class-wc-privacy-erasers.php [edit]
[-] class-wc-post-types.php [edit]
[+] export
[+] log-handlers
[-] class-wc-regenerate-images.php [edit]
[+] abstracts
[-] class-wc-rest-exception.php [edit]
[-] class-wc-order-item-product.php [edit]
[-] class-wc-product-simple.php [edit]
[-] wc-rest-functions.php [edit]
[-] class-wc-post-data.php [edit]
[-] class-wc-embed.php [edit]
[+] payment-tokens
[-] class-wc-template-loader.php [edit]
[-] class-wc-product-variable.php [edit]
[-] class-wc-install.php [edit]
[-] class-wc-shipping-rate.php [edit]
[-] class-wc-api.php [edit]
[-] wc-template-functions.php [edit]
[-] wc-update-functions.php [edit]
[-] class-wc-register-wp-admin-settings.php [edit]