CMS-Einbindung · Kirby

Einbindung des immoSoR-Widgets in Kirby.

Kirby ist ein schlankes, datei- und templatebasiertes CMS. Die Einbindung erfolgt über Templates oder Felder im Panel.

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

Haupttemplate

Der Mastercode wird einmalig im Haupttemplate eingefügt.

Panel-Feld

Der Widget-Schlüssel kann als Feld im Kirby-Panel gepflegt werden.

Schlanker Ablauf

Für kleinere Maklerseiten ist diese Trennung meist gut beherrschbar.

Anleitung

Schritt für Schritt.

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

01

Template öffnen

Öffnen Sie das Haupttemplate der Website.

02

Mastercode einfügen

Fügen Sie dort den immoSoR-Mastercode ein.

03

Feld anlegen

Legen Sie bei Bedarf ein Feld für den Widget-Schlüssel im Kirby-Panel an.

04

Schlüssel eintragen

Tragen Sie den passenden Widget-Schlüssel bei der Immobilie ein.

05

Marker ausgeben

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

06

Browser prüfen

Prüfen Sie die Seite im Browser.

07

Zuordnung testen

Testen Sie die Zuordnung der Anfrage 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 · Kirby

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

Blueprint prüfen

Öffnen Sie die Kirby-Blueprints für Immobilienseiten und legen Sie ein Feld für den Widget-Schlüssel an.

02

Mastercode im Snippet setzen

Binden Sie den Mastercode im globalen Layout oder Footer-Snippet ein.

03

Panel-Wert pflegen

Öffnen Sie die konkrete Immobilienseite im Kirby Panel und tragen Sie den Widget-Schlüssel ein.

04

Template-Ausgabe ergänzen

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

05

Datei- und Cacheprüfung

Prüfen Sie, ob die Änderung im Dateisystem gespeichert ist und ggf. Cache geleert wurde.

06

Frontend prüfen

Öffnen Sie die öffentliche Seite und testen Sie die Anfrage.

07

Kopien prüfen

Bei kopierten Seiten muss der Widget-Schlüssel neu gesetzt werden.

Modulcode · Kirby

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.

Kirby: Mastercode im Footer-Snippet

Einmalig im globalen Snippet einfügen.

Kirby: Ausgabe im Objekt-Template

Feldwerte aus dem Panel 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.

Einbindung vorbereiten · Kirby

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

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

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 Kirby

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 Kirby

Mastercode: im Haupttemplate oder Snippet der Website. Objekt-Marker: über ein Blueprint-Feld der Objektseite und dessen Ausgabe im Template. Fallback: iframe-Fallback als Feldinhalt oder Template-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 Kirby.

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.