Crea pop-up personalizzati utilizzando Quickview

La visualizzazione rapida predefinita viene utilizzata nelle esperienze e-commerce in cui viene visualizzato un pop-up con le informazioni sul prodotto per promuovere un acquisto. Tuttavia, puoi attivare il contenuto personalizzato da visualizzare nei pop-up. A seconda del visualizzatore che utilizzi, questa funzionalità consente agli utenti di fare clic su un punto attivo, su un'immagine in miniatura o su una mappa immagine per visualizzare informazioni o contenuti correlati.

Le visualizzazioni rapide sono supportate dai seguenti visualizzatori in Dynamic Media:

  • Immagini interattive (punti attivi cliccabili)
  • Video interattivo (immagini thumbnail cliccabili durante la riproduzione del video)
  • Banner a carosello (hotspot cliccabili o mappe immagine)

Sebbene le funzionalità di ciascun visualizzatore siano diverse, il processo di creazione di una visualizzazione rapida è lo stesso in tutti e tre i visualizzatori supportati.

Per creare pop-up personalizzati utilizzando le Quickview:

  1. Crea una visualizzazione rapida per una risorsa caricata.

    In genere, quando modifichi una risorsa da utilizzare con il visualizzatore in uso, crei una visualizzazione rapida.

    Visualizzatore in uso Completa questi passaggi per creare la visualizzazione rapida
    Immagini interattive Aggiunta di punti attivi a un banner immagine.
    Video interattivi Aggiunta di interattività al video.
    Banner a carosello Aggiunta di punti attivi o mappe immagine a un banner.
  2. Ottieni il codice di incorporamento del visualizzatore per integrare il visualizzatore all’interno del tuo sito web.

    Visualizzatore in uso
    Completa questi passaggi per integrare il visualizzatore con il tuo sito web
    Immagine interattiva Integrazione di un’immagine interattiva con il sito web.
    Video interattivo
    Integrazione di un video interattivo con il sito web.
    Banner a carosello Aggiunta di un banner carosello alla pagina del sito web.
  3. Il visualizzatore che utilizzi ora deve sapere come utilizzare la visualizzazione rapida.

    A questo scopo, il visualizzatore utilizza un gestore chiamato QuickViewActive.


    EsempioSupponiamo che tu stia utilizzando il seguente codice di incorporamento sulla pagina web per un'immagine interattiva:

    chlimage_1-291

    Il gestore viene caricato nel visualizzatore utilizzando setHandlers:

    *viewerInstance*.setHandlers({ *handler 1*, *handler 2*}, ...

    Utilizzando l'esempio di codice di incorporamento di esempio riportato sopra, abbiamo il seguente codice:

    s7interactiveimageviewer.setHandlers({
        quickViewActivate": function(inData) {
            var sku=inData.sku;
            var genericVariable1=inData.genericVariable1;
            var genericVariable2=inData.genericVariable2;
           loadQuickView(sku,genericVariable1,genericVariable2);
        }
    })
    

    Per ulteriori informazioni sul metodo setHandlers(), consulta:

  4. È ora necessario configurare il gestore quickViewActivate.

    Il gestore quickViewActivate controlla le Quickview nel visualizzatore. Il gestore contiene l'elenco di variabili e le chiamate di funzioni da utilizzare con Quickview. Il codice di incorporamento fornisce la mappatura per la variabile SKU impostata in Quickview e per una chiamata della funzione loadQuickView di esempio.

    Variabili
    mappingMap da utilizzare nella pagina Web in base al valore SKU e alle variabili generiche contenute in Quickview:

    var *variable1*= inData.*quickviewVariable*

    Il codice di incorporamento fornito ha una mappatura di esempio per la variabile SKU:

    var sku=inData.sku

    Mappa anche altre variabili dalla visualizzazione rapida, come illustrato di seguito:

    var <i>variable2</i>= inData.<i>quickviewVariable2</i> 
     var <i>variable3</i>= inData.<i>quickviewVariable3</i>
    

    La funzione
    callL'handler richiede anche una chiamata di funzione affinché Quickview funzioni. Si presume che la funzione sia accessibile dalla pagina host. Il codice di incorporamento fornisce un esempio di chiamata della funzione :

    loadQuickView(sku)

    La chiamata della funzione di esempio presuppone che la funzione loadQuickView() esista e sia accessibile.

    Per ulteriori informazioni sul metodo quickViewActivate, consulta:

  5. Effettua le seguenti operazioni:

    • Rimuovi il commento alla sezione setHandlers del codice di incorporamento.

    • Mappa eventuali variabili aggiuntive contenute nella visualizzazione rapida.

      • Aggiorna la chiamata loadQuickView(sku,*var1*,*var2*) se aggiungi ulteriori variabili.
    • Crea una semplice funzione loadQuickView () sulla pagina, all'esterno del visualizzatore.

      Ad esempio, il seguente scrive il valore di sku nella console del browser:

    function loadQuickView(sku){
        console.log ("quickview sku value is " + sku);
    }
    
    • Carica una pagina HTML di prova su un server web e apri.

      Con le variabili mappate da Quickview e la chiamata della funzione in atto, la console del browser scrive il valore della variabile nella console del browser utilizzando la funzione di esempio fornita.

  6. È ora possibile utilizzare una funzione per richiamare un semplice pop-up in Quickview. Nell'esempio seguente viene utilizzato un elemento DIV per un elemento a comparsa.

  7. Assegna uno stile al pop-up DIV nel modo seguente. Aggiungi lo stile aggiuntivo desiderato.

    <style type="text/css">
        #quickview_div{
            position: absolute;
            z-index: 99999999;
            display: none;
        }
    </style>
    
  8. Posiziona il pop-up DIV nel corpo della pagina HTML.

    Uno degli elementi viene impostato con un ID aggiornato con il valore sku quando l’utente richiama un Quickview. L’esempio include anche un semplice pulsante per nascondere nuovamente la finestra a comparsa quando diventa visibile.

    <div id="quickview_div" >
        <table>
            <tr><td><input id="btnClosePopup" type="button" value="Close"        onclick='document.getElementById("quickview_div").style.display="none"' /><br /></td></tr>
            <tr><td>SKU</td><td><input type="text" id="txtSku" name="txtSku"></td></tr>
        </table>
    </div>
    
  9. Aggiungi una funzione per aggiornare il valore SKU nel pop-up; rendere il pop-up visibile sostituendo la funzione semplice creata al punto 5. con le seguenti caratteristiche:

    <script type="text/javascript">
        function loadQuickView(sku){
            document.getElementById("txtSku").setAttribute("value",sku); // write sku value
            document.getElementById("quickview_div").style.display="block"; // show popup
        }
    </script>
    
  10. Carica una pagina HTML di prova sul tuo server web e apri. Il visualizzatore visualizza il pop-up DIV quando un utente richiama una visualizzazione rapida.

  11. Come visualizzare il pop-up personalizzato in modalità a schermo intero

    Alcuni visualizzatori, come il visualizzatore video interattivo, supportano la visualizzazione in modalità a schermo intero. Tuttavia, se si utilizza il pop-up come descritto nei passaggi precedenti, questo viene visualizzato dietro il visualizzatore in modalità a schermo intero.

    Per visualizzare la visualizzazione a comparsa sia in modalità standard che a schermo intero, allegare la finestra a comparsa al contenitore del visualizzatore. A questo scopo, puoi utilizzare un secondo metodo di gestione, initComplete.

    Il initComplete hander viene richiamato dopo l'inizializzazione del visualizzatore.

    "initComplete":function() { code block }
    

    Per ulteriori informazioni sul metodo init(), consulta:

    • Visualizzatore di immagini interattive - init
    • Visualizzatore video interattivo - init
  12. Per allegare al visualizzatore il pop-up (descritto nei passaggi precedenti), utilizza il seguente codice:

    "initComplete":function() {
        var popup = document.getElementById('quickview_div');
        popup.parentNode.removeChild(popup);
        var sdkContainerId = s7interactivevideoviewer.getComponent("container").getInnerContainerId();
        var inner_container = document.getElementById(sdkContainerId);
        inner_container.appendChild(popup);
    }
    

    Nel codice riportato sopra, abbiamo fatto quanto segue:

    • Identificato il nostro pop-up personalizzato.
    • È stato rimosso dal DOM.
    • Identificato il contenitore del visualizzatore.
    • È stato allegato il pop-up al contenitore del visualizzatore.
  13. L’intero codice setHandlers deve ora essere simile al seguente (è stato utilizzato il visualizzatore video interattivo):

    s7interactivevideoviewer.setHandlers({
        "quickViewActivate": function(inData) {
            var sku=inData.sku;
            loadQuickView(sku);
    
        },
        "initComplete":function() {
            var popup = document.getElementById('quickview_div'); // get custom quick view container
            popup.parentNode.removeChild(popup); // remove it from current DOM
            var sdkContainerId = s7interactivevideoviewer.getComponent("container").getInnerContainerId();
            var inner_container = document.getElementById(sdkContainerId);
            inner_container.appendChild(popup);
        }
    });
    
  14. Dopo il caricamento dei gestori, inizializza il visualizzatore:

    *viewerInstance.*init()


    EsempioQuesto esempio utilizza il visualizzatore di immagini interattivo.

    s7interactiveimageviewer.init()

    Dopo aver incorporato il visualizzatore nella pagina host, assicurati che l’istanza del visualizzatore sia creata e che i gestori siano caricati prima che il visualizzatore venga richiamato utilizzando init().

In questa pagina