Usage
Automatic placement
After installing the extension and entering the credentials, the rating is
rendered before </ on every page, centred. Nothing else to do.
Switch it off with auto in the extension configuration if you
want to place the snippet yourself.
Content element
Add the content element ProvenExpert rating where the snippet should appear. The automatic placement then holds back, so there is never more than one review snippet on a page.
Google grants stars only for a snippet that is fully visible, and expects one review snippet per page.
TypoScript
Add the static template ProvenExpert (server-side) to your root template, then place the rating wherever you need it:
# e.g. below the footer, on every page
page.footerData.950 < lib.provenExpertRating
# optional: override the configured layout
page.footerData.950.style = stars
Fluid
{namespace pe=Bm1\ProvenExpert\ViewHelpers}
<pe:rating />
<pe:rating style="textInline" />
Caching
Rating data is cached for an hour by default. If the API is unreachable, the last successful response keeps being served and the API is retried after a minute, so the rating never disappears because of a network hiccup.
Changes made in the ProvenExpert account show up with a delay: this extension caches, and ProvenExpert caches on its own servers as well.
What is sent where
Only the web server talks to ProvenExpert. The visitor's browser loads nothing
from ProvenExpert: no script, no image, no font. No cookies and no
session entries are created, and no visitor data reaches
ProvenExpert.
This covers the display of the rating. Collecting reviews through ProvenExpert is a separate processing activity.