by ShopSite Lauren » Fri Jul 17, 2015 3:22 pm
On the 2 include files, those are part of the BB theme, so that (1) different pricing layouts can be used, and (2) so that different product layouts can be used by different pages with the same product. I've given more information about each of these below. [-- VAR.Price STORE.Price --] is just replaced by the basic text "Price" that is configured under Preferences > Store Text > Store Pages.
[-- INCLUDE VAR.PriceDisplay PROCESS --]
With the BB theme files, there are 8 different product price layouts all in 8 different include files. Some are simple and used on category pages, some are more advanced layouts and only used on more information pages. If you want to edit the price display, I would suggest copying the code from the price display being used, and paste it into your custom template, then modify it there. To find out what price display is being used, you will want to look in the product template. Go to Merchandising > Custom Templates > Page/Product > Copy ShopSite Product Template, and make a copy of the product template your products are using. The default include file for the price display for BB themes is BB-PriceTwoLine.sst. If you are using the regular BB-Product.sst product template, then your product pages are using the BB-PriceTwoLine.sst include file to control the way the price is formatted. If you are using a different -.sst product template, there might be other product displays. You will look in the template for a tag that is formatted like the following [-- VAR.PriceDisplay BB-PriceTwoLine.sst --]. The second part of the tag will tell you what include file is being used for the price display.
If you want to quickly test out the other 7 price displays to see if any of them fit your needs, you can go to Merchandising > Custom Templates > Page/Product > Edit Product Template, to edit the product template your products are currently using. Just after the [-- INCLUDE BB-VARs-DOCTYPE.sst PROCESS --] tag, enter one of the following 7 tags (try one out, then publish, then try another out and publish, etc). Save changes, then go to Utilities > Publish > Regenerate. ShopSite will recreate all your product pages with the new price display layout. If you don't like it, try another price display layout. The link below has an example of all 8 price layouts with the sale price being used.
[-- VAR.PriceDisplay BB-PriceOneLine.sst --]
[-- VAR.PriceDisplay BB-PriceOnly.sst --]
[-- VAR.PriceDisplay BB-PriceOnlyPlus.sst --]
[-- VAR.PriceDisplay BB-PriceQuickNDirty.sst --]
[-- VAR.PriceDisplay BB-PriceRounded.sst --]
[-- VAR.PriceDisplay BB-PriceTable.sst --]
[-- VAR.PriceDisplay BB-PriceTitled.sst --]
http://shopsite.com/templates/cookbook/builtintemplates-bbthemes-pricing.html
[-- INCLUDE VAR.ProductDefine PROCESS --]
With original ShopSite functionality, a product has a single product template assigned. The product template that is assigned is used to format the product information on all category pages the product is assigned to, plus the format for the more information page. There are a few page templates that need a specific product layout in order to work correctly (such as multi-add-to-cart page templates), so those page templates will force a particular product template, overriding the merchant's ability to change the product layout and can end up affecting the layout of the product's more information page. The VAR tag for the product layout allows the best of both worlds, the page template can control the product layout on that page only, and the merchant's choice for the product template can control the layout of the more information page. So every BB page template specifies the product layout/define/definition for that page, meaning that each BB page template may have a different VAR tag for the product define. The default for most page templates is the BB-ProductDefine.sst include file.
In version 12 sp 1, there are only 2 possible product defines, one for regular product pages, and one for multi-add-to-cart situations. So it is likely that in order to modify the code that is output by the VAR.ProductDefine, you would simply need to go to Merchandising > Custom Templates > Includes > Copy ShopSite Include, and make a copy of the BB-ProductDefine.sst include file. Then make a copy of your copy and rename it the exact same name as the original. This will make it so that your newly copied include file will override the original include file.
If you wanted to create your own -.sst include file, you could create the file, then go to Merchandising > Custom Templates > Page/Product > and edit the Page template your pages use, and change the current VAR.ProductDefine BB-ProductDefine.sst tag to now include your new include file name.
- ShopSite Lauren
Contact me for help with any of your
custom ShopSite template questions.