Shortcodes

Esta página aún no está disponible en tu idioma.

WP-ImmoMakler stellt eine Reihe von Shortcodes bereit, mit denen Sie Immobilienelemente auf beliebigen WordPress-Seiten, in Texten und in Widgets einbinden können. Shortcodes sind die einfachste Methode, Elemente ohne Page-Builder oder Theme-Anpassungen einzusetzen.

Schreibweise der Shortcode-Namen

Alle WP-ImmoMakler-Shortcodes verwenden Bindestriche (z. B. [immomakler-archive]) – nicht Unterstriche. Schreibweisen wie [immomakler_archive] oder [immomakler_search_form] werden nicht erkannt.

Listen und Filter

Immobilienliste

[immomakler-archive]
[immomakler-archive vermarktungsart=kauf posts_per_page=6 columns=3]
[immomakler-archive projekt=BAUFELD-A columns=2]
[immomakler-archive idprefix=2026- limit=10 loadmore=10]

Rendert eine Immobilienliste an beliebiger Stelle. Akzeptiert sämtliche WP_Query-Parameter als Attribute und einige zusätzliche Darstellungs-Parameter.

Attribut	Beschreibung	Standard
`columns`	Anzahl der Spalten in der Liste	Wert aus den Listen-Einstellungen
`vertical`	`1` erzwingt vertikales Layout, `0` deaktiviert es	Listen-Einstellung
`boxed`	`1` legt die Objekte in eine Box	Listen-Einstellung
`limit` / `posts_per_page`	Maximale Anzahl der angezeigten Objekte	`-1` (keine Begrenzung)
`loadmore`	Anzahl der Objekte, die per “Weitere laden”-Button nachgeladen werden	`0` (Button aus)
`projekt`	Gruppenkennung eines Bauprojekts – matcht Einheiten mit diesem Wert in `gruppen_kennung` oder `gruppennummer` (beide OpenImmo-Felder werden automatisch geprüft)	–
`idprefix`	Filtert auf Objektnummern, die mit dem Präfix beginnen	–
`show_orderby`	`1` zeigt Sortier-Auswahl über der Liste	`0`
`use_order`	Initialer Sortierschlüssel (z. B. `kaufpreis-asc`)	–
`post__in`	Komma-separierte Liste von WordPress-Post-IDs	–

Zusätzlich können Sie Standard-WP_Query-Parameter wie meta_key, meta_value, orderby, order, tax_query_objektart etc. einsetzen. Beispiele finden Sie unter Ähnliche Objekte anzeigen und Referenzobjekte einbinden.

Suchmaske

[immomakler-search-form]
[immomakler-search-form columns=4]

Bettet die Suchmaske an beliebiger Stelle ein, etwa in einer Sidebar oder auf der Startseite.

Attribut	Beschreibung	Standard
`columns`	Anzahl der Spalten der Suchmaske	Suchmasken-Einstellung

Wenn Sie nach Möglichkeiten suchen, die Listenansicht zu individualisieren, also z.B. ein Textfeld zwischen die Suchmaske und die Immobilienliste einzubauen, wenden Sie sich gerne an unseren Support.

Suche nach Objektnummer

[immomakler-search-for-id]

Rendert ein einfaches Eingabefeld, mit dem Besucher direkt nach einer Objekt-ID suchen können. Nach dem Absenden wird zur Detailansicht des passenden Objekts weitergeleitet.

Darstellung von Wohn-/ Gewerbeeinheiten

[immomakler-project-units project=BAUFELD-A]

Rendert eine sortierbare, responsive Tabelle aller Einheiten (Wohnungen, Büros etc.) eines Bauprojekts. Die Wohneinheiten können als Tabelle oder in der gewohnten Listenansicht dargestellt werden.

Dieser Shortcode ist gedacht für manuell erstellte Projektseiten – also eigene WordPress-Seiten oder Landingpages mit individuellem Layout, die nicht über die WP-ImmoMakler-Projekt-Detailansicht generiert werden. Geben Sie das gewünschte Projekt über die Projekt-Kennung an (BAUFELD-A ist hier ein Platzhalter; tragen Sie den Wert aus gruppen_kennung oder gruppennummer Ihres Projekts ein – Sie müssen nicht wissen, welches der beiden OpenImmo-Felder Ihr Export befüllt, beide werden geprüft).

Auf der von WP-ImmoMakler erzeugten Projekt-Detailseite ist die Tabelle bereits automatisch unterhalb der Projektdaten eingebunden – dort benötigen Sie den Shortcode nicht.

Standardmäßig ist die ganze Tabellenzeile klickbar und öffnet die Detailseite der jeweiligen Einheit. Spalten, für die kein Wert hinterlegt ist (z. B. etage bei einem ebenerdigen Projekt), werden automatisch ausgeblendet – die Spaltenliste in den Einstellungen ist also die maximale Auswahl, nicht die garantierte Anzeige.

Attribut	Beschreibung	Standard
`project`	Projekt-Kennung der Einheiten – die `gruppen_kennung` bzw. `gruppennummer` Ihres Projekts. Beide OpenImmo-Felder werden automatisch geprüft	Erforderlich
`meta_key`	Override des Zuordnungsmodus: `gruppen_kennung` (Standard, gleicht beide Gruppenfelder ab) oder `objektnr_extern_prefix` (matcht Einheiten, deren Objekt-ID mit der des Projekts beginnt)	Wert aus den Einstellungen
`columns`	Komma-separierte Liste der Spalten (Meta-Schlüssel), z. B. `objektnr_extern,etage,anzahl_zimmer,flaeche,preis`	Wert aus den Einstellungen
`sortable`	`1`/`0` – clientseitige Sortierung	`1`
`link_row`	`1`/`0` – ganze Zeile verlinken	Einstellung (Standard: `1`)
`link_id`	`1`/`0` – nur die Objekt-ID verlinken	Einstellung
`show_status`	`1`/`0` – Status-/Verfügbarkeitsspalte ergänzen	Einstellung
`show_details`	`1`/`0` – Info-Icon-Spalte rechts ergänzen	Einstellung
`expandable`	`1`/`0` – aufklappbare Detailzeilen (Akkordeon) statt Zeilen-Verlinkung	Einstellung (Standard: `0`)
`cover_source`	`title_image` (Titelbild) oder `floorplan` (Grundriss) – Vorschaubild im Detailfeld der aufklappbaren Zeilen	Einstellung (Standard: `floorplan`)
`contact`	`1`/`0` – Button „Kontakt aufnehmen” im aufklappbaren Detailfeld, der das Kontaktformular der jeweiligen Einheit öffnet	Einstellung (Standard: `1`)
`default_sort`	Spalte, nach der die Tabelle beim Laden vorsortiert wird (z. B. `etage`, `preis`, `flaeche`)	Einstellung (Standard: `objektnr_extern`)
`default_sort_order`	`asc` (aufsteigend) oder `desc` (absteigend) – Richtung der Vorsortierung	Einstellung (Standard: `asc`)

Standard-Sortierung: Über welche Spalte und in welche Richtung die Tabelle beim Laden vorsortiert wird, legen Sie global im Backend Ihrer Website (wp-admin) unter WP-ImmoMakler → Einstellungen → Projekte über die Optionen „Standard-Sortierung: Spalte” und „Standard-Sortierung: Richtung” fest; pro Einbindung überschreiben Sie das mit den Attributen default_sort und default_sort_order. Ihre Besucher können anschließend jede Spalte per Klick auf die Überschrift umsortieren. Die Etagen-Spalte wird dabei sinnvoll gereiht (Erdgeschoss vor 1. OG vor 2. OG vor Dachgeschoss), nicht rein alphabetisch. Einheiten ohne Wert in der Sortierspalte stehen in beiden Richtungen am Ende.

Verfügbare Spalten-Schlüssel: objektnr_extern, objekttitel, etage, anzahl_zimmer, flaeche (Wohn-/Nutz-/Gewerbefläche je nach Objekttyp), wohnflaeche, nutzflaeche, gesamtflaeche, preis, kaufpreis, kaltmiete, warmmiete, status. Beliebige weitere Meta-Schlüssel sind ebenfalls möglich. Leere Spalten – also solche, für die keine einzige Einheit einen Wert liefert – werden automatisch entfernt; die Spalten objektnr_extern und details bleiben immer erhalten, da diese als Zeilen-Anker bzw. Info-Symbol-Link auch ohne eigenen Textinhalt eine Funktion haben.

Aufklappbare Detailzeilen (Akkordeon): Aktivieren Sie im Backend Ihrer Website (wp-admin) unter WP-ImmoMakler → Einstellungen → Projekte die Option „Aufklappbare Detailzeilen”. Ein Klick auf eine Tabellenzeile öffnet dann direkt darunter ein Detailfeld mit einem Vorschaubild und – standardmäßig – Bad, WC, Balkon/Terrasse und Heizungsart; ein Klick auf das Bild öffnet die vollständige Bildergalerie (Fotos und Grundrisse). Über die Option „Vorschaubild im Detailfeld” wählen Sie zwischen dem ersten Grundriss (Standard, mit Fallback auf das Titelbild, falls keiner vorhanden ist) und dem Titelbild (erstes Foto). Die Detailinhalte werden erst beim Aufklappen nachgeladen, damit auch Projekte mit vielen Einheiten schnell laden. Bei aktivierten Detailzeilen ist die Option „Ganze Tabellenzeile klickbar” wirkungslos – die Detailseite der Einheit bleibt über die Details-Spalte oder die verlinkte Objekt-ID erreichbar.

Datenfelder im Detailfeld konfigurieren: Welche Felder im aufklappbaren Detailfeld erscheinen, legen Sie – analog zu den Tabellenspalten – über die Einstellung „Datenfelder im Detailfeld” als komma-separierte Liste fest (Standard: anzahl_badezimmer,anzahl_sep_wc,balkon_terrasse,heizungsart). Die Sonderfelder balkon_terrasse (kombinierte Anzahl Balkone/Terrassen) und heizungsart (Liste der Heizungsarten) werden speziell aufbereitet; jeder andere Schlüssel wird als Objekt-Meta-Feld behandelt und genau wie eine Tabellenspalte formatiert (z.B. wohnflaeche, anzahl_zimmer, baujahr). Felder ohne Wert werden automatisch ausgeblendet.

Kontaktformular im Detailfeld: Bei aktivierten Detailzeilen zeigt jedes aufgeklappte Detailfeld standardmäßig einen Button „Kontakt aufnehmen”. Ein Klick öffnet direkt darunter das WP-ImmoMakler-Kontaktformular für genau diese Einheit – eine Anfrage geht an die zuständige Ansprechperson der Einheit, ohne dass Ihre Besucher die Projektseite verlassen müssen. Die Funktion ist standardmäßig aktiv; abschalten können Sie sie im Backend Ihrer Website (wp-admin) unter WP-ImmoMakler → Einstellungen → Projekte über die Option „Kontaktformular im Detailfeld” oder pro Einbindung über das Attribut contact="0". Der Button erscheint nur bei Einheiten, für die auch auf der Einheiten-Detailseite ein Kontaktformular angezeigt wird (Status „offen”; bei „reserviert” abhängig von der entsprechenden Einstellung).

Erweitern: Das Info-Symbol der Details-Spalte lässt sich über den Filter immomakler_project_units_details_icon durch eigenes SVG-Markup ersetzen. Die Beschriftung des Kontakt-Buttons im Detailfeld passen Sie über den Filter immomakler_project_units_contact_button_label an.

Suchaufträge

Kompaktes Suchauftrags-Formular

[immomakler-searchagents-form]

Rendert ein kompaktes Suchauftrags-Formular mit den wichtigsten Feldern.

Vollständiges Suchauftrags-Formular

[immomakler-searchagents-form-full]

Rendert das vollständige Suchauftrags-Formular mit allen verfügbaren Feldern. Funktioniert auf beliebigen Seiten.

Bearbeitungsformular

[immomakler-searchagents-edit]

Alias für das vollständige Formular, gedacht für die Seite, auf die der Bearbeitungs-Link aus den Suchauftrags-E-Mails verweist.

Welche Felder das Formular enthält und wie Sie diese im Backend konfigurieren, ist unter Immobilien-Suchaufträge konfigurieren beschrieben.

Google-Maps-Karte

[immomakler-map]
[immomakler-map vermarktungsart=miete posts_per_page=200]
[immomakler-map post__in=123,456,789]

Zeigt eine Google-Maps-Karte mit den per Filter ausgewählten Immobilien. Auf einer Listen-Seite ohne Attribute übernimmt der Shortcode automatisch die aktuelle Filterung.

Akzeptiert dieselben WP_Query-Attribute wie [immomakler-archive]. posts_per_page ist auf maximal 1000 begrenzt.

Carousel

[immomakler-carousel]
[immomakler-carousel vermarktungsart=kauf limit=12]
[immomakler-carousel projekt=BAUFELD-A]

Zeigt ausgewählte Immobilien als Carousel an. Konfigurierbar über die WP-ImmoMakler-Einstellungen. Akzeptiert dieselben Filter-Attribute wie [immomakler-archive].

Weitere Details: Carousel einrichten.

Merklisten-Indikator

[immomakler-cart-indicator]

Rendert einen Button mit Zähler, der die Anzahl der gemerkten Objekte anzeigt. Eignet sich für Menüs, Header oder Sidebars. Erfordert eine aktivierte Merkliste; Details: Merkliste einrichten.

Kontaktformular

[immomakler-contact]
[immomakler-contact recipient="info@beispiel.de" subject="Anfrage Landingpage"]
[immomakler-contact propertyid=12345]

Rendert ein eigenständiges Kontaktformular, dessen Empfänger und Betreff Sie pro Einbindung steuern können. Geeignet für Landingpages oder Kontaktseiten.

Attribut	Beschreibung	Standard
`recipient`	Empfänger-E-Mail-Adresse	Globale Empfänger-Einstellung
`subject`	Betreffzeile der E-Mail	Standard-Betreff
`propertyid`	WordPress-Post-ID einer Immobilie, auf die sich die Anfrage bezieht	–

Hinweise zur Konfiguration der Felder, Pflichtfelder und DSGVO-Hinweise finden Sie unter Kontaktformular konfigurieren.

Page-Builder-Templates

Für den Einsatz innerhalb von Page-Builder-Templates (Elementor, Divi, Bricks, Oxygen, WPBakery) stellt WP-ImmoMakler zusätzliche Shortcodes wie [immomakler-template-archive], [immomakler-single], [immomakler-template-single-gallery], [immomakler-template-single-map], [immomakler-template-single-videos], [immomakler-template-single-downloads-links] und [immomakler-template-single-contact] bereit. Diese sind nicht für reguläre Seiten gedacht, sondern werden ausschließlich in den Template-Einstellungen Ihres Page-Builders verwendet. In den meisten Page-Buildern stehen dafür eigene Widgets zur Verfügung; siehe Elementor Pro und die übrigen Page-Builder-Artikel.

Shortcodes in Seiten einbinden

Öffnen Sie eine beliebige WordPress-Seite im Editor und fügen Sie den gewünschten Shortcode ein. Im Gutenberg-Editor verwenden Sie dazu den Block Shortcode.

In PHP-Templates oder im WP-ImmoMakler Child-Skin-Plugin können Sie Shortcodes mit do_shortcode() ausgeben:

echo do_shortcode( '[immomakler-archive vermarktungsart=kauf posts_per_page=3]' );