Discover, trust, install: FAIR 1.0 is here

WooCommerce Grid / List toggle is a simple plugin which adds a grid / list toggle button to your product archives allowing users to toggle between grid / list views of your products on your WooCommerce store.

The list view arranges products in a vertical list and pulls in the excerpt to give a more detailed overview.

The grid view you will be familiar with as this is WooCommerce’s default layout for product archives.

The store owner can choose whether grid or list view be set as the default via the “WooCommerce” > “Product Catalog” section of the Customizer.

Please feel free to contribute on github.

1. Upload woocommerce-grid-list-toggle to the /wp-content/plugins/ directory
2. Activate the plugin through the ‘Plugins’ menu in WordPress
3. Choose the default setting on the catalog tab of the WooCommerce settings screen
4. Done!

1. 

   List view.

Installation Instructions

1. Upload woocommerce-grid-list-toggle to the /wp-content/plugins/ directory
2. Activate the plugin through the ‘Plugins’ menu in WordPress
3. Choose the default setting on the catalog tab of the WooCommerce settings screen
4. Done!

It doesn’t work with my theme, what gives?

You may see varied results depending on how the theme has been built and whether it’s already pulling the excerpt into product archives. I’ve tried to cover all bases with CSS but it’s likely you’ll need to make your own adjustments. WooCommerce Grid / List toggle has been tested with Twenty Ten, Twenty Eleven and Twenty Twelve.

I found and fixed a bug how can I help?

Thanks! Please fork the repo on github, push your fix then send a pull request.

I don’t like the button styles, how can I remove them and start fresh?

Add the following code to the functions.php file in your theme / child theme:

add_action( 'wp_enqueue_scripts', 'remove_gridlist_styles', 30 );
function remove_gridlist_styles() {
    wp_dequeue_style( 'grid-list-button' );
}

That will remove the button styles but keep the layout styles which will allow you to design the buttons as you see fit.

To remove the layout styles as well use:

add_action('wp_enqueue_scripts', 'remove_gridlist_styles', 30);
function remove_gridlist_styles() {
    wp_dequeue_style( 'grid-list-button' );
    wp_dequeue_style( 'grid-list-layout' );
}

1.2.1 – 11/05/18

• Hide debug info.

1.2.0 – 01/05/18

• Moved the settings to the Customizer (WooCommerce > Product Catalog)
• Removed unnecessary .less files
• Tweaked button styles
• Full compatibility with Storefront theme

1.1.0 – 12/12/16

• Outputs are now filterable. Kudos joshuadavidnelson.

1.0.0 – 19/06/2015

• Revamped button styles.
• Updated textdomain to ‘woocommerce-grid-list-toggle’.
• Code tidy up.

0.4.0 – 04/02/2013

• WooCommerce 2.1 compatibility.

0.3.4 – 10/12/2013

• Grid list toggle now appears on custom product taxonomies. Kudos dariodev.

0.3.3 – 30/05/2013

• Improved i18n
• Added languages folder
• Added default .po file for translators
• Added full German translations for v0.3.2 (including the above enhancements)
• Kudos deckerweb for all the above 🙂
• Stripped object pass by reference

0.3.2 – 08/02/2013

• Product category descriptions now displayed in list view

0.3.1 – 07/02/2013

• Removed unnecessary default options

0.3 – 30/01/2013

• Added option to choose default view

0.2.3 – 28/01/2013

• Fixed active class bug on the toggle button
• Styled the star-rating in list view

0.2.2 – 16/01/2013

• Re-applied button style. See FAQ to remove
• YUI compressed CSS
• Styles loaded on product tag archives

0.2.1 – 10/01/2013

• Add active class to grid button on initial load

0.2 – 09/01/2013

• Delayed gridlist_toggle_button() priority for better WooCommerce 2.0 compatibility
• Even stricter CSS for list view (improves theme compatibility)
• Changed #gridlist-toggle to .gridlist-toggle

0.1.1 – 08/01/2013

• Set grid as default view
• Stricter CSS for list view
• Only add the excerpt on shop / product category pages
• Removed toggle button styling – this should be done in your theme

0.1

Initial release.