Virtuelle Tour

Contao EstateManager Erweiterung

Die Virtual Tour Erweiterung ermöglicht das entgegennehmen und darstellen von 3D-Rundgängen bekannter Drittanbieter. Folgende Drittanbieter werden dabei bereits unterstützt:

  • Ogulo

  • Immoviewer

Um beliebige Drittanbieter unterstützen zu können, werden Links, welcher der Immobilie zugewiesen sind und mit folgenden Subdomains übertragen / eingerichtet wurden, ebenfalls als 3D-Rundgang erkannt.

  • 3d.*

  • 360.*

  • 360grad.*

Darüber hinaus, steht nach der Installation dieser Erweiterung ein weiteres Immobilien-Feld zur Verfügung, welches unabhängig vom Drittanbieter oder der URL, den dort eingetragenen Link als virtuellen Rundgang erkennt:

  • Virtueller 3D-Rundgang

Installation

Composer
Contao-Manager
GitHub
Composer
$ composer require contao-estatemanager/virtual-tour
Contao-Manager

Über die Suche des Contao-Manager kann der Begriff EstateManager oder virtual-tour gesucht werden. Anschließen wählt man das Paket Contao EstateManager Virtueller 3D-Rundgang über die Schaltfläche "hinzufügen" aus und klickt zum installieren über den Reiter "Pakete" auf die Schaltfläche "Änderungen anwenden". Eine detaillierte Anleitung wie man mit dem Contao-Manager arbeitet findest du hier.

GitHub

Installation direkt über GitHub:

https://github.com/contao-estatemanager/virtual-tour

Nach der Installation muss das Contao-Installtool aufgerufen und die Datenbank aktualisiert werden.

Module

Hier finden Sie eine Übersicht neuer (🟢), sowie erweiterte (🔵) Module.

🔵 Liste
🔵 Ergebnisliste
🔵 Liste

Erweitert die Liste um folgende Einstellungen.

Einstellungen

🔹Virtuellen Rundgang hinzufügen

Fügt für jeder Immobilie in der Liste die Möglichkeit hinzu, den virtuellen Rundgang zu öffnen. Die neue Einstellung befindet sich in der Palette Immobilien Erweiterung .

Template

🔸real_estate_itemext_virtual_tour_default

Das Template muss über das Feld Immobilien Template Erweiterung: Virtueller Rundgangin der Palette Templates-Einstellungen ausgewählt werden.

🔵 Ergebnisliste

Erweitert die Ergebnisliste um folgende Einstellungen.

Einstellungen

🔹Virtuellen Rundgang hinzufügen

Fügt für jeder Immobilie in der Liste die Möglichkeit hinzu, den virtuellen Rundgang zu öffnen. Die neue Einstellung befindet sich in der Palette Immobilien Erweiterung .

Template

🔸real_estate_itemext_virtual_tour_default

Das Template muss über das Feld Immobilien Template Erweiterung: Virtueller Rundgangin der Palette Templates-Einstellungen ausgewählt werden.

Exposé-Module

Hier finden Sie eine Übersicht neuer (🟢) und erweiterte (🔵) Exposé-Module.

🟢 Virtueller-Rundgang
🔵 Galerie
🟢 Virtueller-Rundgang

Das Exposé-Modul Virtueller-Rundgang ermöglicht die Ausgabe einer Schaltfläche zum öffnen des virtuellen Rundgangs.

Einstellungen

🔹Text

Ermöglicht die Ergänzung eines beliebigen Textes.

🔹Ausblenden bei keinen Ergebnissen

Dieses Modul wird nur ausgegeben wenn ein virtueller Rundgang zum darstellen gefunden wurde.

Template

🔸expose_mod_virtualTour

🔵 Galerie

Erweitert das Exposé-Modul Galerie um eine weitere Galerie-Kategorie (Virtueller-Rundgang). Des Weiteren wird eine neue Palette (Virtueller-Rundgang Einstellungen) erzeugt um folgende Einstellungen vornehmen zu können.

Einstellungen

🔹Vorschaubild verwenden

Gibt ein Vorschaubild aus. Sofern kein eigenes Bild ausgewählt wurde, wird das Titelbild der Immobilie verwendet.

🔹Eigenes Vorschaubild

Hier können Sie ein eigenes Vorschaubild definieren.

Bitte beachte das mitgelieferte JavaScript-Template für die Verwendung von Vorschaubildern.

Template

🔸expose_mod_virtual_tour_gallery_default

Status-Token

Die Liste von vorhandenen Status-Token wird um den Virtuellen-Rundgang Status-Token ergänzt und steht anschließend überall dort zur Verfügung, wo Status-Token ausgegeben werden können.

JavaScript-Templates

Hier finden Sie eine Übersicht neuer JavaScript-Templates.

🟢 Virtueller Rundgang
🟢 Virtueller Rundgang

Um den virtuellen Rundgang bei Verwendung eines Vorschaubild nicht direkt einzubinden (da diese zum Beispiel bei verschiedenen Anbietern mit Musik unterspielt werden), bindet das mitgelieferte JavaScript-Template die Zielseite erst nach Klick auf das Vorschaubild ein.

Template

🔸js_realestatevirtualtour

Events

Um von außen bei Klick auf das Vorschaubild Einfluss nehmen zu können, wird einCustomEvent registriert und kann nach Bedarf entgegengenommen werden.

  • virtualtour.onClickPreview

document.addEventListener('virtualtour.onClickPreview', function(e){
// Do something
console.log(e.detail);
});

Lizenz

Für diese Erweiterung ist eine Lizenz erforderlich. Zum Erwerb einer Lizenz folge bitte den Schritten unter Lizenzen.