Shortcode de galerie
Avec le shortcode [immomakler_gallery], vous intégrez la galerie d’images d’un bien immobilier sur n’importe quelle page ou article WordPress. Le shortcode utilise la bibliothèque de galerie partagée (Swiper + Lightgallery) et prend en charge plusieurs mises en page préconfigurées (presets).
Utilisation de base
Section intitulée « Utilisation de base »Sur une page de détail d’un bien immobilier, le shortcode suffit sans arguments — le bien est automatiquement déduit de l’article actuel :
[immomakler_gallery]En dehors de la page de détail, vous devez indiquer explicitement le bien — soit via le numéro d’objet externe (property_id), soit via l’ID de post WordPress (post_id) :
[immomakler_gallery property_id="ABC-123"][immomakler_gallery post_id="42"]Attributs
Section intitulée « Attributs »| Attribut | Valeurs | Par défaut | Description |
|---|---|---|---|
property_id | numéro d’objet externe (objektnr_extern) | — | Sélectionne le bien via objektnr_extern dans le Property_Post_Type. |
post_id | ID de post WordPress (entier) | — | Post WordPress direct (remplace property_id). |
source | all, floorplans, non_floorplans | all | Filtre la sélection d’images selon le meta gruppe (GRUNDRISS). |
preset | ID de preset enregistré | horizontal_thumbs | Sélectionne la mise en page de la galerie. Presets intégrés : horizontal_thumbs, vertical_thumbs. Des presets personnalisés peuvent être enregistrés via le hook d’action immomakler_gallery_register_presets. |
Tous les autres attributs sont transmis comme options au preset actif. Les valeurs de type booléen (true/false/yes/no/1/0/on/off) et les valeurs numériques sont automatiquement converties dans le type PHP approprié.
Exemples
Section intitulée « Exemples »Galerie du bien actuel avec vignettes verticales
Section intitulée « Galerie du bien actuel avec vignettes verticales »[immomakler_gallery preset="vertical_thumbs"]Afficher uniquement les plans
Section intitulée « Afficher uniquement les plans »[immomakler_gallery source="floorplans"]Uniquement les photos sans plans, sans vignettes
Section intitulée « Uniquement les photos sans plans, sans vignettes »[immomakler_gallery source="non_floorplans" show_thumbs="false"]Intégrer une galerie sur une page d’atterrissage
Section intitulée « Intégrer une galerie sur une page d’atterrissage »[immomakler_gallery property_id="OBJ-2026-007" preset="vertical_thumbs"]Contexte technique
Section intitulée « Contexte technique »Le shortcode est un simple wrapper autour du \ImmoMakler\Frontend\Gallery\Gallery_Service. Il résout le bien, récupère les images via l’Image_Source_Resolver, fusionne les options de l’appelant avec les valeurs par défaut du preset et transmet le résultat à la méthode render() du preset.
Pour les possibilités de personnalisation supplémentaires — hooks de filtre pour la sélection d’images, le tableau d’options et la lightbox, ainsi que les variables CSS pour un style personnalisé — consultez Bibliothèque de galerie : Personnaliser.