Galerie-Shortcode
Mit dem Shortcode [immomakler_gallery] betten Sie die Bildergalerie einer Immobilie auf jeder beliebigen WordPress-Seite oder in jedem Beitrag ein. Der Shortcode nutzt die geteilte Galerie-Bibliothek (Swiper + Lightgallery) und unterstützt mehrere vorkonfigurierte Layouts (Presets).
Grundlegende Verwendung
Abschnitt betitelt „Grundlegende Verwendung“Auf einer Immobilien-Detailseite reicht der Shortcode ohne Argumente — die Property wird automatisch aus dem aktuellen Beitrag abgeleitet:
[immomakler_gallery]Außerhalb der Detailseite müssen Sie die Immobilie explizit angeben — entweder über die externe Objektnummer (property_id) oder über die WordPress-Post-ID (post_id):
[immomakler_gallery property_id="ABC-123"][immomakler_gallery post_id="42"]Attribute
Abschnitt betitelt „Attribute“| Attribut | Werte | Standard | Beschreibung |
|---|---|---|---|
property_id | externe Objektnummer (objektnr_extern) | — | Selektiert die Immobilie über objektnr_extern aus dem Property_Post_Type. |
post_id | WordPress Post-ID (Integer) | — | Direkter WordPress-Post (überschreibt property_id). |
source | all, floorplans, non_floorplans | all | Filtert die Bildauswahl nach dem gruppe-Meta (GRUNDRISS). |
preset | registrierte Preset-ID | horizontal_thumbs | Wählt das Galerie-Layout. Eingebaute Presets: horizontal_thumbs, vertical_thumbs. Eigene Presets können über das Action-Hook immomakler_gallery_register_presets registriert werden. |
Alle übrigen Attribute werden als Optionen an das aktive Preset weitergereicht. Boolean-artige Werte (true/false/yes/no/1/0/on/off) und numerische Werte werden automatisch in den passenden PHP-Typ konvertiert.
Eine dieser Optionen ist image_click — sie legt fest, was ein Klick auf ein Foto auslöst: lightbox (Standard, Großansicht über der Seite), permalink (zur Detailseite der Immobilie) oder none (nicht anklickbar). permalink ist für Galerien in einer Immobilienliste gedacht.
Beispiele
Abschnitt betitelt „Beispiele“Galerie der aktuellen Immobilie mit vertikalen Vorschaubildern
Abschnitt betitelt „Galerie der aktuellen Immobilie mit vertikalen Vorschaubildern“[immomakler_gallery preset="vertical_thumbs"]Nur Grundrisse anzeigen
Abschnitt betitelt „Nur Grundrisse anzeigen“[immomakler_gallery source="floorplans"]Nur Bilder ohne Grundrisse, ohne Vorschaubilder
Abschnitt betitelt „Nur Bilder ohne Grundrisse, ohne Vorschaubilder“[immomakler_gallery source="non_floorplans" show_thumbs="false"]Galerie auf einer Landingpage einbinden
Abschnitt betitelt „Galerie auf einer Landingpage einbinden“[immomakler_gallery property_id="OBJ-2026-007" preset="vertical_thumbs"]Klick auf ein Foto führt zur Immobilie
Abschnitt betitelt „Klick auf ein Foto führt zur Immobilie“[immomakler_gallery image_click="permalink"]Technischer Hintergrund
Abschnitt betitelt „Technischer Hintergrund“Der Shortcode ist ein dünner Wrapper um den \ImmoMakler\Frontend\Gallery\Gallery_Service. Er löst die Property auf, ruft die Bilder über den Image_Source_Resolver ab, mischt Caller-Optionen mit den Standardwerten des Presets und übergibt das Ergebnis an die render()-Methode des Presets.
Weiterführende Anpassungsmöglichkeiten — Filter-Hooks für die Bildauswahl, das Optionen-Array und die Lightbox sowie CSS-Variablen für individuelles Styling — finden Sie unter Galerie-Library: Anpassen.