Zum Inhalt

DiscountCodeUrl — Gutscheincode per URL

Extension for Magento 2

Bedienungsanleitung

CopeX GmbH
Web: https://copex.io
Email: office@copex.io

Inhaltsverzeichnis

Abschnitt Seite
1 Voraussetzungen 2
2 Installation 2
3 Konfiguration 2
4 Verwendung 4
5 Fehlerbehandlung 5

1 Voraussetzungen

  • Magento 2.3 oder höher
  • PHP 7.3 oder höher
  • Kompatibel mit Luma- und Hyvä-Themes

2 Installation

Via Composer

composer require copex/module-discount-code-url
php bin/magento module:enable CopeX_DiscountCodeUrl
php bin/magento setup:upgrade
php bin/magento cache:flush

3 Konfiguration

Die Konfiguration des Moduls finden Sie im Magento 2 Backend unter Shops > Konfiguration > Umsatz > Umsatz > Discount URL Einstellungen.

Konfiguration

3.1 Aktivierung

  • Aktiviert — Aktiviert oder deaktiviert das gesamte Modul. Wenn deaktiviert, werden URL-Parameter für Gutscheincodes ignoriert und keine automatischen Gutscheincode-Anwendungen vorgenommen.

3.2 URL-Parameter

  • URL-Parameter — Der Name des Query-String-Parameters, der den Gutscheincode enthält. Standardwert: discount.

Beispiele: - Mit discount (Standard): https://meinshop.at/?discount=MEINCODE - Mit coupon: https://meinshop.at/?coupon=MEINCODE - Mit promo: https://meinshop.at/?promo=MEINCODE

  • Cookie-Lebensdauer — Gibt an, wie lange der Gutscheincode im Browser-Cookie gespeichert bleibt (in Sekunden). Standardwert: 0 (Session-Cookie — bleibt aktiv, bis das Browser-Fenster oder der Tab geschlossen wird). Ein Wert größer als 0 gibt die Anzahl der Sekunden an, z. B. 3600 für eine Stunde oder 86400 für einen Tag.

3.4 Nachrichten

  • Angewendete Meldung — Text, der unterhalb des Produktpreises angezeigt wird, wenn ein Gutscheincode erfolgreich angewendet wurde (z. B. "Gutscheincode MEINCODE wurde angewendet").

  • Countdown anzeigen — Aktiviert einen Countdown-Timer auf der Storefront, der anzeigt, wie lange der Gutscheincode noch gültig ist.

  • Angewendete Meldung (Countdown) — Text, der neben dem Countdown-Timer angezeigt wird.

4 Verwendung

4.1 Gutscheincode per URL übergeben

Fügen Sie den konfigurierten URL-Parameter mit dem gewünschten Gutscheincode an eine beliebige Shop-URL an:

https://meinshop.at/?discount=SOMMERRABATT20
https://meinshop.at/sale?discount=SOMMERRABATT20
https://meinshop.at/neu-produkte.html?discount=SOMMERRABATT20

Beim Aufruf dieser URL passiert Folgendes:

  1. Das Modul liest den discount-Parameter aus der URL.
  2. Der Gutscheincode wird auf Gültigkeit geprüft (existiert, nicht abgelaufen, noch verwendbar).
  3. Bei gültigem Code wird dieser in einem Cookie gespeichert.
  4. Der Code wird automatisch auf den Warenkorb angewendet, sobald der Kunde Artikel hinzufügt oder zur Kasse geht.
  5. Nach abgeschlossenem Kauf wird das Cookie automatisch gelöscht.

4.2 Session-Persistenz

Der Gutscheincode wird in einem Browser-Cookie gespeichert und bleibt über mehrere Seiten hinweg aktiv:

  • Beim Hinzufügen von Artikeln in den Warenkorb wird der Code automatisch angewendet.
  • Beim Aufrufen des Warenkorbs oder der Kasse ist der Code bereits eingetragen.
  • Erst nach einem erfolgreichen Kauf wird das Cookie gelöscht.

Tipp für Marketing-Kampagnen: Erstellen Sie individuelle Links für unterschiedliche Werbekanäle, um die Effektivität der einzelnen Kampagnen nachverfolgen zu können:

https://meinshop.at/?discount=NEWSLETTER20    (für Newsletter)
https://meinshop.at/?discount=SOCIAL15        (für Social Media)
https://meinshop.at/?discount=PARTNER10       (für Partner-Sites)

4.3 Produktseiten-Integration

Auf Produktdetailseiten zeigt das Modul optional einen Rabatthinweis an:

  • Wenn ein gültiger Gutscheincode aktiv ist, wird der rabattierte Preis unterhalb des regulären Preises angezeigt.
  • Die konfigurierte Bestätigungsnachricht wird ebenfalls eingeblendet.

4.4 Prüfung der Gutscheingültigkeit

Vor dem Anwenden wird der Code auf folgende Kriterien geprüft:

  • Gutscheincode existiert in der Datenbank
  • Aktionsregel ist aktiv und nicht abgelaufen
  • Startdatum der Aktion wurde erreicht
  • Verwendungslimit ist nicht erreicht

Wenn einer dieser Prüfpunkte fehlschlägt, wird der Code ohne Fehlermeldung ignoriert.

5 Fehlerbehandlung

  • Gutscheincode wird nicht angewendet — Stellen Sie sicher, dass das Modul aktiviert ist und der URL-Parameter korrekt konfiguriert ist. Prüfen Sie unter Marketing > Aktionen > Warenkorbpreisregeln, ob der Gutscheincode existiert, aktiv ist und noch nicht abgelaufen ist.

  • Code wird nach dem ersten Kauf weiterhin angezeigt — Prüfen Sie, ob der Observer SalesOrderPlaceAfter korrekt registriert ist. Das Cookie sollte nach jedem abgeschlossenen Kauf automatisch gelöscht werden.

  • Code bleibt nach Ablauf noch aktiv — Das Modul prüft die Gültigkeit beim Laden der Seite, aber das Cookie kann noch gespeichert sein. Leeren Sie den Browser-Cache oder warten Sie auf den Cookie-Ablauf.

  • Countdown wird nicht angezeigt — Stellen Sie sicher, dass die Option Countdown anzeigen in der Konfiguration aktiviert ist. Für Hyvä-Themes muss ggf. die Hyvä-Config neu generiert werden.

Lizenz

GPL-3.0 Open Source — CopeX GmbH.