=== ViveSol Inmo Connect ===
Contributors: vivesol
Tags: real estate, property listings, inmobiliaria, inmuebles, agencia inmobiliaria
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.1.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Convierte WordPress en un portal inmobiliario con un único plugin: inmuebles, agentes, estadísticas de ventas y mapas interactivos.

== Description ==

Convierte WordPress en un portal inmobiliario profesional con un único plugin.

Gestiona fichas de inmuebles, agentes, estadísticas reales de ventas, mapas interactivos, formularios de contacto avanzados y mucho más desde un único panel.

Además, permite publicar automáticamente tus inmuebles en el portal inmobiliario colaborativo ViveSol.es mediante una API gratuita y opcional.

= Funciones principales =

* Gestión de inmuebles desde WordPress.
* Listados públicos de inmuebles con filtros avanzados.
* Mapa interactivo de inmuebles opcional.
* Fichas individuales de inmuebles.
* Galería de imágenes.
* Gestión de agentes inmobiliarios.
* Formularios y datos de contacto de la agencia.
* Carrusel de inmuebles destacados.
* Estadísticas de inmuebles y ventas.
* Enlace opcional al simulador hipotecario.
* Sincronización opcional con la red inmobiliaria ViveSol.

ViveSol Inmo Connect funciona sin necesidad de una cuenta de ViveSol ni de una clave API. La sincronización con la API de ViveSol está desactivada por defecto y solo puede activarse manualmente por el administrador del sitio.

= Shortcodes disponibles =

El plugin incluye los siguientes shortcodes:

* `[vivesol_map]` - Muestra un mapa interactivo de inmuebles cuando los mapas de OpenStreetMap han sido activados por el administrador del sitio.
* `[vivesol_grid_listings]` - Muestra un listado público de inmuebles con filtros avanzados.
* `[vivesol_search]` - Muestra un formulario independiente de búsqueda de propiedades y presenta los resultados que coinciden tras realizar la búsqueda.
* `[vivesol_single_listing]` - Muestra la ficha de un inmueble individual.
* `[vivesol_data_agency]` - Muestra los datos de contacto de la agencia.
* `[vivesol_featured_carousel]` - Muestra un carrusel de inmuebles destacados.
* `[vivesol_agents]` - Muestra los agentes inmobiliarios públicos.

= Sincronización opcional con la API de ViveSol =

El plugin puede sincronizar opcionalmente los datos de los inmuebles con la red inmobiliaria colaborativa ViveSol.

Esta función está desactivada por defecto. Solo funciona cuando el administrador del sitio activa la conexión API, introduce una clave API válida y acepta el texto de consentimiento mostrado en los ajustes del plugin.

Cuando está activada, el plugin envía datos de inmuebles a ViveSol para su publicación en la red inmobiliaria colaborativa.

Los datos enviados pueden incluir:

* URL del sitio web de origen.
* URL del inmueble de origen.
* ID del inmueble.
* Referencia o título del inmueble.
* Tipo de operación.
* Tipo de inmueble.
* Precio y estado de visibilidad del precio.
* Número de habitaciones.
* Número de baños.
* Metros cuadrados.
* Descripción del inmueble.
* Teléfono de contacto.
* Correo electrónico de la agencia.
* Número de WhatsApp de la agencia.
* Provincia.
* Latitud y longitud.
* Estado de URL externa del anuncio.
* Estado de inmueble destacado.
* Estado de publicación del inmueble.
* URLs de las imágenes del inmueble.

No se envían datos a ViveSol hasta que el administrador del sitio activa manualmente la conexión API.

Más información:

* Documentación: https://vivesol.es/ayuda/
* Soporte: https://vivesol.es/contacto/
* Política de privacidad: https://vivesol.es/politica-de-privacidad/

== Servicios externos ==

El plugin utiliza los siguientes servicios externos únicamente cuando se activa o utiliza la funcionalidad correspondiente.

= API de ViveSol =

URL del servicio: https://vivesol.es

Finalidad: sincronización opcional de inmuebles con la red inmobiliaria ViveSol, enlace opcional al simulador hipotecario y distintivo público opcional de integración con ViveSol.

Cuando el administrador del sitio activa la sincronización mediante API e introduce una clave API válida, se envían datos de inmuebles y agencia a ViveSol para que los inmuebles puedan publicarse en la red inmobiliaria colaborativa.

La conexión API está desactivada por defecto y requiere una acción expresa del administrador del sitio.

El enlace opcional al simulador hipotecario y el distintivo público "Integrado con ViveSol.es" están desactivados por defecto. Solo se muestran cuando el administrador del sitio los activa desde los ajustes del plugin.

Estos enlaces no envían datos automáticamente. El navegador del visitante solo se conecta con ViveSol.es cuando hace clic en ellos.

Términos del servicio de ViveSol: https://vivesol.es/terminos-del-servicio/
Política de privacidad de ViveSol: https://vivesol.es/politica-de-privacidad/

= Mapas de OpenStreetMap =

URL del servicio: https://tile.openstreetmap.org

Finalidad: mostrar mapas interactivos en las vistas públicas y en el panel de administración.

El plugin incluye Leaflet localmente. Los mapas de OpenStreetMap están desactivados por defecto y requieren la aceptación expresa del administrador del sitio desde el asistente de configuración o los ajustes del plugin.

Cuando esta opción está desactivada, los mapas públicos se ocultan, los campos de mapa del administrador muestran un aviso local y el plugin no realiza solicitudes de mapas a OpenStreetMap.

Cuando esta opción está activada, los mapas se cargan desde los servidores de OpenStreetMap únicamente al mostrar una vista con mapa.

Política de uso de teselas de OpenStreetMap: https://operations.osmfoundation.org/policies/tiles/
Términos de uso de OpenStreetMap: https://osmfoundation.org/wiki/Terms_of_Use
Política de privacidad de OpenStreetMap: https://osmfoundation.org/wiki/Privacy_Policy

= Enlaces de contacto y compartición mediante WhatsApp =

URL del servicio: https://wa.me y https://api.whatsapp.com

Finalidad: abrir enlaces de contacto o compartición mediante WhatsApp cuando una persona pulsa un botón de WhatsApp.

El plugin no envía datos automáticamente a WhatsApp. Estos enlaces solo se abren cuando la persona usuaria hace clic en ellos.

Términos de servicio de WhatsApp: https://www.whatsapp.com/legal/terms-of-service
Política de privacidad de WhatsApp: https://www.whatsapp.com/legal/privacy-policy

= Enlaces de compartición mediante Facebook =

URL del servicio: https://www.facebook.com

Finalidad: abrir diálogos de compartición en Facebook cuando una persona pulsa un botón para compartir.

El plugin no envía datos automáticamente a Facebook. Estos enlaces solo se abren cuando la persona usuaria hace clic en ellos.

Términos de Facebook: https://www.facebook.com/legal/terms
Política de privacidad de Facebook: https://www.facebook.com/privacy/policy/

== Installation ==

1. Sube los archivos del plugin al directorio `/wp-content/plugins/vivesol-inmo-connect/` o instálalo desde la pantalla de plugins de WordPress.
2. Activa el plugin desde la pantalla "Plugins" de WordPress.
3. Accede al menú ViveSol Inmo Connect desde el escritorio de WordPress.
4. Configura los datos de tu agencia desde los ajustes del plugin.
5. Añade tus inmuebles.
6. Inserta los shortcodes necesarios en las páginas de tu web.

== Frequently Asked Questions ==

= ¿Necesito una cuenta de ViveSol para usar el plugin? =

No. El plugin funciona sin necesidad de una cuenta de ViveSol ni de una clave API. La gestión de inmuebles, los listados, los agentes, los datos de agencia y los mapas opcionales pueden utilizarse directamente desde WordPress.

= ¿Es obligatoria la sincronización con la API de ViveSol? =

No. La sincronización mediante API es opcional y está desactivada por defecto.

= ¿Qué ocurre al activar la API de ViveSol? =

Cuando se activa la sincronización con la API y se introduce una clave API válida, los datos de los inmuebles pueden enviarse a ViveSol.es para su publicación en la red inmobiliaria colaborativa.

= ¿Puedo utilizar el plugin únicamente en mi propia web? =

Sí. Puedes utilizar ViveSol Inmo Connect como un plugin inmobiliario independiente sin activar la API de ViveSol.

= ¿El plugin incluye Leaflet? =

Sí. Leaflet está incluido localmente en el plugin.

= ¿El plugin carga mapas desde un servicio externo? =

Solo después de una aceptación expresa. Los mapas de OpenStreetMap están desactivados por defecto. Cuando el administrador del sitio activa la opción "Activar mapas interactivos con OpenStreetMap", el plugin carga los mapas únicamente al mostrar una vista con mapa.

= ¿Puedo gestionar agentes inmobiliarios? =

Sí. El plugin incluye gestión de agentes y un shortcode para mostrar agentes públicos.

= ¿Puedo mostrar inmuebles con filtros? =

Sí. El shortcode `[vivesol_grid_listings]` muestra un listado público de inmuebles con filtros.

== Screenshots ==

1. Listado de inmuebles.
2. Ficha pública detallada del inmueble con galería de imágenes.
3. Mapa interactivo de inmuebles.
4. Formulario para añadir y editar inmuebles.
5. Listado y gestión de agentes.
6. Estadísticas de inmuebles y ventas.

== Changelog ==

= 1.1.0 =
* Añadido el shortcode `[vivesol_search]` para mostrar un buscador independiente de inmuebles.
* Añadidas provincias dinámicas y paginación en los resultados del nuevo buscador.
* Añadido soporte para configurar el número de columnas del carrusel mediante columns.

= 1.0.0 =
* Versión inicial.
