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:

Page	Rec Slot	Description	Hook	Custom Hook
Front	frontpage-nosto-1	Personalized Recommendations	HOOK_HOME
Front	frontpage-nosto-2	Best Sellers and Trending Products	HOOK_HOME
Front	frontpage-nosto-3	Browsing History	HOOK_HOME
Front	frontpage-nosto-4	Browsing History related Recommendations	HOOK_HOME
Category	nosto-page-category1	Best Sellers and Trending Products	HOOK_TOP	HOOK_CATEGORY_TOP
Category	nosto-page-category2	Browsing History	HOOK_TOP	HOOK_CATEGORY_FOOTER
Product	nosto-page-product1	Cross-Selling and Up-Selling	HOOK_PRODUCT_FOOTER
Product	nosto-page-product2	Cross-Selling and Up-Selling	HOOK_PRODUCT_FOOTER
Product	nosto-page-product3	Cross-Selling and Up-Selling	HOOK_PRODUCT_FOOTER
Cart	nosto-page-cart1	Shopping Cart Recommendations	HOOK_SHOPPING_CART
Cart	nosto-page-cart2	Personalized Recommendations	HOOK_SHOPPING_CART
Cart	nosto-page-cart3	Best Sellers and Trending Products	HOOK_SHOPPING_CART
Search	nosto-page-search1	Search and Visit related Recommendations	HOOK_TOP	HOOK_SEARCH_TOP
Search	nosto-page-search2	Browsing History	HOOK_TOP	HOOK_SEARCH_FOOTER
Order	thankyou-nosto-1	Order Related Recommendations	HOOK_ORDER_CONFIRMATION
Order	thankyou-nosto-2		HOOK_ORDER_CONFIRMATION
404	notfound-nosto-1	Browsing History related Recommendations	HOOK_TOP
404	notfound-nosto-2	Best Sellers and Trending Products	HOOK_TOP
404	notfound-nosto-3	Landing Page Recommendations	HOOK_TOP

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:

1. 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.

2. 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.

Page
Top	{if isset($HOOK_CATEGORY_TOP) && $HOOK_CATEGORY_TOP}{$HOOK_CATEGORY_TOP}{/if}
Footer	{if isset($HOOK_CATEGORY_FOOTER) && $HOOK_CATEGORY_FOOTER}{$HOOK_CATEGORY_FOOTER}{/if}

Search Page:

Edit the search template and place the following snippet precisely where you you want the top and footer recommendations to appear.

Page
Top	{if isset($HOOK_SEARCH_TOP) && $HOOK_SEARCH_TOP}{$HOOK_SEARCH_TOP}{/if}
Footer	{if isset($HOOK_SEARCH_FOOTER) && $HOOK_SEARCH_FOOTER}{$HOOK_SEARCH_FOOTER}{/if}

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.