Requirements 

Install the extension 

composer require bm1/provenexpert

Without Composer, download the extension from the TYPO3 Extension Repository or from the GitHub releases.

API credentials 

The credentials are shown in your ProvenExpert account under Reputation boost > Google stars > PHP scripts, in the two lines:

$yourApiId = '...';
$yourAPIKey = '...';

Enter them in Admin Tools > Settings > Extension Configuration > bm1_provenexpert, or per site – see Configuration.

Extension configuration 

Layout 

ProvenExpert always returns the layout selected in the account under Google stars > Display of the rich snippet; its API offers no parameter for it. The extension therefore builds the visible output itself, from the ratingValue and reviewCount fields of the same API response – a route ProvenExpert explicitly allows. The JSON-LD block is always taken over from ProvenExpert unchanged, so the structured data stays exactly as intended.

Per site 

The same keys can be set per site below settings.bm1_provenexpert, which takes precedence over the extension configuration:

settings:
  bm1_provenexpert:
    apiId: '...'
    apiKey: '...'
    ratingStyle: 'starsInline'

On TYPO3 v13 and above you can add the shipped site set bm1/provenexpert, which makes the settings editable in the backend.

Keeping credentials out of the repository 

Any string setting may hold a placeholder such as %env(PROVENEXPERT_API_KEY)%, which is resolved from the server environment. In site YAML files TYPO3 resolves such placeholders on its own.

Automatic placement 

After installing the extension and entering the credentials, the rating is rendered before </body> on every page, centred. Nothing else to do.

Switch it off with autoInsert in the extension configuration if you want to place the snippet yourself.

Content element 

Add the content element ProvenExpert rating where it should appear and choose what it shows:

Rating

Stars, link and rich snippet. The automatic placement then holds back, so there is never more than one review snippet on a page.

Seal

The ProvenExpert seal as an image - portrait, landscape, square or circle, up to 250 pixels wide. The image is stored below typo3temp/assets/bm1_provenexpert/ and delivered from your own domain. It keeps its aspect ratio and shrinks to the available width on narrow screens. The seal carries no structured data, so it can sit on the same page as the rating.

The ProvenExpert widget type bar is not offered on purpose: its API response is a <script> tag pointing at ProvenExpert, which would require consent again.

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