Einbindungsbeispiel · Grav CMS

Beispiel: immoSoR-Widget in Grav CMS einbinden.

Diese Beispielseite zeigt einen vollständigen Musteraufbau für Grav 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 Grav CMS einfügen.
  3. Objekt-Marker auf die konkrete Immobilienseite setzen.
  4. Seite speichern, Cache leeren und Test-Anfrage auslösen.

Backend-Anleitung · Grav CMS

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

Theme und Seitenstruktur öffnen

Öffnen Sie Grav Admin oder die Dateistruktur mit Theme, Templates und Objektseiten.

02

Mastercode im Theme setzen

Fügen Sie den Mastercode im Basistemplate oder Footer des Themes ein.

03

Frontmatter-Feld nutzen

Pflegen Sie Widget-Schlüssel oder Marker im Frontmatter der konkreten Objektseite.

04

Markdown/HTML prüfen

Prüfen Sie, ob HTML im Markdown erlaubt ist oder über das Template ausgegeben werden muss.

05

Template-Ausgabe ergänzen

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

06

Cache leeren

Leeren Sie Grav-Cache und ggf. Theme-Cache.

07

Frontend testen

Öffnen Sie die Objektseite und lösen Sie eine Test-Anfrage aus.

Modulcode · Grav 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.

Grav CMS: Mastercode im Theme

Einmalig im Theme-Template oder Footer.

Grav CMS: Frontmatter und Twig-Ausgabe

Werte im Frontmatter pflegen und im Objekt-Template ausgeben.

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 · Grav 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.