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.
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"]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.