=== Nidoraíz — Ecosistema inmobiliaria ===
Contributors: nidoraiz
Tags: inmobiliaria, real estate, inmuebles, propiedades, colombia
Requires at least: 6.0
Tested up to: 6.8
Requires PHP: 7.4
Stable tag: 0.5.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Tu inventario de nidoraiz en el sitio de tu inmobiliaria: búsqueda, filtros, scroll infinito y fichas listas para Google y los asistentes de IA.

== Description ==

Conecta el sitio WordPress de tu inmobiliaria con nidoraiz, el CRM inmobiliario. Al conectar:

* Tu inventario publicado aparece en `/inmuebles/`, con buscador, filtros (operación, tipo, municipio, barrio, precio, alcobas, baños, parqueaderos, área desde y hasta, estrato, año de construcción, amenidades, con video o recorrido 360°) y scroll infinito.
* El buscador entiende lo que la gente escribe: «casa con piscina» o «algo para estudiantes» encuentran lo que se parece, aunque no tenga esas palabras exactas. Busca solo en los inmuebles de tu inmobiliaria.
* Una página por cada combinación con inmuebles suficientes — `/inmuebles/arriendo/apartamentos/en/envigado/` —, con su título, un párrafo armado solo con datos (cuántos hay, desde y hasta cuánto, de qué área) y enlaces a las combinaciones cercanas. Se indexa con 5 inmuebles o más y entra sola al sitemap.
* Cada inmueble tiene su ficha en tu dominio, pintada en el servidor, con fotos, datos, descripción, amenidades y botón de WhatsApp.
* Las fichas llevan datos estructurados (schema.org `RealEstateListing`) y el primer párrafo con los hechos: lo que leen Google, Bing y los asistentes de IA.
* Los formularios llegan como prospectos a tu CRM, con la autorización de tratamiento de datos (Ley 1581) guardada.
* Lo que cambias en nidoraiz llega solo: nidoraiz avisa y el plugin trae lo nuevo.
* Si vienes de Wasi, las URL viejas de tus inmuebles redirigen a las fichas nuevas.

Funciona con cualquier tema (también Elementor, Astra, Divi y temas de bloques) y se lleva bien con Yoast SEO y Rank Math.

**Shortcodes**

* `[nidoraiz_buscador]` — el buscador, en cualquier página (en Elementor, con el widget «Shortcode»).
* `[nidoraiz_listado cantidad="6" operacion="arriendo"]` — inmuebles para la portada.
* `[nidoraiz_captacion]` — formulario «quiero vender o arrendar mi inmueble».

== Installation ==

1. Sube el plugin y actívalo.
2. En nidoraiz, ve a Documentación API → Sitio web (https://nidoraiz.com/api-docs?tab=sitio-web), agrega el dominio de este sitio y copia el código de conexión.
3. En WordPress, en el menú **Nidoraíz** (se abre solo al activar el plugin), pega el código y pulsa «Conectar».

El sitio tiene que estar en https.

== External services ==

Este plugin se conecta con **nidoraiz** (https://nidoraiz.com), el CRM inmobiliario de la inmobiliaria dueña del sitio. Sin una cuenta de nidoraiz no hace nada, y no se conecta hasta que un administrador pulsa «Conectar».

* **Al conectar** envía a `https://nidoraiz.com/api/sitio/v1/conectar` el código de conexión, el dominio del sitio, la versión del plugin y dos direcciones del sitio (el reto y los avisos). nidoraiz llama una vez al sitio para comprobar que el dominio es de quien conecta.
* **Cuando un visitante busca con palabras** (no un código), el texto de la búsqueda se manda a `https://nidoraiz.com/api/sitio/v1/buscar` para buscar por significado en el inventario de la inmobiliaria, junto con la IP del visitante (solo para el límite de búsquedas; no se guarda). Se puede apagar en Nidoraíz → Ajustes.
* **Para sincronizar** pide a `https://nidoraiz.com/api/sitio/v1/inventario` e `…/inmuebles` el inventario publicado de la inmobiliaria, con la llave del sitio. nidoraiz avisa los cambios a `/wp-json/nidoraiz/v1/evento` (avisos firmados).
* **Cuando un visitante envía un formulario** se manda a `https://nidoraiz.com/api/sitio/v1/leads`: nombre, teléfono, correo, mensaje, la página, el inmueble, la autorización de tratamiento de datos, el origen de la visita (UTM y referente, si los hay), la dirección IP y el navegador del visitante (para frenar el abuso). Solo si la persona acepta la autorización.
* **Las fotos** se muestran desde el CDN de imágenes de nidoraiz (`img.nidoraiz.us`).

Términos: https://nidoraiz.com/terminos · Privacidad: https://nidoraiz.com/privacidad

== Frequently Asked Questions ==

= ¿Se descargan las fotos a mi hosting? =

No. Se muestran desde el CDN de nidoraiz con tamaños adaptados a cada pantalla: tu hosting no se llena.

= ¿Puedo cambiar cómo se ve? =

Sí, sin código: Apariencia → Personalizar → Nidoraíz (o Nidoraíz → Apariencia) cambia el diseño de los filtros (simple, clásico, barra, cajón o columna lateral), de las tarjetas (cinco) y de la ficha (cuatro, uno igual al de nidoraiz), un estilo listo, colores, formas, textos e iconos, con vista previa en vivo. Para cambiar el HTML, copia `templates/ficha.php`, `templates/listado.php` o `templates/partes/*.php` a `tu-tema/nidoraiz/` y edítala. Cada color y tamaño es una variable CSS (`--nrz-acento`, `--nrz-radio`…) que también se puede fijar desde el CSS del tema.

= ¿Qué pasa si nidoraiz no responde? =

El sitio sigue mostrando la última copia del inventario, y el buscador sigue por palabras.

= ¿Las páginas como «casas en venta en Envigado» las tengo que crear? =

No. Salen solas de tu inventario: cuando una combinación llega a 5 inmuebles se indexa y entra al sitemap (`/nidoraiz-inmuebles.xml`, también en el índice de Yoast y Rank Math); si baja de 3, deja de indexarse; sin inmuebles, desaparece.

== Changelog ==

= 0.5.0 =
* Cuatro diseños para la ficha del inmueble, en Apariencia → Personalizar → Nidoraíz → Ficha: «Nidoraíz» (como la ficha de nidoraiz: visor de fotos con flechas, cuenta y miniaturas, tres fotos al lado, chips, cifras con iconos, detalles técnicos y una columna fija con el precio, la inmobiliaria, el formulario y los botones de WhatsApp, correo y llamar), «Clásica» (la de antes), «Portada» (la primera foto a lo ancho con el título y el precio encima) y «Una columna» (como un artículo, con el contacto al final).
* «Ver las N fotos» abre todas las fotos en una ventana encima de la página.
* En el teléfono, una barra fija con el precio, llamar y WhatsApp (se apaga en el Personalizador).
* Cinco diseños para las tarjetas del listado: «Nidoraíz» (el precio sobre la foto, cifras con iconos y «Ver detalles»), «Clásica», «Superpuesta» (todo encima de la foto), «Horizontal» y «Mínima».
* Iconos en las tarjetas (ubicación, alcobas, baños y área) y en la ficha.
* Ajustes nuevos: color de la caja del precio, botón de correo, texto del botón del formulario y de «Ver detalles».

= 0.4.1 =
* Iconos en el buscador: la lupa en el campo de búsqueda; «Más filtros» y «Filtros» con su icono; Precio, Espacios, operación, tipo y municipio en la barra; un icono en cada grupo de filtros; la papelera en «Limpiar» y la X para cerrar el cajón.
* En el cajón y la columna lateral, cada grupo se pliega con su flecha. Abren solos «Qué buscas», «Precio» y los que tienen algo elegido.
* «Más filtros» dice cuántos filtros hay puestos.
* Los iconos se apagan en Apariencia → Personalizar → Nidoraíz → Buscador.

= 0.4.0 =
* Cinco diseños de filtros para escoger en Apariencia → Personalizar → Nidoraíz → Buscador: simple (una línea), clásico (una línea y «Más filtros», con o sin grupos), barra moderna (píldoras como «Precio» o «Espacios» que abren un panel y dicen lo que tienen elegido), cajón (un botón «Filtros» con su cuenta abre un panel de lado) y columna lateral (los filtros a la izquierda de los resultados, a la vista al bajar).
* Los filtros van agrupados: qué buscas, precio, espacios, características y amenidades.
* En el teléfono, el cajón y la columna lateral abren a pantalla completa, los paneles de la barra suben desde abajo y la fila de la barra se desliza de lado.
* Estilos listos de un clic (minimalista, redondeado, corporativo y alto contraste), que después se ajustan a mano.
* Sin color elegido, los botones toman el color principal del tema (temas de bloques, Astra, Kadence y Elementor).
* Campos, píldoras y botones del mismo tamaño de letra, y el ancho de cada campo crece con ella: con temas de letra grande ya no se cortan las opciones.
* Textos nuevos que se pueden cambiar: «Filtros» y «Ver inmuebles».

= 0.3.1 =
* El plugin se llama «Nidoraíz — Ecosistema inmobiliaria».

= 0.3.0 =
* Panel «Nidoraíz» en Apariencia → Personalizar, con vista previa en vivo: colores (principal, botones, texto, precio, fondos, bordes, etiquetas, WhatsApp), esquinas, alto de campos, tamaño del texto, ancho, espacio y sombra; buscador en caja o sin caja, qué filtros se ven, sus textos, cuántas amenidades y si «Más filtros» abre solo; columnas, forma de la foto, qué muestra cada tarjeta; y qué secciones y botones lleva la ficha.
* Los campos del buscador ya no se enciman con temas como Astra.

= 0.2.2 =
* El código de conexión se saca en nidoraiz en Documentación API → Sitio web; el escritorio trae el botón «Abrir nidoraiz» que lleva directo.

= 0.2.1 =
* La búsqueda por palabras también mira la descripción del inmueble (antes solo el título, los datos y las amenidades).

= 0.2.0 =
* Menú propio «Nidoraíz» en el escritorio, con la bienvenida al activar, primeros pasos y ajustes.
* Filtros nuevos: área hasta, año de construcción, amenidades, con video y con recorrido 360°.
* Búsqueda por significado en el inventario de la inmobiliaria, con respaldo por palabras.
* Páginas de combinaciones (operación, tipo y lugar) con texto de datos, enlaces entre ellas, JSON-LD de la lista y sitemap propio.
* Crédito «con tecnología de nidoraiz», apagado por defecto.

= 0.1.0 =
* Primera versión: conexión con código, inventario sincronizado, listado con filtros y scroll infinito, ficha con datos estructurados, formularios con autorización de datos y redirecciones desde Wasi.
