Recommendation Integration

There are several ways to integrate the REST calls with the Recommendation engine and to avoid blocking web page rendering, if the communication with the Recommender is distrusted or interrupted.

Simple Way

The simplest way to load recommendations is to synchronously request the Recommendation Engine for recommendations as they are needed. This way is sufficient in most cases. The most important drawback is that the request time increases by the time of the recommendation request. If the network is overloaded or the Recommendation Engine is not available it can lock the request.

Loading in the bottom

You can place the code that loads the data from the eZ Recommender at the bottom of the generated document and flush the output buffer to the client just before requesting recommendations. The browser will get a whole page to render and can display it even if the very end of the page is still loading. Then the JavaScript code with the recommendation information loaded at the bottom of the page must fill the gaps on the page with recommendations as soon as it is completely loaded.

Non-blocking loading in the background

If the website is implemented in a language which supports multithreading or non-blocking I/O, it is possible to start the recommendation request just after the browser request is received. The page generation and the recommendation requests will be accomplished in parallel. By combining this idea with the previous solution and placing the recommendation results at the bottom of the page you can avoid any interruption in the processing.

Loading from JavaScript using JSONP

It is not possible to request the recommendation controller server directly from the JavaScript (over AJAX library or directly over XMLHttpRequest) because of the cross-domain restriction in most browsers. One of the possible ways to work around this limitation is JSONP.

Loading over proxy

A better solution than JSONP is to provide the proxy on the server side, which will forward script requests to the Recommender system. It can be implemented as a very simple proxy using the mod_proxy module of Apache Webserver. It just transfers the data and the JavaScript renders the response into HTML itself.

An alternative approach is creating the HTML code on the server side for every target page in a sense to simplify the script on the client side.

As a possible implementation of such a proxy following tools can be used: the apache proxy module, an independent daemon like “netcat” or a PHP script.


An overview of pros and cons for each of the above techniques:

Problem Simple Way Bottom loading Background loading JSONP XMLHttpRequest + Proxy
Is not blocked by ad blockers or no-track plug-ins Yes Yes Yes Yes
Works if JavaScript is disabled Yes depends
Works for server without multithreading functionality Yes Yes Yes Yes
Compatible with frontend caching on the server Yes Yes
Does not delay page rendering depends depends Yes Yes
Supports authentication for recommendation fetching Yes Yes Yes depends
Read the Docs