Einbindungsbeispiel · Craft CMS

Beispiel: immoSoR-Widget in Craft CMS einbinden.

Diese Beispielseite zeigt einen vollständigen Musteraufbau für Craft CMS. Sie können daran ablesen, welcher Code global gehört und welcher Code auf die konkrete Immobilienseite gesetzt wird.

Musterwerte: Objekt-ID 100XVBK, Widget-Schlüssel wgt_100xvbk_e9aa89a0, öffentliche Adresse https://app.dreifisch.com/w/wgt_100xvbk_e9aa89a0.

Für Maklerbüro und Redaktion

Der einfache Ablauf.

  1. Objekt-ID und Widget-Schlüssel aus der immoSoR-Objektakte übernehmen.
  2. Mastercode einmalig in Craft CMS einfügen.
  3. Objekt-Marker auf die konkrete Immobilienseite setzen.
  4. Seite speichern, Cache leeren und Test-Anfrage auslösen.

Backend-Anleitung · Craft CMS

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

Sections und Felder öffnen

Öffnen Sie im Craft-Backend Settings → Fields und die Section der Immobilien-Entries.

02

Feld anlegen

Legen Sie ein Feld für Widget-Schlüssel oder Objekt-Marker an und weisen Sie es dem Immobilien-Entry-Typ zu.

03

Mastercode im Twig-Layout setzen

Binden Sie den Mastercode einmalig im globalen Twig-Layout oder in einem Template-Part ein.

04

Entry bearbeiten

Öffnen Sie den konkreten Immobilien-Entry und tragen Sie den immoSoR-Wert ein.

05

Objekttemplate ergänzen

Geben Sie den Marker im Twig-Template der Objektseite aus.

06

Caches leeren

Leeren Sie Template-, Element- und ggf. statische Caches.

07

Frontend prüfen

Testen Sie die öffentliche Seite und kontrollieren Sie die immoSoR-Zuordnung.

Modulcode · Craft CMS

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.

Craft CMS: Mastercode im Layout

Einmalig im globalen Twig-Layout.

Craft CMS: Entry-Feld im Objekttemplate

Widget-Schlüssel als Feld am Immobilien-Entry pflegen.

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.

Codeblöcke · Craft CMS

Muster-Code sichtbar kopieren.

Diese Beispielseite zeigt alle vier Einbindungsvarianten mit kopierbaren Codefeldern. Der Mastercode bleibt allgemein; der Objekt-Marker gehört zur konkreten Immobilienseite.

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.

Nach dem Einfügen

So erkennt das Maklerbüro, ob die Einbindung stimmt.

Öffnen Sie die öffentliche Objektseite. Das Widget muss sichtbar sein oder die Exposé-Anforderung öffnen. Danach lösen Sie eine Test-Anfrage aus. In immoSoR muss der Vorgang in der Objektakte 100XVBK erscheinen.

Weiter prüfen

Öffnen Sie die Anleitung, die FAQ oder den Zugang zur App, wenn echte Objektwerte eingesetzt werden sollen.

Zugang

Testzugang oder Zugang öffnen.

Der Testzugang zeigt E-Mail-Adresse, E-Mail-Bestätigung, Zugangsdaten und Übersichtsseite.