Shortcodes

WP-ImmoMakler ofrece una serie de shortcodes con los que puede integrar elementos inmobiliarios en cualquier página de WordPress, en textos y en widgets. Los shortcodes son la forma más sencilla de insertar elementos sin recurrir a un page builder ni modificar su tema.

Convención de nombres de los shortcodes

Todos los shortcodes de WP-ImmoMakler utilizan guiones (por ejemplo [immomakler-archive]) y no guiones bajos. Variantes como [immomakler_archive] o [immomakler_search_form] no son reconocidas.

Listas y filtros

Lista de inmuebles

[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]

Renderiza una lista de inmuebles en cualquier ubicación. Acepta todos los parámetros de WP_Query como atributos, además de algunos parámetros adicionales de presentación.

Atributo	Descripción	Predeterminado
`columns`	Número de columnas en la lista	Valor de los ajustes de la lista
`vertical`	`1` fuerza un diseño vertical, `0` lo desactiva	Ajuste de la lista
`boxed`	`1` envuelve los inmuebles en una caja	Ajuste de la lista
`limit` / `posts_per_page`	Número máximo de inmuebles mostrados	`-1` (sin límite)
`loadmore`	Número de inmuebles que se cargan con el botón “Cargar más”	`0` (botón desactivado)
`projekt`	Identificador de proyecto de un proyecto inmobiliario – busca unidades con este valor. Es determinante el identificador de proyecto derivado durante la importación a partir de `gruppen_kennung` o `gruppennummer` (véase Campo de agrupación para la asignación de proyectos)	–
`idprefix`	Filtra por números de inmueble que comienzan con el prefijo	–
`show_orderby`	`1` muestra el selector de orden sobre la lista	`0`
`use_order`	Clave de orden inicial (por ejemplo `kaufpreis-asc`)	–
`post__in`	Lista de IDs de entradas de WordPress separadas por comas	–

Adicionalmente puede utilizar parámetros estándar de WP_Query como meta_key, meta_value, orderby, order, tax_query_objektart, etc. Encontrará ejemplos en Inmuebles similares e Integrar inmuebles de referencia.

Formulario de búsqueda

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

Integra el formulario de búsqueda en cualquier ubicación, por ejemplo en una barra lateral o en la página de inicio.

Atributo	Descripción	Predeterminado
`columns`	Número de columnas del formulario de búsqueda	Ajuste del formulario de búsqueda

Si busca formas de personalizar la vista de lista, por ejemplo añadiendo un campo de texto entre el formulario de búsqueda y la lista de inmuebles, no dude en ponerse en contacto con nuestro equipo de soporte.

Búsqueda por número de inmueble

[immomakler-search-for-id]

Renderiza un campo de entrada simple con el que los visitantes pueden buscar directamente por ID de inmueble. Tras enviar el formulario, se redirige a la vista de detalle del inmueble correspondiente.

Visualización de unidades residenciales y comerciales

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

Renderiza una tabla ordenable y responsive con todas las unidades (pisos, oficinas, etc.) de un proyecto inmobiliario. Las unidades pueden presentarse como tabla o en la vista de lista habitual.

Este shortcode está pensado para páginas de proyecto creadas manualmente — es decir, páginas de WordPress propias o landing pages con diseño personalizado que no se generan a través de la vista de detalle de proyecto de WP-ImmoMakler. Indique el proyecto deseado mediante el identificador de proyecto (BAUFELD-A es un marcador de posición). Es determinante el identificador de proyecto que WP-ImmoMakler ha derivado durante la importación — por defecto, el valor de gruppen_kennung; en su defecto, el de gruppennummer. Qué campo se utiliza se controla en Ajustes: Proyectos.

En la página de detalle del proyecto generada por WP-ImmoMakler, la tabla ya está integrada automáticamente bajo los datos del proyecto — no es necesario utilizar el shortcode allí.

De forma predeterminada, toda la fila de la tabla es clicable y abre la página de detalle de la unidad correspondiente. Las columnas para las que no se ha introducido ningún valor (por ejemplo etage en un proyecto en planta baja) se ocultan automáticamente — la lista de columnas de los ajustes es, por tanto, la selección máxima, no la visualización garantizada.

Atributo	Descripción	Predeterminado
`project`	Identificador de proyecto de las unidades — el valor derivado durante la importación a partir de `gruppen_kennung` o `gruppennummer` (véase Campo de agrupación para la asignación de proyectos)	Obligatorio
`meta_key`	Override del modo de coincidencia: `gruppen_kennung` (predeterminado, comprueba el identificador de proyecto) o `objektnr_extern_prefix` (busca unidades cuyo ID de inmueble comienza con el del proyecto)	Valor de los ajustes
`columns`	Lista de columnas (claves meta) separadas por comas, p. ej. `objektnr_extern,etage,anzahl_zimmer,flaeche,preis`	Valor de los ajustes
`sortable`	`1`/`0` – ordenación en el cliente	`1`
`link_row`	`1`/`0` – enlazar la fila completa	Ajuste (predeterminado: `1`)
`link_id`	`1`/`0` – enlazar solo el ID del inmueble	Ajuste
`show_status`	`1`/`0` – añadir la columna de estado / disponibilidad	Ajuste
`show_details`	`1`/`0` – añadir una columna con icono de información a la derecha	Ajuste
`expandable`	`1`/`0` – filas de detalle desplegables (acordeón) en lugar de enlace en la fila	Ajuste (predeterminado: `0`)
`cover_source`	`title_image` (imagen de portada) o `floorplan` (plano) – imagen de previsualización en el panel de detalle de las filas desplegables	Ajuste (predeterminado: `floorplan`)
`contact`	`1`/`0` – botón «Contactar» en el panel de detalle desplegable que abre el formulario de contacto de la unidad correspondiente	Ajuste (predeterminado: `1`)
`default_sort`	Columna por la que se preordena la tabla al cargarse (por ejemplo `etage`, `preis`, `flaeche`)	Ajuste (predeterminado: `objektnr_extern`)
`default_sort_order`	`asc` (ascendente) o `desc` (descendente) – dirección de la preordenación	Ajuste (predeterminado: `asc`)

Ordenación predeterminada: La columna y la dirección en que se preordena la tabla al cargarse se definen globalmente en el backend de su sitio web (wp-admin) en WP-ImmoMakler → Ajustes → Proyectos mediante las opciones «Ordenación predeterminada: columna» y «Ordenación predeterminada: dirección»; por cada inserción, puede sobrescribir esto con los atributos default_sort y default_sort_order. A continuación, sus visitantes pueden reordenar cualquier columna haciendo clic en su encabezado. La columna de planta se ordena de forma lógica (planta baja antes que 1.ª planta antes que 2.ª planta antes que ático), no puramente alfabética. Las unidades sin valor en la columna de ordenación se sitúan al final en ambas direcciones.

Claves de columna disponibles: objektnr_extern, objekttitel, etage, anzahl_zimmer, flaeche (superficie habitable/útil/comercial según el tipo de inmueble), wohnflaeche, nutzflaeche, gesamtflaeche, preis, kaufpreis, kaltmiete, warmmiete, status. También se pueden utilizar cualesquiera otras claves meta. Las columnas vacías — aquellas para las que ninguna unidad proporciona un valor — se eliminan automáticamente; las columnas objektnr_extern y details se conservan siempre, ya que funcionan como ancla de fila y enlace de icono de información incluso sin contenido de texto propio.

Filas de detalle desplegables (acordeón): Active la opción «Filas de detalle desplegables» en el backend de su sitio web (wp-admin) en WP-ImmoMakler → Ajustes → Proyectos. Al hacer clic en una fila de la tabla se abre directamente debajo un panel de detalle con baño, aseo, balcón/terraza, tipo de calefacción y una imagen de previsualización; al hacer clic en la imagen se abre la galería de imágenes completa (fotos y planos). Con la opción «Imagen de previsualización en el panel de detalle» puede elegir entre el primer plano (predeterminado, con Fallback a la imagen de portada si no existe ninguno) y la imagen de portada (primera foto). El contenido del detalle se carga solo al desplegar la fila, de modo que incluso los proyectos con muchas unidades cargan rápidamente. Cuando las filas de detalle están activadas, la opción «Fila de tabla completa clicable» no tiene efecto — la página de detalle de la unidad sigue siendo accesible a través de la columna de detalles o del ID del inmueble vinculado.

Configuración de los campos de datos en el panel de detalle: Los campos que aparecen en el panel de detalle desplegable se definen — de forma análoga a las columnas de la tabla — a través del ajuste «Campos de datos en el panel de detalle» como una lista separada por comas (valor predeterminado: anzahl_badezimmer,anzahl_sep_wc,balkon_terrasse,heizungsart). Los campos especiales balkon_terrasse (número combinado de balcones/terrazas) y heizungsart (lista de tipos de calefacción) se procesan de forma especial; cualquier otra clave se trata como un campo meta del inmueble y se formatea igual que una columna de la tabla (por ejemplo, wohnflaeche, anzahl_zimmer, baujahr). Los campos sin valor se ocultan automáticamente.

Formulario de contacto en el panel de detalle: Cuando las filas de detalle están activadas, cada panel de detalle desplegado muestra de forma predeterminada un botón «Contactar». Al hacer clic, se abre directamente debajo el formulario de contacto de WP-ImmoMakler para esa unidad concreta — la consulta se envía a la persona de contacto responsable de la unidad, sin que sus visitantes tengan que abandonar la página del proyecto. La función está activada de forma predeterminada; puede desactivarla en el backend de su sitio web (wp-admin) en WP-ImmoMakler → Ajustes → Proyectos mediante la opción «Formulario de contacto en el panel de detalle» o, para cada inserción, mediante el atributo contact="0". El botón solo aparece en unidades para las que también se muestra un formulario de contacto en la página de detalle de la unidad (estado «disponible»; en el caso de «reservado», depende del ajuste correspondiente).

Ampliación: El icono de información de la columna de detalles puede sustituirse por su propio marcado SVG mediante el filtro immomakler_project_units_details_icon. El texto del botón de contacto en el panel de detalle puede personalizarse mediante el filtro immomakler_project_units_contact_button_label.

Alertas de búsqueda

Formulario compacto de alerta de búsqueda

[immomakler-searchagents-form]

Renderiza un formulario compacto de alerta de búsqueda con los campos más importantes. Solo se muestra en páginas de archivo de WP-ImmoMakler.

Formulario completo de alerta de búsqueda

[immomakler-searchagents-form-full]

Renderiza el formulario completo de alerta de búsqueda con todos los campos disponibles. Funciona en cualquier página.

Formulario de edición

[immomakler-searchagents-edit]

Alias del formulario completo, pensado para la página a la que apunta el enlace de edición de los correos electrónicos de alertas de búsqueda.

Encontrará información sobre los campos del formulario y cómo configurarlos en el backend en Configurar las alertas de búsqueda de inmuebles.

Mapa de Google Maps

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

Muestra un mapa de Google Maps con los inmuebles seleccionados por el filtro actual. En una página de listado sin atributos, el shortcode adopta automáticamente el filtrado vigente.

Acepta los mismos atributos WP_Query que [immomakler-archive]. posts_per_page está limitado a un máximo de 1000.

Carousel

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

Muestra inmuebles seleccionados en forma de carousel. Configurable mediante los ajustes de WP-ImmoMakler. Acepta los mismos atributos de filtrado que [immomakler-archive].

Más detalles: Configurar el Carousel.

Indicador de la lista de favoritos

[immomakler-cart-indicator]

Renderiza un botón con contador que muestra el número de inmuebles guardados. Adecuado para menús, cabeceras o barras laterales. Requiere que la lista de favoritos esté activada; detalles: Configurar la lista de favoritos.

Formulario de contacto

[immomakler-contact]
[immomakler-contact recipient="info@ejemplo.com" subject="Consulta desde landing page"]
[immomakler-contact propertyid=12345]

Renderiza un formulario de contacto independiente cuyo destinatario y asunto puede personalizar en cada inserción. Adecuado para landing pages o páginas de contacto.

Atributo	Descripción	Predeterminado
`recipient`	Dirección de correo electrónico del destinatario	Ajuste global de destinatario
`subject`	Línea de asunto del correo	Asunto predeterminado
`propertyid`	ID de entrada de WordPress del inmueble al que se refiere la consulta	–

Encontrará indicaciones sobre la configuración de los campos, los campos obligatorios y los avisos del RGPD en Formulario de contacto.

Plantillas de page builder

Para su uso dentro de plantillas de page builder (Elementor, Divi, Bricks, Oxygen, WPBakery), WP-ImmoMakler proporciona shortcodes adicionales como [immomakler-template-archive], [immomakler-single], [immomakler-template-single-gallery], [immomakler-template-single-map], [immomakler-template-single-videos], [immomakler-template-single-downloads-links] y [immomakler-template-single-contact]. No están pensados para páginas normales, sino que se utilizan exclusivamente en los ajustes de plantilla de su page builder. La mayoría de los page builders ofrecen widgets propios para el mismo fin; consulte Elementor Pro y los demás artículos sobre page builders.

Integrar shortcodes en páginas

Abra cualquier página de WordPress en el editor e inserte el shortcode deseado. En el editor de Gutenberg, utilice para ello el bloque Shortcode.

En plantillas PHP o en el WP-ImmoMakler Child-Skin-Plugin puede generar shortcodes con do_shortcode():

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