Immobilien-Videos in WordPress einbinden (YouTube, Vimeo, MP4)

Objektvideos gehören zu den wirkungsvollsten Medien auf einer Immobilien-Website: Sie vermitteln Interessenten einen realistischen Eindruck und verlängern die Verweildauer. WP-ImmoMakler zeigt Videos automatisch in einem eigenen Bereich „Videos” in der Immobilien-Detailansicht Ihrer WordPress-Website an, sobald sie für ein Objekt hinterlegt sind. Eine manuelle Konfiguration ist dafür nicht erforderlich.

So gelangen Videos zu Ihren Immobilien

Videos werden beim Import automatisch aus Ihrer Maklersoftware übernommen:

Video-Links: Links auf YouTube- oder Vimeo-Videos, die als OpenImmo-Anhang übertragen werden (z. B. Anhangsgruppe FILMLINK). WP-ImmoMakler erkennt YouTube- und Vimeo-URLs auch dann, wenn sie als gewöhnlicher Link übertragen werden – solche Links erscheinen im Videos-Bereich statt in der Linkliste.
Videodateien: Videodateien, die als OpenImmo-Anhang mitgeliefert werden, werden in die WordPress-Mediathek importiert und dem Objekt zugeordnet.

Unterstützte Formate

YouTube-Links – alle gängigen URL-Formen, auch Kurzlinks (youtu.be) und YouTube Shorts
Vimeo-Links – auch Vanity-URLs wie vimeo.com/ihrname/objektvideo
Videodateien: mp4, m4v, webm, ogv, wmv, flv

Videodateien in anderen Formaten werden nicht abgespielt, sondern als Download-Link im Videos-Bereich angeboten.

Videos werden als Vorschaubild mit Play-Button angezeigt. Erst nach einem Klick wird das Video in einer Lightbox in voller Größe abgespielt. Das beschleunigt den Seitenaufbau, da beim Laden der Seite keine Video-Player mehr eingebettet werden.

Die Vorschaubilder werden serverseitig zwischengespeichert und von Ihrer eigenen Website ausgeliefert. Kann kein Vorschaubild ermittelt werden, zeigt WP-ImmoMakler eine neutrale Platzhalter-Kachel mit Play-Button an.

Vorschaubilder für hochgeladene Videodateien

YouTube und Vimeo liefern zu jedem Video ein Vorschaubild mit. Videodateien aus Ihrer Maklersoftware (z. B. MP4) bringen keines mit – WP-ImmoMakler erzeugt daher automatisch eines aus dem Video selbst. Als Bildausschnitt dient eine Stelle kurz nach dem Anfang, damit nicht ein Einblende-Effekt oder eine Titeltafel als Vorschau erscheint.

Wo das Bild entsteht, hängt von Ihrem Server ab:

Ist auf Ihrem Server das Programm ffmpeg installiert, erzeugt WP-ImmoMakler das Vorschaubild direkt dort. Es steht dann kurz nach dem ersten Seitenaufruf bereit.
Andernfalls wird es im Browser der Website-Besuchenden erzeugt und anschließend auf Ihrem Server gespeichert. In diesem Fall kann es einige Aufrufe dauern, bis das Vorschaubild erscheint: Damit niemand ein beliebiges Bild unterschieben kann, wird es erst übernommen, wenn zwei voneinander unabhängige Besuchende dasselbe Bild liefern.

In beiden Fällen wird das fertige Vorschaubild auf Ihrem Server zwischengespeichert und von Ihrer eigenen Website ausgeliefert; es werden dabei keine Daten an Dritte übertragen. Bis ein Vorschaubild vorliegt, zeigt die Kachel den neutralen Platzhalter.

Ladezeit, Core Web Vitals und SEO

Die Vorschaubild-Darstellung verbessert nicht nur den Datenschutz, sondern auch die Suchmaschinenoptimierung Ihrer Immobilien-Website. Die Ladegeschwindigkeit ist über die Core Web Vitals ein Rankingfaktor bei Google – gerade bildlastige Immobilien-Detailseiten profitieren davon, dass keine Video-Player mehr am Seitenaufbau teilnehmen:

Keine eingebetteten Player beim Seitenaufbau: YouTube- und Vimeo-Embeds laden erhebliche Mengen JavaScript von Fremdservern. Mit der Lightbox passiert das erst, wenn Besuchende ein Video tatsächlich starten.
Moderne Bildformate in passender Größe: Die Vorschaubilder liefert WP-ImmoMakler als AVIF bzw. WebP aus – kleiner als JPEG bei gleicher Qualität. Zusätzlich werden sie in mehreren Größen erzeugt und responsiv (mit srcset) ausgeliefert, sodass Mobilgeräte eine passend kleine Variante laden statt des Vorschaubilds in voller Auflösung.
Kein Layout-Springen: Die Video-Kacheln reservieren ihre Abmessungen bereits beim Laden und vermeiden so Layoutverschiebungen (Cumulative Layout Shift).
Weniger Fremd-Requests: Vor der Zustimmung baut der Browser keine Verbindungen zu YouTube oder Vimeo auf.

Bei YouTube- und Vimeo-Videos holt WP-ImmoMakler vor dem Abspielen die Zustimmung der Website-Besuchenden ein. Auf dem Vorschaubild erscheint ein Hinweis mit Link auf die Datenschutzerklärung des jeweiligen Anbieters und einem Button „Video abspielen”. Erst nach dem Klick auf diesen Button wird das Video geladen und abgespielt.

Die Zustimmung wird – wie bei der Google-Maps-Consent-Box – je Dienst (YouTube bzw. Vimeo) im Local Storage des Browsers gespeichert (ähnlich wie ein Cookie) und gilt für alle weiteren Videos desselben Dienstes auf Ihrer Website.
Vor der Zustimmung überträgt der Browser der Besuchenden keine Daten an YouTube oder Vimeo. Auch die Vorschaubilder stammen von Ihrer eigenen Website, nicht von den Servern der Videoanbieter.
YouTube-Videos werden nach der Zustimmung im datenschutzfreundlichen youtube-nocookie-Modus abgespielt.

Weitere Informationen zur DSGVO-konformen Einbindung externer Dienste finden Sie unter Cookie-Zustimmung DSGVO-konform.

Wenn Sie das Blocken von YouTube und Vimeo stattdessen mit einem Drittanbieter-Consent-Plugin (z. B. Borlabs Cookie oder Real Cookie Banner) umsetzen möchten, können Sie die Lightbox- und Consent-Funktion im Backend Ihrer Website (wp-admin) unter WP-ImmoMakler → Einstellungen → Darstellung deaktivieren. Videos werden dann wie in früheren Versionen direkt in die Seite eingebettet.

Videos mit Page Buildern platzieren

In eigenen Layouts platzieren Sie den Videos-Bereich mit dem Widget bzw. Element „Videos”, das WP-ImmoMakler für Elementor, Divi, Bricks und WPBakery bereitstellt. Alternativ steht in allen Page-Builder-Templates der Shortcode [immomakler-template-single-videos] zur Verfügung – siehe Shortcodes.

Vimeo-Player in Ihren Website-Farben

Wenn Sie im WordPress-Customizer unter WP-ImmoMakler → Farben die Farbanpassung aktiviert haben, übernimmt der Vimeo-Player automatisch die eingestellte Linkfarbe für seine Bedienelemente.

Videos im PDF-Exposé PLUS

Das PDF-Exposé enthält nach den Objektfotos und Grundrissen automatisch einen Abschnitt mit den Videos der Immobilie. Jeder Eintrag zeigt das Vorschaubild des Videos sowie einen QR-Code – beide verlinken direkt auf das Video. Wer das ausgedruckte Exposé liest, scannt einfach den QR-Code mit dem Smartphone; im digitalen PDF genügt ein Klick auf das Vorschaubild.

Video-Icon in der Listenansicht

Optional kann ein Video-Icon auf dem Vorschaubild in der Listenansicht eingeblendet werden, das Besuchern auf einen Blick zeigt, welche Objekte ein Video besitzen – ähnlich wie das Icon für virtuelle Touren. Wenden Sie sich für diese Erweiterung an den WP-ImmoMakler-Support.

Mit dem Filter immomakler_video_links können Sie die Video-Links einer Immobilie per Code ergänzen oder verändern, mit immomakler_video_lightbox_options die Lightbox-Optionen (lightGallery) einzelner Video-Kacheln anpassen.

// Minimal: allen Immobilien ein Imagevideo hinzufügen.
add_filter( 'immomakler_video_links', function ( array $links ): array {
    $links[] = 'https://www.youtube.com/watch?v=IhrImagevideo';
    return $links;
});

// Erweitert: Video nur für ein bestimmtes Objekt ergänzen.
add_filter( 'immomakler_video_links', function ( array $links, int $post_id ): array {
    if ( get_post_meta( $post_id, 'objektnr_extern', true ) === 'OBJ-1234' ) {
        $links[] = 'https://vimeo.com/123456789';
    }
    return $links;
}, 10, 2 );

Für die Vorschaubilder hochgeladener Videodateien gibt es zwei weitere Filter: immomakler_video_poster_browser_capture bestimmt, ob Vorschaubilder im Browser der Besuchenden erzeugt werden dürfen, immomakler_ffmpeg_binary den Pfad zum ffmpeg-Programm.

// Vorschaubilder nicht im Browser der Besuchenden erzeugen lassen.
// Es werden dann nur noch Vorschaubilder von ffmpeg oder von Hand
// zugewiesene Beitragsbilder verwendet.
add_filter( 'immomakler_video_poster_browser_capture', '__return_false' );

// ffmpeg liegt an einem Ort, der nicht im Systempfad steht.
add_filter( 'immomakler_ffmpeg_binary', function (): string {
    return '/opt/bin/ffmpeg';
});

Häufige Fragen

Wie binde ich ein YouTube-Video DSGVO-konform in WordPress ein?

WP-ImmoMakler zeigt zunächst nur ein lokal gespeichertes Vorschaubild und holt vor dem Abspielen die Zustimmung der Besuchenden ein. Erst danach lädt das Video – im datenschutzfreundlichen youtube-nocookie-Modus. Vor der Zustimmung fließen keine Daten an YouTube oder Vimeo.

Muss ich Videos manuell zu meinen Immobilien hinzufügen?

Nein. Video-Links und Videodateien werden beim Import automatisch aus Ihrer Maklersoftware übernommen (z. B. als OpenImmo-Anhang) und erscheinen im Videos-Bereich der Detailansicht. Per Code lassen sich zusätzliche Videos über den Filter immomakler_video_links ergänzen.

Welche Videoformate und Plattformen werden unterstützt?

YouTube (inklusive Shorts und Kurzlinks), Vimeo (inklusive Vanity-URLs) sowie Videodateien in den Formaten mp4, m4v, webm, ogv, wmv und flv. Andere Dateiformate werden als Download-Link angeboten.

Warum zeigt meine hochgeladene Videodatei noch kein Vorschaubild?

Bei Videodateien erzeugt WP-ImmoMakler das Vorschaubild aus dem Video selbst. Ist auf Ihrem Server ffmpeg installiert, geschieht das kurz nach dem ersten Seitenaufruf. Andernfalls entsteht das Bild im Browser der Besuchenden, und es wird erst übernommen, wenn zwei voneinander unabhängige Besuchende dasselbe Bild geliefert haben – auf einer frisch importierten Immobilie kann das also etwas dauern. Wenn Sie nicht warten möchten, weisen Sie der Videodatei in der Mediathek ein Beitragsbild zu; dieses erscheint sofort und hat immer Vorrang.

Verlangsamen eingebettete Videos meine Immobilien-Website?

Mit der Lightbox-Darstellung nicht: Beim Seitenaufbau lädt nur ein optimiertes Vorschaubild von Ihrer eigenen Website. Der Video-Player mit seinem JavaScript wird erst geladen, wenn Besuchende das Video tatsächlich starten.