Technik
Mastercode, Objekt-Marker, Editor-Filter und Cache werden für Contao getrennt geprüft.
Technische Fragen öffnen →Einbindung-FAQ · Contao
Häufige Fragen zum immoSoR-Widget in Contao.
Diese Fragen richten sich an Maklerbüros, die das immoSoR-Widget in Contao-Seitenlayouts, Modulen oder Objektseiten nutzen möchten.
Die Fragen sind bewusst systembezogen formuliert: Einbauort, Editor, Cache, Fallback, Objektzuordnung und der praktische Ablauf im Maklerbüro.
Maklerbüro
Entscheidend ist die richtige Zuordnung: Jede Immobilienseite braucht genau den Marker, der zu diesem Objekt gehört.
Fachliche Fragen öffnen →Rückfrage
Bei Sondertemplates, CRM-Ausgabe oder eingeschränkten Codefeldern sollten App-Prüfung oder Telefonrückfrage genutzt werden.
Allgemeine Fragen öffnen →Einbindung vorbereiten · Contao
Objekt-ID eintragen. Code kopieren. Einfügen. Fertig.
Der Assistent erzeugt Muster-Code für Contao. Der Mastercode wird einmalig in der Website hinterlegt. Der Objekt-Marker gehört auf die konkrete Immobilienseite.
Beispielwerte aus der Objekt-Akte sauberer Musterfall
- Objekt-ID
100XVBK- Widget-Schlüssel
wgt_100xvbk_e9aa89a0- Öffentliche Adresse
https://app.dreifisch.com/w/wgt_100xvbk_e9aa89a0
Schnellkopie · Contao
Muster-Code sichtbar kopieren.
Diese Codeblöcke zeigen den Musterfall mit Objekt-ID 100XVBK und Widget-Schlüssel wgt_100xvbk_e9aa89a0. Für echte Objekte verwenden Sie die Werte aus der Objekt-Akte oder öffnen den Code-Assistenten.
1. Mastercode
Einmalig global hinterlegen.
2. Objekt-Marker
Auf die konkrete Immobilienseite setzen.
3. Komplettcode
Für einfache HTML-/Codefelder, wenn alles zusammen eingefügt wird.
4. iframe-Fallback
Für Fälle, in denen JavaScript oder Meta-Zeilen entfernt werden.
Backend-Anleitung · Contao
Administrator-Anleitung: Widget in Contao einbauen.
Diese Schritte richten sich an Administratoren, Redakteure und betreuende Agenturen. Sie zeigen den Backend-Weg vom globalen Mastercode bis zum objektbezogenen Marker auf der Immobilienseite.
Schritt für Schritt
Saubere Reihenfolge der Einrichtung.
Die Reihenfolge trennt Verwaltung, Technik, Objektzuordnung und Prüfweg. Erst wenn die öffentliche Seite die richtige Objektakte trifft, ist die Einbindung abgeschlossen.
01
Themes und Seitenlayout öffnen
Melden Sie sich in Contao an und öffnen Sie Themes, Seitenlayouts oder globale Module. Dort wird der Mastercode hinterlegt.
02
Mastercode im Layout setzen
Fügen Sie den Mastercode im Seitenlayout, in einem globalen Modul oder in einer Template-Erweiterung ein.
03
Immobilienseite öffnen
Öffnen Sie den Artikel oder die Seite der konkreten Immobilie. Prüfen Sie, ob die Objektseite über Inhaltselemente oder ein Template kommt.
04
HTML-Inhaltselement verwenden
Legen Sie ein HTML-Inhaltselement für den Objekt-Marker an oder geben Sie den Marker aus einem Feld im Template aus.
05
Veröffentlichung prüfen
Prüfen Sie Start-/Stoppzeiten, Sichtbarkeit und Zuordnung des Inhaltselements.
06
Cache neu aufbauen
Leeren Sie Contao-Cache und ggf. Browser-/Proxy-Cache.
07
Objektzuordnung testen
Öffnen Sie die öffentliche Seite und prüfen Sie mit einer Test-Anfrage, ob immoSoR den Vorgang dem richtigen Objekt zuordnet.
Modulcode · Contao
Backend-Modul sauber vorbereiten.
Die folgenden Muster sind als technische Vorlage gedacht. Vor produktiver Nutzung prüft die betreuende Person Sicherheitsregeln, Ausgabeformat, CSP und Projektstandard.
Contao: Mastercode im Seitenlayout
Im Layout, globalen Modul oder Template einmalig einfügen.
Contao: HTML-Inhaltselement am Objekt
Als HTML-Inhaltselement in den Artikel der konkreten Immobilie setzen.
Prüfung
Der Backend-Einbau endet erst im öffentlichen Frontend.
Speichern im CMS ist nur der Zwischenschritt. Entscheidend ist die öffentliche Objektseite, die mobile Ansicht und die Test-Anfrage in der richtigen immoSoR-Objektakte.
Prüfregel
Der Mastercode ist allgemein. Der Marker ist objektbezogen.
In Contao wird der allgemeine technische Lader getrennt vom konkreten Immobilienbezug geführt. Diese Trennung schützt das Maklerbüro vor falschen Zuordnungen.
Bei wiederverwendeten Modulen muss die Objektzuordnung sichtbar getrennt bleiben.
01
Technische Fragen
Diese Fragen betreffen Einbauort, Codeausgabe, Cache und Fallback in Contao.
FrageWo wird der immoSoR-Mastercode in Contao sauber hinterlegt?
Der Mastercode gehört in Contao an eine Stelle, die auf den gewünschten Objektseiten zuverlässig ausgegeben wird: im Seitenlayout, über ein globales Modul oder über eine Template-Erweiterung. Er wird nur einmal eingebunden und lädt die allgemeine Widget-Funktion.
immoSoR-Hinweis: immoSoR trennt den allgemeinen Lader vom Objektbezug. Dadurch muss nicht auf jeder Objektseite derselbe technische Code gepflegt werden.
FrageWo gehört der Objekt-Marker in Contao hin?
Der Objekt-Marker gehört in Contao direkt zur jeweiligen Immobilienseite: als HTML-Inhaltselement auf der Objektseite oder über ein Template-Feld der Immobilienausgabe. Er enthält Objekt-Code und Widget-Schlüssel und darf nicht pauschal in einem globalen Bereich stehen.
immoSoR-Hinweis: Die Anfrage wird nur dann richtig dokumentiert, wenn der Marker genau zur angezeigten Immobilie gehört.
FrageKann Contao Script-Tags, HTML oder den Marker entfernen?
Das hängt von der konkreten Einrichtung ab. Bei Contao-Inhaltselemente, Module, Seitenlayouts und Templates können Filter, Rechte oder Sicherheitsregeln verhindern, dass JavaScript im Inhalt gespeichert oder ausgegeben wird.
immoSoR-Hinweis: Wenn der Editor Code entfernt, wird der Mastercode über Template, globalen Codebereich oder Agenturzugriff eingebunden; der Marker bleibt objektbezogen.
FrageWas muss nach dem Speichern in Contao technisch geprüft werden?
Nach dem Speichern sollten Contao-Systemcache und ggf. Browser-/Proxy-Cache geprüft oder geleert werden. Danach wird die öffentliche Objektseite im Browser geöffnet und die Exposé-Anforderung einmal testweise ausgelöst.
immoSoR-Hinweis: Der Test zeigt, ob das Widget sichtbar ist, ob der richtige Objektbezug erscheint und ob die Anfrage in der Objektakte ankommt.
02
Fachliche Fragen im Maklerbüro
Diese Fragen betreffen Objektzuordnung, Kopien, Archivierung und Nachweis im Arbeitsalltag des Maklerbüros.
FrageWie verhindert das Maklerbüro in Contao, dass ein Marker zum falschen Objekt gehört?
Vor der Veröffentlichung wird der Objekt-Code aus immoSoR mit der Objektseite in Contao verglichen. Titel, Adresse oder Objektkennung müssen zusammenpassen. Erst danach sollte die Seite freigegeben werden.
immoSoR-Hinweis: immoSoR macht den Objektbezug sichtbar und führt jede Anfrage in der passenden Objektakte.
FrageWie arbeitet Contao mit mehreren aktiven Immobilien?
Für jedes aktive Objekt wird ein eigener Widget-Schlüssel geführt. In Contao erhält jede Immobilienseite ihren eigenen Marker. Der Mastercode bleibt gleich, der Marker wechselt je Objekt.
immoSoR-Hinweis: So können mehrere Objekte parallel laufen, ohne dass Anfragen zwischen den Immobilien vermischt werden.
FrageWas ist bei kopierten oder archivierten Objektseiten in Contao zu beachten?
Bei wiederverwendeten Modulen muss die Objektzuordnung sichtbar getrennt bleiben. Vor einer erneuten Veröffentlichung muss deshalb geprüft werden, ob der alte Marker entfernt, ersetzt oder deaktiviert werden muss.
immoSoR-Hinweis: In immoSoR bleibt nachvollziehbar, welches Objekt aktiv ist und welcher Widget-Schlüssel für die öffentliche Anfrage genutzt wird.
FrageWie wird aus einer Contao-Anfrage ein prüfbarer Vorgang?
Die öffentliche Objektseite führt den Besucher zur Exposé-Anforderung. Nach Anfrage und Bestätigung verbindet immoSoR Objekt, Interessent, Exposé-Fassung, Zustellung, Zeitpunkt und Nachweis.
immoSoR-Hinweis: Das Maklerbüro erhält keinen losen Website-Klick, sondern einen objektbezogenen Vorgang in der Handakte.
03
Allgemeine Fragen
Diese Fragen betreffen Fallback, Rücksprache und den Einstieg ohne vollständigen Umbau der Website.
FrageWas ist der sichere Fallback, wenn Contao kein JavaScript erlaubt?
Dann kann iframe-Fallback im HTML-Inhaltselement, wenn Script-Code nicht im Redaktionsbereich ausgegeben wird genutzt werden. Falls auch das nicht möglich ist, bleiben Kurzlink und QR-Code als sauberer externer Zugang zur Exposé-Anforderung.
immoSoR-Hinweis: Das Maklerbüro kann immoSoR auch dann nutzen, wenn die bestehende Website nur eingeschränkt Code zulässt.
FrageWann sollte das Maklerbüro bei einer Contao-Einbindung Rücksprache halten?
Rücksprache ist sinnvoll, wenn unklar ist, ob der Code global oder objektbezogen eingebunden wird, wenn ein Cache die Ausgabe verzögert oder wenn die Website aus einem CRM, Import oder Sondertemplate gespeist wird.
immoSoR-Hinweis: Weitere Fragen können in der App unter app.dreifisch.com geprüft oder telefonisch unter +49-39998-95900 geklärt werden.
Weitere Fragen
Prüfen, bevor die Objektseite veröffentlicht wird.
Wenn unklar ist, ob der Code in Contao global, objektbezogen oder als Fallback eingebunden werden muss, sollte die Einbindung vor dem öffentlichen Einsatz geprüft werden.
Support und Rückfrage
Weitere Fragen können innerhalb der App geprüft oder telefonisch geklärt werden.
Weiterführend
Anleitung und FAQ zusammen prüfen.
Die FAQ ergänzt die konkrete Einbindungsanleitung. Zuerst die Anleitung öffnen, danach die zehn Prüffragen kontrollieren.
Zugang
Testzugang oder Zugang öffnen.
Der Testzugang zeigt E-Mail-Adresse, E-Mail-Bestätigung, Zugangsdaten und Übersichtsseite.