Snippets
Found under the Install/Update/Repair Status tab, snippets are the application files that govern the functionality of your category system. Under the Snippet list, you will see all the available snippets that have been added to your collections. A good rule of thumb regarding the snippet colors is as follows:
Under Status, you can see if a snippet has been deployed or not as well. Under Actions, you can choose to activate snippets individually if they are highlighted in red or yellow, or activate all at once by clicking the Deploy All button above the Actions column.
All snippets begin with the designation “snippets/btp-categories-” followed by the snippet name and “.liquid,” each with it’s own function; an example if a snippet name is “snippets/btp-categories-data.liquid.”
The first three snippets (snippets/btp-categories-data.liquid, snippets/btp-categories-settings.liquid, and snippets/btp-categories-functions.liquid) you begin with are necessary for Categories by BTP to function properly, so it is strongly advised that these three snippets remain intact and unaltered.
The last three snippets (snippets/btp-categories-collectionbreadcrumbs.liquid, snippets/btp-categories-productbreadcrumbs.liquid, and snippets/btp-categories-tree.liquid) are the snippets you will include in whatever section of your theme where you would like to use those breadcrumbs and the tree.
Install New Snippets
In order to see how your categories show up in your customer-facing storefront, you need to ensure that the correct snippets have been installed within your theme. You can view how your categories appear in your online storefront by selecting the ‘View on Online Store’ button on the toolbar for any of your categories. All snippets are based in the Liquid collections template, so look for that designation when making changes.
To adjust your snippets:
*You can also follow this procedure to install product breadcrumb trails on product pages; in the Edit/HTML/CSS menu, select “product.liquid” instead of “collection.liquid”
Generate Product Tags
“Checking this option automatically adds product tags to your collections’ conditions and sets the rules to match ANY CONDITION. Unchecking leaves the collections’ conditions as-is, giving you the responsibility of configuring your collections.”
This option is found under the Settings tab and can affect how your product tags are created. If you are creating categories for the first time for certain products, it is recommended that you keep this option checked to easily create product tags. These newly-created product tags will be viewable by clicking the [ ] button on their respective category’s toolbar on the right in the Categories tab.
However, if you would prefer to use existing collections that you have already configured the collections to your liking, you may uncheck this option and choose your Existing Collections from the appropriate drop-down menu in the Categories tab.
“Main” Tags
Assign these tags to products that you feel belong directly within a particular category; these conditions can be viewed by selecting the Edit Collection button. “Main” tags are often used to be very specific within the overall category tree. For example, a Dell XPS desktop computer would be better served if it’s “main” tag was placed in a category called “Desktops” rather just “Computers.” We recommend that you only place one “main” tag per product.
“Other” Tags
Assign these tags to products that you feel should be associated with a particular category; these conditions can be viewed by selecting the Edit Collection button. “Other” tags are secondary tags to make particular products more easily found within the overall category tree. For example, since we placed a “main” tag on our Dell XPS desktop computer for the “Desktops” category, it would do us well to add an “other” tag for it under “Computers” to also associate the product with that category.
Add a Tag to a Product
To add a category tag to a product:
Primary and Secondary Tagging Example
Primary Tag:
Microsoft > Office > 2013 > Product Name (TAGPRIMARY123)
Secondary Tags:
Microsoft (TAGSECONDARY1)
Microsoft > Office (TAGSECONDARY3)
Microsoft > Office > 2013 (TagSECONDARY2)
URL example: www.url.com/product/productname
Breadcrumb: Microsoft > Office > 2013 > Product Name
If you navigate from one of the secondary categories, you can tell it how you want to show your breadcrumb. If you use the default {% breadcrumb %} and you navigate to the product from Microsoft, your breadcrumb would simply be "Microsoft". If you tell the template to show the fully qualified one all the time, then it would show the full "Microsoft > Office > 2013 > Product Name".