Vorschaubild für Immobilienlisten

Ce contenu n’est pas encore disponible dans votre langue.

Wird ein Link auf eine Immobilienliste geteilt – etwa die Liste aller Angebote in einem Ort – zeigen soziale Netzwerke und Messenger ein Vorschaubild. WP-ImmoMakler wählt dieses Bild für Sie aus. Sie können für jeden Ort ein eigenes Foto hinterlegen oder eine Karte des Orts verwenden lassen.

Das Vorschaubild erscheint als og:image und als <meta name="thumbnail"> im HTML-Kopf der Liste. Ist Yoast SEO oder Rank Math SEO aktiv, gibt das SEO-Plugin die Open-Graph-Tags aus und übernimmt dafür das Bild von WP-ImmoMakler. Ohne SEO-Plugin gibt WP-ImmoMakler die Open-Graph-Tags der Liste selbst aus: Titel, Adresse, Vorschaubild und, falls vorhanden, die Beschreibung des Orts. Ist ein anderes SEO-Plugin aktiv, das eigene Open-Graph-Tags schreibt (All in One SEO, SEOPress, The SEO Framework, Slim SEO), verzichtet WP-ImmoMakler darauf, damit keine Angaben doppelt erscheinen. Dasselbe Bild tragen die Strukturdaten des SEO-Plugins als Bild der Seite (primaryImageOfPage); ab PLUS verweist die Seite dort zusätzlich über mainEntity auf die schema.org/ItemList der Liste.

Welches Bild verwendet wird

WP-ImmoMakler nimmt das erste Bild dieser Reihenfolge, das vorhanden ist:

Rang	Bild	Wo Sie es festlegen
1	Social-Media-Bild aus Yoast SEO oder Rank Math	Im SEO-Plugin beim Bearbeiten des Orts, Tab Social
2	Eigenes Bild des Orts	WP-ImmoMakler → Vorschaubilder
3	Karte des Orts	Einstellung Karte als Vorschaubild für Ortslisten
4	Foto der ersten Immobilie der Liste	–

Das allgemeine Standardbild Ihrer Website aus Yoast SEO oder Rank Math kommt nur noch zum Zuge, wenn keine Immobilie der Liste ein Foto hat.

Eigenes Bild für einen Ort hinterlegen

Die Bilder legen Sie im Backend Ihrer Website (wp-admin) unter WP-ImmoMakler → Vorschaubilder fest. Die Seite listet die Orte Ihrer Immobilien mit der Anzahl ihrer Immobilien; über die Reiter erreichen Sie auch die übrigen Kategorien wie Objektarten oder Vermarktungsarten.

Suchen Sie den Ort über das Suchfeld oder blättern Sie in der Liste.
Klicken Sie in seiner Zeile auf Bild auswählen und wählen Sie ein Bild aus der Mediathek oder laden Sie ein neues hoch.
Klicken Sie auf Bild verwenden. Die Auswahl wird sofort gespeichert.

Mit Bild entfernen heben Sie die Auswahl wieder auf. Das Bild selbst bleibt in der Mediathek. Über Liste ansehen öffnen Sie die Immobilienliste des Orts.

Namen und Slugs der Orte lassen sich auf dieser Seite nicht ändern. Sie stammen aus dem Import und werden von ihm überschrieben; das Vorschaubild dagegen lässt der Import unverändert.

Empfohlen ist ein Bild im Querformat mit 1200 × 630 Pixeln. Wie bei den Immobilienfotos liefert WP-ImmoMakler für die Vorschau immer ein JPG, PNG oder GIF aus, auch wenn Ihre Website Bilder in AVIF oder WebP umwandelt.

Karte als Vorschaubild

Haben Sie für einen Ort kein eigenes Bild hinterlegt, kann WP-ImmoMakler stattdessen eine Karte des Orts zeigen. Schalten Sie dazu im Backend Ihrer Website (wp-admin) unter WP-ImmoMakler → Einstellungen → SEO/AEO/GEO die Option Karte als Vorschaubild für Ortslisten ein. Sie ist standardmäßig ausgeschaltet.

So entsteht die Karte:

WP-ImmoMakler sucht den Ort über Ihren Geocoding-Dienst und zeigt ihn mit seiner Umgebung, mittig und in einem Ausschnitt, der zur Größe des Orts passt. Die Lage Ihrer Immobilien hilft dabei, gleichnamige Orte auseinanderzuhalten. Findet der Dienst den Ort nicht, zeigt die Karte die Gegend, in der die Immobilien des Orts liegen.
Die Karte enthält keine Markierungen einzelner Immobilien.
Gezeichnet wird sie von dem Dienst, den Ihre Website für statische Karten verwendet: in allen Editionen Google Maps, ab PLUS auch der Anbieter, den Sie im Tab Geodienste unter Dienst für Karten-Vorschaubilder gewählt haben (siehe Karten der Immobilien). Farbgebung und Kartentyp folgen Ihren Karten-Einstellungen.
Die Karte wird beim ersten Aufruf der Liste einmal erzeugt, als JPG mit 1200 × 630 Pixeln auf Ihrer Website gespeichert und von dort ausgeliefert. Ein Netzwerk, das die Vorschau abruft, nimmt deshalb keinen Kontakt zum Kartendienst auf. Pro Ort fallen eine Anfrage beim Geocoding-Dienst und eine beim Kartendienst an; neu erzeugt wird die Karte erst, wenn sich der Ausschnitt oder Ihre Karten-Einstellungen ändern.
Lässt sich keine Karte erzeugen, zum Beispiel weil kein API-Key hinterlegt ist, zeigt die Vorschau das Foto der ersten Immobilie. Einen neuen Versuch unternimmt WP-ImmoMakler nach einem Tag.

Google Maps, Mapbox und MapTiler zeichnen ihren Urheberhinweis selbst in das Bild. Bei Geoapify und den aus Kacheln zusammengesetzten Karten schreibt WP-ImmoMakler den Hinweis, den der Kartenanbieter verlangt, in die rechte untere Ecke, denn in einer Link-Vorschau erscheint er sonst nirgends.

PHP-Filter

Mit dem Filter immomakler_archive_image ersetzen Sie das Vorschaubild einer Liste. Er erhält das ausgewählte Bild und den Begriff der Liste – null auf der allgemeinen Immobilienliste und bei Suchergebnissen:

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 );

Mit dem Filter immomakler_opengraph_archive_tags schalten Sie die Open-Graph-Tags, die WP-ImmoMakler ohne SEO-Plugin auf Immobilienlisten ausgibt, ab oder erzwingen sie:

add_filter( 'immomakler_opengraph_archive_tags', '__return_false' );

Mit dem Filter immomakler_static_map_attribution legen Sie den Urheberhinweis fest, der in eine Karte geschrieben wird. Ein leerer Text bedeutet, dass der Kartendienst seinen Hinweis selbst zeichnet: