DokumentationAEM 6.5Benutzerhandbuch

Erstellen eines benutzerdefinierten Popup-Fensters mithilfe einer Schnellansicht using-quickviews-to-create-custom-pop-ups

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Themen:

Erstellt für:

  • Benutzende
  • Admin

Die standardmäßige Schnellansicht wird in E-Commerce-Erlebnissen eingesetzt, in denen ein Popup-Fenster mit Produktinformationen angezeigt wird, um eine Kaufentscheidung zu fördern. Sie können jedoch benutzerdefinierte Inhalte auslösen, die in Popup-Fenstern angezeigt werden. Abhängig vom verwendeten Viewer können Benutzer mit dieser Funktion auf einen Hotspot, ein Miniaturbild oder auf eine Imagemap klicken, um Informationen oder zugehörige Inhalte anzuzeigen.

Schnellansichten werden in Dynamic Media von folgenden Viewern unterstützt:

  • Interaktive Bilder (klickbare Hotspots)
  • Interaktives Video (klickbare Miniaturbilder während der Videowiedergabe)
  • Karussellbanner (klickbare Hotspots oder Imagemaps)

Auch wenn die Funktionalität der Viewer unterschiedlich ist, ist der Prozess zum Erstellen einer Schnellansicht für alle drei unterstützten Viewer identisch.

Erstellen eines benutzerdefinierten Popup-Fensters mithilfe einer Schnellansicht:

  1. Erstellen Sie eine Schnellansicht für ein hochgeladenes Asset.

    In der Regel erstellen Sie eine Schnellansicht, wenn Sie ein Asset zur Verwendung mit dem Viewer, den Sie gerade benutzen, bearbeiten.

    table 0-row-2 1-row-2 2-row-2 3-row-2 html-authored no-header
    Derzeit verwendeter Viewer Führen Sie diese Schritte aus, wenn Sie die Schnellansicht erstellen möchten
    Interaktive Bilder Hinzufügen von Hotspots zu einem Bildbanner.
    Interaktive Videos Hinzufügen von Interaktivität zum Video.
    Karussellbanner Hinzufügen von Hotspots oder Imagemaps zu einem Banner.

  2. Rufen Sie den Einbettungs-Code für den Viewer ab, um den Viewer in Ihre Website zu integrieren.

    table 0-row-2 1-row-2 2-row-2 3-row-2 html-authored no-header
    Derzeit verwendeter Viewer Führen Sie die folgenden Schritte aus, um den Viewer mit Ihrer Website zu integrieren
    Interaktives Bild Integrieren eines interaktiven Bildes auf Ihrer Website.
    Interaktives Video Integrieren eines interaktiven Videos mit Ihrer Website.
    Karussellbanner Hinzufügen eines Karussellbanners zu Ihrer Website.

  3. Der Viewer, den Sie nutzen, muss erfahren, wie die Schnellansicht verwendet werden soll.

    Der Viewer verwendet einen Handler mit dem Namen QuickViewActive.

    Beispiel
    Angenommen, Sie verwenden auf Ihrer Web-Seite für ein interaktives Bild den folgenden Einbettungs-Code:

    chlimage_1-291

    Der Handler wird mit setHandlers in den Viewer geladen:

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

    Mit dem obigen Einbettungs-Code-Beispiel gibt es folgenden Code:

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

    Hier finden Sie weitere Informationen zur Methode setHandlers():

  4. Konfigurieren Sie den quickViewActivate-Handler.

    Der Handler quickViewActivate steuert die Schnellansichten im Viewer. Der Handler enthält die Variablenliste und die Funktionsaufrufe, die mit der Schnellansicht verwendet werden. Der Einbettungs-Code stellt die Zuordnung für das SKU-Variablenset in der Schnellansicht sowie ein Beispiel für einen Aufruf der Funktion loadQuickView bereit.

    Variablenzuordnung
    Ordnen Sie Variablen für die Verwendung auf Ihrer Web-Seite dem in der Schnellansicht enthaltenen SKU-Wert und den allgemeinen Variablen zu:

    var *variable1*= inData.*quickviewVariable*

    Der bereitgestellte Einbettungs-Code enthält ein Zuordnungsbeispiel für die SKU-Variable:

    var sku=inData.sku

    Ordnen Sie weitere Variablen aus der Schnellansicht wie folgt zu:

    code language-none 
    var <i>variable2</i>= inData.<i>quickviewVariable2</i>
 var <i>variable3</i>= inData.<i>quickviewVariable3</i>

    Funktionsaufruf
    Der Handler benötigt außerdem einen Funktionsaufruf, damit die Schnellansicht funktioniert. Die Host-Seite muss auf diese Funktion zugreifen können. Der Einbettungs-Code bietet ein Beispiel für einen Funktionsaufruf:

    loadQuickView(sku)

    Im Beispiel für einen Funktionsaufruf wird davon ausgegangen, dass die Funktion loadQuickView() vorhanden und verfügbar ist.

    Hier finden Sie weitere Informationen zur Methode quickViewActivate:

  5. Gehen Sie folgendermaßen vor:

    • Entfernen Sie im Einbettungs-Code die Auskommentierung des Abschnitts „setHandlers“.

    • Ordnen Sie alle weiteren Variablen zu, die in der Schnellansicht enthalten sind.

      • Aktualisieren Sie den Aufruf loadQuickView(sku,*var1*,*var2*), wenn Sie weitere Variablen hinzufügen.

    • Erstellen Sie auf der Seite eine einfache loadQuickView ()-Funktion außerhalb des Viewers.

      Die folgende Funktion schreibt z. B. den SKU-Wert in die Browser-Konsole:

    code language-xml 
    function loadQuickView(sku){
    console.log ("quickview sku value is " + sku);
}

    • Laden Sie eine HTML-Testseite auf einen Webserver hoch und öffnen Sie sie.

      Mit den zugeordneten Variablen aus der Schnellansicht und dem Funktionsaufruf schreibt die Browser-Konsole den Variablenwert mithilfe der Beispielfunktion in die Browser-Konsole.

  6. Sie können jetzt eine Funktion verwenden, um ein einfaches Popup in der Schnellansicht aufzurufen. Im folgenden Beispiel wird ein DIV für ein Popup-Fenster verwendet.

  7. Gestalten Sie das Popup-Fenster DIV wie folgt. Fügen Sie gegebenenfalls Ihre eigenen Stile hinzu.

    code language-xml 
    <style type="text/css">
    #quickview_div{
        position: absolute;
        z-index: 99999999;
        display: none;
    }
</style>

  8. Platzieren Sie das Popup-Fesnter DIV im Textbereich Ihrer HTML-Seite.

    Für eines der Elemente ist eine ID festgelegt, die mit den SKU-Wert aktualisiert wird, wenn der Benutzer eine Schnellansicht aufruft. Das Beispiel beinhaltet auch eine einfache Schaltfläche, um das Popup-Fenster wieder auszublenden.

    code language-xml 
    <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. Fügen Sie eine Funktion hinzu, um den SKU-Wert im Popup-Fenster zu aktualisieren. Machen Sie das Popup-Fenster sichtbar, indem Sie die in Schritt 5 erstellte einfache Funktion durch Folgendes ersetzen:

    code language-xml 
    <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. Laden Sie eine HTML-Testseite auf Ihren Webserver hoch und öffnen Sie sie. Der Viewer zeigt das Popup-DIV an, wenn ein Benutzer eine Schnellansicht aufruft.

  11. Anzeigen des benutzerdefinierten Popup-Fensters im Vollbildmodus

    Einige Viewer, wie der interaktive Video-Viewer, unterstützen die Anzeige im Vollbildmodus. Wenn Sie das Popup-Fenster jedoch verwenden, wie in den vorherigen Schritten beschrieben, wird es im Vollbildmodus hinter dem Viewer angezeigt.

    Damit das Popup-Fenster sowohl im Standard- als auch im Vollbildmodus im Vordergrund angezeigt wird, müssen Sie das Popup mit dem Viewer-Container verbinden. Verwenden Sie eine zweite Handler-Methode, initComplete.

    Der Handler initComplete wird aufgerufen, nachdem der Viewer initialisiert wurde.

    code language-xml 
    "initComplete":function() { code block }

    Hier finden Sie weitere Informationen zur Methode init():

  12. Um das in den vorherigen Schritten beschriebene Popup-Fenster mit dem Viewer zu verbinden, verwenden Sie den folgenden Code:

    code language-xml 
    "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);
}

    Im obigen Code wurde Folgendes ausgeführt:

    • Das benutzerdefinierte Popup-Fenster erkannt.
    • Es wurde aus dem DOM entfernt.
    • Den Viewer-Container erkannt.
    • Das Popup-Fenster mit dem Viewer-Container verbunden.

  13. Ihr gesamter setHandlers-Code sieht etwa wie folgt aus (für den interaktiven Video-Viewer):

    code language-xml 
    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. Nachdem die Handler geladen wurden, initialisieren Sie den Viewer:

    *viewerInstance.*init()

    Beispiel
    Dieses Beispiel verwendet den interaktiven Bild-Viewer.

    s7interactiveimageviewer.init()

    Nachdem Sie den Viewer in Ihre Host-Seite eingebettet haben, prüfen Sie, ob die Viewer-Instanz erstellt wird und die Handler geladen werden, bevor der Viewer mit init() aufgerufen wird.

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2