Antes de empezar
- Cuenta verificada en Multilistado (gratis). El widget se crea en Portal → Más → Widget IDX.
- WordPress 5.8 o posterior y PHP 7.4 o posterior en tu hosting.
- WordPress.com: instalar plugins requiere un plan de pago (Personal, Premium, Business o Commerce, según WordPress.com, consultado el 2026-09-30). En el plan gratuito usa la opción de iframe si tu plan permite HTML, o enlaza a tu sitio de Multilistado.
- El plugin es solo un «embed»: guarda tu ID y unos ajustes, no hace llamadas desde tu servidor y no copia propiedades a tu base de datos. Los navegadores de tus visitantes cargan el buscador desde multilistado.mx.
Gratis para agentes e inmobiliarias con licencia. Crea tu cuenta, verifica tu licencia y genera tu API key o tu widget en minutos.
Pasos
1. Crea tu widget y copia el ID
En multilistado.mx/portal/widget pulsa Crear widget. Elige ¿Qué propiedades muestra? (todo el Multilistado o solo las tuyas), filtros, idioma y colores, y pulsa Guardar. El ID es el código de 24 caracteres (números y letras a–f) que aparece en la sección WordPress, por ejemplo 3f9a0c1e2b4d5a6c7e8f9012.
2. Descarga el plugin
Descargar multilistado-idx.zip (versión 1.0.0, licencia GPL-2.0-or-later). No lo descomprimas: WordPress necesita el archivo .zip.
3. Súbelo e instálalo
En el escritorio de WordPress (etiquetas de WordPress 6.x/7.x en español de México, verificadas el 2026-09-30 en translate.wordpress.org y la documentación oficial):
- Plugins → Agregar plugin (en español de España: «Añadir plugin»; en versiones anteriores: «Añadir nuevo»).
- Pulsa Subir plugin (arriba) y elige
multilistado-idx.zip. - Instalar ahora → Activar plugin.
En WordPress.com (vista predeterminada): Plugins → Subir y arrastra el .zip; se instala y activa solo.
4. Pega tu ID
Ajustes → Multilistado IDX:
| Campo | Qué poner |
|---|---|
| ID de widget | Tu ID de 24 caracteres |
| Modo de inserción | Script (recomendado: altura automática). Usa «iframe simple» solo si un plugin de seguridad u optimización bloquea scripts externos |
| Altura inicial (px) | 900 (300–4000). Con el modo script la altura se ajusta sola |
| Enlace «Ver todas las propiedades» | Opcional: la dirección https de tu sitio gratuito de Multilistado. El contenido de un iframe no le da posicionamiento a tu sitio; un enlace normal sí |
Pulsa Guardar cambios.
5. Agrega el buscador a una página
Editor de bloques (Gutenberg): agrega el bloque Multilistado (categoría «Incrustados»). En el panel lateral elige Mostrar: «Barra de búsqueda + resultados» o «Solo resultados», y opcionalmente ciudad, tipo y operación. En el editor verás un recuadro; el buscador aparece en la página publicada.
Código corto: agrega un bloque Shortcode (se llama igual en español) y pega:
[multilistado_busqueda][multilistado_propiedades ciudad="Tijuana" tipo="casa" operacion="venta"][multilistado_busqueda estado="Baja California" precio_min="2000000" precio_max="6000000" recamaras="3" vista="map" idioma="es"]Usa el generador de código para armarlo sin errores.
6. Prueba
Abre la página publicada (en una ventana privada, sin sesión), haz una búsqueda, abre una propiedad y envía una solicitud de información con tus datos. Debe aparecer en Portal → Leads con origen widget:<tu ID>. Revisa también en el celular.
Atributos del código corto
| Atributo | Valores | Ejemplo |
|---|---|---|
ciudad | Nombre de la ciudad (coincidencia parcial, sin acentos) | ciudad="Rosarito" |
estado | Nombre exacto del estado | estado="Baja California" |
colonia | Colonia o fraccionamiento (parcial) | colonia="Playas de Tijuana" |
tipo | casa, departamento, terreno, oficina, local, bodega, rancho, edificio, otro (o en inglés: house, apartment…) | tipo="departamento" |
operacion | venta o renta | operacion="renta" |
precio_min, precio_max | Número sin comas (en la moneda de cada propiedad; no se convierte) | precio_max="5000000" |
recamaras | Mínimo de recámaras (1–19) | recamaras="2" |
idioma | es o en (por omisión, el del widget) | idioma="en" |
vista | grid (cuadrícula), list (lista) o map (mapa) | vista="map" |
altura | Altura inicial en px (300–4000) | altura="1200" |
widget | Otro ID de widget (si tienes varios) | widget="3f9a…" |
enlace | no oculta el enlace «Ver todas las propiedades» en esta página | enlace="no" |
Los filtros del código corto reemplazan los predeterminados del widget; el visitante puede cambiarlos desde la barra de búsqueda. «Resultados por página» se configura en el widget (portal).
Elementor, Divi y otros constructores
- Elementor: arrastra el widget Shortcode y pega
[multilistado_busqueda](o el widget HTML con el código de script). Ambos están en Elementor gratuito (ayuda de Elementor, consultada el 2026-09-30). - Divi: agrega el módulo Code («Código» en español; etiqueta no verificada) y pega el código corto o el script (documentación de Divi, consultada el 2026-09-30).
- Otros (WPBakery, Beaver Builder, Bricks…): cualquier elemento que acepte códigos cortos o «HTML personalizado» sirve.
- Sin plugin: agrega un bloque HTML personalizado con el script. Guardar
<script>requiere el permisounfiltered_html(administradores y editores en un sitio normal; en multisitio solo súper administradores).
Problemas comunes
| Síntoma | Solución |
|---|---|
| Aparece «Multilistado IDX: configura tu ID de widget en Ajustes → Multilistado IDX.» | Solo lo ven los administradores: falta el ID o no tiene 24 caracteres. |
| No aparece nada | Revisa que el widget esté Activo en el portal; desactiva la «optimización de JavaScript» (retrasar/combinar scripts) para multilistado.mx, o cambia a iframe simple. |
| «Este widget no está disponible.» | El widget fue desactivado o eliminado, o el ID es incorrecto. |
| Se ve cortado o con barra de desplazamiento | Usa el modo Script; en modo iframe sube la Altura inicial. |
| No se muestra en tu dominio | Si llenaste Dominios permitidos en el portal, agrega tu dominio (misitio.com cubre también www.misitio.com). |
Desinstalar
Desactiva y elimina el plugin en Plugins; al eliminarlo se borran sus ajustes. Si eliminas o desactivas el widget en el portal, el código deja de mostrarse en todos los sitios.