Modul AboProdukte¶

Mit dem Modul „AboProdukte“ verkaufen Sie Produkte mit begrenzter Laufzeit (Abonnements). Bei Ablauf oder einige Tage vorher kann das Abo automatisch verlängert werden, oder der Kunde erhält eine E-Mail mit der Möglichkeit zur Verlängerung.

Einrichten¶

Öffnen Sie wpShopGermany → Konfiguration → Module und aktivieren Sie das Modul AboProdukte. Die Einstellungen im Modul gelten für alle Aboprodukte. Im einzelnen Produkt können Sie sie überschreiben (siehe Aboprodukt anlegen).

Allgemein¶

Einstellung	Beschreibung
Standard URL für Ablauf/Verlängerung	Diese Adresse wird bei Kauf, Verlängerung und Ablauf eines Abos aufgerufen (siehe URL-Benachrichtigung).
Mail bei erstem Kauf eines Abos	Zusätzliche E-Mail an den Kunden, sobald die Abo-Bestellung bezahlt ist (Vorlage `mail_firstbuy.phtml`).
Mail bei Kauf einer Verlängerung	E-Mail an den Kunden, sobald eine Verlängerung bezahlt ist (Vorlage `mail_rebuy.phtml`).
Abos pro Seite (Backend)	Anzahl der Abos je Seite in der Aboverwaltung.

Betreff, Absender und weitere Angaben dieser E-Mails legen Sie unter E-Mail-Konfiguration fest. Dort stehen auch die E-Mails „E-Mail bei abgelaufenem Abo“ (Vorlage mail_expiration.phtml), „E-Mail bei Information vor Verlängerung“ und „E-Mail an Admin wenn Abo angehalten werden soll“.

Ablauf und Verlängerung¶

Einstellung	Beschreibung
Bei Ablauf des Abos	Was bei Ablauf passiert: Nichts, Mail versenden (der Kunde erhält die E-Mail zum abgelaufenen Abo mit der Möglichkeit zur Verlängerung) oder Automatisch verlängern.
X - Tage vor Ablauf des Abos	Was einige Tage vor Ablauf passiert: Nichts, Mail versenden oder Automatisch verlängern.
Zeitspanne zum Versenden der Informationsmail in Tagen	Wie viele Tage vor Ablauf „X - Tage vor Ablauf des Abos“ greift.
Zahlungsart für automatische Verlängerung	Zahlungsart der Verlängerungsbestellung, z. B. Wie ursprüngliche Zahlungsart.
Mail an Kunden	Der Kunde erhält bei der automatischen Verlängerung eine Bestellbestätigung.
Mail an Administrator	Der Administrator erhält bei der automatischen Verlängerung eine E-Mail.
Kunde kann im Frontend	Was der Kunde in seinem Kundenkonto tun darf: Nichts, Verlängerung direkt stoppen oder Verlängerung über Mail an Administrator stoppen.

Beispiele¶

Der Kunde wird einige Tage vor Ablauf per E-Mail informiert, bei Ablauf wird das Abo automatisch verlängert. Bei Ablauf erhält er die Bestellbestätigung der Verlängerung.
Das Abo wird einige Tage vor Ablauf automatisch verlängert; der Kunde erhält dann die Bestellbestätigung der Verlängerung. Bei Ablauf erhält er noch einmal eine E-Mail.
Vor Ablauf passiert nichts. Bei Ablauf wird das Abo verlängert und der Kunde erhält die Bestellbestätigung der Verlängerung.

Cronjob¶

Verlängerungen, E-Mails und URL-Benachrichtigungen bei Ablauf werden von einem Cronjob ausgelöst. Rufen Sie dazu die im Modul angezeigte CRON URL regelmäßig automatisch auf (z. B. über einen Cron-Eintrag Ihres Hosters):

https://shop.test/?wpsg_cron=1

Je Aufruf werden höchstens 50 Abos bearbeitet. Mit dem Parameter limit ändern Sie diese Zahl, zum Beispiel:

https://shop.test/?wpsg_cron=1&limit=25

Unter Cron Status zeigt das Modul den letzten Lauf und ob der Cronjob gerade läuft oder wartet. Bleibt ein Lauf nach einem Fehler hängen, beenden Sie ihn mit Zurücksetzen. Der Cronjob startet dann beim nächsten Aufruf neu.

Aboprodukt anlegen¶

Ist das Modul aktiv, erscheint beim Bearbeiten eines Produkts (wpShopGermany → Produktverwaltung) der Bereich Abo Produkt.

Einstellung	Beschreibung
Abo Produkt	Macht das Produkt zum Aboprodukt.
Anzahl der Abo-Verlängerungen beschränken / max. Abo-Verlängerungen	Begrenzt, wie oft das Abo verlängert werden kann.
Abo Preis	Preis einer Verlängerung (Brutto oder Netto, je nach Preiseingabe des Shops).
Abo Dauer (Tage)	Laufzeit des Abos in Tagen.
URL Benachrichtigung	Eigene Benachrichtigungs-URL für dieses Produkt. Leer wird die URL aus der Modulkonfiguration verwendet.
Bei Ablauf des Abos, X - Tage vor Ablauf des Abos, Zeitspanne zum Versenden der Informationsmail in Tagen, Zahlungsart für automatische Verlängerung, Mail an Kunden, Mail an Administrator	Überschreiben die Moduleinstellungen für dieses Produkt. Standard übernimmt die Einstellung des Moduls.

Aboverwaltung im Backend¶

Neben der Bestellverwaltung zeigt wpShopGermany → Aboverwaltung alle Abos. Sie können nach Abostatus filtern (laufend, in Verlängerung, abgelaufen), Abos suchen und löschen. Rot markierte Laufzeiten bedeuten, dass die Verlängerung deaktiviert ist.

Berechtigung

Die Aboverwaltung erfordert die Berechtigung für Abos. Administratoren erhalten sie automatisch; anderen Benutzerrollen weisen Sie sie unter Berechtigungen zu.

Abos im Kundenkonto¶

Mit dem Modul Kundenverwaltung sieht der Kunde seine Abos in seinem Kundenkonto. Wählen Sie dazu in den Einstellungen der Kundenverwaltung eine Abonnementenübersichtsseite.

Je Abo werden angezeigt:

Erstkauf (Startzeitpunkt)
Preis für die Abo-Dauer
Laufzeit (Endzeitpunkt)
automatische Verlängerung (aktiv/inaktiv) mit der Möglichkeit, sie zu deaktivieren

Ob der Kunde die Verlängerung direkt stoppen kann oder dies per E-Mail beim Administrator beantragt, legen Sie mit Kunde kann im Frontend fest.

URL-Benachrichtigung¶

Über die URL-Benachrichtigung ruft der Shop ein externes Skript auf, das weitere Aktionen auslösen kann. Allgemeines dazu steht im Tutorial URL-Benachrichtigung.

Erster Kauf eines Aboprodukts
- $_REQUEST['typ'] steht auf abo_firstbuy
- $_REQUEST['abo_kaufdatum'] ist das Kaufdatum im Format YYYY-MM-DD HH:II:SS
- $_REQUEST['abo_expiration'] ist das Ablaufdatum im Format YYYY-MM-DD HH:II:SS
Ablauf eines Aboprodukts
- $_REQUEST['typ'] steht auf abo_expiration
Verlängerung eines Aboprodukts
- $_REQUEST['typ'] steht auf abo_rebuy
- $_REQUEST['abo_baseOrderID'] ist die ID der ursprünglichen Bestellung, in der das Aboprodukt gekauft wurde
- $_REQUEST['abo_kaufdatum'] ist das Kaufdatum im Format YYYY-MM-DD HH:II:SS
- $_REQUEST['abo_expiration'] ist das Ablaufdatum im Format YYYY-MM-DD HH:II:SS

Außerdem enthält jede Benachrichtigung:

Daten der Bestellung: $_REQUEST['order_{Feldname aus Tabelle wpsg_order}']
Daten des Kunden: $_REQUEST['customer_{Feldname aus Tabelle wpsg_kunden}']
Daten des Produkts: $_REQUEST['product_{Feldname aus Tabelle wpsg_products}']

Ein Beispielskript liegt unter /wp-content/plugins/wpshopgermany-free/mods/mod_abo/demo_notification.php.