The product picker control is used in numerous places throughout Hotcakes. You'll find it in promotions, related products, and so many more places. This article will help you get familiar with this control so that you can use it wherever and whenever you come across it.
The following prerequisites will be necessary to accomplish the goals of this article:
- Have access to your Hotcakes store administration
There are no prerequisites required to begin with this article.
The product picker in it's fullest format looks like the image below.
The product search portion of this control is seen the most often. You even see and use it when you are looking for products in the catalog product listing. Any search you complete here will update the "Product Selection" portion of the control, discussed below.
|Search||This is a free-form textbox where you can enter any search term you wish to use to find products with. It can be the SKU, or anything that might be found in the product name, description, and meta data. Hit <Enter> to trigger the search.|
|Manufacturer||This drop down list will be filled with all of the manufacturers you have in your store. Selecting any choice in this drop down list will automatically trigger the search and show any products that match the manufacturer.|
|Vendor||This drop down list will be filled with all of the vendors you have in your store. Selecting any choice in this drop down list will automatically trigger the search and show any products that match the vendor.|
|Category||You'll see all of the categories you have created in this drop down list. Selecting any choice in this drop down list will automatically trigger the search and show any products that match the vendor|
This section of the control lists any products that match your search above. Every time you trigger the search, this listing will be updated.
|Page||This drop down list will have an item for each page of results that match the search parameters above. Simply choose the page you want, and the results here will be updated to show the products on that page.|
|Items Per Page||By default, this grid will be showing 5 products per page of results. If you wish to see more than that, change the value using this drop down list. The grid will update to reflect your selection immediately.|
|All||This column contains a checkbox for each product. Check each product you wish to select. You can also click the "All" header to check all checkboxes that are currently displayed. Checkboxes on other pages will not be selected when you do this.|
|SKU||The value in this column will display the SKU for the product in the row. It will not reflect any variants.|
|Name||This will contain the name of the product in this row.|
|Add Selected Products||Once you have selected at least one product in the grid, click this button to add the selected products to the column on the right.|
When you haven't yet selected any products, the right column will look like the image below, reminding you to select a product.
Once you select at least one product, they will begin to be displayed here in a grid format. The grid is shown and described below.
|[no name]||This first column allows you to sort the products in the grid. This order will be applied to whichever view you're using this control in.|
|[no name]||The primary image of the product in this row will be displayed here.|
|Product||The name of the product in this row will be displayed here.|
|[no name]||If you wish to remove a product from the selection, click the icon in this column.|