Installatie en configuratie van de module Kowal Outlet Products
- Composer-pakket:
kowal/module-outletproducts - Magento-module:
Kowal_OutletProducts - Vereist applicatietype: Magento 2
- Pakketafhankelijkheid:
kowal/base - CLI-opdracht van de module:
bin/magento kowal_outletproducts:generate
Installatie via Composer
Voeg de repository van de module toe:
De toegangsgegevens voor de Composer-repository, het e-mailadres van de klant en de licentietoken, ontvang je na aankoop per e-mail. Ze zijn ook beschikbaar in het klantpaneel na inloggen op kowal.store. Vervang TWOJ_EMAIL_KLIENTA door het e-mailadres van je account en TWOJ_TOKEN door de ontvangen token. Voer de opdrachten uit in de hoofdmap van Magento.
composer config repositories.kowal composer https://repo.kowal.store
Als de repository privé is, configureer dan de toegangstoken:
composer config http-basic.repo.kowal.store 'TWOJ_EMAIL_KLIENTA' 'TWOJ_TOKEN'
Installeer de module:
composer require kowal/module-outletproducts
Schakel de module in:
php bin/magento module:enable Kowal_OutletProducts
Voer de database-update uit:
php bin/magento setup:upgrade
Start in een productieomgeving de DI-compilatie en de deployment van statische resources volgens het deploymentproces van de shop:
php bin/magento setup:di:compilephp bin/magento setup:static-content:deploy
Leeg de cache:
php bin/magento cache:flush
Update van een bestaande installatie
Voer na het updaten van de module het volgende uit:
composer update kowal/module-outletproductsphp bin/magento setup:upgradephp bin/magento cache:flush
Als de shop in production mode draait, voer dan ook de standaard deploymentstappen uit:
php bin/magento setup:di:compilephp bin/magento setup:static-content:deploy
setup:upgrade is vereist, omdat de module productattributen toevoegt en bijwerkt die worden gebruikt voor de afhandeling van OUTLET en kopieën van speciale prijzen.
Productattributen
De module voegt de volgende attributen toe of gebruikt deze:
| Attribuut | Betekenis |
|---|
sale | Markeert het product als OUTLET. |
special_price_copy | Kopie van de waarde special_price voordat het product naar OUTLET gaat. |
special_from_date_copy | Kopie van de datum special_from_date. |
special_to_date_copy | Kopie van de datum special_to_date. |
special_price_copy_active | Marker die aangeeft dat de kopie van de speciale prijs is gemaakt. |
Configuratie in het beheerpaneel
Ga naar:
Stores > Configuration > kowal > OUTLET Products
Beschikbare opties:
| Optie | Beschrijving |
|---|
Włącz moduł Outlet | Schakelt de werking van de module in of uit. |
Usuń ceny specjalne dla produktów po wyprzedaży | Bepaalt of de speciale prijs na afloop van OUTLET moet worden gewist. Als de optie is uitgeschakeld, herstelt de module de prijs vanuit de kopie. |
Kategorie outletowe | Lijst met categorieën waaraan OUTLET-producten worden toegewezen en waaruit ze later automatisch worden verwijderd. |
Wyłącz zarządzanie stanem magazynowym po wyprzedaży | Maakt het mogelijk om manage_stock uit te schakelen na afloop van de uitverkoop. |
Włącz backorder po zakończeniu wyprzedaży outletowej | Maakt het mogelijk om backorder in te schakelen en het product als beschikbaar te markeren na afloop van de outletverkoop. |
De configuratie is beschikbaar op default-, website- en store-niveau. OUTLET-categorieën die door cron worden gebruikt, worden opgehaald uit de standaardconfiguratie.
Configuratie van OUTLET-categorieën
- Maak in Magento een categorie of categorieën aan die bestemd zijn voor de outlet.
- Zorg ervoor dat de categorieën actief en zichtbaar zijn in het menu of de listing, als ze beschikbaar moeten zijn voor klanten.
- Selecteer in de moduleconfiguratie alle outletcategorieën in het veld
Kategorie outletowe. - Sla de configuratie op.
- Leeg de Magento-cache.
php bin/magento cache:flush
Producten importeren naar OUTLET
Ga naar het paneel:
kowal > Upload Outlet Products
In het formulier:
- Plak de lijst met SKU's, één SKU per regel.
- Selecteer de OUTLET-categorieën.
- Selecteer optioneel de websites waaraan het product moet worden toegewezen.
- Kies of de module voorraadbeheer moet inschakelen voor de geïmporteerde producten.
- Klik op
Importuj.
Voorbeeldlijst met SKU's:
TSHIRT-BLACK-MTSHIRT-BLACK-LJACKET-NAVY-XLSHOES-WHITE-42
Tijdens de import voert de module het volgende uit:
- wijst producten toe aan OUTLET-categorieën,
- stelt het attribuut
sale in, - werkt configurable parents bij,
- maakt een kopie van de speciale prijs en promotiedatums,
- werkt de stock bij volgens de geselecteerde optie,
- ververst indexen en cache van producten en categorieën.
Ondersteuning voor configureerbare producten
Als het geïmporteerde product een variant van een configureerbaar product is, zoekt de module de parent op en wijst deze toe aan de OUTLET-categorie. Hierdoor verschijnt het configureerbare product in de categorielisting en kan de klant de outletvariant selecteren.
Tijdens de periodieke herberekening controleert de module of de parent nog actieve OUTLET-varianten heeft. Zo niet, dan wordt de parent losgekoppeld van de OUTLET-categorie.
Afhandeling van speciale prijzen
Bij import naar OUTLET slaat de module een kopie op van:
special_price,special_from_date,special_to_date.
De kopie wordt opgeslagen volgens de scope van het attribuut voor de speciale prijs in Magento:
- voor globale prijzen: op globaal niveau,
- voor prijzen per website: op het niveau van de standaard-store view van elke website,
- voor prijzen per store: op store view-niveau.
De module rekent geen valuta om. Magento slaat prijzen op als basiswaarden voor de juiste scope, terwijl de valutapresentatie op de frontend wordt afgehandeld door de standaardmechanismen van Magento.
Het gedrag na afloop van OUTLET hangt af van de optie Usuń ceny specjalne dla produktów po wyprzedaży:
Tak: de module wist de speciale prijs en verwijdert de technische kopie,Nie: de module herstelt de speciale prijs en datums vanuit de kopie en verwijdert daarna de technische kopie.
Cron
De module heeft een cron-taak:
kowal_outletproducts_outlet
De taak start de OUTLET-helper en controleert periodiek outletproducten. Cron verwijdert producten uit OUTLET-categorieën wanneer ze daar niet meer zichtbaar zouden moeten zijn en ververst de indexen en cache.
Controleer na de installatie of Magento cron correct werkt:
php bin/magento cron:run
In een productieomgeving moet cron worden uitgevoerd vanuit de systeemcrontab van de Magento-applicatiegebruiker.
Herberekening handmatig starten
De herberekening kan handmatig via CLI worden gestart:
php bin/magento kowal_outletproducts:generate
De opdracht voert hetzelfde proces uit als het proces dat door cron wordt gestart.
Indexen en cache
Na wijzigingen ververst de module de belangrijkste product- en catalogusindexen:
catalog_product_price,catalog_product_category,catalogsearch_fulltext,inventory,cataloginventory_stock.
De module wist ook de cachetags van producten en OUTLET-categorieën, waardoor de categorielisting na een statuswijziging of loskoppeling van een product zou moeten worden bijgewerkt.
Indien nodig kan een volledige herindexering worden afgedwongen:
php bin/magento indexer:reindexphp bin/magento cache:flush
Test na deployment
Aanbevolen functionele test:
- Selecteer een simple product met voorraad.
- Stel een speciale prijs en promotiedatums in.
- Voeg het product toe aan OUTLET via het importpaneel.
- Controleer of het product in de OUTLET-categorie is verschenen.
- Controleer of het attribuut
sale de waarde Tak heeft. - Controleer bij een configureerbaar product of de parent in OUTLET is verschenen.
- Wijzig de productstatus zodat het product niet salable is.
- Start cron of de CLI-opdracht.
- Controleer of het product uit de OUTLET-categorie is verwijderd.
- Controleer of de speciale prijs is hersteld of verwijderd volgens de configuratie.
Meest voorkomende problemen
Het product is nog steeds zichtbaar in OUTLET
Controleer:
- of Magento cron werkt,
- of het product nog steeds
sale = 1 heeft, - of het product is toegewezen aan een van de categorieën die als OUTLET zijn geconfigureerd,
- of de indexen en cache zijn ververst.
Hulpcommando's:
php bin/magento cron:runphp bin/magento indexer:reindexphp bin/magento cache:flush
Parent configurable staat nog steeds in OUTLET
Controleer of een van de productvarianten nog steeds sale = 1 heeft. De parent blijft in OUTLET zolang deze een actieve outletvariant heeft.
De speciale prijs is niet hersteld
Controleer:
- of het product eerder aan OUTLET is toegevoegd na de installatie van de kopie-attributen,
- of het attribuut
special_price_copy_active was ingesteld, - of de configuratie
Usuń ceny specjalne dla produktów po wyprzedaży is ingesteld op Nie, - welke prijsscope in Magento is ingesteld.
Prijzen verschillen tussen store views
Controleer de configuratie van de prijsscope in Magento. De module rekent geen valuta om en synchroniseert geen prijzen tussen store views. De module herstelt de waarden die voor de juiste prijsscope zijn opgeslagen.
De-installatie
Als de module moet worden uitgeschakeld:
php bin/magento module:disable Kowal_OutletProductsphp bin/magento setup:upgradephp bin/magento cache:flush
Het Composer-pakket verwijderen:
composer remove kowal/module-outletproductsphp bin/magento setup:upgradephp bin/magento cache:flush
Voordat de module wordt verwijderd, wordt aanbevolen te controleren of producten niet handmatig moeten worden opgeschoond van het attribuut sale of losgekoppeld van de OUTLET-categorie.
