Virtuellen Rundgang in WordPress veröffentlichen: So klappt die Einbindung sauber

Was du vor der Einbindung brauchst

Bevor du einen Rundgang in WordPress veröffentlichst, sollte er in Panorise bereits fertig angelegt und veröffentlicht sein.

Du brauchst dafür:

• mindestens einen fertig gerenderten Panorama-Inhalt,
• eine Website in Panorise,
• einen virtuellen Rundgang mit Szenen,
• eine gültige Startszene
• und den veröffentlichten Status des Rundgangs.

Das ist wichtig, weil private Rundgänge nicht öffentlich erreichbar sind. Wenn du also versuchst, einen noch nicht freigegebenen Rundgang in WordPress einzubauen, wird die Einbettung nicht funktionieren.

In der Panorise-Hilfe erfährst du, wie du einen virtuellen Rundgang erstellst. Rundgänge können erst dann öffentlich eingebettet werden, wenn sie veröffentlicht sind und eine Startszene haben. Genau das sollte vor dem Einbau geprüft werden.

Variante 1: Den Rundgang direkt per iframe einbetten

Wenn du den Rundgang nur einmal in eine WordPress-Seite setzen willst oder lieber mit einem einfachen HTML-Block arbeitest, reicht der iframe völlig aus.

Panorise stellt dir dafür einen Embed-Code bereit, der ungefähr so aussieht:

<iframe src="https://app.panorise.de/tour/..." width="100%" height="650" frameborder="0" allowfullscreen></iframe>

Diesen Code kannst du in WordPress an der gewünschten Stelle einfügen, zum Beispiel in:

• einen HTML-Block im Block-Editor,
• ein Custom-HTML-Element in einem Page Builder
• oder direkt in ein Template, wenn du die Einbindung im Theme lösen möchtest.

Was an dem Code wichtig ist

• width="100%" sorgt dafür, dass der Rundgang die verfügbare Breite nutzt.
• Die height solltest du an dein Layout anpassen. 500 Pixel reichen manchmal, 650 Pixel wirken oft ruhiger.
• allowfullscreen solltest du stehen lassen. Dann kann der Rundgang im Vollbild geöffnet werden, sofern der Browser das zulässt.

Gerade bei mobil optimierten Seiten lohnt sich ein kurzer Blick auf die Höhe. Ein zu flacher iframe wirkt schnell gequetscht, vor allem bei Rundgängen mit Hotspots oder mehreren Szenen. Wenn du dir unsicher bist, fang lieber mit etwas mehr Höhe an und teste dann im echten Layout.

Variante 2: Das offizielle WordPress-Plugin nutzen

Wenn du regelmäßig Panoramen oder Rundgänge in WordPress einfügst, ist das Plugin meist die angenehmere Lösung. Das ist vor allem dann praktisch, wenn mehrere Leute im Backend arbeiten und niemand bei jedem Beitrag den Code bearbeiten möchte.

Das WordPress-Plugin richtest du in vier Schritten ein:

1. Plugin herunterladen und in WordPress installieren.
2. API-Token in Panorise erstellen.
3. Token im WordPress-Plugin hinterlegen.
4. Rundgang per Shortcode einfügen.

1. Plugin installieren

Das offizielle Plugin kannst du direkt ins WordPress-Dashboard hochladen. Danach wird es wie gewohnt aktiviert.

Wenn du in Panorise arbeitest, ist der Standardwert für die Server-URL bereits auf https://app.panorise.de ausgelegt. Das kannst du normalerweise so lassen. Eine eigene Server-URL brauchst du nur, wenn du mit einer separaten oder Enterprise-Installation arbeitest.

2. API-Token erstellen

Damit das Plugin auf deine Inhalte zugreifen kann, brauchst du einen API-Token aus deinem Panorise-Konto.

Damit steuerst du den Zugriff sauber. Für WordPress reicht in der Regel ein Token, das auf die passende Website oder den passenden Bereich zeigt. Nutze nach Möglichkeit ein Website-Token für die jeweilige Kundenwebsite. Die einzelnen Schritte zeigt die Hilfe zum Erstellen eines API-Tokens.

3. Token im Plugin hinterlegen

Im WordPress-Backend trägst du den Token in den Plugin-Einstellungen ein.

Wenn alles korrekt ist, solltest du danach deine Panorise-Inhalte im Plugin sehen. Bei Rundgängen werden dort die veröffentlichten Touren angezeigt. Private Rundgänge tauchen nicht auf, weil sie nicht öffentlich sind.

4. Rundgang per Shortcode einfügen

Für einen veröffentlichten Rundgang verwendet das Plugin einen Shortcode wie diesen:

[panorise_tour public_key="PUBLIC_KEY" height="500px" width="100%"]

Den PUBLIC_KEY ersetzt du durch den Public Key des veröffentlichten Rundgangs. Höhe und Breite kannst du an dein Layout anpassen.

Der Vorteil ist klar: Redakteure müssen keinen iframe-Code anfassen. Sie kopieren den Shortcode in den Beitrag oder auf die Seite, und fertig.

Responsive Darstellung, Ladeverhalten und Barrierearmut prüfen

Eine technisch funktionierende Einbettung ist erst die halbe Arbeit. Der Rundgang sollte auf kleinen und großen Bildschirmen gut bedienbar sein, ohne den restlichen Seiteninhalt zu verdrängen. Prüfe deshalb nicht nur ein Smartphone und einen Desktop-Monitor, sondern auch eine mittlere Tablet-Breite. Gerade an den Übergängen eines WordPress-Themes können feste Containerbreiten, Seitenleisten oder großzügige Innenabstände den verfügbaren Platz unerwartet verkleinern.

Liegt der Rundgang weit unten auf einer langen Seite, kann beim direkten iframe das Attribut loading="lazy" sinnvoll sein. Der Browser lädt die Einbettung dann in der Regel erst, wenn sie sich dem sichtbaren Bereich nähert. Das entlastet den ersten Seitenaufruf. Steht der Rundgang dagegen direkt im sichtbaren Einstiegsbereich und ist er das wichtigste Element der Seite, solltest du prüfen, ob verzögertes Laden die Nutzung unnötig ausbremst. Entscheidend ist nicht eine pauschale Einstellung, sondern die tatsächliche Position im Layout.

Gib Besuchern vor der Einbettung außerdem eine kurze, verständliche Orientierung. Ein Satz wie „Bewege den Rundgang mit der Maus oder per Finger und öffne die markierten Bereiche“ nimmt Unsicherheit, ohne die Seite mit Erklärungen zu überladen. Wenn wichtige Informationen ausschließlich im Panorama vorkommen, sollten sie zusätzlich als normaler Seitentext verfügbar sein. So bleiben Öffnungszeiten, Ausstattungsmerkmale oder Kontaktmöglichkeiten auch für Menschen zugänglich, die den interaktiven Rundgang nicht nutzen können.

Kontrolliere zum Abschluss die Bedienung per Tastatur, den Vollbildmodus und das Verhalten nach einer Änderung der Displayausrichtung. Achte zudem darauf, dass Cookie-, Consent- oder Sicherheitslösungen nicht nur den Ladevorgang blockieren, sondern in diesem Fall auch einen verständlichen Hinweis anzeigen. Eine leere Fläche wirkt wie ein technischer Fehler; eine kurze Erklärung mit einer Handlungsmöglichkeit schafft dagegen Vertrauen.

Wann iframe besser ist und wann das Plugin sinnvoller ist

Wenn du nur eine einzelne Website hast und selten etwas änderst, ist der iframe oft völlig ausreichend. Er ist direkt, leicht verständlich und funktioniert in vielen Setups ohne weiteren Aufwand.

Das Plugin lohnt sich vor allem dann, wenn:

• mehrere Redakteure Inhalte pflegen,
• du regelmäßig Rundgänge veröffentlichst,
• du das Einfügen möglichst einfach halten willst
• oder du im WordPress-Backend einen festen, wiederholbaren Workflow brauchst.

Für Agenturen und Kundenseiten ist das meistens der angenehmere Weg. Einmal sauber eingerichtet, wird das Einfügen von Rundgängen deutlich entspannter.

Typische Fehler beim Einbinden

Wenn ein Rundgang in WordPress nicht erscheint, liegt es meistens an einem der folgenden Punkte.

Der Rundgang ist noch privat

Private Rundgänge lassen sich nicht öffentlich einbetten. Prüfe zuerst, ob der Rundgang in Panorise wirklich veröffentlicht ist.

Die Startszene fehlt

Ohne gültige Startszene lässt sich ein Rundgang nicht sauber veröffentlichen. Das ist einer der häufigsten Stolpersteine, wenn alles eigentlich fertig aussieht, aber die Freigabe nicht klappt.

Die iframe-Höhe ist zu klein

Wenn der Rundgang zwar geladen wird, aber abgeschnitten wirkt, ist meist die Höhe das Problem. Dann solltest du einen großzügigeren Wert testen.

WordPress oder ein Security-Plugin blockiert die Einbettung

Manche Seiten filtern iframes, entfernen allowfullscreen oder blockieren externe Inhalte über Sicherheitsregeln. Dann hilft ein Blick auf die Seite selbst, nicht auf Panorise.

Der API-Token ist falsch oder abgelaufen

Wenn das Plugin keine Inhalte anzeigt, prüfe den Token im WordPress-Plugin. Auch ein falsch zugewiesenes Website-Token kann dazu führen, dass nichts sichtbar ist.

Ein kleiner Praxis-Tipp aus der Umsetzung

Wenn du einen virtuellen Rundgang für ein Projekt veröffentlichst, teste ihn immer einmal auf der echten Zielseite. Nicht nur im WordPress-Editor, sondern genau dort, wo ihn Besucher später sehen.

Die Einbettung kann im Editor gut aussehen, aber auf der echten Seite durch CSS, Containerbreiten oder Sicherheitsregeln trotzdem merkwürdig wirken. Gerade bei Rundgängen mit Hotspots oder mehreren Szenen merkst du das oft erst im finalen Layout.

Ich würde deshalb immer so vorgehen:

1. Rundgang in Panorise veröffentlichen.
2. Einmal per iframe oder Shortcode in WordPress einfügen.
3. Die Seite auf Desktop und Smartphone prüfen.
4. Höhe, Abstände und Überschriften noch einmal anpassen.

Das kostet fünf Minuten, spart aber später oft deutlich mehr.

Für welche Seiten sich ein WordPress-Rundgang besonders lohnt

Virtuelle Rundgänge funktionieren in WordPress besonders gut bei Inhalten, bei denen Menschen sich räumlich orientieren wollen.

Typische Beispiele:

• Hotels und Ferienunterkünfte,
• Immobilien und Neubauprojekte,
• Showrooms und Ausstellungsräume,
• Museen oder Veranstaltungsorte
• sowie Agentur- oder Unternehmensseiten mit Referenzprojekten.

Überall dort hilft ein Rundgang dabei, mehr Eindruck zu machen als ein einzelnes Foto oder ein trockener Text.

Sauber eingebunden statt mühsam improvisiert

Einen virtuellen Rundgang in WordPress zu veröffentlichen ist mit Panorise kein Bastelprojekt. Wenn du schnell fertig werden willst, nimm den iframe. Wenn du öfter Inhalte pflegst oder mit mehreren Redakteuren arbeitest, ist das WordPress-Plugin die angenehmere Lösung.

Wichtig ist vor allem:

• Der Rundgang muss veröffentlicht sein.
• Eine Startszene muss gesetzt sein.
• Das Layout sollte genug Höhe bekommen.
• Die Einbindung sollte direkt auf der Zielseite getestet werden.

So wird aus einem technischen Embed kein Notbehelf, sondern ein sauberer Teil deiner WordPress-Seite.