2011-09-16 08:10:12 +00:00
< ? php
/**
2015-11-03 13:53:50 +00:00
* Contains the query functions for WooCommerce which alter the front - end post queries and loops
2011-09-16 08:10:12 +00:00
*
2017-09-27 18:01:50 +00:00
* @ version 3.2 . 0
* @ package WooCommerce / Classes
* @ author Automattic
2011-09-16 08:10:12 +00:00
*/
2013-07-23 16:05:01 +00:00
2014-09-20 18:58:54 +00:00
if ( ! defined ( 'ABSPATH' ) ) {
2015-01-28 17:50:58 +00:00
exit ;
2014-09-20 18:58:54 +00:00
}
2013-07-23 16:05:01 +00:00
/**
2015-11-03 13:31:20 +00:00
* WC_Query Class .
2013-07-23 16:05:01 +00:00
*/
2012-01-27 16:38:39 +00:00
class WC_Query {
2012-08-02 21:54:26 +00:00
2017-09-27 18:01:50 +00:00
/**
* Query vars to add to wp .
*
* @ var array
*/
2013-09-03 15:14:56 +00:00
public $query_vars = array ();
2013-06-04 16:33:43 +00:00
2016-02-10 10:19:32 +00:00
/**
2017-09-27 18:01:50 +00:00
* Stores chosen attributes .
*
2016-02-10 10:19:32 +00:00
* @ var array
*/
private static $_chosen_attributes ;
2012-08-14 19:42:38 +00:00
/**
2012-08-15 17:08:42 +00:00
* Constructor for the query class . Hooks in methods .
2012-08-14 19:42:38 +00:00
*/
2012-12-14 21:55:19 +00:00
public function __construct () {
2013-07-23 16:05:01 +00:00
add_action ( 'init' , array ( $this , 'add_endpoints' ) );
if ( ! is_admin () ) {
2015-01-05 14:43:01 +00:00
add_action ( 'wp_loaded' , array ( $this , 'get_errors' ), 20 );
2016-08-27 02:23:54 +00:00
add_filter ( 'query_vars' , array ( $this , 'add_query_vars' ), 0 );
add_action ( 'parse_request' , array ( $this , 'parse_request' ), 0 );
2014-06-30 10:41:21 +00:00
add_action ( 'pre_get_posts' , array ( $this , 'pre_get_posts' ) );
2013-10-21 12:05:34 +00:00
add_action ( 'wp' , array ( $this , 'remove_product_query' ) );
add_action ( 'wp' , array ( $this , 'remove_ordering_args' ) );
2013-07-23 16:05:01 +00:00
}
2013-09-03 15:14:56 +00:00
$this -> init_query_vars ();
}
2014-12-05 13:42:19 +00:00
/**
2015-11-03 13:31:20 +00:00
* Get any errors from querystring .
2014-12-05 13:42:19 +00:00
*/
public function get_errors () {
2017-11-09 11:50:50 +00:00
if ( ! empty ( $_GET [ 'wc_error' ] ) && ( $error = sanitize_text_field ( wp_unslash ( $_GET [ 'wc_error' ] ) ) ) && ! wc_has_notice ( $error , 'error' ) ) { // WPCS: sanitization ok, input var ok.
2014-12-05 13:42:19 +00:00
wc_add_notice ( $error , 'error' );
}
}
2013-09-03 15:14:56 +00:00
/**
* Init query vars by loading options .
*/
public function init_query_vars () {
2016-01-19 19:47:17 +00:00
// Query vars to add to WP.
2013-09-03 15:14:56 +00:00
$this -> query_vars = array (
2016-01-19 19:47:17 +00:00
// Checkout actions.
2013-11-01 17:08:22 +00:00
'order-pay' => get_option ( 'woocommerce_checkout_pay_endpoint' , 'order-pay' ),
'order-received' => get_option ( 'woocommerce_checkout_order_received_endpoint' , 'order-received' ),
2016-01-19 19:47:17 +00:00
// My account actions.
2016-02-09 20:19:34 +00:00
'orders' => get_option ( 'woocommerce_myaccount_orders_endpoint' , 'orders' ),
'view-order' => get_option ( 'woocommerce_myaccount_view_order_endpoint' , 'view-order' ),
'downloads' => get_option ( 'woocommerce_myaccount_downloads_endpoint' , 'downloads' ),
'edit-account' => get_option ( 'woocommerce_myaccount_edit_account_endpoint' , 'edit-account' ),
'edit-address' => get_option ( 'woocommerce_myaccount_edit_address_endpoint' , 'edit-address' ),
'payment-methods' => get_option ( 'woocommerce_myaccount_payment_methods_endpoint' , 'payment-methods' ),
'lost-password' => get_option ( 'woocommerce_myaccount_lost_password_endpoint' , 'lost-password' ),
'customer-logout' => get_option ( 'woocommerce_logout_endpoint' , 'customer-logout' ),
'add-payment-method' => get_option ( 'woocommerce_myaccount_add_payment_method_endpoint' , 'add-payment-method' ),
'delete-payment-method' => get_option ( 'woocommerce_myaccount_delete_payment_method_endpoint' , 'delete-payment-method' ),
'set-default-payment-method' => get_option ( 'woocommerce_myaccount_set_default_payment_method_endpoint' , 'set-default-payment-method' ),
2013-09-03 15:14:56 +00:00
);
2013-07-23 16:05:01 +00:00
}
2013-07-26 14:36:28 +00:00
/**
2015-11-03 13:31:20 +00:00
* Get page title for an endpoint .
2017-11-09 11:50:50 +00:00
*
* @ param string $endpoint Endpoint to get .
2014-12-05 13:42:19 +00:00
* @ return string
2013-07-26 14:36:28 +00:00
*/
2014-12-05 13:42:19 +00:00
public function get_endpoint_title ( $endpoint ) {
global $wp ;
switch ( $endpoint ) {
case 'order-pay' :
2016-10-12 10:16:30 +00:00
$title = __ ( 'Pay for order' , 'woocommerce' );
2014-12-05 13:42:19 +00:00
break ;
case 'order-received' :
2016-10-12 10:16:30 +00:00
$title = __ ( 'Order received' , 'woocommerce' );
2014-12-05 13:42:19 +00:00
break ;
2016-01-19 19:47:17 +00:00
case 'orders' :
2016-01-20 15:46:59 +00:00
if ( ! empty ( $wp -> query_vars [ 'orders' ] ) ) {
2016-10-29 17:32:38 +00:00
/* translators: %s: page */
2016-01-20 15:46:59 +00:00
$title = sprintf ( __ ( 'Orders (page %d)' , 'woocommerce' ), intval ( $wp -> query_vars [ 'orders' ] ) );
2016-01-19 21:02:26 +00:00
} else {
$title = __ ( 'Orders' , 'woocommerce' );
}
2016-01-19 19:47:17 +00:00
break ;
2014-12-05 13:42:19 +00:00
case 'view-order' :
$order = wc_get_order ( $wp -> query_vars [ 'view-order' ] );
2016-10-29 17:32:38 +00:00
/* translators: %s: order number */
2015-06-10 15:09:18 +00:00
$title = ( $order ) ? sprintf ( __ ( 'Order #%s' , 'woocommerce' ), $order -> get_order_number () ) : '' ;
2014-12-05 13:42:19 +00:00
break ;
2016-01-19 19:47:17 +00:00
case 'downloads' :
$title = __ ( 'Downloads' , 'woocommerce' );
break ;
2014-12-05 13:42:19 +00:00
case 'edit-account' :
2016-10-12 10:16:30 +00:00
$title = __ ( 'Account details' , 'woocommerce' );
2014-12-05 13:42:19 +00:00
break ;
case 'edit-address' :
2016-05-24 18:09:07 +00:00
$title = __ ( 'Addresses' , 'woocommerce' );
2014-12-05 13:42:19 +00:00
break ;
2016-01-20 20:13:17 +00:00
case 'payment-methods' :
2016-10-12 10:16:30 +00:00
$title = __ ( 'Payment methods' , 'woocommerce' );
2016-01-20 20:13:17 +00:00
break ;
2014-12-05 13:42:19 +00:00
case 'add-payment-method' :
2016-10-12 10:16:30 +00:00
$title = __ ( 'Add payment method' , 'woocommerce' );
2014-12-05 13:42:19 +00:00
break ;
case 'lost-password' :
2016-10-12 10:16:30 +00:00
$title = __ ( 'Lost password' , 'woocommerce' );
2014-12-05 13:42:19 +00:00
break ;
default :
2016-12-22 14:25:22 +00:00
$title = '' ;
2014-12-05 13:42:19 +00:00
break ;
}
2016-01-19 19:47:17 +00:00
2016-12-25 22:43:25 +00:00
return apply_filters ( 'woocommerce_endpoint_' . $endpoint . '_title' , $title , $endpoint );
2013-07-26 14:36:28 +00:00
}
2016-06-17 20:12:42 +00:00
/**
* Endpoint mask describing the places the endpoint should be added .
*
* @ since 2.6 . 2
* @ return int
*/
2017-02-15 14:30:23 +00:00
public function get_endpoints_mask () {
2016-06-17 20:12:42 +00:00
if ( 'page' === get_option ( 'show_on_front' ) ) {
$page_on_front = get_option ( 'page_on_front' );
$myaccount_page_id = get_option ( 'woocommerce_myaccount_page_id' );
$checkout_page_id = get_option ( 'woocommerce_checkout_page_id' );
2017-11-09 11:50:50 +00:00
if ( in_array ( $page_on_front , array ( $myaccount_page_id , $checkout_page_id ), true ) ) {
2016-06-17 20:12:42 +00:00
return EP_ROOT | EP_PAGES ;
}
}
return EP_PAGES ;
}
2013-07-23 16:05:01 +00:00
/**
2015-11-03 13:31:20 +00:00
* Add endpoints for query vars .
2013-07-23 16:05:01 +00:00
*/
public function add_endpoints () {
2016-06-17 20:12:42 +00:00
$mask = $this -> get_endpoints_mask ();
2014-12-05 13:42:19 +00:00
foreach ( $this -> query_vars as $key => $var ) {
2016-06-30 16:58:10 +00:00
if ( ! empty ( $var ) ) {
add_rewrite_endpoint ( $var , $mask );
}
2014-12-05 13:42:19 +00:00
}
2011-09-16 08:10:12 +00:00
}
2011-12-22 19:55:08 +00:00
2013-05-31 15:13:14 +00:00
/**
2016-01-06 15:17:26 +00:00
* Add query vars .
2013-05-31 15:13:14 +00:00
*
2017-11-09 11:50:50 +00:00
* @ param array $vars Vars to append .
2013-11-29 18:50:31 +00:00
* @ return array
2013-05-31 15:13:14 +00:00
*/
public function add_query_vars ( $vars ) {
2017-02-13 18:22:05 +00:00
foreach ( $this -> get_query_vars () as $key => $var ) {
2013-09-03 15:14:56 +00:00
$vars [] = $key ;
2014-12-05 13:42:19 +00:00
}
2013-05-31 15:13:14 +00:00
return $vars ;
}
2014-02-12 12:18:36 +00:00
/**
2015-11-03 13:31:20 +00:00
* Get query vars .
2014-09-02 19:50:19 +00:00
*
* @ return array
2014-02-12 12:18:36 +00:00
*/
public function get_query_vars () {
2017-02-13 18:22:05 +00:00
return apply_filters ( 'woocommerce_get_query_vars' , $this -> query_vars );
2014-02-12 12:18:36 +00:00
}
2014-12-05 13:42:19 +00:00
/**
2015-11-03 13:31:20 +00:00
* Get query current active query var .
2014-12-05 13:42:19 +00:00
*
* @ return string
*/
public function get_current_endpoint () {
global $wp ;
foreach ( $this -> get_query_vars () as $key => $value ) {
if ( isset ( $wp -> query_vars [ $key ] ) ) {
return $key ;
}
}
return '' ;
}
2013-05-31 15:13:14 +00:00
/**
2015-11-03 13:31:20 +00:00
* Parse the request and look for query vars - endpoints may not be supported .
2013-05-31 15:13:14 +00:00
*/
public function parse_request () {
global $wp ;
2017-02-13 18:22:05 +00:00
foreach ( $this -> get_query_vars () as $key => $var ) {
2017-11-09 11:50:50 +00:00
if ( isset ( $_GET [ $var ] ) ) { // WPCS: input var ok.
$wp -> query_vars [ $key ] = wc_clean ( wp_unslash ( $_GET [ $var ] ) ); // WPCS: sanitization ok, input var ok.
2016-09-02 03:15:49 +00:00
} elseif ( isset ( $wp -> query_vars [ $var ] ) ) {
2013-09-03 15:14:56 +00:00
$wp -> query_vars [ $key ] = $wp -> query_vars [ $var ];
}
}
2013-05-31 15:13:14 +00:00
}
2016-07-26 12:37:51 +00:00
/**
* Are we currently on the front page ?
2017-05-15 11:50:52 +00:00
*
2017-11-09 11:50:50 +00:00
* @ param object $q Query object .
2017-05-15 11:50:52 +00:00
* @ return bool
2016-07-26 12:37:51 +00:00
*/
private function is_showing_page_on_front ( $q ) {
return $q -> is_home () && 'page' === get_option ( 'show_on_front' );
}
/**
* Is the front page a page we define ?
2017-05-15 11:50:52 +00:00
*
2017-11-09 11:50:50 +00:00
* @ param int $page_id Page ID to check .
2017-05-15 11:50:52 +00:00
* @ return bool
2016-07-26 12:37:51 +00:00
*/
private function page_on_front_is ( $page_id ) {
return absint ( get_option ( 'page_on_front' ) ) === absint ( $page_id );
}
2011-09-16 08:10:12 +00:00
/**
2015-11-03 13:31:20 +00:00
* Hook into pre_get_posts to do the main product query .
2012-08-14 20:19:41 +00:00
*
2017-11-09 11:50:50 +00:00
* @ param object $q query object .
2011-09-16 08:10:12 +00:00
*/
2012-12-14 21:55:19 +00:00
public function pre_get_posts ( $q ) {
2017-11-09 11:17:02 +00:00
// We only want to affect the main query.
2014-06-25 10:10:05 +00:00
if ( ! $q -> is_main_query () ) {
2012-06-13 23:52:21 +00:00
return ;
2014-06-25 10:10:05 +00:00
}
2017-11-09 11:17:02 +00:00
// Fix for endpoints on the homepage.
2016-07-26 12:37:51 +00:00
if ( $this -> is_showing_page_on_front ( $q ) && ! $this -> page_on_front_is ( $q -> get ( 'page_id' ) ) ) {
2014-06-25 10:10:05 +00:00
$_query = wp_parse_args ( $q -> query );
if ( ! empty ( $_query ) && array_intersect ( array_keys ( $_query ), array_keys ( $this -> query_vars ) ) ) {
$q -> is_page = true ;
$q -> is_home = false ;
$q -> is_singular = true ;
2016-01-13 11:01:08 +00:00
$q -> set ( 'page_id' , ( int ) get_option ( 'page_on_front' ) );
add_filter ( 'redirect_canonical' , '__return_false' );
2014-06-25 10:10:05 +00:00
}
}
2014-08-29 09:26:21 +00:00
2013-03-04 22:49:17 +00:00
// When orderby is set, WordPress shows posts. Get around that here.
2016-07-26 12:37:51 +00:00
if ( $this -> is_showing_page_on_front ( $q ) && $this -> page_on_front_is ( wc_get_page_id ( 'shop' ) ) ) {
2013-03-04 22:49:17 +00:00
$_query = wp_parse_args ( $q -> query );
if ( empty ( $_query ) || ! array_diff ( array_keys ( $_query ), array ( 'preview' , 'page' , 'paged' , 'cpage' , 'orderby' ) ) ) {
$q -> is_page = true ;
$q -> is_home = false ;
2016-01-13 11:01:08 +00:00
$q -> set ( 'page_id' , ( int ) get_option ( 'page_on_front' ) );
2013-03-04 22:49:17 +00:00
$q -> set ( 'post_type' , 'product' );
}
}
2017-11-09 11:50:50 +00:00
// Fix product feeds.
2016-06-21 11:46:39 +00:00
if ( $q -> is_feed () && $q -> is_post_type_archive ( 'product' ) ) {
$q -> is_comment_feed = false ;
}
2017-11-09 11:17:02 +00:00
// Special check for shops with the product archive on front.
2016-07-29 21:46:39 +00:00
if ( $q -> is_page () && 'page' === get_option ( 'show_on_front' ) && absint ( $q -> get ( 'page_id' ) ) === wc_get_page_id ( 'shop' ) ) {
2017-11-09 11:50:50 +00:00
// This is a front-page shop.
2012-06-13 23:52:21 +00:00
$q -> set ( 'post_type' , 'product' );
$q -> set ( 'page_id' , '' );
2015-12-10 10:42:54 +00:00
2014-07-03 14:14:00 +00:00
if ( isset ( $q -> query [ 'paged' ] ) ) {
2012-06-13 23:52:21 +00:00
$q -> set ( 'paged' , $q -> query [ 'paged' ] );
2014-07-03 14:14:00 +00:00
}
2012-08-02 21:54:26 +00:00
2017-11-09 11:17:02 +00:00
// Define a variable so we know this is the front page shop later on.
2017-09-05 19:52:39 +00:00
wc_maybe_define_constant ( 'SHOP_IS_ON_FRONT' , true );
2012-08-02 21:54:26 +00:00
2017-11-09 11:17:02 +00:00
// Get the actual WP page to avoid errors and let us use is_front_page(). This is hacky but works. Awaiting https://core.trac.wordpress.org/ticket/21096.
2012-06-29 09:23:21 +00:00
global $wp_post_types ;
2012-11-27 16:22:47 +00:00
2015-12-10 10:42:54 +00:00
$shop_page = get_post ( wc_get_page_id ( 'shop' ) );
2012-08-02 21:54:26 +00:00
2012-06-29 09:23:21 +00:00
$wp_post_types [ 'product' ] -> ID = $shop_page -> ID ;
$wp_post_types [ 'product' ] -> post_title = $shop_page -> post_title ;
$wp_post_types [ 'product' ] -> post_name = $shop_page -> post_name ;
2014-05-21 13:30:51 +00:00
$wp_post_types [ 'product' ] -> post_type = $shop_page -> post_type ;
$wp_post_types [ 'product' ] -> ancestors = get_ancestors ( $shop_page -> ID , $shop_page -> post_type );
2012-08-02 21:54:26 +00:00
2017-11-09 11:17:02 +00:00
// Fix conditional Functions like is_front_page.
2014-07-03 14:14:00 +00:00
$q -> is_singular = false ;
2013-01-02 20:11:17 +00:00
$q -> is_post_type_archive = true ;
2014-07-03 14:14:00 +00:00
$q -> is_archive = true ;
$q -> is_page = true ;
2012-11-27 16:22:47 +00:00
2017-11-09 11:17:02 +00:00
// Remove post type archive name from front page title tag.
2015-12-10 10:42:54 +00:00
add_filter ( 'post_type_archive_title' , '__return_empty_string' , 5 );
2017-11-09 11:17:02 +00:00
// Fix WP SEO.
2014-05-07 10:40:21 +00:00
if ( class_exists ( 'WPSEO_Meta' ) ) {
2013-01-02 20:11:17 +00:00
add_filter ( 'wpseo_metadesc' , array ( $this , 'wpseo_metadesc' ) );
add_filter ( 'wpseo_metakey' , array ( $this , 'wpseo_metakey' ) );
}
2014-06-25 10:10:05 +00:00
} elseif ( ! $q -> is_post_type_archive ( 'product' ) && ! $q -> is_tax ( get_object_taxonomies ( 'product' ) ) ) {
return ;
2012-06-13 23:52:21 +00:00
}
2012-08-02 21:54:26 +00:00
2013-01-02 20:11:17 +00:00
$this -> product_query ( $q );
$this -> remove_product_query ();
2011-12-22 19:55:08 +00:00
}
2012-11-27 16:22:47 +00:00
2012-08-22 19:44:27 +00:00
/**
2016-01-06 15:17:26 +00:00
* WP SEO meta description .
*
2015-11-03 13:31:20 +00:00
* Hooked into wpseo_ hook already , so no need for function_exist .
2012-11-27 16:22:47 +00:00
*
2012-08-22 19:44:27 +00:00
* @ access public
2013-11-29 18:50:31 +00:00
* @ return string
2012-08-22 19:44:27 +00:00
*/
2012-12-14 21:55:19 +00:00
public function wpseo_metadesc () {
2016-02-09 21:14:55 +00:00
return WPSEO_Meta :: get_value ( 'metadesc' , wc_get_page_id ( 'shop' ) );
2012-08-22 19:44:27 +00:00
}
2012-11-27 16:22:47 +00:00
2012-08-22 19:44:27 +00:00
/**
2016-01-06 15:17:26 +00:00
* WP SEO meta key .
*
2015-11-03 13:31:20 +00:00
* Hooked into wpseo_ hook already , so no need for function_exist .
2012-11-27 16:22:47 +00:00
*
2012-08-22 19:44:27 +00:00
* @ access public
2013-11-29 18:50:31 +00:00
* @ return string
2012-08-22 19:44:27 +00:00
*/
2012-12-14 21:55:19 +00:00
public function wpseo_metakey () {
2016-02-09 21:14:55 +00:00
return WPSEO_Meta :: get_value ( 'metakey' , wc_get_page_id ( 'shop' ) );
2012-03-26 14:34:23 +00:00
}
2012-08-02 21:54:26 +00:00
2011-12-22 19:55:08 +00:00
/**
2015-11-03 13:31:20 +00:00
* Query the products , applying sorting / ordering etc . This applies to the main wordpress loop .
2012-08-14 20:19:41 +00:00
*
2017-11-09 11:50:50 +00:00
* @ param mixed $q Query object .
2011-12-22 19:55:08 +00:00
*/
2012-12-14 21:55:19 +00:00
public function product_query ( $q ) {
2017-09-25 12:08:08 +00:00
if ( ! is_feed () ) {
$ordering = $this -> get_catalog_ordering_args ();
$q -> set ( 'orderby' , $ordering [ 'orderby' ] );
$q -> set ( 'order' , $ordering [ 'order' ] );
if ( isset ( $ordering [ 'meta_key' ] ) ) {
$q -> set ( 'meta_key' , $ordering [ 'meta_key' ] );
}
2014-12-09 08:33:29 +00:00
}
2012-08-02 21:54:26 +00:00
2017-11-09 11:17:02 +00:00
// Query vars that affect posts shown.
2016-12-08 10:56:45 +00:00
$q -> set ( 'meta_query' , $this -> get_meta_query ( $q -> get ( 'meta_query' ), true ) );
$q -> set ( 'tax_query' , $this -> get_tax_query ( $q -> get ( 'tax_query' ), true ) );
2013-01-02 20:11:17 +00:00
$q -> set ( 'posts_per_page' , $q -> get ( 'posts_per_page' ) ? $q -> get ( 'posts_per_page' ) : apply_filters ( 'loop_shop_per_page' , get_option ( 'posts_per_page' ) ) );
2015-03-13 10:33:36 +00:00
$q -> set ( 'wc_query' , 'product_query' );
2016-10-24 06:51:48 +00:00
$q -> set ( 'post__in' , array_unique ( ( array ) apply_filters ( 'loop_shop_post_in' , array () ) ) );
2012-08-02 21:54:26 +00:00
2013-01-02 20:11:17 +00:00
do_action ( 'woocommerce_product_query' , $q , $this );
2011-09-16 08:10:12 +00:00
}
2011-12-22 19:55:08 +00:00
2012-08-14 20:19:41 +00:00
2011-09-16 08:10:12 +00:00
/**
2015-11-03 13:31:20 +00:00
* Remove the query .
2011-09-16 08:10:12 +00:00
*/
2012-12-14 21:55:19 +00:00
public function remove_product_query () {
2014-06-30 10:41:21 +00:00
remove_action ( 'pre_get_posts' , array ( $this , 'pre_get_posts' ) );
2011-09-16 08:10:12 +00:00
}
2012-08-02 21:54:26 +00:00
2013-10-21 12:05:34 +00:00
/**
2015-11-03 13:31:20 +00:00
* Remove ordering queries .
2013-10-21 12:05:34 +00:00
*/
public function remove_ordering_args () {
2017-04-24 17:11:16 +00:00
remove_filter ( 'posts_clauses' , array ( $this , 'order_by_price_asc_post_clauses' ) );
remove_filter ( 'posts_clauses' , array ( $this , 'order_by_price_desc_post_clauses' ) );
2013-10-21 12:05:34 +00:00
remove_filter ( 'posts_clauses' , array ( $this , 'order_by_popularity_post_clauses' ) );
remove_filter ( 'posts_clauses' , array ( $this , 'order_by_rating_post_clauses' ) );
}
2011-09-23 11:04:51 +00:00
/**
2015-11-03 13:31:20 +00:00
* Returns an array of arguments for ordering products based on the selected values .
2012-08-14 20:19:41 +00:00
*
2017-11-09 11:50:50 +00:00
* @ param string $orderby Order by param .
* @ param string $order Order param .
2012-08-14 20:19:41 +00:00
* @ return array
2011-09-23 11:04:51 +00:00
*/
2012-12-18 06:57:44 +00:00
public function get_catalog_ordering_args ( $orderby = '' , $order = '' ) {
2017-11-09 11:50:50 +00:00
// Get ordering from query string unless defined.
2013-01-12 10:53:08 +00:00
if ( ! $orderby ) {
2017-11-09 11:50:50 +00:00
$orderby_value = isset ( $_GET [ 'orderby' ] ) ? wc_clean ( ( string ) wp_unslash ( $_GET [ 'orderby' ] ) ) : apply_filters ( 'woocommerce_default_catalog_orderby' , get_option ( 'woocommerce_default_catalog_orderby' ) ); // WPCS: sanitization ok, input var ok.
2013-01-12 10:53:08 +00:00
2017-11-09 11:50:50 +00:00
// Get order + orderby args from string.
2013-01-12 10:53:08 +00:00
$orderby_value = explode ( '-' , $orderby_value );
$orderby = esc_attr ( $orderby_value [ 0 ] );
$order = ! empty ( $orderby_value [ 1 ] ) ? $orderby_value [ 1 ] : $order ;
}
2012-08-02 21:54:26 +00:00
2013-03-22 17:06:06 +00:00
$orderby = strtolower ( $orderby );
$order = strtoupper ( $order );
2017-08-30 22:30:46 +00:00
$args = array (
'orderby' => 'relevance' ,
'order' => 'DESC' ,
2017-11-09 11:50:50 +00:00
'meta_key' => '' , // @codingStandardsIgnoreLine
2017-08-30 22:30:46 +00:00
);
2012-12-18 06:57:44 +00:00
2017-08-24 11:58:50 +00:00
// Set to default. Menu order for non-searches, relevance for searches.
if ( ! is_search () ) {
$args [ 'orderby' ] = 'menu_order title' ;
$args [ 'order' ] = ( 'DESC' === $order ) ? 'DESC' : 'ASC' ;
2017-11-09 11:50:50 +00:00
$args [ 'meta_key' ] = '' ; // @codingStandardsIgnoreLine
2017-08-24 11:58:50 +00:00
}
2013-07-17 10:21:48 +00:00
2012-12-18 06:57:44 +00:00
switch ( $orderby ) {
2013-12-05 12:53:22 +00:00
case 'rand' :
2017-11-09 11:50:50 +00:00
// @codingStandardsIgnoreStart
2013-12-05 12:53:22 +00:00
$args [ 'orderby' ] = 'rand' ;
2017-11-09 11:50:50 +00:00
// @codingStandardsIgnoreEnd
2016-09-07 22:32:24 +00:00
break ;
2011-09-23 11:04:51 +00:00
case 'date' :
2016-03-08 12:54:07 +00:00
$args [ 'orderby' ] = 'date ID' ;
2016-09-07 22:32:24 +00:00
$args [ 'order' ] = ( 'ASC' === $order ) ? 'ASC' : 'DESC' ;
break ;
2011-09-23 11:04:51 +00:00
case 'price' :
2017-04-24 17:11:16 +00:00
if ( 'DESC' === $order ) {
add_filter ( 'posts_clauses' , array ( $this , 'order_by_price_desc_post_clauses' ) );
} else {
add_filter ( 'posts_clauses' , array ( $this , 'order_by_price_asc_post_clauses' ) );
}
2016-09-07 22:32:24 +00:00
break ;
2013-01-12 10:53:08 +00:00
case 'popularity' :
2017-11-09 11:50:50 +00:00
$args [ 'meta_key' ] = 'total_sales' ; // @codingStandardsIgnoreLine
2013-07-17 10:21:48 +00:00
2017-11-09 11:50:50 +00:00
// Sorting handled later though a hook.
2013-07-17 10:21:48 +00:00
add_filter ( 'posts_clauses' , array ( $this , 'order_by_popularity_post_clauses' ) );
2016-09-07 22:32:24 +00:00
break ;
2013-01-12 10:53:08 +00:00
case 'rating' :
2017-11-09 11:50:50 +00:00
$args [ 'meta_key' ] = '_wc_average_rating' ; // @codingStandardsIgnoreLine
2016-08-18 10:33:19 +00:00
$args [ 'orderby' ] = array (
'meta_value_num' => 'DESC' ,
'ID' => 'ASC' ,
);
2016-09-07 22:32:24 +00:00
break ;
2013-03-22 17:06:06 +00:00
case 'title' :
2016-09-07 22:32:24 +00:00
$args [ 'orderby' ] = 'title' ;
$args [ 'order' ] = ( 'DESC' === $order ) ? 'DESC' : 'ASC' ;
break ;
2017-08-24 11:58:50 +00:00
case 'relevance' :
$args [ 'orderby' ] = 'relevance' ;
$args [ 'order' ] = 'DESC' ;
break ;
2012-06-13 23:52:21 +00:00
}
2012-08-02 21:54:26 +00:00
2012-12-18 06:57:44 +00:00
return apply_filters ( 'woocommerce_get_catalog_ordering_args' , $args );
2011-09-23 11:04:51 +00:00
}
2012-08-02 21:54:26 +00:00
2017-04-24 17:11:16 +00:00
/**
* Handle numeric price sorting .
*
2017-11-09 11:50:50 +00:00
* @ param array $args Array of args to append to .
2017-04-24 17:11:16 +00:00
* @ return array
*/
public function order_by_price_asc_post_clauses ( $args ) {
global $wpdb ;
2017-04-25 11:11:28 +00:00
$args [ 'join' ] .= " INNER JOIN ( SELECT post_id, min( meta_value+0 ) price FROM $wpdb->postmeta WHERE meta_key='_price' GROUP BY post_id ) as price_query ON $wpdb->posts .ID = price_query.post_id " ;
2017-11-09 11:50:50 +00:00
$args [ 'orderby' ] = ' price_query.price ASC ' ;
2017-04-24 17:11:16 +00:00
return $args ;
}
/**
* Handle numeric price sorting .
*
2017-11-09 11:50:50 +00:00
* @ param array $args Array of args to append to .
2017-04-24 17:11:16 +00:00
* @ return array
*/
public function order_by_price_desc_post_clauses ( $args ) {
2017-09-04 11:57:28 +00:00
global $wpdb , $wp_query ;
if ( isset ( $wp_query -> queried_object , $wp_query -> queried_object -> term_taxonomy_id , $wp_query -> queried_object -> taxonomy ) && is_a ( $wp_query -> queried_object , 'WP_Term' ) ) {
$search_within_terms = get_term_children ( $wp_query -> queried_object -> term_taxonomy_id , $wp_query -> queried_object -> taxonomy );
$search_within_terms [] = $wp_query -> queried_object -> term_taxonomy_id ;
$args [ 'join' ] .= " INNER JOIN (
SELECT post_id , max ( meta_value + 0 ) price
FROM $wpdb -> postmeta
INNER JOIN (
SELECT $wpdb -> term_relationships . object_id
FROM $wpdb -> term_relationships
WHERE 1 = 1
AND $wpdb -> term_relationships . term_taxonomy_id IN ( " . implode( ',', array_map( 'absint', $search_within_terms ) ) . " )
) as products_within_terms ON $wpdb -> postmeta . post_id = products_within_terms . object_id
WHERE meta_key = '_price' GROUP BY post_id ) as price_query ON $wpdb -> posts . ID = price_query . post_id " ;
} else {
$args [ 'join' ] .= " INNER JOIN ( SELECT post_id, max( meta_value+0 ) price FROM $wpdb->postmeta WHERE meta_key='_price' GROUP BY post_id ) as price_query ON $wpdb->posts .ID = price_query.post_id " ;
}
2017-11-09 11:50:50 +00:00
$args [ 'orderby' ] = ' price_query.price DESC ' ;
2017-09-04 11:57:28 +00:00
2017-04-24 17:11:16 +00:00
return $args ;
}
2013-07-17 10:21:48 +00:00
/**
2017-07-17 10:10:52 +00:00
* WP Core doens ' t let us change the sort direction for individual orderby params - https :// core . trac . wordpress . org / ticket / 17065.
2013-07-17 10:21:48 +00:00
*
* This lets us sort by meta value desc , and have a second orderby param .
*
2017-11-09 11:50:50 +00:00
* @ param array $args Array of args to append to .
2013-07-17 10:21:48 +00:00
* @ return array
*/
public function order_by_popularity_post_clauses ( $args ) {
global $wpdb ;
$args [ 'orderby' ] = " $wpdb->postmeta .meta_value+0 DESC, $wpdb->posts .post_date DESC " ;
return $args ;
}
2013-04-17 15:29:43 +00:00
/**
* Appends meta queries to an array .
2016-07-11 13:48:47 +00:00
*
2017-11-09 11:50:50 +00:00
* @ param array $meta_query Existing meta query .
* @ param bool $main_query Is this the main query .
2013-10-04 16:48:50 +00:00
* @ return array
2013-04-17 15:29:43 +00:00
*/
2016-12-08 10:56:45 +00:00
public function get_meta_query ( $meta_query = array (), $main_query = false ) {
2016-02-09 21:14:55 +00:00
if ( ! is_array ( $meta_query ) ) {
2013-04-17 15:29:43 +00:00
$meta_query = array ();
2016-02-09 21:14:55 +00:00
}
2016-07-11 13:48:47 +00:00
$meta_query [ 'price_filter' ] = $this -> price_filter_meta_query ();
2016-02-09 21:14:55 +00:00
return array_filter ( apply_filters ( 'woocommerce_product_query_meta_query' , $meta_query , $this ) );
}
2016-12-09 15:43:25 +00:00
/**
* Appends tax queries to an array .
2017-11-09 11:50:50 +00:00
*
* @ param array $tax_query Existing tax query .
* @ param bool $main_query Is this the main query .
2016-12-09 15:43:25 +00:00
* @ return array
*/
public function get_tax_query ( $tax_query = array (), $main_query = false ) {
if ( ! is_array ( $tax_query ) ) {
$tax_query = array ( 'relation' => 'AND' );
}
// Layered nav filters on terms.
if ( $main_query && ( $_chosen_attributes = $this -> get_layered_nav_chosen_attributes () ) ) {
foreach ( $_chosen_attributes as $taxonomy => $data ) {
$tax_query [] = array (
'taxonomy' => $taxonomy ,
'field' => 'slug' ,
'terms' => $data [ 'terms' ],
'operator' => 'and' === $data [ 'query_type' ] ? 'AND' : 'IN' ,
'include_children' => false ,
);
}
}
2017-03-27 16:32:00 +00:00
$product_visibility_terms = wc_get_product_visibility_term_ids ();
2016-12-09 17:04:44 +00:00
$product_visibility_not_in = array ( is_search () && $main_query ? $product_visibility_terms [ 'exclude-from-search' ] : $product_visibility_terms [ 'exclude-from-catalog' ] );
2016-12-09 15:43:25 +00:00
// Hide out of stock products.
if ( 'yes' === get_option ( 'woocommerce_hide_out_of_stock_items' ) ) {
2016-12-09 17:04:44 +00:00
$product_visibility_not_in [] = $product_visibility_terms [ 'outofstock' ];
2016-12-09 15:43:25 +00:00
}
// Filter by rating.
2017-11-09 11:50:50 +00:00
if ( isset ( $_GET [ 'rating_filter' ] ) ) { // WPCS: input var ok.
$rating_filter = array_filter ( array_map ( 'absint' , explode ( ',' , wp_unslash ( $_GET [ 'rating_filter' ] ) ) ) ); // WPCS: sanitization ok, input var ok.
2016-12-09 17:04:44 +00:00
$rating_terms = array ();
2016-12-09 15:43:25 +00:00
for ( $i = 1 ; $i <= 5 ; $i ++ ) {
2017-11-09 11:50:50 +00:00
if ( in_array ( $i , $rating_filter , true ) && isset ( $product_visibility_terms [ 'rated-' . $i ] ) ) {
2016-12-09 17:04:44 +00:00
$rating_terms [] = $product_visibility_terms [ 'rated-' . $i ];
2016-12-09 15:43:25 +00:00
}
}
if ( ! empty ( $rating_terms ) ) {
$tax_query [] = array (
'taxonomy' => 'product_visibility' ,
'field' => 'term_taxonomy_id' ,
'terms' => $rating_terms ,
'operator' => 'IN' ,
'rating_filter' => true ,
);
}
}
if ( ! empty ( $product_visibility_not_in ) ) {
$tax_query [] = array (
'taxonomy' => 'product_visibility' ,
'field' => 'term_taxonomy_id' ,
'terms' => $product_visibility_not_in ,
'operator' => 'NOT IN' ,
);
}
return array_filter ( apply_filters ( 'woocommerce_product_query_tax_query' , $tax_query , $this ) );
}
2016-02-09 21:14:55 +00:00
/**
* Return a meta query for filtering by price .
2017-11-09 11:50:50 +00:00
*
2016-02-09 21:14:55 +00:00
* @ return array
*/
private function price_filter_meta_query () {
2017-11-09 11:50:50 +00:00
if ( isset ( $_GET [ 'max_price' ] ) || isset ( $_GET [ 'min_price' ] ) ) { // WPCS: input var ok.
$meta_query = wc_get_min_max_price_meta_query ( $_GET ); // WPCS: input var ok.
2016-10-11 18:36:53 +00:00
$meta_query [ 'price_filter' ] = true ;
2013-04-17 15:29:43 +00:00
2016-10-11 18:36:53 +00:00
return $meta_query ;
2016-02-09 21:14:55 +00:00
}
2016-10-11 18:36:53 +00:00
2016-02-09 21:14:55 +00:00
return array ();
}
2016-02-10 10:02:50 +00:00
/**
* Get the tax query which was used by the main query .
2017-11-09 11:50:50 +00:00
*
2016-02-10 10:02:50 +00:00
* @ return array
*/
public static function get_main_tax_query () {
global $wp_the_query ;
2016-11-21 11:50:40 +00:00
$tax_query = isset ( $wp_the_query -> tax_query , $wp_the_query -> tax_query -> queries ) ? $wp_the_query -> tax_query -> queries : array ();
2016-02-10 10:02:50 +00:00
return $tax_query ;
}
/**
* Get the meta query which was used by the main query .
2017-11-09 11:50:50 +00:00
*
2016-02-10 10:02:50 +00:00
* @ return array
*/
public static function get_main_meta_query () {
global $wp_the_query ;
$args = $wp_the_query -> query_vars ;
$meta_query = isset ( $args [ 'meta_query' ] ) ? $args [ 'meta_query' ] : array ();
return $meta_query ;
}
2016-07-19 13:09:31 +00:00
/**
* Based on WP_Query :: parse_search
*/
public static function get_main_search_query_sql () {
global $wp_the_query , $wpdb ;
$args = $wp_the_query -> query_vars ;
$search_terms = isset ( $args [ 'search_terms' ] ) ? $args [ 'search_terms' ] : array ();
$sql = array ();
foreach ( $search_terms as $term ) {
// Terms prefixed with '-' should be excluded.
$include = '-' !== substr ( $term , 0 , 1 );
if ( $include ) {
$like_op = 'LIKE' ;
$andor_op = 'OR' ;
} else {
$like_op = 'NOT LIKE' ;
$andor_op = 'AND' ;
$term = substr ( $term , 1 );
}
$like = '%' . $wpdb -> esc_like ( $term ) . '%' ;
2017-11-09 11:50:50 +00:00
$sql [] = $wpdb -> prepare ( " (( $wpdb->posts .post_title $like_op %s) $andor_op ( $wpdb->posts .post_excerpt $like_op %s) $andor_op ( $wpdb->posts .post_content $like_op %s)) " , $like , $like , $like ); // unprepared SQL ok.
2016-07-19 13:09:31 +00:00
}
if ( ! empty ( $sql ) && ! is_user_logged_in () ) {
$sql [] = " ( $wpdb->posts .post_password = '') " ;
}
return implode ( ' AND ' , $sql );
}
2013-08-09 16:11:15 +00:00
/**
2015-11-03 13:31:20 +00:00
* Layered Nav Init .
2013-08-09 16:11:15 +00:00
*/
2016-02-10 10:19:32 +00:00
public static function get_layered_nav_chosen_attributes () {
if ( ! is_array ( self :: $_chosen_attributes ) ) {
self :: $_chosen_attributes = array ();
if ( $attribute_taxonomies = wc_get_attribute_taxonomies () ) {
foreach ( $attribute_taxonomies as $tax ) {
$attribute = wc_sanitize_taxonomy_name ( $tax -> attribute_name );
$taxonomy = wc_attribute_taxonomy_name ( $attribute );
2017-11-09 11:50:50 +00:00
$filter_terms = ! empty ( $_GET [ 'filter_' . $attribute ] ) ? explode ( ',' , wc_clean ( wp_unslash ( $_GET [ 'filter_' . $attribute ] ) ) ) : array (); // WPCS: sanitization ok, input var ok.
2016-02-10 10:19:32 +00:00
if ( empty ( $filter_terms ) || ! taxonomy_exists ( $taxonomy ) ) {
continue ;
}
2013-08-09 16:11:15 +00:00
2017-11-09 11:50:50 +00:00
$query_type = ! empty ( $_GET [ 'query_type_' . $attribute ] ) && in_array ( $_GET [ 'query_type_' . $attribute ], array ( 'and' , 'or' ), true ) ? wc_clean ( wp_unslash ( $_GET [ 'query_type_' . $attribute ] ) ) : '' ; // WPCS: sanitization ok, input var ok.
self :: $_chosen_attributes [ $taxonomy ][ 'terms' ] = array_map ( 'sanitize_title' , $filter_terms ); // Ensures correct encoding.
2016-02-10 10:19:32 +00:00
self :: $_chosen_attributes [ $taxonomy ][ 'query_type' ] = $query_type ? $query_type : apply_filters ( 'woocommerce_layered_nav_default_query_type' , 'and' );
2013-08-09 16:11:15 +00:00
}
2015-06-09 13:58:27 +00:00
}
}
2016-02-10 10:19:32 +00:00
return self :: $_chosen_attributes ;
2013-08-09 16:11:15 +00:00
}
2017-11-09 11:50:50 +00:00
// @codingStandardsIgnoreStart
/**
* Order by rating post clauses .
*
* @ deprecated 3.0 . 0
* @ param array $args
* @ return array
*/
public function order_by_rating_post_clauses ( $args ) {
global $wpdb ;
wc_deprecated_function ( 'order_by_rating_post_clauses' , '3.0' );
$args [ 'fields' ] .= " , AVG( $wpdb->commentmeta .meta_value ) as average_rating " ;
$args [ 'where' ] .= " AND ( $wpdb->commentmeta .meta_key = 'rating' OR $wpdb->commentmeta .meta_key IS null ) " ;
$args [ 'join' ] .= "
LEFT OUTER JOIN $wpdb -> comments ON ( $wpdb -> posts . ID = $wpdb -> comments . comment_post_ID )
LEFT JOIN $wpdb -> commentmeta ON ( $wpdb -> comments . comment_ID = $wpdb -> commentmeta . comment_id )
" ;
$args [ 'orderby' ] = " average_rating DESC, $wpdb->posts .post_date DESC " ;
$args [ 'groupby' ] = " $wpdb->posts .ID " ;
return $args ;
}
/**
* Return a meta query for filtering by rating .
*
* @ deprecated 3.0 . 0 Replaced with taxonomy .
* @ return array
*/
public function rating_filter_meta_query () {
return array ();
}
/**
* Returns a meta query to handle product visibility .
*
* @ deprecated 3.0 . 0 Replaced with taxonomy .
* @ param string $compare ( default : 'IN' )
* @ return array
*/
public function visibility_meta_query ( $compare = 'IN' ) {
return array ();
}
/**
* Returns a meta query to handle product stock status .
*
* @ deprecated 3.0 . 0 Replaced with taxonomy .
* @ param string $status ( default : 'instock' )
* @ return array
*/
public function stock_status_meta_query ( $status = 'instock' ) {
return array ();
}
2016-02-10 10:19:32 +00:00
/**
* @ deprecated 2.6 . 0
*/
2016-02-11 11:13:48 +00:00
public function layered_nav_init () {
2016-11-23 16:15:00 +00:00
wc_deprecated_function ( 'layered_nav_init' , '2.6' );
2016-02-11 11:13:48 +00:00
}
2016-02-10 10:19:32 +00:00
2015-11-13 09:41:44 +00:00
/**
2017-03-20 15:47:51 +00:00
* Get an unpaginated list all product IDs ( both filtered and unfiltered ) . Makes use of transients .
2016-02-09 21:14:55 +00:00
* @ deprecated 2.6 . 0 due to performance concerns
2015-11-13 09:41:44 +00:00
*/
2016-02-09 21:14:55 +00:00
public function get_products_in_view () {
2016-11-23 16:15:00 +00:00
wc_deprecated_function ( 'get_products_in_view' , '2.6' );
2015-11-13 09:41:44 +00:00
}
/**
2016-02-09 21:14:55 +00:00
* Layered Nav post filter .
* @ deprecated 2.6 . 0 due to performance concerns
2017-05-15 11:50:52 +00:00
*
* @ param $filtered_posts
2015-11-13 09:41:44 +00:00
*/
2016-02-09 21:14:55 +00:00
public function layered_nav_query ( $filtered_posts ) {
2016-11-23 16:15:00 +00:00
wc_deprecated_function ( 'layered_nav_query' , '2.6' );
2016-02-09 15:18:27 +00:00
}
2017-11-09 11:50:50 +00:00
/**
* Search post excerpt .
*
* @ deprecated 3.2 . 0 - Not needed anymore since WordPress 4.5 .
*/
public function search_post_excerpt ( $where = '' ) {
wc_deprecated_function ( 'WC_Query::search_post_excerpt' , '3.2.0' , 'Excerpt added to search query by default since WordPress 4.5.' );
return $where ;
}
/**
* Remove the posts_where filter .
* @ deprecated 3.2 . 0 - Nothing to remove anymore because search_post_excerpt () is deprecated .
*/
public function remove_posts_where () {
wc_deprecated_function ( 'WC_Query::remove_posts_where' , '3.2.0' , 'Nothing to remove anymore because search_post_excerpt() is deprecated.' );
}
// @codingStandardsIgnoreEnd
2013-07-23 16:05:01 +00:00
}