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

PATH: home / lab2454c / adenbic.com / wp-content / plugins / yith-woocommerce-wishlist / includes

<?php
/**
 * Wishlist Factory class
 *
 * @author YITH <plugins@yithemes.com>
 * @package YITH\Wishlist\Classes\Wishlists
 * @version 3.0.0
 */

if ( ! defined( 'YITH_WCWL' ) ) {
	exit;
} // Exit if accessed directly

if ( ! class_exists( 'YITH_WCWL_Wishlist_Factory' ) ) {
	/**
	 * This class is used to create all Wishlist object required by the plugin
	 *
	 * @since 3.0.0
	 */
	class YITH_WCWL_Wishlist_Factory {
		/**
		 * Retrieve a specific wishlist from ID or token
		 *
		 * @param string|int|bool $wishlist_id Wishlist id or token or false, when you want to retrieve default.
		 * @param string          $context Context; when on edit context, and no wishlist matches selection, default wishlist will be created and returned.
		 * @return \YITH_WCWL_Wishlist|bool Wishlist object or false on failure
		 */
		public static function get_wishlist( $wishlist_id = false, $context = 'view' ) {
			if ( ! $wishlist_id ) {
				return self::get_default_wishlist( false, $context );
			}

try {
				return new YITH_WCWL_Wishlist( $wishlist_id );
			} catch ( Exception $e ) {
				wc_caught_exception( $e, __FUNCTION__, func_get_args() );
				return false;
			}
		}

/**
		 * Query database to search for wishlists that matches specific parameters
		 *
		 * @param array $args Array of valid arguments 
		 * [ 
		 * 'id' // Wishlist id to search, if any 
		 * 'user_id' // User owner 
		 * 'wishlist_slug' // Slug of the wishlist to search 
		 * 'wishlist_name' // Name of the wishlist to search 
		 * 'wishlist_token' // Token of the wishlist to search 
		 * 'wishlist_visibility' // Wishlist visibility: all, visible, public, shared, private 
		 * 'user_search' // String to match against first name / last name or email of the wishlist owner 
		 * 'is_default' // Whether wishlist should be default or not 
		 * 'orderby' // Column used to sort final result (could be any wishlist lists column) 
		 * 'order' // Sorting order 
		 * 'limit' // Pagination param: maximum number of elements in the set. 0 to retrieve all elements 
		 * 'offset' // Pagination param: offset for the current set. 0 to start from the first item 
		 * 'show_empty' // Whether to show empty lists os not 
		 * ].
		 *
		 * @return \YITH_WCWL_Wishlist[]|bool A list of matching wishlists or false on failure
		 */
		public static function get_wishlists( $args = array() ) {
			/**
			 * APPLY_FILTERS: yith_wcwl_wishlist_query_args
			 *
			 * Filter the array of parameters to get wishlists.
			 *
			 * @param array $args Array of parameters
			 *
			 * @return array
			 */
			$args = apply_filters( 'yith_wcwl_wishlist_query_args', $args );

try {
				$results = WC_Data_Store::load( 'wishlist' )->query( $args );

/**
				 * APPLY_FILTERS: yith_wcwl_wishlist_query
				 *
				 * Filter the result of the query to get wishlists.
				 *
				 * @param array $results Query results
				 * @param array $args    Array of parameters
				 *
				 * @return array
				 */
				return apply_filters( 'yith_wcwl_wishlist_query', $results, $args );
			} catch ( Exception $e ) {
				wc_caught_exception( $e, __FUNCTION__, func_get_args() );
				return false;
			}
		}

/**
		 * Query database to count wishlists that matches specific parameters
		 *
		 * @param array $args Same parameters allowed for {@see get_wishlists}.
		 * @return int Count
		 */
		public static function get_wishlists_count( $args = array() ) {
			/**
			 * APPLY_FILTERS: yith_wcwl_wishlists_count_query_args
			 *
			 * Filter the array of parameters to get wishlists count.
			 *
			 * @param array $args Array of parameters
			 *
			 * @return array
			 */
			$args = apply_filters( 'yith_wcwl_wishlists_count_query_args', $args );

try {
				$result = WC_Data_Store::load( 'wishlist' )->count( $args );

/**
				 * APPLY_FILTERS: yith_wcwl_wishlist_count_query
				 *
				 * Filter the result of the query to get wishlists count.
				 *
				 * @param int   $result Query results
				 * @param array $args   Array of parameters
				 *
				 * @return int
				 */
				return apply_filters( 'yith_wcwl_wishlist_count_query', $result, $args );
			} catch ( Exception $e ) {
				wc_caught_exception( $e, __FUNCTION__, func_get_args() );
				return 0;
			}
		}

/**
		 * Search user ids whose wishlists match passed parameters
		 * NOTE: this will only retrieve wishlists for a logged in user, while guests wishlist will be ignored
		 *
		 * @param array $args Array of valid arguments 
		 * [ 
		 * 'search' // String to match against first name / last name / user login or user email of wishlist owner 
		 * 'limit' // Pagination param: number of items to show in one page. 0 to show all items 
		 * 'offset' // Pagination param: offset for the current set. 0 to start from the first item 
		 * ].
		 * @return int[]|bool Array of user ids, or false on failure
		 */
		public static function get_wishlist_users( $args = array() ) {
			/**
			 * APPLY_FILTERS: yith_wcwl_wishlist_users_query_args
			 *
			 * Filter the array of parameters to get wishlists users.
			 *
			 * @param array $args Array of parameters
			 *
			 * @return array
			 */
			$args = apply_filters( 'yith_wcwl_wishlist_users_query_args', $args );

try {
				$results = WC_Data_Store::load( 'wishlist' )->search_users( $args );

/**
				 * APPLY_FILTERS: yith_wcwl_wishlist_user_query
				 *
				 * Filter the result of the query to get wishlists users.
				 *
				 * @param array $results Query results
				 * @param array $args   Array of parameters
				 *
				 * @return array
				 */
				return apply_filters( 'yith_wcwl_wishlist_user_query', $results, $args );
			} catch ( Exception $e ) {
				wc_caught_exception( $e, __FUNCTION__, func_get_args() );
				return false;
			}
		}

/**
		 * Retrieve current wishlist, basing on query string parameters, user or session
		 *
		 * @param array $args Array of arguments 
		 * [ 
		 * 'action_params' // query string parameters
		 * 'user_id' // user we need to retrieve wishlist for
		 * 'wishlist_id' // id of the wishlist we need to retrieve
		 * ].
		 * @return YITH_WCWL_Wishlist|bool
		 */
		public static function get_current_wishlist( $args = array() ) {
			$defaults = array(
				'action_params' => get_query_var( YITH_WCWL()->wishlist_param, false ),
				'user_id' => isset( $_GET['user_id'] ) ? intval( $_GET['user_id'] ) : false, // phpcs:ignore WordPress.Security.NonceVerification.Recommended
				'wishlist_id' => false,
			);

/**
			 * Extracted variables:
			 *
			 * @var $action_params
			 * @var $user_id
			 * @var $wishlist_id
			 */
			$args = wp_parse_args( $args, $defaults );
			extract( $args ); // phpcs:ignore WordPress.PHP.DontExtract

// retrieve options from query string.
			/**
			 * APPLY_FILTERS: yith_wcwl_current_wishlist_view_params
			 *
			 * Filter the array of parameters to see the current wishlist.
			 *
			 * @param array $params Array of parameters
			 *
			 * @return array
			 */
			$action_params = explode( '/', apply_filters( 'yith_wcwl_current_wishlist_view_params', $action_params ) );

$action = ( isset( $action_params[0] ) ) ? $action_params[0] : 'view';
			$value  = ( isset( $action_params[1] ) ) ? $action_params[1] : '';

if ( ! empty( $wishlist_id ) ) {
				return self::get_wishlist( $wishlist_id );
			}

if ( ! empty( $user_id ) ) {
				return self::get_default_wishlist( $user_id );
			}

if (
				empty( $action ) ||
				! in_array( $action, YITH_WCWL()->get_available_views(), true ) ||
				in_array( $action, array( 'view', 'user' ), true ) ||
				( in_array( $action, array( 'manage', 'create' ), true ) && ! YITH_WCWL()->is_multi_wishlist_enabled() )
			) {
				switch ( $action ) {
					case 'user':
						$user_id = $value;
						$user_id = ( ! $user_id ) ? get_query_var( $user_id, false ) : $user_id;

return self::get_default_wishlist( intval( $user_id ) );
					case 'view':
					default:
						return self::get_wishlist( sanitize_text_field( $value ) );
				}
			}

return false;
		}

/**
		 * Retrieve default wishlist for current user (or current session)
		 *
		 * @param string|int|bool $id      Customer or session id; false if you want to use current customer or session.
		 * @param string          $context Context; when on edit context, wishlist will be created, if not exists.
		 *
		 * @return \YITH_WCWL_Wishlist|bool Wishlist object or false on failure
		 */
		public static function get_default_wishlist( $id = false, $context = 'read' ) {
			try {
				$default_wishlist = WC_Data_Store::load( 'wishlist' )->get_default_wishlist( $id, $context );

/**
				 * APPLY_FILTERS: yith_wcwl_default_wishlist
				 *
				 * Filter the default wishlist created.
				 *
				 * @param YITH_WCWL_Wishlist $default_wishlist Default wishlist
				 * @param int                $id               Customer or session ID
				 * @param string             $context          Context
				 *
				 * @return YITH_WCWL_Wishlist
				 */
				return apply_filters( 'yith_wcwl_default_wishlist', $default_wishlist, $id, $context );
			} catch ( Exception $e ) {
				wc_caught_exception( $e, __FUNCTION__, func_get_args() );
				return false;
			}
		}

/**
		 * Retrieve default wishlist for current user (or current session)
		 *
		 * @param string|int|bool $id Customer or session id; false if you want to use current customer or session.
		 * @return \YITH_WCWL_Wishlist|bool Wishlist object or false on failure
		 */
		public static function generate_default_wishlist( $id = false ) {
			return self::get_default_wishlist( $id );
		}

/**
		 * Generate new token for a wishlist
		 *
		 * @return string|bool Brand new token, or false on failure
		 */
		public static function generate_wishlist_token() {
			try {
				$token = WC_Data_Store::load( 'wishlist' )->generate_token();
				return $token;
			} catch ( Exception $e ) {
				wc_caught_exception( $e, __FUNCTION__, func_get_args() );
				return false;
			}
		}

/**
		 * Retrieve a specific wishlist item from ID
		 *
		 * @param int|\YITH_WCWL_Wishlist_Item|stdClass $item_id Item identifier, or item itself.
		 * @return \YITH_WCWL_Wishlist_Item|bool Wishlist item, or false on failure
		 */
		public static function get_wishlist_item( $item_id = 0 ) {
			if ( is_numeric( $item_id ) ) {
				$id = $item_id;
			} elseif ( $item_id instanceof YITH_WCWL_Wishlist_Item ) {
				$id = $item_id->get_id();
			} elseif ( is_object( $item_id ) && ! empty( $item_id->ID ) ) {
				$id = $item_id->ID;
			} else {
				$id = false;
			}

if ( $id ) {
				try {
					return new YITH_WCWL_Wishlist_Item( $id );
				} catch ( Exception $e ) {
					return false;
				}
			}
			return false;
		}

/**
		 * Retrieve item from a wishlist by product id
		 *
		 * @param int|string $wishlist_id Wishlist id or token.
		 * @param int        $product_id  Product ID.
		 * @return YITH_WCWL_Wishlist_Item|bool Item, or false when no item found
		 */
		public static function get_wishlist_item_by_product_id( $wishlist_id, $product_id ) {
			$wishlist = self::get_wishlist( $wishlist_id );

if ( $wishlist ) {
				return $wishlist->get_product( $product_id );
			}

return false;
		}

/**
		 * Query database to search for wishlist items that matches specific parameters
		 *
		 * @param array $args Arguments array; it may contains any of the following: 
		 * [ 
		 * 'user_id' // Owner of the wishlist; default to current user logged in (if any), or false for cookie wishlist 
		 * 'product_id' // Product to search in the wishlist 
		 * 'wishlist_id' // wishlist_id for a specific wishlist, false for default, or all for any wishlist 
		 * 'wishlist_token' // wishlist token, or false as default 
		 * 'wishlist_visibility' // all, visible, public, shared, private 
		 * 'is_default' => // whether searched wishlist should be default one 
		 * 'id' => false, // only for table select 
		 * 'limit' => false, // pagination param; number of items per page. 0 to get all items 
		 * 'offset' => 0 // pagination param; offset for the current set. 0 to start from the first item 
		 * ].
		 *
		 * @return \YITH_WCWL_Wishlist_Item[]|bool A list of matching items or false on failure
		 */
		public static function get_wishlist_items( $args = array() ) {
			/**
			 * APPLY_FILTERS: yith_wcwl_wishlist_items_query_args
			 *
			 * Filter the array of parameters to get wishlist items.
			 *
			 * @param array $args Array of parameters
			 *
			 * @return array
			 */
			$args = apply_filters( 'yith_wcwl_wishlist_items_query_args', $args );

try {
				$results = WC_Data_Store::load( 'wishlist-item' )->query( $args );

/**
				 * APPLY_FILTERS: yith_wcwl_wishlist_item_query
				 *
				 * Filter the result of the query to get wishlist items.
				 *
				 * @param array $results Query results
				 * @param array $args    Array of parameters
				 *
				 * @return array
				 */
				return apply_filters( 'yith_wcwl_wishlist_item_query', $results, $args );
			} catch ( Exception $e ) {
				wc_caught_exception( $e, __FUNCTION__, func_get_args() );
				return false;
			}
		}

/**
		 * Query database to count wishlist items that matches specific parameters
		 *
		 * @param array $args Same parameters allowed for {@see get_wishlist_items}.
		 * @return int Count
		 */
		public static function get_wishlist_items_count( $args = array() ) {
			/**
			 * APPLY_FILTERS: yith_wcwl_wishlist_items_count_query_args
			 *
			 * Filter the array of parameters to get wishlist items count.
			 *
			 * @param array $args Array of parameters
			 *
			 * @return array
			 */
			$args = apply_filters( 'yith_wcwl_wishlist_items_count_query_args', $args );

try {
				$result = WC_Data_Store::load( 'wishlist-item' )->count( $args );

/**
				 * APPLY_FILTERS: yith_wcwl_wishlist_item_count_query
				 *
				 * Filter the result of the query to get wishlist items count.
				 *
				 * @param int   $result Query results
				 * @param array $args   Array of parameters
				 *
				 * @return int
				 */
				return apply_filters( 'yith_wcwl_wishlist_item_count_query', $result, $args );
			} catch ( Exception $e ) {
				wc_caught_exception( $e, __FUNCTION__, func_get_args() );
				return 0;
			}
		}

/**
		 * Count how many times a specific product was added to wishlist
		 *
		 * @param int $product_id Product id.
		 * @return int Count of times product was added to cart
		 */
		public static function get_times_added_count( $product_id ) {
			try {
				$result = WC_Data_Store::load( 'wishlist-item' )->count_times_added( $product_id );

/**
				 * APPLY_FILTERS: yith_wcwl_wishlist_times_added_count_query
				 *
				 * Filter the result of the query to get how many times a product has been added to a wishlist.
				 *
				 * @param int $result     Query results
				 * @param int $product_id Product ID
				 *
				 * @return int
				 */
				return (int) apply_filters( 'yith_wcwl_wishlist_times_added_count_query', $result, $product_id );
			} catch ( Exception $e ) {
				wc_caught_exception( $e, __FUNCTION__, func_get_args() );
				return 0;
			}
		}

/**
		 * Count how many times a specific product was added to wishlist by the current user
		 *
		 * @param int $product_id Product id.
		 * @return int Count of times product was added to cart
		 */
		public static function get_times_current_user_added_count( $product_id ) {
			try {
				$result = WC_Data_Store::load( 'wishlist-item' )->count_times_added( $product_id, 'current' );

/**
				 * APPLY_FILTERS: yith_wcwl_wishlist_times_current_user_added_count_query
				 *
				 * Filter the result of the query to get how many times a product has been added to a wishlist by the current user.
				 *
				 * @param int $result     Query results
				 * @param int $product_id Product ID
				 *
				 * @return int
				 */
				return (int) apply_filters( 'yith_wcwl_wishlist_times_current_user_added_count_query', $result, $product_id );
			} catch ( Exception $e ) {
				wc_caught_exception( $e, __FUNCTION__, func_get_args() );
				return 0;
			}
		}
	}
}

[-] class-yith-wcwl-wishlist-factory.php [edit]
[+] widgets
[-] class-yith-wcwl-shortcode.php [edit]
[+] ..
[-] class-yith-wcwl-frontend.php [edit]
[-] class-yith-wcwl-privacy.php [edit]
[-] class-yith-wcwl-admin.php [edit]
[-] class-yith-wcwl-form-handler.php [edit]
[-] class-yith-wcwl-session.php [edit]
[-] class-yith-wcwl-ajax-handler.php [edit]
[+] legacy
[-] class-yith-wcwl-exception.php [edit]
[-] class-yith-wcwl-wishlist-item.php [edit]
[-] class-yith-wcwl-cron.php [edit]
[-] class-yith-wcwl-wishlist.php [edit]
[-] class-yith-wcwl-install.php [edit]
[-] class-yith-wcwl.php [edit]
[+] data-stores
[-] functions-yith-wcwl.php [edit]