[FÜR PLUGINENTWICKLER] Eigene Warenkorbpositionen als Einmalposition kennzeichnen

Geändert am Mi, 15 Apr um 2:03 NACHMITTAGS

INHALTSVERZEICHNIS

1. Anzahl der Ausführungen von Warenkorbpositionen steuern


1.1 Standardverhalten


Im Standardverhalten führt abocloud alle Warenkorbpositionen wiederkehrend aus. Das heißt, wenn dein Plugin eine Position im Warenkorb hinzufügt, wird diese auch in allen folgenden Bestellungen enthalten sein. 


Für bestimmte Anwendungsfälle (zB. Treuepunkte, Einmalrabatt, etc.) kann das ungewollt sein. 

Ab Pluginversion 1.9.0 ist es möglich Positionen entsprechend zu markieren.


1.2 Markierung von Warenkorbpositionen


Über eine Anpassung einer Sessionvariable können andere Plugins steuern, welche Warenkorbpositionen im Abo wiederkehrend sind oder nur X-mal abgerechnet werden.


Um deine Warenkorbposition entsprechend zu markieren musst du in der Session folgenden Eintrag schreiben:


$_SESSION['ws5_abocloud_remaining_executions'][$INDEX] = [
             'remainingExecutions' => 1,   // -1 = wiederkehrend, >= 1 = nach n Ausführungen entfernen
             'pluginId' => 'mein_treuepunkteplugin',
];

Hierbei gilt folgendes:


- $INDEX: Hier den Index (Position) deiner Warenkorbposition im Warenkorb angegeben. (Also zB. 0)

- remainingExecutions: -  -1 = wiederkehrend, >= 1 = nach n Ausführungen entfernen

- pluginId: Name deines Plugins zu Identifiktation


Beachte bitte auch, dass du diese Informationen in die Session schreiben solltest, bevor der Kunde "Zahlungspflichtig bestellen" drückt. Um alles andere kümmert sich das Plugin.


Die Sessionvariable wird nach erfolgreichem Kauf vom abocloud-Plugin selbst wieder unsettet.


Tags: