:navigation-title: ProvenExpert

..  _start:

=====================================
ProvenExpert Google stars, server-side
=====================================

..  rst-class:: horizbuttons-tip-m

*   Shows your ProvenExpert rating without loading anything from
    ProvenExpert into the visitor's browser.

:Extension key:
    bm1_provenexpert

:Package name:
    bm1/provenexpert

:Version:
    |release|

:Language:
    en

:Author:
    Phillip Baumgärtner & contributors

:License:
    This document is published under the
    `Open Publication License <https://www.opencontent.org/openpub/>`__.

:Rendered:
    |today|

----

ProvenExpert offers its "Google stars" rich snippet as a JavaScript and as a
PHP script. The JavaScript variant runs in the visitor's browser and writes to
:code:`sessionStorage`, which usually puts it behind a consent banner – where
most visitors and search engines never get to see the rating.

This extension takes the PHP route and wraps it in proper TYPO3 plumbing:
caching, backend configuration, a content element and a Fluid ViewHelper. Only
the web server talks to ProvenExpert.

----

..  card-grid::
    :columns: 1
    :columns-md: 2
    :gap: 4
    :class: pb-4
    :card-height: 100

    ..  card:: Installation

        Install via Composer and enter the API credentials.

        ..  card-footer:: :ref:`Get started <installation>`
            :button-style: btn btn-secondary stretched-link

    ..  card:: Configuration

        Extension configuration, site settings and the available layouts.

        ..  card-footer:: :ref:`Configure the extension <configuration>`
            :button-style: btn btn-secondary stretched-link

    ..  card:: Usage

        Content element, TypoScript and Fluid.

        ..  card-footer:: :ref:`Render the rating <usage>`
            :button-style: btn btn-secondary stretched-link

..  toctree::
    :hidden:

    Installation/Index
    Configuration/Index
    Usage/Index