woocommerce_catalog_orderby │ filter-hook │ WC 9.7.0

Allows you to change product sorting options on shop pages.

Usage

add_filter( 'woocommerce_catalog_orderby', 'wp_kama_woocommerce_catalog_orderby_filter' );

/**
 * Function for `woocommerce_catalog_orderby` filter-hook.
 * 
 * @param array $catalog_orderby_options Array of catalog orderby options.
 *
 * @return array
 */
function wp_kama_woocommerce_catalog_orderby_filter( $catalog_orderby_options ){
	// filter...
	return $catalog_orderby_options;
}

$array(array) (required)

An array of sorting options. Default sorting options:

array(
	'menu_order' => __( 'Default sorting', 'woocommerce' ),
	'popularity' => __( 'Sort by popularity', 'woocommerce' ),
	'rating'     => __( 'Sort by average rating', 'woocommerce' ),
	'date'       => __( 'Sort by latest', 'woocommerce' ),
	'price'      => __( 'Sort by price: low to high', 'woocommerce' ),
	'price-desc' => __( 'Sort by price: high to low', 'woocommerce' ),
)

Examples

#1 Remove sorting by date

add_filter( 'woocommerce_catalog_orderby', 'remove_default_sort_by_date' );

function remove_default_sort_by_date( $array ){
	unset( $array['date'] );

	return $array;
}

#2 Add a custom sorting option

add_filter( 'woocommerce_catalog_orderby', 'add_sorting_by_random' );

function add_sorting_by_random( $array ){
	$array['random'] = __( 'Random', 'woocommerce' );

	return $array;
}