ratingstar / typo3-seal

1.3.2 2026-11-10 11:22 UTC

Requires

• php: >=8.2
• typo3/cms-core: ^13.4 || ^14.0
• typo3/cms-fluid: ^13.4 || ^14.0
• typo3/cms-frontend: ^13.4 || ^14.0

GPL-2.0-or-later

• Phillip Baumgärtner

• extension
• seo
• TYPO3 CMS
• reviews
• Rich Snippets
• customer reviews
• seal
• ratingstar
• review widget

Published on Packagist.org on 2026-11-10 11:41 UTC

README

RatingStar ist das Bewertungstool für Unternehmen: Kundenbewertungen sammeln, Bewertungen aus Google und anderen Portalen bündeln und alles auf der eigenen Website zeigen. Diese Extension bringt das nach TYPO3 — Siegel und Bewertungs-Widgets in allen neun Varianten sowie die Google-Sterne (Rich Snippets / AggregateRating) einer RatingStar-Filiale.

TYPO3 extension ratingstar_seal · Composer ratingstar/typo3-seal · TYPO3 v13 + v14 · GPL-2.0-or-later

Funktionsumfang

• Site Settings: RatingStar-Profil-Slug + Embed-Key, pro Site konfigurierbar (Set ratingstar/seal)
• Siegel-Widget — alle Varianten: Banderole, Rundsiegel, Profil-Karte (inline oder schwebend in einer Bildschirmecke), Bewertungsleiste, Gesamtnote, Zitat, Karussell, Bewertungswand, Fußleiste — als Content-Element und als Fluid-ViewHelper <rs:seal>; Bewertungsleiste, Gesamtnote, Zitat, Karussell und Bewertungswand wahlweise hell oder dunkel (Feld „Darstellung", Attribut data-theme)
• Per-Embed-Optik: alle von seal.js unterstützten Optionen (EMBED_OVERRIDES) direkt im Content-Element — je Variante ein eigener Formular-Tab (Größe, Breite, Kartenfarbe, Anzahl, Rotation, Sortierung, Fußleisten-Farben, Bewertungs-Filter …). Jedes Feld steht auf „Standard (aus Dashboard)" und wird nur ausgegeben, wenn es bewusst gesetzt ist — die zentrale Konfiguration bleibt führend. Dieselbe Variante kann so mehrfach pro Seite mit unterschiedlichen Einstellungen eingebunden werden. Für Experten bzw. künftige Optionen gibt es zusätzlich das Passthrough-Feld „Weitere data-Attribute" (Attribut-String aus dem Dashboard-Generator, überschreibt gleichnamige Feld-Einstellungen); im ViewHelper entsprechend overrides="{…}" und dataAttributes="…". Ungültige Werte ignoriert seal.js automatisch.
• Google-Sterne: serverseitiges JSON-LD (LocalBusiness + AggregateRating) über den offiziellen key-basierten RatingStar-Endpunkt — site-weit per Middleware oder gezielt als Content-Element/ViewHelper <rs:jsonLd> (mit großem L); genau ein JSON-LD-Block pro Seite

Beispiele:

<rs:seal variant="seal-circle"/>
<rs:seal variant="profile-card" position="bottom-right"/>
<rs:seal variant="carousel" dataAttributes="data-car-count=&quot;4&quot; data-car-width=&quot;s&quot;"/>

Installation

composer require ratingstar/typo3-seal
vendor/bin/typo3 extension:setup

Datenbank-Schema aktualisieren (Pflicht): extension:setup legt die Cache-Tabellen cache_ratingstar_seal und cache_ratingstar_seal_tags an, in denen die Extension die Google-Sterne (JSON-LD) zwischenspeichert. Ohne Kommandozeile geht dasselbe im Backend-Modul Maintenance über „Analyze Database Structure" (TYPO3 13: Admin Tools → Maintenance, TYPO3 14: System → Maintenance). Fehlen die Tabellen, gibt die Extension keine Google-Sterne aus und schreibt bei jedem Seitenaufruf einen Fehler ins TYPO3-Log; die Siegel-Widgets funktionieren trotzdem.

Danach zwei Schritte je Site:

1. Set ratingstar/seal als Abhängigkeit der Site eintragen (Pflicht). Ohne das Set rendern die Content-Elemente nicht. Im Backend unter Site Management → Sites die Site bearbeiten und bei „Sets for this Site" das Set „RatingStar Seal" hinzufügen — oder in config/sites/<site>/config.yaml:

   dependencies:
     - ratingstar/seal

2. Profil-Slug und Embed-Key der Filiale in den Site Settings hinterlegen (Site Management → Settings, Kategorie „RatingStar Seal") — oder in config/sites/<site>/settings.yaml:

   ratingstar:
     slug: meine-filiale
     key: <Embed-Key aus dem RatingStar-Dashboard>

Anforderungen

• TYPO3 13.4 LTS oder 14
• PHP 8.2+

Lizenz

GPL-2.0-or-later