# Buscador del Multilistado en WordPress

Instala el plugin gratuito «Multilistado IDX», pega el ID de tu widget y agrega el bloque o un código corto en cualquier página. No hace falta programar.

Fuente: https://multilistado.mx/developers/wordpress · Actualizado: 2026-09-30 · Otro idioma: https://multilistado.mx/developers/wordpress.md?lang=en

## Antes de empezar

- **Cuenta verificada en Multilistado** (gratis). El widget se crea en [Portal → Más → Widget IDX](https://multilistado.mx/portal/widget).
- **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](https://wordpress.com/support/plugins/install-a-plugin/), consultado el 2026-09-30). En el plan gratuito usa la opción de [iframe](https://multilistado.mx/developers/widget#html) 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.

Crea tu API key gratis en https://multilistado.mx/portal/api-keys (agentes verificados).

## Pasos

### 1. Crea tu widget y copia el ID

En [multilistado.mx/portal/widget](https://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](https://multilistado.mx/descargas/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](https://translate.wordpress.org/) y la [documentación oficial](https://wordpress.org/documentation/article/manage-plugins/)):

1. **Plugins → Agregar plugin** (en español de España: «Añadir plugin»; en versiones anteriores: «Añadir nuevo»).
2. Pulsa **Subir plugin** (arriba) y elige `multilistado-idx.zip`.
3. **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:

```text
[multilistado_busqueda]
```

```text
[multilistado_propiedades ciudad="Tijuana" tipo="casa" operacion="venta"]
```

```text
[multilistado_busqueda estado="Baja California" precio_min="2000000" precio_max="6000000" recamaras="3" vista="map" idioma="es"]
```

Usa el [generador de código](https://multilistado.mx/developers/widget#generador) 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](https://multilistado.mx/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](https://multilistado.mx/developers/widget#script)). Ambos están en Elementor gratuito ([ayuda de Elementor](https://elementor.com/help/shortcode-widget/), 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](https://www.elegantthemes.com/documentation/divi/code/), 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](https://multilistado.mx/developers/widget#script). Guardar `<script>` requiere el permiso `unfiltered_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.