Installazione e configurazione del modulo Kowal Outlet Products
- Pacchetto Composer:
kowal/module-outletproducts - Modulo Magento:
Kowal_OutletProducts - Tipo di applicazione richiesto: Magento 2
- Dipendenza del pacchetto:
kowal/base - Comando CLI del modulo:
bin/magento kowal_outletproducts:generate
Installazione tramite Composer
Aggiungi il repository del modulo:
Riceverai via e-mail, dopo l’acquisto, i dati di accesso al repository Composer, ovvero l’indirizzo e-mail del cliente e il token di licenza. Sono disponibili anche nel pannello cliente dopo l’accesso su kowal.store. Sostituisci TWOJ_EMAIL_KLIENTA con l’indirizzo e-mail del tuo account e TWOJ_TOKEN con il token ricevuto. Esegui i comandi nella directory principale di Magento.
composer config repositories.kowal composer https://repo.kowal.store
Se il repository è privato, configura il token di accesso:
composer config http-basic.repo.kowal.store 'TWOJ_EMAIL_KLIENTA' 'TWOJ_TOKEN'
Installa il modulo:
composer require kowal/module-outletproducts
Abilita il modulo:
php bin/magento module:enable Kowal_OutletProducts
Esegui l’aggiornamento del database:
php bin/magento setup:upgrade
In ambiente di produzione, esegui la compilazione DI e il deploy delle risorse statiche secondo il processo di distribuzione dello store:
php bin/magento setup:di:compilephp bin/magento setup:static-content:deploy
Pulisci la cache:
php bin/magento cache:flush
Aggiornamento di un’installazione esistente
Dopo l’aggiornamento del modulo, esegui:
composer update kowal/module-outletproductsphp bin/magento setup:upgradephp bin/magento cache:flush
Se lo store opera in production mode, esegui anche i passaggi standard di deploy:
php bin/magento setup:di:compilephp bin/magento setup:static-content:deploy
setup:upgrade è richiesto perché il modulo aggiunge e aggiorna gli attributi prodotto utilizzati per gestire OUTLET e le copie dei prezzi speciali.
Attributi prodotto
Il modulo aggiunge o utilizza i seguenti attributi:
| Attributo | Significato |
|---|
sale | Contrassegna il prodotto come OUTLET. |
special_price_copy | Copia del valore special_price prima dell’ingresso del prodotto in OUTLET. |
special_from_date_copy | Copia della data special_from_date. |
special_to_date_copy | Copia della data special_to_date. |
special_price_copy_active | Indicatore che informa che la copia del prezzo speciale è stata eseguita. |
Configurazione nel pannello di amministrazione
Vai a:
Stores > Configuration > kowal > OUTLET Products
Opzioni disponibili:
| Opzione | Descrizione |
|---|
Włącz moduł Outlet | Abilita o disabilita il funzionamento del modulo. |
Usuń ceny specjalne dla produktów po wyprzedaży | Determina se, al termine di OUTLET, il prezzo speciale deve essere cancellato. Se l’opzione è disabilitata, il modulo ripristinerà il prezzo dalla copia. |
Kategorie outletowe | Elenco delle categorie a cui vengono assegnati i prodotti OUTLET e dalle quali vengono successivamente rimossi automaticamente. |
Wyłącz zarządzanie stanem magazynowym po wyprzedaży | Consente di disabilitare manage_stock al termine della vendita promozionale. |
Włącz backorder po zakończeniu wyprzedaży outletowej | Consente di abilitare il backorder e contrassegnare il prodotto come disponibile al termine della vendita outlet. |
La configurazione è disponibile a livello default, website e store. Le categorie OUTLET utilizzate dal cron vengono recuperate dalla configurazione predefinita.
Configurazione delle categorie OUTLET
- Crea in Magento una o più categorie destinate all’outlet.
- Assicurati che le categorie siano attive e visibili nel menu o nel listing, se devono essere accessibili ai clienti.
- Nella configurazione del modulo, seleziona tutte le categorie outlet nel campo
Kategorie outletowe. - Salva la configurazione.
- Pulisci la cache di Magento.
php bin/magento cache:flush
Importazione dei prodotti in OUTLET
Vai al pannello:
kowal > Upload Outlet Products
Nel modulo:
- Incolla l’elenco degli SKU, uno SKU per riga.
- Seleziona le categorie OUTLET.
- Facoltativamente, seleziona i website a cui il prodotto deve essere assegnato.
- Scegli se il modulo deve abilitare la gestione delle scorte per i prodotti importati.
- Fai clic su
Importuj.
Esempio di elenco SKU:
TSHIRT-BLACK-MTSHIRT-BLACK-LJACKET-NAVY-XLSHOES-WHITE-42
Durante l’importazione il modulo:
- assegna i prodotti alle categorie OUTLET,
- imposta l’attributo
sale, - aggiorna i parent configurable,
- crea una copia del prezzo speciale e delle date della promozione,
- aggiorna lo stock in base all’opzione selezionata,
- aggiorna gli indici e la cache di prodotti e categorie.
Gestione dei prodotti configurabili
Se il prodotto importato è una variante di un prodotto configurabile, il modulo cerca il parent e lo assegna alla categoria OUTLET. In questo modo il prodotto configurabile compare nel listing della categoria e il cliente può scegliere la variante outlet.
Durante il ricalcolo ciclico, il modulo verifica se il parent ha ancora varianti OUTLET attive. In caso contrario, il parent viene scollegato dalla categoria OUTLET.
Gestione dei prezzi speciali
Durante l’importazione in OUTLET, il modulo salva una copia di:
special_price,special_from_date,special_to_date.
La copia viene salvata in base allo scope dell’attributo del prezzo speciale in Magento:
- per i prezzi globali: a livello globale,
- per i prezzi per website: a livello della store view predefinita di ciascun website,
- per i prezzi per store: a livello di store view.
Il modulo non converte le valute. Magento memorizza i prezzi come valori di base per lo scope appropriato, mentre la presentazione delle valute sul frontend resta gestita dai meccanismi standard di Magento.
Il comportamento al termine di OUTLET dipende dall’opzione Usuń ceny specjalne dla produktów po wyprzedaży:
Tak: il modulo cancella il prezzo speciale ed elimina la copia tecnica,Nie: il modulo ripristina il prezzo speciale e le date dalla copia, quindi elimina la copia tecnica.
Cron
Il modulo dispone di un task cron:
kowal_outletproducts_outlet
Il task avvia l’helper OUTLET e controlla ciclicamente i prodotti outlet. Il cron rimuove i prodotti dalle categorie OUTLET quando non dovrebbero più essere visibili lì e aggiorna gli indici e la cache.
Dopo l’installazione, assicurati che il cron Magento funzioni correttamente:
php bin/magento cron:run
In ambiente di produzione, il cron deve essere eseguito dal crontab di sistema dell’utente dell’applicazione Magento.
Avvio manuale del ricalcolo
Il ricalcolo può essere avviato manualmente da CLI:
php bin/magento kowal_outletproducts:generate
Il comando esegue lo stesso processo avviato dal cron.
Indici e cache
Dopo le modifiche, il modulo aggiorna gli indici prodotto e catalogo più importanti:
catalog_product_price,catalog_product_category,catalogsearch_fulltext,inventory,cataloginventory_stock.
Il modulo pulisce anche la cache dei tag di prodotti e categorie OUTLET, così il listing della categoria dovrebbe aggiornarsi dopo la modifica dello stato o lo scollegamento del prodotto.
Se necessario, è possibile forzare una reindicizzazione completa:
php bin/magento indexer:reindexphp bin/magento cache:flush
Test dopo il deploy
Test funzionale consigliato:
- Seleziona un prodotto semplice con giacenza di magazzino.
- Imposta per il prodotto un prezzo speciale e le date della promozione.
- Aggiungi il prodotto a OUTLET tramite il pannello di importazione.
- Verifica che il prodotto sia comparso nella categoria OUTLET.
- Verifica che l’attributo
sale abbia il valore Tak. - Per un prodotto configurabile, verifica che il parent sia comparso in OUTLET.
- Modifica lo stato del prodotto in modo che non sia salable.
- Esegui il cron o il comando CLI.
- Verifica che il prodotto sia stato rimosso dalla categoria OUTLET.
- Verifica che il prezzo speciale sia stato ripristinato oppure rimosso in base alla configurazione.
Problemi più frequenti
Il prodotto è ancora visibile in OUTLET
Verifica:
- se il cron Magento è in esecuzione,
- se il prodotto non ha ancora
sale = 1, - se il prodotto è assegnato a una delle categorie configurate come OUTLET,
- se gli indici e la cache sono stati aggiornati.
Comandi di supporto:
php bin/magento cron:runphp bin/magento indexer:reindexphp bin/magento cache:flush
Il parent configurable è ancora in OUTLET
Verifica se una qualsiasi variante del prodotto ha ancora sale = 1. Il parent viene mantenuto in OUTLET finché dispone di una variante outlet attiva.
Il prezzo speciale non è stato ripristinato
Verifica:
- se il prodotto era stato aggiunto in precedenza a OUTLET dopo l’installazione degli attributi di copia,
- se l’attributo
special_price_copy_active era impostato, - se la configurazione
Usuń ceny specjalne dla produktów po wyprzedaży è impostata su Nie, - quale scope dei prezzi è impostato in Magento.
I prezzi differiscono tra le store view
Verifica la configurazione dello scope dei prezzi in Magento. Il modulo non converte le valute e non sincronizza i prezzi tra store view. Ripristina i valori salvati per lo scope di prezzo appropriato.
Disinstallazione
Se il modulo deve essere disabilitato:
php bin/magento module:disable Kowal_OutletProductsphp bin/magento setup:upgradephp bin/magento cache:flush
Rimozione del pacchetto Composer:
composer remove kowal/module-outletproductsphp bin/magento setup:upgradephp bin/magento cache:flush
Prima di rimuovere il modulo, si consiglia di verificare se i prodotti richiedono la pulizia manuale dell’attributo sale o lo scollegamento dalla categoria OUTLET.
