PHPackages                             c4y/reviews - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. c4y/reviews

ActiveContao-bundle

c4y/reviews
===========

Contao Bundle für Kundenbewertungen

0.0.8(2y ago)1163[1 issues](https://github.com/c4y/reviews/issues)MITPHPPHP ^7.4 || ^8.0CI failing

Since Sep 1Pushed 2y ago1 watchersCompare

[ Source](https://github.com/c4y/reviews)[ Packagist](https://packagist.org/packages/c4y/reviews)[ RSS](/packages/c4y-reviews/feed)WikiDiscussions master Synced today

READMEChangelog (1)Dependencies (10)Versions (9)Used By (0)

Contao4you reviews Bundle
=========================

[](#contao4you-reviews-bundle)

Dieses Contao-Bundle dient zur (automatisierten) Erfassung und Ausgabe von Kundenbewertungen.

Features
--------

[](#features)

- Kategorien/Bewertungen
- Name, Bewertung, Sterne
- Badge mit Logo, Anzahl der Bewertungen und der durchschnittlichen Bewertung, z.B. 4,5/5 sowie Darstellung mit Sternen
- Liste mit allen Bewertungen
- Ein Service, mit dem automatisiert Einladungen mittels Notification\_Center zu einer Bewertung verschickt werden können (z.B. nach einem Kauf im Shop)
- Ausgabe eines RichSnippets

### Badge

[](#badge)

Die Bewertungen werden mit einem Badge dargestellt. Das Badge wird typischerweise auf der Seite an einer fixen Stelle angezeigt mit einem Logo, der durchschnittlichen Sterne-Bewertung und der Anzahl der Kundenbewertungen. Mit Klick auf das Badge wird eine Liste mit x Bewertungen (einstellbar) angezeigt sowie einem Link zur Seite mit allen Bewertungen.

Das Badge kann weggeklickt werden. Das wird als Session-Cookie gespeichert. Sobald der Browser geschlossen und neu geöffnet wird, erscheint das Badge erneut.

[![](docs/images/badge.jpg)](docs/images/badge.jpg)

[![](docs/images/badge_liste.jpg)](docs/images/badge_liste.jpg)

Formular
--------

[](#formular)

[![](docs/images/formular.jpg)](docs/images/formular.jpg)

Einladung
---------

[](#einladung)

Um eine Bewertung abgeben zu können, muss der "Kunde" eingeladen werden. Hierbei wird ein Token generiert, womit der Kunde eine einmalige Bewertung abgeben kann. Die Einladung kann mit dem Formular verschickt werden oder automatisiert per ReviewsService-&gt;sendLink(...) oder per API (siehe weiter unten)

[![](docs/images/link_verschicken.jpg)](docs/images/link_verschicken.jpg)

Kategorien
----------

[](#kategorien)

Die Bewertungen werden je Kategorie erfasst. In einer Multi-Domain Installation können dies z.B. verschiedene Webseiten sein - so dass für jede Webseite (Seitenbaum) verschiedene Bewertungen erfasst werden können.

Die Bewertungen müssen nach erfolgreicher Abgabe erst vom Admin aktiviert werden und können hier auch (im Backend) kommentiert werden.

Installieren
------------

[](#installieren)

1. Im Contao-Manager nach c4y/reviews suchen und installieren:
2. oder auf der Konsole composer require c4y/reviews

Einrichtung
-----------

[](#einrichtung)

1. Im Notification Center einen Gateway einrichten (falls noch nicht vorhanden)
2. Im Notification Center zwei Benachrichtungungen anlegen. Einmal vom Typ "Bewertungslink". Diese E-Mail wird an den Besucher/Kunden verschickt. Als Empfänger kann ##recipient\_email## eingetragen werden. Für den Link zum Bewertungsformular dient das Simpletoken ##link##. Die zweite Benachrichtung ist vom Typ "Bewertung-Admin-Mail". Diese Benachrichtigung wird verschickt, wenn eine Bewertung erfolgreich abgegeben (aber noch nicht veröffentlicht) wurde. Die Benachrichtung kann direkt mit dem Link ##link## freigeschaltet werden. Des weiteren stehen die Token ##user##, ##rating##, ##review## und ##category## zur Verfügung.
3. Die folgenden Seiten werden benötigt
    - Bewertung - Link verschicken (um manuell Einladungen zu verschicken)
    - Bewertung - Formular
    - Bewertung - Liste
    - Bewertung - abgegeben
    - Bewertung - Fehler / ungültiger Token
    - Bewertung - Erfolgreich
4. Eine "Kategorie" unter Inhalte / Bewertungen anlegen
    - die Seite "Bewertung - Formular" auswählen
    - die Benachrichtigungen auswählen
5. Die folgenden Module erstellen
    - Bewertungs-Badge (Weiterleitung zur Seite "Bewertung-Liste", Auswahl der Logos, Angabe wieviele Bewertungen in der Liste erscheinen, die mit Klick auf das Badge eingeblendet werden)
    - Bewertungs-Formular (Weiterleitung zu den angegebenen Seiten bei einem fehlerhaften/abgelaufenen Token bzw. nach erfolgreicher Abgabe einer Bewertung)
    - Bewertungs-Link verschicken (Angabe der angelegten Kategorie)
    - Bewertungs-Liste (Auswahl der Kategorie, Angabe wieviele Elemente pro Seite angezeigt werden sollen)
6. Einbau der Module auf den zuvor angelegten Seiten
7. Einbau des Badge-Moduls im Seitenlayout (am Besten in den Footer)
8. Aktivierung des CSS im Seitenlayout (bei Bedarf bzw. zum Testen)

Senden per Service
------------------

[](#senden-per-service)

1. Hinzufügen des ReviewService per DI
2. Senden einer Einladung per ReviewService-&gt;sendLink($user, $email, $kategorie)
    - der User ist im Klartext derjenige, der bei der Bewertung angezeigt wird

Senden per API
--------------

[](#senden-per-api)

POST Request als JSON. Der API Token muss bei den Bewertungen in der jeweiligen Kategorie angelegt werden.

```
POST /api/reviews/sendlink
{
	"user": "API User",
	"email": "test@test.de",
	"category": 1,
	"apiToken": "ac43a85f-167c-41db-aa7b-7edb51d6a55b"
}

```

###  Health Score

22

—

LowBetter than 22% of packages

Maintenance0

Infrequent updates — may be unmaintained

Popularity12

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity58

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~209 days

Recently: every ~136 days

Total

8

Last Release

977d ago

PHP version history (2 changes)0.0.1PHP ^5.6 || ^7.2

0.0.4PHP ^7.4 || ^8.0

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/808164?v=4)[Oliver Lohoff](/maintainers/c4y)[@c4y](https://github.com/c4y)

---

Top Contributors

[![c4y](https://avatars.githubusercontent.com/u/808164?v=4)](https://github.com/c4y "c4y (2 commits)")

---

Tags

contaoreviewsbewertungen

###  Code Quality

TestsPHPUnit

Code StylePHP CS Fixer

### Embed Badge

![Health badge](/badges/c4y-reviews/health.svg)

```
[![Health](https://phpackages.com/badges/c4y-reviews/health.svg)](https://phpackages.com/packages/c4y-reviews)
```

###  Alternatives

[isotope/isotope-core

Isotope is the premier open source eCommerce solution for Contao Open Source CMS

13959.2k74](/packages/isotope-isotope-core)[codefog/contao-news_categories

News Categories bundle for Contao Open Source CMS

3183.3k6](/packages/codefog-contao-news-categories)[terminal42/contao-node

Node bundle for Contao Open Source CMS

3172.5k4](/packages/terminal42-contao-node)[terminal42/dcawizard

dcaWizard extension for Contao Open Source CMS

10370.7k15](/packages/terminal42-dcawizard)[terminal42/contao-mp_forms

An extension for Contao Open Source CMS to create multi steps forms using the form generator

2633.7k5](/packages/terminal42-contao-mp-forms)[markocupic/calendar-event-booking-bundle

Contao Calendar Event Booking Bundle

125.0k1](/packages/markocupic-calendar-event-booking-bundle)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
