Aller au contenu

Image d'aperçu des listes de biens

Lorsque le lien d’une liste de biens est partagé, par exemple la liste de toutes les offres d’une localité, les réseaux sociaux et les messageries affichent une image d’aperçu. WP-ImmoMakler choisit cette image pour vous. Vous pouvez définir une photo propre à chaque localité ou faire utiliser une carte de la localité.

L’image d’aperçu apparaît comme og:image et comme <meta name="thumbnail"> dans l’en-tête HTML de la liste. Lorsque Yoast SEO ou Rank Math SEO est actif, le plugin SEO génère les balises Open Graph et reprend pour cela l’image de WP-ImmoMakler. Sans plugin SEO, WP-ImmoMakler génère lui-même les balises Open Graph de la liste : titre, adresse, image d’aperçu et, si elle existe, la description de la localité. Si un autre plugin SEO qui écrit ses propres balises Open Graph est actif (All in One SEO, SEOPress, The SEO Framework, Slim SEO), WP-ImmoMakler s’en abstient afin que rien n’apparaisse en double. Les données structurées du plugin SEO portent la même image comme image de la page (primaryImageOfPage) ; à partir de PLUS, la page renvoie en outre, via mainEntity, à la schema.org/ItemList de la liste.

WP-ImmoMakler prend la première image disponible dans cet ordre :

RangImageOù la définir
1Image pour les réseaux sociaux de Yoast SEO ou Rank MathDans le plugin SEO lors de la modification de la localité, onglet Social
2Image propre à la localité**WP-ImmoMakler → “Images d’aperçu”
3Carte de la localitéRéglage Carte comme image d’aperçu des listes de lieux
4Photo du premier bien de la liste–

L’image par défaut générale de votre site issue de Yoast SEO ou Rank Math n’entre en jeu que si aucun bien de la liste n’a de photo.

Vous définissez les images dans le backend de votre site web (wp-admin) sous **WP-ImmoMakler → “Images d’aperçu”. La page répertorie les localités de vos biens avec le nombre de biens de chacune ; les onglets vous donnent aussi accès aux autres catégories, comme les types de bien ou les types de commercialisation.

  1. Recherchez la localité avec le champ de recherche ou parcourez la liste.
  2. Dans sa ligne, cliquez sur Sélectionner l’image et choisissez une image de la médiathèque ou téléversez-en une nouvelle.
  3. Cliquez sur Utiliser l’image. La sélection est enregistrée immédiatement.

Avec Supprimer l’image, vous annulez la sélection. L’image elle-même reste dans la médiathèque. Avec Voir la liste, vous ouvrez la liste de biens de la localité.

Les noms et les slugs des localités ne peuvent pas être modifiés sur cette page. Ils proviennent de l’import et sont écrasés par celui-ci ; l’image d’aperçu, en revanche, reste inchangée après l’import.

Une image au format paysage de 1200 × 630 pixels est recommandée. Comme pour les photos des biens, WP-ImmoMakler fournit toujours pour l’aperçu un JPG, PNG ou GIF, même si votre site convertit les images en AVIF ou WebP.

Si vous n’avez pas défini d’image propre pour une localité, WP-ImmoMakler peut afficher à la place une carte de la localité. Pour cela, activez dans le backend de votre site web (wp-admin), sous WP-ImmoMakler → Paramètres → SEO/AEO/GEO, l’option Carte comme image d’aperçu des listes de lieux. Elle est désactivée par défaut.

Voici comment la carte est créée :

  • WP-ImmoMakler recherche la localité via votre service de géocodage et l’affiche avec ses environs, au centre et dans un cadrage adapté à la taille de la localité. La position de vos biens aide à distinguer des localités de même nom. Si le service ne trouve pas la localité, la carte montre la zone où se situent les biens de la localité.
  • La carte ne contient aucun marqueur de biens individuels.
  • Elle est dessinée par le service que votre site utilise pour les cartes statiques : Google Maps dans toutes les éditions et, à partir de PLUS, également le fournisseur que vous avez choisi dans l’onglet Services de géolocalisation sous Service d’images d’aperçu de carte (voir Cartes des biens). Les couleurs et le type de carte suivent vos réglages de cartes.
  • La carte est créée une seule fois lors du premier appel de la liste, enregistrée sur votre site en JPG de 1200 × 630 pixels et diffusée à partir de là. Un réseau qui récupère l’aperçu ne contacte donc pas le service de cartes. Pour chaque localité, une requête est envoyée au service de géocodage et une au service de cartes ; la carte n’est régénérée que lorsque le cadrage ou vos réglages de cartes changent.
  • Si aucune carte ne peut être créée, par exemple parce qu’aucune clé API n’est renseignée, l’aperçu affiche la photo du premier bien. WP-ImmoMakler réessaie après un jour.

Google Maps, Mapbox et MapTiler dessinent eux-mêmes la mention de la source dans l’image. Pour Geoapify et pour les cartes assemblées à partir de tuiles, WP-ImmoMakler inscrit dans le coin inférieur droit la mention exigée par le fournisseur de cartes, car sinon elle n’apparaîtrait nulle part dans un aperçu de lien.

Avec le filtre immomakler_archive_image, vous remplacez l’image d’aperçu d’une liste. Il reçoit l’image sélectionnée et le terme de la liste – null sur la liste générale des biens et pour les résultats de recherche :

add_filter( 'immomakler_archive_image', function ( $image, $term ) {
if ( $term && 'immomakler_object_location' === $term->taxonomy && 'hamburg' === $term->slug ) {
return [
'url' => 'https://www.example.com/wp-content/uploads/hamburg-hafen.jpg',
'width' => 1200,
'height' => 630,
'type' => 'image/jpeg',
];
}
return $image;
}, 10, 2 );

Avec le filtre immomakler_opengraph_archive_tags, vous désactivez ou forcez les balises Open Graph que WP-ImmoMakler génère sur les listes de biens sans plugin SEO :

add_filter( 'immomakler_opengraph_archive_tags', '__return_false' );

Avec le filtre immomakler_static_map_attribution, vous définissez la mention de la source inscrite dans une carte. Un texte vide signifie que le service de cartes dessine lui-même sa mention :

add_filter( 'immomakler_static_map_attribution', function ( $attribution ) {
return '© OpenStreetMap contributors';
} );