Zum Hauptinhalt springen
In diesem Abschnitt werden die verfügbaren Aktionen im Bereich Produktbewertungen beschrieben. Mit diesen Aktionen können Bewertungen erstellt, bearbeitet und gelöscht werden.

​
Aktionen im Überblick

AktionBeschreibung
ProductRatingAddErstellt eine neue Produktbewertung.
ProductRatingUpdateBearbeitet eine bestehende Produktbewertung.
ProductRatingDeleteLöscht eine bestehende Produktbewertung.

​
Aktionen

​
ProductRatingAdd

Mit dieser Aktion wird eine neue Bewertung für ein Produkt erstellt. Der Kunde muss dafür eingeloggt sein. Anwendungsbeispiel
Nutzbar auf der Produktdetailseite oder in der Bestellhistorie, um eingeloggten Kunden die Möglichkeit zu geben, ein gekauftes Produkt zu bewerten. Parameter
NameBeschreibung
productIdDie ID des Produkts, das bewertet werden soll.
orderIdDie ID der Bestellung, zu der die Bewertung gehört.
pointsDie Bewertung in Punkten (z.B. 1-5 Sterne).
subjectDer Titel der Bewertung.
descriptionDer Bewertungstext.
anonymousGibt an, ob die Bewertung anonym abgegeben werden soll.
Fehlercodes
FehlercodeBeschreibung
notLoggedInDer Benutzer ist nicht eingeloggt.
missingProductIdParameter productId fehlt.
missingOrderIdParameter orderId fehlt.
missingPointsParameter points fehlt.
ratingAlreadyExistsFür dieses Produkt und diese Bestellung existiert bereits eine Bewertung.
Zugehörige Module, Variablen & Methoden Beispiel das zeigt, wie ein eingeloggter Kunde ein Produkt mit Sternebewertung, Titel und Kommentar bewerten kann, inklusive Erfolgsausgabe. 
{{ var $myActionProductRatingAdd = $wsActions.create("ProductRatingAdd") }}
<form method="post" action="{{= $wsViews.current.url() }}">
    <input type="hidden" name="wscsrf" value="{{= $myActionProductRatingAdd.csrf }}">
    <input type="hidden" name="wsact" value="{{= $myActionProductRatingAdd.id }}">
    <input type="hidden" name="productId" value="{{= $myProduct.id }}">
    <input type="hidden" name="orderId" value="{{= $myOrderId }}">
    <input type="hidden" name="points" value="{{= $myActionProductRatingAdd.fields.points | ifNull(1) }}">
    <input type="text" name="subject">
    <textarea name="description"></textarea>
    <button type="submit">Bewertung abgeben.</button>
</form>

​
ProductRatingUpdate

Mit dieser Aktion wird eine bestehende Produktbewertung des eingeloggten Kunden bearbeitet. Anwendungsbeispiel
Nutzbar auf der Produktdetailseite oder im Kundenkonto, wenn ein Kunde seine abgegebene Bewertung nachträglich anpassen möchte. Parameter
NameBeschreibung
productIdDie ID des Produkts, dessen Bewertung bearbeitet werden soll.
orderIdDie ID der Bestellung, zu der die Bewertung gehört.
pointsDie neue Bewertung in Punkten.
subjectDer neue Titel der Bewertung.
descriptionDer neue Bewertungstext.
anonymousGibt an, ob die Bewertung anonym abgegeben werden soll.
Fehlercodes
FehlercodeBeschreibung
notLoggedInDer Benutzer ist nicht eingeloggt.
missingProductIdParameter productId fehlt.
missingOrderIdParameter orderId fehlt.
invalidRatingDie Bewertung existiert nicht oder gehört nicht zu diesem Kundenkonto.
Zugehörige Module, Variablen & Methoden Beispiel das zeigt, wie ein Kunde eine bestehende Bewertung bearbeiten kann, mit vorausgefüllten Feldern. 
{{ var $myActionProductRatingUpdate = $wsActions.create("ProductRatingUpdate") }}
{{ var $myRating = $wsProductRating.loadSingleRating($myProduct, $myOrderId) }}
<form method="post" action="{{= $wsViews.current.url() }}">
    <input type="hidden" name="wscsrf" value="{{= $myActionProductRatingUpdate.csrf }}">
    <input type="hidden" name="wsact" value="{{= $myActionProductRatingUpdate.id }}">
    <input type="hidden" name="productId" value="{{= $myProduct }}">
    <input type="hidden" name="orderId" value="{{= $myOrderId }}">
    <input type="hidden" name="points" value="{{= $myRating.points | ifNull(1) }}">
    <input type="text" name="subject" value="{{= $myRating.subject | ifNull('') }}">
    <textarea name="description">{{= $myRating.description | ifNull('') }}</textarea>
    <button type="submit">Bewertung aktualisieren.</button>
</form>

​
ProductRatingDelete

Mit dieser Aktion wird eine bestehende Produktbewertung des eingeloggten Kunden gelöscht. Anwendungsbeispiel
Nutzbar auf der Produktdetailseite oder im Kundenkonto, wenn ein Kunde seine abgegebene Bewertung entfernen möchte. Parameter
NameBeschreibung
productIdDie ID des Produkts, dessen Bewertung gelöscht werden soll.
orderIdDie ID der Bestellung, zu der die Bewertung gehört.
Fehlercodes
FehlercodeBeschreibung
notLoggedInDer Benutzer ist nicht eingeloggt.
missingProductIdParameter productId fehlt.
missingOrderIdParameter orderId fehlt.
invalidRatingDie Bewertung existiert nicht oder gehört nicht zu diesem Kundenkonto.
Zugehörige Module, Variablen & Methoden Beispiel das zeigt, wie eine Bewertung über einen Button gelöscht wird. 
{{ var $myActionProductRatingDelete = $wsActions.create("ProductRatingDelete") }}
<form method="post" action="{{= $wsViews.current.url() }}">
    <input type="hidden" name="wscsrf" value="{{= $myActionProductRatingDelete.csrf }}">
    <input type="hidden" name="wsact" value="{{= $myActionProductRatingDelete.id }}">
    <input type="hidden" name="productId" value="{{= $myProduct.id }}">
    <input type="hidden" name="orderId" value="{{= $myOrderId }}">
    <button type="submit">Bewertung löschen.</button>
</form>