Creare 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, questa funzionalità consente agli utenti di selezionare un punto attivo, un'immagine in miniatura o una mappa immagine per visualizzare informazioni o contenuti correlati.

Quickview è supportato dai seguenti visualizzatori in Dynamic Media:

  • Immagine interattiva (punti attivi cliccabili)
  • Video interattivo (immagini thumbnail cliccabili durante la riproduzione del video)
  • Banner a carosello (punti attivi 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 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 se desideri 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 se desideri 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 stai utilizzando ora deve sapere come utilizzare la visualizzazione rapida.

    Il visualizzatore utilizza un gestore chiamato QuickViewActive.


    EsempioSupponiamo di utilizzare il seguente codice di incorporamento nella 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, è disponibile 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 la visualizzazione rapida 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 della variabile SKU impostata in Quickview e una chiamata della funzione di esempio loadQuickView.

    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. Utilizzare un secondo metodo di gestione, initComplete.

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

    "initComplete":function() { code block }
    

    Per ulteriori informazioni sul metodo init(), consulta:

  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 precedente, è stato fatto quanto segue:

    • Identificato il 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 è 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 interattive.

    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