Download the PHP package c4y/reviews without Composer

On this page you can find all versions of the php package c4y/reviews. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Informations about the package reviews

Contao4you reviews Bundle

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

Features

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.

Formular

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->sendLink(...) oder per API (siehe weiter unten)

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

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

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

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

Senden per API

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

All versions of reviews with dependencies

PHP Build Version
Package Version
Requires php Version ^7.4 || ^8.0
contao/core-bundle Version ^4.13
codefog/contao-haste Version ^5.0
terminal42/notification_center Version ^1.5
ext-json Version *
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package c4y/reviews contains the following files

Loading the files please wait ....