Troubleshooting

Scenarios

The recommendations block needs to be configured with a Scenario. A Scenario is configured in the Recombee backend and is a collection of options that combine to define a complete query, except for the number of items returned. Setting up Scenarios is a vital preliminary step before this module can be used.

The machine name of the Scenario needs to be copied over into the block. This introduces the possibility of human error and care would be taken to enter the right value.

Transforming the results

Non-trivial implementation of the Recombee module will involve the themer authoring a (Handlebars) template which will be used to convert the JSON to HTML. Please read the JSON Template documentation for details. Themers will most likely need to create a small sandbox to refine their transformation.

You can use the following template to log the results into the console.

{{log  this}}

https://handlebarsjs.com/guide/builtin-helpers.html#each
https://handlebarsjs.com/guide/builtin-helpers.html#log

Doing this will dump the results to the console, giving you the raw results to work with. You can then use something like the following to iterate on your template.

http://tryhandlebarsjs.com/

Once you have the template right you can use it for your own custom JSON Template.