Installation und Konfiguration des Moduls Kowal Outlet Products
- Composer-Paket:
kowal/module-outletproducts
- Magento-Modul:
Kowal_OutletProducts
- Erforderlicher Anwendungstyp: Magento 2
- Paketabhängigkeit:
kowal/base
- CLI-Befehl des Moduls:
bin/magento kowal_outletproducts:generate
Installation über Composer
Fügen Sie das Repository des Moduls hinzu:
Die Zugangsdaten für das Composer-Repository, also die E-Mail-Adresse des Kunden und das Lizenz-Token, erhalten Sie nach dem Kauf per E-Mail. Sie sind nach der Anmeldung auf kowal.storeauch im Kundenbereich verfügbar. Ersetzen Sie TWOJ_EMAIL_KLIENTA durch die E-Mail-Adresse Ihres Kontos und TWOJ_TOKEN durch das erhaltene Token. Führen Sie die Befehle im Magento-Hauptverzeichnis aus.
composer config repositories.kowal composer https://repo.kowal.store
Wenn das Repository privat ist, konfigurieren Sie das Zugriffstoken:
composer config http-basic.repo.kowal.store "TWOJ_EMAIL_KLIENTA" "TWOJ_TOKEN"
Installieren Sie das Modul:
composer require kowal/module-outletproducts
Aktivieren Sie das Modul:
php bin/magento module:enable Kowal_OutletProducts
Aktualisieren Sie die Datenbank:
php bin/magento setup:upgrade
Führen Sie in der Produktionsumgebung die DI-Kompilierung und die Bereitstellung statischer Ressourcen gemäß dem Bereitstellungsprozess des Shops aus:
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy
Leeren Sie den Cache:
php bin/magento cache:flush
Aktualisierung einer bestehenden Installation
Führen Sie nach der Aktualisierung des Moduls folgende Befehle aus:
composer update kowal/module-outletproducts
php bin/magento setup:upgrade
php bin/magento cache:flush
Wenn der Shop im Production Mode betrieben wird, führen Sie auch die standardmäßigen Bereitstellungsschritte aus:
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy
setup:upgradeist erforderlich, da das Modul Produktattribute hinzufügt und aktualisiert, die zur Verwaltung des OUTLET-Bereichs und der Kopien von Sonderpreisen verwendet werden.
Produktattribute
Das Modul fügt die folgenden Attribute hinzu oder verwendet sie:
| Attribut |
Bedeutung |
sale |
Kennzeichnet das Produkt als OUTLET. |
special_price_copy |
Kopie des Wertsspecial_pricevor der Aufnahme des Produkts in den OUTLET-Bereich. |
special_from_date_copy |
Kopie des Datumsspecial_from_date. |
special_to_date_copy |
Kopie des Datumsspecial_to_date. |
special_price_copy_active |
Marker, der angibt, dass eine Kopie des Sonderpreises erstellt wurde. |
Konfiguration im Admin-Panel
Navigieren Sie zu:
Stores > Configuration > kowal > OUTLET Products
Verfügbare Optionen:
| Option |
Beschreibung |
Włącz moduł Outlet |
Aktiviert oder deaktiviert das Modul. |
Usuń ceny specjalne dla produktów po wyprzedaży |
Legt fest, ob der Sonderpreis nach Ende des OUTLET-Zyklus gelöscht werden soll. Wenn die Option deaktiviert ist, stellt das Modul den Preis aus der Kopie wieder her. |
Kategorie outletowe |
Liste der Kategorien, denen OUTLET-Produkte zugewiesen und aus denen sie später automatisch entfernt werden. |
Wyłącz zarządzanie stanem magazynowym po wyprzedaży |
Ermöglicht die Deaktivierung vonmanage_stocknach Ende des Abverkaufs. |
Włącz backorder po zakończeniu wyprzedaży outletowej |
Ermöglicht die Aktivierung von Backorders und die Kennzeichnung des Produkts als verfügbar, nachdem der Outlet-Verkauf beendet wurde. |
Die Konfiguration ist auf Default-, Website- und Store-Ebene verfügbar. Die vom Cron-Job verwendeten OUTLET-Kategorien werden aus der Standardkonfiguration abgerufen.
Konfiguration der OUTLET-Kategorien
- Erstellen Sie in Magento eine oder mehrere Kategorien für den Outlet-Bereich.
- Stellen Sie sicher, dass die Kategorien aktiv und im Menü oder in der Produktliste sichtbar sind, wenn sie für Kunden zugänglich sein sollen.
- Wählen Sie in der Modulkonfiguration im Feld
Kategorie outletowe.
- Speichern Sie die Konfiguration.
- Leeren Sie den Magento-Cache.
php bin/magento cache:flush
Import von Produkten in den OUTLET-Bereich
Öffnen Sie das Panel:
kowal > Upload Outlet Products
Im Formular:
- Fügen Sie die SKU-Liste ein, jeweils eine SKU pro Zeile.
- Wählen Sie die OUTLET-Kategorien aus.
- Wählen Sie optional die Websites aus, denen das Produkt zugeordnet werden soll.
- Legen Sie fest, ob das Modul die Lagerbestandsverwaltung für die importierten Produkte aktivieren soll.
- Klicken Sie auf
Importuj.
Beispiel für eine SKU-Liste:
TSHIRT-BLACK-M
TSHIRT-BLACK-L
JACKET-NAVY-XL
SHOES-WHITE-42
Während des Imports führt das Modul folgende Schritte aus:
- Es ordnet die Produkte den OUTLET-Kategorien zu,
- setzt das Attribut
sale,
- aktualisiert die übergeordneten konfigurierbaren Produkte,
- erstellt eine Kopie des Sonderpreises und der Aktionszeiträume,
- aktualisiert den Lagerbestand entsprechend der gewählten Option,
- aktualisiert die Produkt- und Kategorieindizes sowie den Cache.
Verwaltung konfigurierbarer Produkte
Wenn das importierte Produkt eine Variante eines konfigurierbaren Produkts ist, sucht das Modul nach dem übergeordneten Produkt und ordnet es der Kategorie OUTLET zu. Dadurch erscheint das konfigurierbare Produkt in der Kategorieliste und der Kunde kann die Outlet-Variante auswählen.
Bei der regelmäßigen Neuberechnung prüft das Modul, ob das übergeordnete Produkt noch aktive OUTLET-Varianten besitzt. Ist dies nicht der Fall, wird das übergeordnete Produkt aus der Kategorie OUTLET entfernt.
Verwaltung von Sonderpreisen
Beim Import in den OUTLET-Bereich speichert das Modul eine Kopie der folgenden Werte:
special_price,special_from_date,special_to_date.
Die Kopie wird entsprechend dem Scope des Sonderpreisattributs in Magento gespeichert:
- bei globalen Preisen: auf globaler Ebene,
- bei Preisen pro Website: auf Ebene des standardmäßigen Store Views jeder Website,
- bei Preisen pro Store: auf Store-View-Ebene.
Das Modul rechnet keine Währungen um. Magento speichert Preise als Basiswerte für den jeweiligen Scope, während die Darstellung der Währungen im Frontend weiterhin von den standardmäßigen Magento-Mechanismen übernommen wird.
Das Verhalten nach Ende des OUTLET-Zyklus hängt von der OptionUsuń ceny specjalne dla produktów po wyprzedażyab:
Tak: Das Modul löscht den Sonderpreis und entfernt die technische Kopie,Nie: Das Modul stellt den Sonderpreis und die Datumswerte aus der Kopie wieder her und entfernt anschließend die technische Kopie.
Cron
Das Modul verfügt über den folgenden Cron-Job:
kowal_outletproducts_outlet
Der Job startet den OUTLET-Helper und prüft regelmäßig die Outlet-Produkte. Der Cron-Job entfernt Produkte aus den OUTLET-Kategorien, wenn sie dort nicht mehr sichtbar sein sollen, und aktualisiert Indizes sowie Cache.
Stellen Sie nach der Installation sicher, dass der Magento-Cron korrekt ausgeführt wird:
php bin/magento cron:run
In der Produktionsumgebung sollte der Cron-Job über die systemweite Crontab des Magento-Anwendungsbenutzers ausgeführt werden.
Manueller Start der Neuberechnung
Die Neuberechnung kann manuell über die CLI gestartet werden:
php bin/magento kowal_outletproducts:generate
Der Befehl führt denselben Prozess aus, der vom Cron-Job gestartet wird.
Indizes und Cache
Nach Änderungen aktualisiert das Modul die wichtigsten Produkt- und Katalogindizes:
catalog_product_price,catalog_product_category,catalogsearch_fulltext,inventory,cataloginventory_stock.
Das Modul leert außerdem den Cache der Tags von Produkten und OUTLET-Kategorien, sodass die Kategorieliste nach einer Statusänderung oder dem Entfernen eines Produkts aktualisiert werden sollte.
Bei Bedarf kann eine vollständige Neuindizierung erzwungen werden:
php bin/magento indexer:reindex
php bin/magento cache:flush
Test nach der Implementierung
Empfohlener Funktionstest:
- Wählen Sie ein einfaches Produkt mit Lagerbestand aus.
- Legen Sie einen Sonderpreis und Aktionszeiträume fest.
- Fügen Sie das Produkt über das Import-Panel zum OUTLET-Bereich hinzu.
- Prüfen Sie, ob das Produkt in der Kategorie OUTLET angezeigt wird.
- Prüfen Sie, ob das Attribut
saleden WertTak.
- Prüfen Sie bei einem konfigurierbaren Produkt, ob das übergeordnete Produkt im OUTLET-Bereich angezeigt wird.
- Ändern Sie den Produktbestand so, dass das Produkt nicht mehr verkaufsfähig ist.
- Starten Sie den Cron-Job oder den CLI-Befehl.
- Prüfen Sie, ob das Produkt aus der Kategorie OUTLET entfernt wurde.
- Prüfen Sie, ob der Sonderpreis gemäß der Konfiguration wiederhergestellt oder gelöscht wurde.
Häufige Probleme
Das Produkt ist weiterhin im OUTLET-Bereich sichtbar
Prüfen Sie:
- ob der Magento-Cron ausgeführt wird,
- ob das Produkt weiterhin
sale = 1,
- ob das Produkt einer der als OUTLET konfigurierten Kategorien zugeordnet ist,
- ob Indizes und Cache aktualisiert wurden.
Hilfreiche Befehle:
php bin/magento cron:run
php bin/magento indexer:reindex
php bin/magento cache:flush
Das übergeordnete konfigurierbare Produkt befindet sich weiterhin im OUTLET-Bereich
Prüfen Sie, ob eine Produktvariante weiterhinsale = 1besitzt. Das übergeordnete Produkt verbleibt im OUTLET-Bereich, solange es eine aktive Outlet-Variante besitzt.
Der Sonderpreis wurde nicht wiederhergestellt
Prüfen Sie:
- ob das Produkt nach der Installation der Kopie-Attribute zum OUTLET-Bereich hinzugefügt wurde,
- ob das Attribut
special_price_copy_activegesetzt war,
- ob die Konfiguration
Usuń ceny specjalne dla produktów po wyprzedażyaufNie,
- welcher Preis-Scope in Magento eingestellt ist.
Die Preise unterscheiden sich zwischen den Store Views
Prüfen Sie die Konfiguration des Preis-Scopes in Magento. Das Modul rechnet keine Währungen um und synchronisiert keine Preise zwischen Store Views. Es stellt die für den jeweiligen Preis-Scope gespeicherten Werte wieder her.
Deinstallation
Wenn das Modul deaktiviert werden soll:
php bin/magento module:disable Kowal_OutletProducts
php bin/magento setup:upgrade
php bin/magento cache:flush
Entfernen des Composer-Pakets:
composer remove kowal/module-outletproducts
php bin/magento setup:upgrade
php bin/magento cache:flush
Vor dem Entfernen des Moduls wird empfohlen zu prüfen, ob bei den Produkten das Attributsale manuell bereinigt oder die Zuordnung zu den OUTLET-Kategorien aufgehoben werden muss.
