Einbindung-FAQ · TYPO3

Häufige Fragen zum immoSoR-Widget in TYPO3.

Diese Fragen richten sich an Maklerbüros und Agenturen, die das immoSoR-Widget in TYPO3-Exposé-Seiten oder Objekt-Templates einbinden 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 · TYPO3

Objekt-ID eintragen. Code kopieren. Einfügen. Fertig.

Der Assistent erzeugt Muster-Code für TYPO3. 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
Beispielseite öffnen Muster öffnen

Schnellkopie · TYPO3

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.

Einbindung vorbereiten

immoSoR-Widget für TYPO3

Werte aus der Objekt-Akte einsetzen. Code erstellen. Passenden Block kopieren.

Ihre Werte

Nutzen Sie für einen echten Einbau die Werte aus Ihrer immoSoR-Objektakte. Die Beispielwerte zeigen nur den Aufbau.

Für TYPO3

Mastercode: über TypoScript, das Sitepackage, ein globales Template oder eine zentrale Footer-Ausgabe. Objekt-Marker: als HTML-Inhaltselement auf der Exposé-Seite oder automatisch im Fluid-Template der Objektansicht. Fallback: iframe-Fallback als HTML-Inhaltselement, falls Scripts im Redaktionsbereich nicht zugelassen sind.

1. Mastercode einmalig global einfügen
2. Objekt-Marker auf die konkrete Objektseite setzen
3. Komplettcode für einfache HTML-/Codefelder
4. iframe-Fallback wenn Script nicht zugelassen wird

Nach dem Einfügen speichern Sie die CMS-Seite, leeren gegebenenfalls den Cache und lösen eine Test-Anfrage aus. In immoSoR muss die Anfrage in der richtigen Objekt-Akte erscheinen.

Werte in der App prüfen

Backend-Anleitung · TYPO3

Administrator-Anleitung: Widget in TYPO3 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

Backend und Seitenbaum öffnen

Melden Sie sich im TYPO3-Backend an und öffnen Sie den Seitenbaum mit der Exposé- oder Objektseite. Prüfen Sie, ob die Ausgabe über Inhaltselement, Sitepackage oder Fluid-Template läuft.

02

Mastercode im Sitepackage oder TypoScript setzen

Hinterlegen Sie den Mastercode zentral über Sitepackage, TypoScript, globales Template oder eine Footer-Ausgabe. Der Mastercode wird nicht pro Objekt dupliziert.

03

Exposé-Seite bearbeiten

Öffnen Sie die konkrete Exposé-Seite oder das Datensatz-Template der Immobilienausgabe. Vergleichen Sie die TYPO3-Exposé-ID mit der immoSoR-Objekt-ID.

04

HTML-Inhaltselement oder Fluid-Ausgabe nutzen

Setzen Sie den Objekt-Marker als HTML-Inhaltselement oder geben Sie ihn im Fluid-Template aus einem Objektfeld aus.

05

Cache vollständig leeren

Leeren Sie TYPO3-Seitencache, Systemcache und ggf. Extension- oder CDN-Cache. Prüfen Sie danach die öffentliche URL.

06

Mobile und Consent prüfen

Prüfen Sie, ob Consent- oder Sicherheitsregeln die Ausgabe blockieren. Das Widget muss im Frontend sichtbar oder als Anforderung erreichbar sein.

07

Test-Anfrage dokumentieren

Lösen Sie eine Test-Anfrage aus und kontrollieren Sie in immoSoR die richtige Objektakte, Exposé-Fassung und Zeitspur.

Modulcode · TYPO3

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.

TYPO3: Mastercode per TypoScript

Einmalig im Sitepackage oder im TypoScript-Setup ausgeben.

TYPO3: Fluid-Ausgabe im Exposé-Template

Marker objektbezogen im Detailtemplate ausgeben. Objektwerte projektseitig ersetzen.

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 TYPO3 wird der allgemeine technische Lader getrennt vom konkreten Immobilienbezug geführt. Diese Trennung schützt das Maklerbüro vor falschen Zuordnungen.

Bei Template-Overrides muss die Exposé-ID sauber auf den immoSoR-Objekt-Code abgebildet werden.

01

Technische Fragen

Diese Fragen betreffen Einbauort, Codeausgabe, Cache und Fallback in TYPO3.

FrageWo wird der immoSoR-Mastercode in TYPO3 sauber hinterlegt?

Der Mastercode gehört in TYPO3 an eine Stelle, die auf den gewünschten Objektseiten zuverlässig ausgegeben wird: über TypoScript, das Sitepackage, ein globales Template oder eine zentrale Footer-Ausgabe. 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 TYPO3 hin?

Der Objekt-Marker gehört in TYPO3 direkt zur jeweiligen Immobilienseite: als HTML-Inhaltselement auf der Exposé-Seite oder automatisch im Fluid-Template der Objektansicht. 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 TYPO3 Script-Tags, HTML oder den Marker entfernen?

Das hängt von der konkreten Einrichtung ab. Bei TYPO3-Backend mit Inhaltselementen, Fluid-Template und Sitepackage 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 TYPO3 technisch geprüft werden?

Nach dem Speichern sollten TYPO3-Seitencache, ggf. Extension-Cache und CDN/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 TYPO3, dass ein Marker zum falschen Objekt gehört?

Vor der Veröffentlichung wird der Objekt-Code aus immoSoR mit der Objektseite in TYPO3 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 TYPO3 mit mehreren aktiven Immobilien?

Für jedes aktive Objekt wird ein eigener Widget-Schlüssel geführt. In TYPO3 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 TYPO3 zu beachten?

Bei Template-Overrides muss die Exposé-ID sauber auf den immoSoR-Objekt-Code abgebildet werden. 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 TYPO3-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 TYPO3 kein JavaScript erlaubt?

Dann kann iframe-Fallback als HTML-Inhaltselement, falls Scripts im Redaktionsbereich nicht zugelassen sind 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 TYPO3-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 TYPO3 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.