This is the most important Ecwid widget. It shows and includes a full-featured shopping cart with products, categories, catalog, checkout pages, etc.
- Product Browser
- Generate your code
- Advanced Settings
- Responsive design
- I don't see view modes "List" and "Table" in my store. How to fix this?
- Related Articles
Ecwid can display products in three modes:
- grid (default mode for the products in categories)
- list (default mode for search. It shows the list of products with an abstract from the product description)
- table (useful if your products don't have thumbnails. In this mode Ecwid shows all products in the list without product images)
You can always change the default modes by altering the product browser's settings.
You can adjust product browser layout styles and behavior according to your needs. For that, you will need to slightly modify the widget integration code as described below.
Find the following code in the widget code:
"categoriesPerRow=3","views=grid(20,3) list(60) table(60)","categoryView=grid","searchView=list"
The code defines products and categories listing styles. Let's see its parts:
- "categoriesPerRow=3" -- defines number of categories per row
- "views=grid(20,3) list(60) table(60)" - defines the available views and their settings. If you want to remove any view, just remove the "grid(20,3)" or "list(60)" or "table(60)" text from the settings.
The number in braces is number of products in the particular view. I.e.:
- grid(K,L) - K is a number of products in a column, L -- number of products in a row.
- list(M) - M is number of products on one page
- table(N) - N is number of products on one page
Default view mode:
- "categoryView=grid" - defines the default view for products in categories. Possible values: list, grid, table
- "searchView=list" - defines the default view for search results. Possible values: list, grid, table.
The 'style=' setting in the product browser widget code allows adding custom CSS to the layer that enclose all product browser code. Usually it isn't used. If you want to change some Ecwid elements, use custom CSS themes instead. More details: CSS FAQ.
By default, the Product Browser widget opens with a list of root categories. But you can configure it to show a different category when user opens it for the first time. You can do it by adding the 'defaultCategoryId' option to the widget integration code. Please refer to this article for the details: Default category for product browser.
If your product browser is installed on one page, but you have minicart/vertical categories/search box on all other pages of your site and you want them all to be linked to your main store page, the ecwid_ProductBrowserURL option can be used. Please find the details in this article: ecwid_ProductBrowserURL.
You can use the Settings Wizard to create the necessary settings string quickly: http://www.ecwid.com/playground/pb-settings-wizard/
- If we want to hide the "table" view and use the "list" / "grid" views only; set the 'grid' view as a default one for the products and the 'list' on for the search results, we should use the following code:
- Hide all views except for the 'list' one. The 'list' view is a default one for the products and the search results:
- Set 4 categories per row, 'grid' will have 4 products in a row and a column, the 'list' view will have 5 products per page, the 'table' view will have 50 products per page. The default view for the products is a table, for the search results -- a grid:
xProductBrowser("categoriesPerRow=4","views=grid(4,4) views=list(5) table(50)","categoryView=table","searchView=grid","style=");
If you make changes, but don't see the product browser after that, make sure you don't have any kind of syntax errors.
Ecwid supports responsive layout. It means that the store pages can adapt to the visitor's screen width on the fly and keep the layout clean and nice. Your products and categories lists will be fit for any window's size, as Ecwid will calculate the most suitable number of products or categories in row automatically.
If you have noticed that responsive design works incorrectly in your store, please, inform us about it on our forums.
You cannot see them, because your store uses the old integration code. Since the view modes add some new CSS classes, they may not fit your site's CSS styles. That's why they're not enabled for all existing Ecwid users by default. In order to add them, follow these steps:
- go to the Ecwid control panel
- grab a new integration code of the product browser
- update the existing code with a new one
If you use the WordPress Ecwid plugin, you don't need to update the code. Just update this plugin to the 0.3 version.
- CSS FAQ
- Default category for product browser
- How can I show a specific product by default
- How can I link to a particular product or category
- How to get ID of your product or category