CMS-Einbindung · Craft CMS

Einbindung des immoSoR-Widgets in Craft CMS.

Craft CMS wird häufig für hochwertige, individuell entwickelte Websites genutzt. Die Einbindung erfolgt am besten über Templates und Felder.

Mastercode allgemein einbinden. Objekt-Marker nur auf der passenden Objektseite setzen.

Layout-Template

Der Mastercode wird einmalig im Layout-Template eingebunden.

Feld am Objekt

Der Objekt-Marker wird über ein Feld an der jeweiligen Immobilie gepflegt.

Redaktionell sauber

Der Redakteur pflegt nur den Widget-Schlüssel, das Template erzeugt die Ausgabe.

Anleitung

Schritt für Schritt.

So wird das immoSoR-Widget in diesem System sauber eingebunden.

01

Layout öffnen

Öffnen Sie das globale Layout-Template.

02

Mastercode einfügen

Fügen Sie den immoSoR-Mastercode im Kopf- oder Fußbereich ein.

03

Feld anlegen

Legen Sie ein Feld für den immoSoR-Widget-Schlüssel oder Objekt-Marker an.

04

Wert eintragen

Tragen Sie den passenden Wert bei der jeweiligen Immobilie ein.

05

Marker ausgeben

Geben Sie den Marker im Template der Objektseite aus.

06

Seite prüfen

Prüfen Sie die öffentliche Seite.

07

Zuordnung testen

Testen Sie die Anfrage und die Zuordnung in immoSoR.

Prüfung

Am Ende zählt die richtige Objektzuordnung.

  • Der Mastercode lädt nur die allgemeine Widget-Funktion.
  • Der Objekt-Marker enthält den konkreten Immobilienbezug.
  • Nach dem Einbau muss eine Test-Anfrage ausgelöst werden.
  • In immoSoR muss die Anfrage beim richtigen Objekt erscheinen.
Wichtig

Kopieren Sie den Objekt-Marker nicht pauschal auf mehrere Objektseiten. Jede Immobilie braucht ihre eigene Zuordnung.

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.

Einbindung vorbereiten · Craft CMS

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

Der Assistent erzeugt Muster-Code für Craft CMS. 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 · Craft CMS

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 Craft CMS

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 Craft CMS

Mastercode: im globalen Twig-Layout oder in einem eingebundenen Template-Part. Objekt-Marker: über ein Feld am Immobilien-Entry und dessen Ausgabe im Objekt-Template. Fallback: iframe-Fallback als Feld- oder Matrix-Ausgabe.

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

Einbindung-FAQ

Häufige Fragen zur Widget-Einbindung in Craft CMS.

Zusätzlich zur Anleitung gibt es eine eigene FAQ-Seite mit technischen Fragen, fachlichen Prüfpunkten und typischen Fehlerquellen im Maklerbüro.

Fragen vor dem Einbau klären

Öffnen Sie die passende Einbindung-FAQ, prüfen Sie den Ablauf in der App oder rufen Sie direkt an.

Weiterführend

Passende Anschlussseiten.

Die CMS-Anleitungen sind miteinander verbunden. Der zentrale Überblick führt zurück zur Gesamtordnung der Einbindung.

Zugang

Testzugang oder Zugang öffnen.

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