Adding & Moving Recommendations
All recommendations are added through the PrestaShop hook system, which means that they are dependent on the existence and positioning of the hooks in the theme.
The module adds a default set of recommendation elements to the shop, that can be moved/removed as you see fit. The following recommendation slots are added:
Custom Hooks:
Prestashop does not provide it's own top and footer hooks for the category page. In order to overcome this limitation we have provided a workaround:
Autoslots: In order to compensate for the missing hooks, there is a custom JS that finds a DIV element with the class
center-column
and appends and prepends the respective slots before and after this DIV. This DIV element — present on most Prestashop themes — is the container for the main content block.Custom Hooks: We have created four custom hooks that can be explicitly placed on the category and search pages for precise positioning of the top and footer recommendation slots of the category and search pages.
Category Page:
Edit the search template and place the following snippet precisely where you you want the top and footer recommendations to appear.
Search Page:
Edit the search template and place the following snippet precisely where you you want the top and footer recommendations to appear.
Change position of recommendation elements
In order to change the position of any recommendation element added by Nosto, you can either move the PrestaShop hook position in your theme or unlink the Nosto module from the hook and add the elements directly into your theme. Please refer to the PrestaShop documentation on how to re-position hooks.
During the module installation, some new hooks are also created. These are:
displayCategoryTop
displayCategoryFooter
displaySearchTop
displaySearchFooter
These can be used to position the recommendations on the product category and search result pages, as PrestaShop does not include any hooks out-of-the-box for these pages. The module will automatically add the recommendations without these hooks as well, but for more precise positioning we recommend to include them in your theme. This is as easy as adding a line like {hook h='displayCategoryTop'}
to your theme layout file.
Removing recommendations elements
If you wish to remove one of the default recommendation elements you can easily do so by going to the module configuration page, and for the correct account toggle of the visibility of the recommendation. These settings are found on the Recommendations page of the account management.
Recommendations that are not visible will not be populated with content by Nosto. The recommendation element placeholder will still be added to the site, but it will remain empty and hidden to the users.
Adding new recommendation elements
The easiest way to add your own recommendation elements is to simply add the placeholder "div" in your theme layout, e.g. <div class="nosto_element" id="{id-of-your-choice}"></div>
. Note that you need to register this new element in your Nosto account settings, so that Nosto can start using it.
Last updated