Feeds & Indexing
Product Data Options
You can augment each product with additional information, sent in the data feed, in order to control certain aspects of how PureClarity displays products.
When editing a product open the PureClarity section to see the properties that can be set.
Enter a comma separated list of words or phrases that you’d like to be sent to PureClarity as Search Tags. These tags allow customers to search and find customers. PureClarity Search Rules can also be created to promote or exclude products with certain tags.
Exclude from recommenders
Set this to yes to stop a product from being included in PureClarity Recommenders. You may want to do this for small priced items.
Set if a product should be treated as a new arrival by PureClarity. This enhances recommenders and helps to target customers by showing hot new arrival products that may interest them.
Set if a product should be treated as an on offer product. This enhances recommenders and helps to target customers by showing them products that are on promotion. PureClarity will do this automatically if products are on sale, however, you may want to override this if a product doesn’t currently have a special price but you’d like it to be treated as a promoted product.
Product Image Overlay
You can set an additional overlay image to be placed over the product listing display. This could include an image such as On Offer or Free Delivery.
To set the image, upload and image under the “Images and Videos” section under a products properties, and select the “PureClarity Overlay Image” as the image role by selecting the image and selecting the option from the Role list.
You can set an additional options for PureClarity against each category. To do this go to the PureClarity section on a categories properties page. The options available are:
Secondary Category Image
This allows you to set an additional category image should you wish to set one specifically for PureClarity category recommenders.
If set, this will be used instead of the category's standard image.
Exclude from Recommenders
Set this to yes to stop a category from being included in PureClarity Recommenders.
You can set fallback image URLs to be used where a product, category or brand doesn’t have any images set. To do this navigate to the PureClarity Configuration Page from the left hand menu, and set each URL using the text boxes under the “Placeholder images” section.
Server Side Mode
PureClarity can operate in two modes, Client side and Server side. By default PureClarity works client side. This means that results from PureClarity are injected into the html page as it’s loaded. This is recommended for most set ups and benefits from the added performance of allowing the system to work asynchronously. However, in some circumstances, such as custom pricing, or B2B sites, it maybe better to use the Server Side mode.
Server side mode changes how Magento and PureClarity communicate. All operations are done by backend code, and rendered using Magento's inbuilt widgets.
When in server side mode, Product Recommenders use Magento’s own Product List Widget. And for Search Results and Product Listings templates, that are included in the extension, are used. These templates are similar to Magento’s own Product Listing grid albeit with minor changes to include PureClarity specific functionality. The templates that the extension uses can be overridden and set to be a template in another custom module, to allow you to override these. See HTML & CSS Templates for overriding templates.
When product recommenders, search results and product listing results are rendered in server side mode, the product Ids return by PureClarity are passed to the Magento system, so that product data is pulled and built by Magento system rather than from PureClarity, as is the case in Client side mode. This is useful when a customized magento system has modules that alter product pricing, for example, or have custom functionality dealing with account specific pricing. Also, In search results, the facets and filters on the left are aggregated and built solely by magento, rather than PureClarity. Again, this is useful when product pricing differs from a normal installation as filters often have price sliders to help customer filter product results (PureClarity only holds the prices sent as standard by the feeds).
Enabling Server Side Mode
To enable Server Side mode navigate to the PureClarity Configuration page by selecting PureClarity from the left hand menu. Under the “Advanced” section, select “Yes” from the “Use Server Side Integration” drop down, and click Save Config.
Overriding Server Side Templates
When PureClarity is in Server Side mode, results are rendered using the templates included in the PureClarity extension. However, these can be overwritten by writing your own html templates. To do this navigate to the PureClarity Configuration Page from the left hand menu. Under the “Advanced” section, there are text boxes for Product Recommender, Search Results and Product Listing templates, which you can add references to your own templates.
To override any of the template set the values, for example, to [Module]_[Vendor]::grid.phtml
When overriding templates it’s important to include the following in your templates:
1. PureClarityClickEvents on the mousedown event of the main product container element when overriding the Product Recommender template:
onmousedown="<?php echo $this->getPureClarityClickEvent($_product->getId()); ?>" >
2. PureClarityClickEvents on the mousedown event of each product listing item when overriding the Search Results/Product Listing grid:
onmousedown="<?php echo $this->getPureclarityClickEvents()[$_item->getId()]; ?>">
3. Include the Personalized Products List on Search Result and Products Listing pages. This should be at the very top
<?php echo $this->getPersonalizedProductListHtml(); ?>
Note: You can see examples of the above by viewing the product_recommender.phtml and list.phtml template files under the extensions view > frontend > templates folder.
Client Side Mode
If you want to see the location of your BMZs but they’re not being populated, navigate to the PureClarity Configuration page and set the “Debug Mode” under the Advanced section to “Yes”. BMZs will be populate with their name and id.
SEO Friendly Searches
When in Client Side Mode search results are injected directly into the html page. You can switch on the recording of searches within the Magento dashboard, as well as ensure that the page is populated with hidden products before they are overwritten by the PureClarity results. This, in some situations, improve SEO results. However, this will have a performance impact and should only be used if it’s really required.
Modifying Search Results DOM Element Selector
Navigate to the PureClarity Configuration Page, and under the Advanced section set the value for the DOM element where the results will be injected into, and click [Save Config].