The Ultimate List of WooCommerce Code Snippets

Times flies… It’s been 6 months since I started to work for WooThemes as a WooCommerce full time support technician. During these 6 months I learnt a lot on WooCommerce and I coded a lot of WooCommerce related snippets.

WooCommerce is really powerful tool and easily expandable. It has many hooks that can be used for nearly everything, and that’s what make WooCommerce so good. Here is a list of snippets I wrote or adapted during the past months.

The following snippets can be copied and pasted into your theme’s functions.php folder (a child theme if working with a 3rd party theme) or via a code snippet plugin.

I’ve gone ahead and numbered all the snippets so if you have any issues with a specific one you can let me know in the comments section! WooCommerce does make frequent updates and it’s possible some of these snippets may need updating in the future.

Also here is a table of contents if you want to quickly jump to view a specific snippet:

1. Declare WooCommerce Support

This snippet can be added to your theme to let WooCommerce know it’s compatible.

add_action( 'after_setup_theme', function() {
    add_theme_support( 'woocommerce' );
} );

2. Remove All WooCommerce CSS

This snippet will remove all the WooCommerce stylesheets so you have full control over the design.

add_filter( 'woocommerce_enqueue_styles', '__return_empty_array' );

3. Remove Specific WooCommerce Styles

This snippet will remove specific WooCommerce stylesheets:

function wpexplorer_wc_remove_styles( $styles ) {
    unset( $styles['woocommerce-general'] );
    unset( $styles['woocommerce-layout'] );
    unset( $styles['woocommerce-smallscreen'] );
    return $styles;
}
add_filter( 'woocommerce_enqueue_styles', 'wpexplorer_wc_remove_styles' );

4. Enable Product Gallery Slider, Zoom & Lightbox

This snippet will enable support for the product gallery slider, zoom and lightbox.

add_action( 'after_setup_theme', function() {
    add_theme_support( 'wc-product-gallery-slider' );
    add_theme_support( 'wc-product-gallery-zoom' );
    add_theme_support( 'wc-product-gallery-lightbox' );
} );

5. Add Payment Type to WooCommerce Admin Email

This snippet will display the payment type that was used at checkout in the order email.

function wpexplorer_wc_add_payment_method_to_admin_new_order( $order, $is_admin_email ) {
	if ( $is_admin_email ) {
		echo '<p><strong>Payment Method:</strong> ' . esc_html( $order->payment_method_title ) . '</p>';
	}
}
add_action( 'woocommerce_email_after_order_table', 'wpexplorer_wc_add_payment_method_to_admin_new_order', 15, 2 );

6. Up-Sells Products Display Count

This snippet will modify how many up-sell products display, changing it to 3.

remove_action( 'woocommerce_after_single_product_summary', 'woocommerce_upsell_display', 15 );

if ( ! function_exists( 'woocommerce_output_upsells' ) ) {
	function woocommerce_output_upsells() {
		woocommerce_upsell_display( 3,3 );
	}
}
add_action( 'woocommerce_after_single_product_summary', 'woocommerce_output_upsells', 15 );

7. Remove Specific Product Categories from Shop Page

This snippet can be used to exclude products in specific categories from the shop.

function wpexplorer_exclude_categories_from_shop( $query ) {
	if ( ! $query->is_main_query() || is_admin() || ! function_exists( 'is_shop' ) || ! is_shop() ) {
		return;
	}

	$excluded_categories = [
		'color',
		'flavor',
		'spices',
		'vanilla',
	];
 
	$query->set( 'tax_query', [ [
		'taxonomy' => 'product_cat',
		'field'    => 'slug',
		'terms'    => $excluded_categories,
		'operator' => 'NOT IN'
	] ] );
}
add_action( 'pre_get_posts', 'wpexplorer_exclude_categories_from_shop' );

8. Quickly Translate Any String

Sometimes you may want to quickly translate a string without having to mess with the POT files. This snippet can be used to modify any translatable text.

function wpexplorer_translate_text( $text ) {
	$text = str_replace( 'Choose and option', 'Select', $text );
	return $text;
}
add_filter( 'gettext', 'wpexplorer_translate_text' );
add_filter( 'ngettext', 'wpexplorer_translate_text' );

9. Exclude a Category from the WooCommerce Categories Widget

This snippet can be used to remove certain categories from the WooCommerce categories widget. Be sure to change [ '16' ] to be an array of the term ID’s you wish to exclude.

function wpexplorer_filter_wc_categories_widget_args( $args ) {
	$args['exclude'] = [ '16' ];
	return $args;
}
add_filter( 'woocommerce_product_categories_widget_args', 'wpexplorer_filter_wc_categories_widget_args' );

10. Modify the “Out of Stock” Text

The following snippet will modify the default “Out of Stock” text and change it to “Sold”.

function wpexplorer_wc_modify_out_of_stock_text( $availability ) {
	$availability['availability'] = str_replace( 'Out of stock', 'Sold', $availability['availability'] );
	return $availability;
}
add_filter( 'woocommerce_get_availability', 'wpexplorer_wc_modify_out_of_stock_text' );

11. Display “Product Already in Cart” Instead of “Add to Cart” Button

This snippet to change the default “Add to Cart” button to “Already in cart – Add Again? when viewing a product that’s already in the cart.

// Modify the WooCommerce single product add to cart text.
function wpexplorer_wc_modify_add_to_cart_text( $text ) {
	global $woocommerce;
	foreach( $woocommerce->cart->get_cart() as $cart_item_key => $values ) {
		if ( $values['data']->id == get_the_ID() ) {
			$text = esc_html__('Already in cart - Add Again?', 'text_domain' );
			break;
		}
	}
	return $text;
}
add_filter( 'woocommerce_product_single_add_to_cart_text', 'wpexplorer_wc_modify_add_to_cart_text' );

// Modify the WooCommerce entry add to cart text.
function woo_archive_custom_cart_button_text( $text ) {
	global $woocommerce;
	foreach( $woocommerce->cart->get_cart() as $cart_item_key => $values ) {
		if ( $values['data']->id == get_the_ID() ) {
			$text = esc_html__('Already in cart - Add Again?', 'text_domain' );
			break;
		}
	}
	return $text;
}
add_filter( 'add_to_cart_text', 'woo_archive_custom_cart_button_text' );

12. Hide the Category View Products Count

This snippet will remove the default products count in the categories view.

add_filter( 'woocommerce_subcategory_count_html', '__return_empty_string' );

13. Make Account Checkout Fields Required

This snippet will add the required attribute to various checkout fields.

function wpexplorer_wc_filter_checkout_fields( $fields ) {
	$fields['account']['account_username']['required'] = true;
	$fields['account']['account_password']['required'] = true;
	$fields['account']['account_password-2']['required'] = true;
	return $fields;
}
add_filter( 'woocommerce_checkout_fields', 'wpexplorer_wc_filter_checkout_fields' );

14. Rename a Product Tab

This snippet will rename the product “description” tab to “More Info”. You can modify the code to target any tab.

function wpexplorer_wc_filter_product_tabs( $tabs ) {
	$tabs['description']['title'] = 'More info';
	return $tabs;
}
add_filter( 'woocommerce_product_tabs', 'wpexplorer_wc_filter_product_tabs', 100 );

15. List WooCommerce Product Categories

This snippet will grab the product categories, loop through them and display them as a list.

$product_categories = get_terms( 'product_cat', [
	'number'     => '3',
	'orderby'    => 'name',
	'order'      => 'ASC',
	'hide_empty' => true
] );

if ( $product_categories && ! is_wp_error( $product_categories ) ) {
	echo "<ul>";
	foreach ( $product_categories as $product_category ) {
		echo '<li><a href="' . esc_url( get_term_link( $product_category ) ) . '">' . esc_html( $product_category->name ) . '</li>';  
	}
	echo "</ul>";
}

16. Replace Shop Page Title

This code snippet replaces the default shop page title. Note, that if the code doesn’t work it could be because of the theme you are using.

function wpexplorer_wc_archive_title( $title ) {
    if ( is_shop() && $shop_id = wc_get_page_id( 'shop' ) ) {
        $title = get_the_title( $shop_id );
    }
    return $title;
}
add_filter( 'get_the_archive_title', 'wpexplorer_wc_archive_title' );

17. Change a Widget Title

This snippet will allow you to modify a widget title (on demand).

function wpexplorer_wc_widget_title( $title, $instance, $id_base ) {
	if( 'onsale' === $id_base ) {
		return 'Custom Onsale Widget Title';
	}
	return $title;
}
add_filter( 'widget_title', 'wpexplorer_wc_widget_title', 10, 3 );

18. Get Featured Product ID’s

This snippet will return a list of featured product ID’s.

$query_featured_products = new WP_Query( [
	'post_type'           => 'product',
	'ignore_sticky_posts' => true,
	'posts_per_page'      => -1,
	'fields'              => 'ids',
	'tax_query'           => [
		'taxonomy' => 'product_visibility',
		'field'    => 'name',
		'terms'    => 'featured',
		'operator' => 'IN'
	]
] );
$featured_products = $query_featured_products->posts ?? [];

19. Set a Minimum Order Amount

This snippet will add a minimum order amout of 5 so the user can’t check out unless they have at least 5 items in the cart.

function wpexplorer_wc_minimum_order_amount() {
	global $woocommerce;
	$minimum = 5;
	if ( $woocommerce->cart->total() ) {
		add_error( sprintf( 'You must have an order with a minimum of %s to place your order.', $minimum ) );
	}
}
add_action( 'woocommerce_checkout_process', 'wpexplorer_wc_minimum_order_amount' );

20. Modify the Default Shop Catalog Orderby

This snippet will modify the default order of products shown in your shop. Note, you can now set this via WooCommerce settings instead.

function wpexplorer_wc_default_catalog_orderby() {
	return 'price';
}
add_filter( 'woocommerce_default_catalog_orderby', 'wpexplorer_wc_default_catalog_orderby' );

21. Redirect Add to Cart Button to Checkout Page

This snippet will redirect users to the checkout when adding a product to the cart. Note, you can do this via the WooCommerce settings now without any custom code.

function wpexplorer_wc_redirect_to_checkout( $redirect ) {
	if ( $checkout_url = wc_get_checkout_url() ) {
		$redirect = $checkout_url;
	}
	return $redirect;
}
add_filter( 'add_to_cart_redirect', 'wpexplorer_wc_redirect_to_checkout' );

22. Add Email Recipient When Order is Completed

This snippet allows you to add extra email recipients to receive the completed order email.

function wpexplorer_wc_add_email_recipients( $recipient ) {
	$recipient = "{$recipient}, your@email.com";
	return $recipient;
}
add_filter( 'woocommerce_email_recipient_customer_completed_order', 'wpexplorer_wc_add_email_recipients', 10 );

23. Replace the Default PayPal Logo

This snippet will allow you to modify the default PayPal logo on the check out form.

function wpexplorer_wc_replace_paypal_icon() {
	return 'https://www.paypalobjects.com/webstatic/mktg/logo-center/logo_betalen_met_paypal_nl.jpg';
}
add_filter( 'woocommerce_paypal_icon', 'wpexplorer_wc_replace_paypal_icon' );

24. Modify the Default Placeholder Image

This snippet will modify the default placeholder image.

function wpexplorer_wc_change_placeholder_image( $src ) {
	$src = "YOUR_CUSTOM_IMAGE_URL";
	return $src;
}
add_filter( 'woocommerce_placeholder_img_src', 'wpexplorer_wc_change_placeholder_image' );

25. Manually Empty the Cart

This code snippet will manually empty your cart.

global $woocommerce;
$woocommerce->cart->empty_cart(); 

26. Add a Product to the Cart on Page Load

This snippet will automatically add a product to the cart when visiting the site.

function wpexplorer_wc_auto_add_products_to_cart() {
	if ( ! is_admin() ) {
		global $woocommerce;
		$product_id_to_add = 64; // ID of product to add
		$found = false;
		foreach ( $woocommerce->cart->get_cart() as $cart_item_key => $values ) {
			if ( (int) $product_id_to_add === (int) $values['data']->id ) {
				$found = true;
				return;
			}
		}
		if ( ! $found ) {
			$woocommerce->cart->add_to_cart( $product_id_to_add );
		}
	}
}
add_action( 'init', 'wpexplorer_wc_auto_add_products_to_cart' );

27. Add a Custom Currency Symbol

This snippet will add a new currency symbol that you can select from.

// Adds a custom currency.
function wpexplorer_wc_add_custom_curency( $currencies ) {
	$currencies['ABC'] = __( 'ABC Currency Name', 'text_domain' );
	return $currencies;
}
add_filter( 'woocommerce_currencies', 'wpexplorer_wc_add_custom_curency' );

// Adds a custom currency symbol.
function wpexplorer_wc_modify_currency_symbol( $currency_symbol, $currency ) {
	if ( 'ABC' === $currency ) {
		$currency_symbol = '$';
	}
	return $currency_symbol;
}
add_filter( 'woocommerce_currency_symbol', 'wpexplorer_wc_modify_currency_symbol', 10, 2 );

28. Modify the Add to Cart Button Text

This snippet will change the default Add to Cart button text to your custom text. Note, it will affect all buttons regardless of the product type.

function wpexplorer_wc_modify_cart_button_text() {
	return __( 'My Button Text', 'text_domain' );
}
add_filter( 'single_add_to_cart_text', 'wpexplorer_wc_modify_cart_button_text' );
add_filter( 'add_to_cart_text', 'wpexplorer_wc_modify_cart_button_text' );

29. BCC all WooCommerce Emails

If you wish to bcc all emails you can do so with the following snippet:

function wpexplorer_wc_bcc_all_emails() {
	return 'Bcc: youremail@yourdomain.com' . "\r\n";
}
add_filter( 'woocommerce_email_headers', 'wpexplorer_wc_bcc_all_emails' );

30. Change the Number of Related Products

This snippet can be used to modify the default number of related products that display on the single product pages.

function wpexplorer_wc_related_posts_per_page( $args ) {
    $args['posts_per_page'] = 4;
    return $args;
}
add_filter( 'woocommerce_output_related_products_args', 'wpexplorer_wc_related_posts_per_page' );

31. Change the Next and Previous Text into Arrows

This snippet hooks into the WooCommerce pagination arguments to turn the next and previous text into arrows.

function wpexplorer_wc_pagination_args( $args ) {
    $args['prev_text'] = '←';
    $args['next_text'] = '→';
    return $args;
}
add_filter( 'woocommerce_pagination_args', 'wpexplorer_wc_pagination_args' );

32. Remove all Single Product Tabs

This snippet will quickly remove all tabs from the single product.

add_filter( 'woocommerce_product_tabs', '__return_empty_array', PHP_INT_MAX );

33. Remove Breadcrumbs

This snippet will remove the WooCommerce breadcrumbs.

remove_action( 'woocommerce_before_main_content', 'woocommerce_breadcrumb', 20);

34. Restrict Shipping Countries List

This snippet will restrict the countries in the shipping select dropdown.

function wpexplorer_wc_override_checkout_fields( $fields ) { 
	$fields['shipping']['shipping_country'] = [
		'type'      => 'select',
		'label'     => esc_html__( 'My New Country List', 'text_domain'),
		'options' 	=> [
			'AU' => 'Australia',
		],
	];
	return $fields; 
}
add_filter( 'woocommerce_checkout_fields' , 'wpexplorer_wc_override_checkout_fields' );

35. Change the “Free!” Text on Free Products

This snippet will allow you to modify the default HTML added for free products to let the user know it’s free.

function wpexplorer_wc_modify_free_price_html() {
	return "This product is FREE!";
}

add_filter( 'woocommerce_free_price_html', 'wpexplorer_wc_modify_free_price_html' );

36. Remove All Shipping Methods if Free Shipping is Available

This snippet will remove all available shipping methods if free shipping is available so it’s the only one that can be selected.

function wpexplorer_wc_modify_available_shipping_methds( $available_methods ) {
	if ( isset( $available_methods['free_shipping'] ) ) {
		$available_methods = [ $available_methods['free_shipping'] ];
	}
	return $available_methods;
}
add_filter( 'woocommerce_available_shipping_methods', 'wpexplorer_wc_modify_available_shipping_methds' , 10 );

37. Make the Shipping State Field Not Required

This code snippet will remove the required attribute from the shipping state field.

function wpexplorer_wc_make_shipping_state_not_required( $address_fields ) { 
	$address_fields['shipping_state']['required'] = false;
	return $address_fields;
}
add_filter( 'woocommerce_shipping_fields', 'wpexplorer_wc_make_shipping_state_not_required', 10 );

38. Programmatically Create a New Coupon

This snippet will allow you to insert a new coupon using code.

$coupon_code   = 'UNIQUECODE';
$amount        = '10';
$discount_type = 'fixed_cart';

$new_coupon_id = wp_insert_post( [
	'post_title'   => $coupon_code,
	'post_content' => '',
	'post_status'  => 'publish',
	'post_author'  => 1,
	'post_type'    => 'shop_coupon'
] );

if ( $new_coupon_id ) {
	update_post_meta( $new_coupon_id, 'discount_type', $discount_type );
	update_post_meta( $new_coupon_id, 'coupon_amount', $amount );
	update_post_meta( $new_coupon_id, 'individual_use', 'no' );
	update_post_meta( $new_coupon_id, 'product_ids', '' );
	update_post_meta( $new_coupon_id, 'exclude_product_ids', '' );
	update_post_meta( $new_coupon_id, 'usage_limit', '' );
	update_post_meta( $new_coupon_id, 'expiry_date', '' );
	update_post_meta( $new_coupon_id, 'apply_before_tax', 'yes' );
	update_post_meta( $new_coupon_id, 'free_shipping', 'no' );
}

39. Change New Order Email Subject Line

This snippet will allow you to modify the subject of the email sent when a new order is placed.

function wpexplorer_wc_change_new_order_email_subject( $subject, $order ) {
	global $woocommerce;
	$blogname = wp_specialchars_decode( get_option( 'blogname' ), ENT_QUOTES );
	$subject = sprintf( '[%s] New Customer Order (# %s) from Name %s %s', $blogname, $order->id, $order->billing_first_name, $order->billing_last_name );
	return $subject;
}
add_filter( 'woocommerce_email_subject_new_order', 'wpexplorer_wc_change_new_order_email_subject', 1, 2 );

40. Change the On Sale Text

This snippet will modify the default on sale badge text.

function wpexplorer_woo_sale_flash() {
	return '<span class="onsale">' . esc_html__( 'Sale', 'text_domain' ) . '</span>';
}
add_filter( 'woocommerce_sale_flash', 'wpexplorer_woo_sale_flash' );

Conclusion

And… that’s it! I hope you find will these snippets useful, they were all tested and they all work fine, but if you experience any trouble please let me know  the comments section. Have fun! 😉

Further Reading

You may be interested in the following related WooCommerce guides & articles:

• How to Make your Theme WooCommerce Compatible
• How to Speed Up Your WooCommerce Store
• How to Build an Online Store with WooCommerce
• Best WooCommerce Extensions & Addons

Author Note: This post was originally written by Remi but it’s currently updated and maintained by the WPExplorer staff.