Showcase Revolution: configurazione e aiuto

Carica e installa mprshowcaserevolution in Moduli > "Module Manager". Fai clic su "Configure" per aprire la dashboard. Usa "Improve" > Showcase Revolution per accedere a Widget, Collezioni e Impostazioni > Configurazione. Il sottomenu Impostazioni contiene anche Integrità, Licenza, Assistenza e Aggiorna.

Richiede PrestaShop 1.6.1 o successivo e PHP 7.1 o successivo.

Per un primo test, apri Widget, aggiungi un widget, inserisci un Titolo, scegli Tipo di widget: "New Products", Hook (posizione): "Homepage (displayHome)", "Layout": "Grid", Numero di prodotti: 8 e Attivo: Sì. Inserisci 4 prodotti per riga desktop e 2 prodotti per riga mobile. Salva e apri la homepage.

Funzioni

Usa lo stato di abilitazione del modulo in "Module Manager", oppure l’impostazione Attivo di un widget, per controllare la visualizzazione effettiva. Il campo di configurazione separato "Enable module" non sostituisce questi comandi.

Valori predefiniti dei widget

Queste sono preferenze globali salvate. I widget esistenti hanno campi propri. Imposta esplicitamente ogni nuovo widget; non presumere che modificare una preferenza globale aggiorni i valori dei widget salvati o precompili tutti i campi dell’editor.

Tendenze

Usa il comando di ricalcolo manuale delle tendenze nella dashboard dopo aver raccolto visualizzazioni. I punteggi combinano le visualizzazioni registrate e le vendite di ordini validi. Le visualizzazioni dei prodotti sono registrate tramite actionObjectProductViewAfter; verifica che il tuo negozio o la tua integrazione emetta questo hook. La registrazione dei ritorni in stock usa actionUpdateQuantity e confronta la quantità visibile nei dati memorizzati con la nuova quantità dell’hook. Verifica questa transizione con il tuo flusso di aggiornamento dello stock.

Prestazioni

L’HTML contenente prezzi o comandi di aggiunta al carrello è escluso dalla cache HTML condivisa dei widget. Sono escluse anche le sorgenti personali. I caroselli compatibili con Warehouse hanno una cache aggiuntiva per la selezione e le schede leggere; i dati personalizzati dei prodotti della prima riga sono renderizzati nel contesto del visitatore.

Stili del tema

I valori predefiniti provengono dal sistema condiviso degli stili del tema. Il modulo registra --mpr-sc-primary, --mpr-sc-accent, --mpr-sc-filter-bg, --mpr-sc-radius, --mpr-sc-shadow-hover e --mpr-sc-transition. "Card gap" ha un valore predefinito di 16px e fornisce --mpr-sc-gap. Modifica i comandi di stile condivisi quando devi regolare la palette rilevata o la spaziatura. Le mappature primary-hover e dell’ombra normale non sono disponibili.

L’editor ha le schede Generale, Visualizzazione e Avanzate. I valori seguenti descrivono i valori predefiniti dello schema; inserisci valori espliciti quando un nuovo form è vuoto.

Generale

Le sorgenti sono "Best Sellers", "New Products", "On Sale", "Featured Products", "Trending Now", "Curated Collection", "Back in Stock", "Recently Viewed" e "Cart Recommendations". "Recently Viewed" è elencato ma non restituisce prodotti; non selezionarlo per un blocco funzionante.

"Cart Recommendations" richiede un modulo MPR Sales Revolution abilitato, un carrello caricato e prodotti al suo interno. Le altre sorgenti funzionano indipendentemente da questa integrazione. "Featured Products" usa Ambito categoria o la categoria configurata per i prodotti in evidenza. Ambito categoria non è applicato da tutte le sorgenti, inclusi i percorsi delle collezioni e delle raccomandazioni del carrello.

Visualizzazione

"Grid", "Slider" e "Carousel" normalmente usano la miniatura prodotto nativa del tema nelle versioni moderne di PrestaShop. PrestaShop 1.6 ha un template legacy del modulo. "List" e "Compact" usano template più piccoli del modulo. I punti e la riproduzione automatica vengono passati al renderer attuale del carosello.

Avanzate

Ordina per viene salvato, ma le sorgenti automatiche mantengono il proprio ordine di query. Classe CSS è vuoto per impostazione predefinita e aggiunge una classe al contenitore. CSS personalizzato è vuoto per impostazione predefinita e produce un blocco di stile. Posizione ha un valore predefinito di 0 e ordina i widget all’interno di un hook.

CSS personalizzato non è limitato automaticamente al widget. Includi Classe CSS nei tuoi selettori:

.homepage-staff-picks .mpr-showcase-widget__title {
  text-transform: uppercase;
}

Il database salva anche sort_dir con valore predefinito DESC e show_manufacturer con valore predefinito 0; questi non sono controlli nel form attuale del widget.

Crea una collezione con Nome, una Descrizione facoltativa in testo formattato, Tipo, Data di inizio, Data di fine, Attivo e Posizione. Nome e descrizione sono vuoti per impostazione predefinita, Tipo è curated, le date sono vuote, Attivo è Sì e Posizione è 0. I tipi includono curated, staff_picks, seasonal e spotlight.

Aggiungi i prodotti selezionati, riordinali, poi salva un widget con Tipo di widget: "Curated Collection" e la Collezione corrispondente. I prodotti usano la loro posizione salvata nella collezione.

Le date e Attivo influenzano le query delle collezioni che richiedono una selezione di soli elementi attivi. La ricerca diretta dei prodotti della collezione da parte del widget non controlla questi campi di pianificazione. Controlla un widget di collezione con il suo interruttore Attivo; non fare affidamento sulle date della collezione per nascondere un widget già assegnato.

Ad esempio, crea una collezione chiamata Summer Picks, poi configura:

Title: Summer Picks
Widget Type: Curated Collection
Collection: your saved collection
Hook (Placement): displayHome
Layout: Grid
Products Count: 8
Active: Yes

Gli hook supportati sono:

displayHome
displayFooterCategory
displayLeftColumn
displayRightColumn
displayFooterBefore
displayFooterProduct
displayProductAdditionalInfo
displayOrderConfirmation2
displayCrossSellingShoppingCart
displayNotFound

Il tema deve chiamare l’hook selezionato. Per un piè di pagina prodotto personalizzato:

{hook h='displayFooterProduct'}

Non esiste un renderer per gli shortcode CMS. Usa un hook supportato.

I percorsi di override del tema includono:

themes/your_theme/modules/mprshowcaserevolution/views/templates/front/widget.tpl
themes/your_theme/modules/mprshowcaserevolution/views/templates/front/_product-miniature-widget.tpl
themes/your_theme/modules/mprshowcaserevolution/views/templates/front/layouts/list-item.tpl
themes/your_theme/modules/mprshowcaserevolution/views/templates/front/layouts/compact-item.tpl

I selettori utili includono .mpr-showcase-widget, i suoi modificatori --grid, --slider, --carousel, --list e --compact, .mpr-showcase-widget__title, .mpr-showcase-widget__subtitle, .mpr-showcase-widget__link, .mpr-showcase-slider__nav, .mpr-list-item e .mpr-compact-item.

1. Verifica che il tuo primo widget "Grid" mostri i prodotti nell’hook selezionato.
2. Passa a "Slider" e prova frecce, punti e riproduzione automatica su desktop e mobile.
3. Controlla i comandi dei prezzi e dell’aggiunta al carrello nel tema che usi effettivamente.
4. Fai clic su un prodotto del widget e ispeziona la richiesta trackClick se ti interessa la registrazione dei clic.
5. Prova separatamente una sorgente di collezione e di raccomandazioni del carrello prima di riutilizzarle altrove.

Non viene prodotto alcun contenitore se una sorgente non restituisce prodotti presentabili. Controlla lo stato attivo, l’associazione al negozio corrente, l’hook esatto, l’idoneità della sorgente, la categoria, le immagini di copertina e il numero di prodotti. "Best Sellers" richiede vendite e "Trending Now" richiede visualizzazioni registrate e un ricalcolo. "Back in Stock" richiede transizioni di stock registrate. "Recently Viewed" non restituisce prodotti in questa versione.

Se le modifiche appaiono in ritardo, considera le cache fisse di 30 minuti e la cache del tuo negozio/tema. Se la pianificazione delle collezioni sembra ignorata, usa il comando Attivo del widget stesso. Se un tema ignora i flag di prezzi o pulsanti, controlla il suo template delle miniature.

Esporta o annota widget e collezioni prima della disinstallazione. La disinstallazione rimuove il menu di amministrazione, la registrazione della gestione delle colonne, la registrazione del tema e le tabelle dello schema appartenenti al modulo, inclusi widget, collezioni, tendenze e dati di tracciamento. La disinstallazione standard rimuove le registrazioni degli hook. Se la pulizia del tema non riesce, il metodo si interrompe prima di rimuovere la configurazione rimanente. Rimuovi tutte le chiamate manuali agli hook del tema e gli override che hai aggiunto.