Bienes Raíces

El módulo Bienes Raíces convierte tu sitio en un portal inmobiliario, sin salir de MGPanel. Publica propiedades con fichas completas (precio, características, ubicación y galería), déjalas visibles en un listado con filtros, y recibe consultas de compradores o inquilinos directo a tu CRM.

1. ¿Qué es el módulo de Bienes Raíces?

El módulo Bienes Raíces te permite administrar un catálogo de propiedades (venta, alquiler, venta/alquiler, traspaso, administración o reposeída) y publicarlas automáticamente en tu sitio web.

• Venta y Alquiler: los flujos tradicionales de compra/venta y arrendamiento; Venta y alquiler ofrece ambas modalidades a la vez.
• Traspaso: cesión de un contrato o negocio en marcha (frecuente en locales comerciales).
• Administración: propiedades que gestionas en alquiler por cuenta de un propietario; el listado y la ficha muestran el precio de alquiler mensual.
• Reposeída: propiedades recuperadas por un banco u otra entidad financiera, publicadas para su venta.

• Para dueños de negocio: carga tus propiedades con fotos, precio y ubicación, y compártelas con un enlace público listo para redes o WhatsApp.
• Para desarrolladores: el listado y la ficha de propiedad se pueden insertar en cualquier página con shortcodes y personalizar con CSS global.

Relación con otros módulos:

• Formularios: las consultas de las propiedades se reciben a través de un formulario de Formularios configurado como contacto general.
• Clientes: cada consulta enviada desde una propiedad sigue el mismo flujo formulario → cliente → oportunidad que el resto del CRM.
• Categorías: las categorías de propiedades (ej. Apartamentos, Playa) se crean solas al usarlas, igual que en Blog.

2. Acceso y gestión de propiedades

1. Desde el menú lateral → Sitio Web → Bienes Raíces.
2. Verás la vista principal con:
   1. Barra superior: buscador por título, código o ubicación, botón Filtrar (avanzado) y Nueva propiedad.
   2. Panel de estadísticas: total de propiedades, publicadas, borradores y categorías.
   3. Tabla central: propiedad, operación, precio, ubicación, estatus y menú de acciones (editar, eliminar).

El menú ··· de la barra superior incluye Importar propiedades, Exportar propiedades y Descargar plantilla (ver sección 4).

3. Crear y editar una propiedad

El formulario de propiedad organiza los datos en seis pestañas:

1. Datos
   1. Título (único campo obligatorio), código externo/MLS y tipo (apartamento, casa, oficina, local, lote, bodega/depósito, finca, edificio).
   2. Operación (venta, alquiler, venta y alquiler, traspaso, administración, reposeída) y disponibilidad (disponible, reservado, vendido, alquilado, no disponible).
   3. Precio de venta y/o alquiler, moneda, cuota de administración (HOA), si incluye IVA y si es negociable. Nota: en propiedades con operación administración se usa el precio de alquiler (canon mensual) para mostrar y filtrar precio; las reposeídas usan el precio de venta.
   4. El código interno PROP-XXXX se genera automáticamente al guardar.
2. Características
   1. Recámaras, baños, medios baños, estacionamientos, niveles, año de construcción, estrato, condición, tipo de piso y amoblado.
   2. Área de terreno, área construida, área privada y unidad (m² o ft²).
   3. Amenidades: selecciona de un catálogo (piscina, gimnasio, ascensor, salón social, etc.).
3. Ubicación
   1. Dirección, barrio/sector, ciudad, provincia/departamento, país y código postal.
   2. Coordenadas y un mapa embebido (pega el código iframe o la URL de Google Maps).
4. Multimedia
   1. Sube las fotos de la propiedad; la primera imagen (o la marcada como portada) es la imagen principal del listado y la ficha.
5. Descripción
   1. Destacado (resumen breve para tarjetas) y descripción completa de la propiedad.
6. Configuración
   1. Estatus (Borrador o Publicada), URL pública —se genera del título al crear y no cambia al editar— y categorías.
   2. Marca Destacada para que aparezca en el shortcode destacados.

Guarda con el botón Guardar o Ctrl + S. Recuerda: Estatus (borrador/publicada) y Disponibilidad (vendido, alquilado, etc.) son independientes — una propiedad publicada pero marcada como vendida no aparece en el listado público por defecto.

4. Importar y exportar propiedades

Para cargas masivas (ej. migrar desde otro sistema o portal inmobiliario), usa Importar propiedades desde el menú ···.

• Formatos aceptados: CSV, XLSX o JSON. XLSX es el más seguro con acentos.
• Valores de catálogo: las columnas type y operation deben usar las claves internas (ej. bodega, administracion, reposeida), no las etiquetas visibles.
• Plantilla: descarga una plantilla vacía con Descargar plantilla antes de armar tu archivo.
• Re-importar es idempotente: hace upsert por code_real_estate (o por url si falta); volver a subir el archivo actualiza las propiedades existentes en lugar de duplicarlas.
• Imágenes: se referencian por ruta relativa (ej. 2019/05/foto.jpg) o URL absoluta. Las rutas relativas requieren subir la carpeta de imágenes a S3 bajo la carpeta real-estate/ de tu cuenta; si aún no existen, la propiedad se importa igual y la foto aparece cuando el archivo llegue a S3.
• Exportar propiedades genera un CSV con las mismas columnas — útil para editar en Excel y volver a importar.

5. Formulario de contacto y WhatsApp

Desde Configuración → Bienes Raíces defines cómo te contactan los visitantes desde cualquier ficha de propiedad:

• Formulario de contacto: un formulario único (de Formularios) que recibe las consultas de todas las propiedades; cada envío incluye la propiedad consultada.
• WhatsApp de contacto: número con código de país (ej. +507 6000 0000) para el botón de WhatsApp en la ficha. Si lo dejas vacío, se usa el teléfono del propietario asignado a la propiedad (si existe).
• Incremento de precio del buscador: define cuánto avanzan las flechas ▲▼ de los campos de precio mínimo/máximo del buscador público (ver sección 6), por separado para Venta y Alquiler. Los campos siguen aceptando cualquier monto escrito a mano; el paso solo afecta el spinner nativo. Sin configurar, el buscador usa 25,000 para venta y 200 para alquiler.
• Si no configuras ni formulario ni WhatsApp, la ficha muestra un aviso indicando que falta completar esta configuración.

6. Página pública de propiedades

MGPanel expone automáticamente la página /properties con el listado de propiedades publicadas y disponibles, con una barra de filtros:

• Ubicación: campo de texto libre (ej. "Panamá" o "Bella Vista") que busca por coincidencia parcial en provincia, ciudad y sector a la vez — no hace falta escribir el nombre exacto ni los acentos. Sugiere valores mientras escribes, tomados del propio inventario publicado.
• Operación: todas, en venta, en alquiler, traspaso, administración o reposeída.
• Tipo: apartamento, casa, oficina, local, lote, bodega/depósito, finca o edificio.
• Recámaras mínimas y rango de precio (mín./máx.). El precio son campos de texto libre — cualquier monto es válido; el incremento de las flechas ▲▼ se configura por separado para venta y alquiler en Configuración → Bienes Raíces (sección 5).
• Filtros avanzados (desplegables, ocultos por defecto): baños mínimos, metraje mínimo/máximo (m²), provincia y sector. Provincia y sector se completan automáticamente según las propiedades publicadas, y el sector se limita a los de la provincia elegida.

Filtros dinámicos según el tipo: Recámaras y Baños solo tienen sentido para ciertos tipos de propiedad. Al elegir Lote o Finca, esos dos filtros se ocultan automáticamente (esas propiedades no tienen recámaras ni baños); al elegir Apartamento o Casa vuelven a aparecer. El campo de Metraje también se adapta: solo se muestra si el tipo elegido lo usa. No es un error — el buscador ajusta sus propios controles según el tipo seleccionado.

Cada propiedad enlaza a su ficha en /properties/<slug>: galería con miniaturas y zoom a pantalla completa (si tu cuenta tiene el visor de imágenes ampliado activo), pestañas de Descripción, Características y Ubicación (con mapa), botones Contactar y WhatsApp, y enlaces para compartir en Facebook, X y WhatsApp. Para ver solo una categoría, usa la URL /properties/category/<slug>.

Esta página ya existe por defecto: no la recrees ni cambies su URL. Personalízala con CSS global o secciones adicionales.

7. Shortcodes disponibles

Inserta cualquiera de estos shortcodes en una sección de página (Editar Web) con la sintaxis {{properties=tipo:cantidad parametro="valor"}} (o su alias en español {{propiedades=...}}).

El tipo tiene dos valores especiales: destacados/destacadas (filtra por propiedades destacadas) y buscador/search (inserta el formulario de búsqueda en vez de un listado, ver tabla arriba). Cualquier otro valor funciona como listado general y el filtrado real se controla con los parámetros (operation, type, city, state, neighborhood, bedrooms, bathrooms, price_min/price_max, area_min/area_max, category). Por defecto se ocultan las propiedades vendido/alquilado, salvo que envíes availability explícitamente.

El shortcode {{properties=buscador}} reutiliza el mismo formulario, clases y estilos que la barra de filtros de /properties, incluyendo el desplegable de Filtros avanzados. Al enviarse, siempre redirige a /properties con los filtros en la URL — no muestra resultados en la misma página. Los parámetros que le pases actúan como valores precargados (presets) que el visitante puede cambiar antes de buscar, por ejemplo: {{properties=buscador operation="alquiler" category="apartamentos"}}.

El shortcode {{properties=buscador-simple}} es la variante ligera de {{properties=buscador}}, pensada para un hero o una portada donde el formulario completo de 11 campos es demasiado pesado. El parámetro campos elige qué mostrar: campos="ubicacion" deja solo la barra de ubicación (como una caja de búsqueda tipo "ciudad, provincia"); campos="datos" deja tipo, recámaras y precio; y campos="ubicacion,datos" combina ambos grupos. Ejemplo: {{properties=buscador-simple campos="datos" operation="alquiler"}}.

8. Personalización con CSS

Todo el markup de propiedades usa clases mg-property-* reutilizables. Sobreescríbelas con CSS global (Configuración → Sitio web → CSS) sin tocar el HTML:

• Listado: mg-property-grid, mg-property-card, mg-property-card-image, mg-property-card-placeholder, mg-property-card-body, mg-property-card-title, mg-property-card-price, mg-property-card-meta, mg-property-empty.
• Filtros: mg-property-filters, mg-property-filter, mg-property-filter-actions, mg-property-filters-advanced (desplegable de filtros avanzados), mg-property-filters-advanced-fields, mg-property-filter-location (campo de ubicación por texto libre). El buscador insertado vía shortcode se envuelve además en mg-shortcode-property-search; la variante compacta ({{properties=buscador-simple}}) agrega el modificador mg-property-filters--simple.
• Ficha de propiedad: mg-property-gallery, mg-property-thumb, mg-property-tabs, mg-property-tab, mg-property-tab-content, mg-property-whatsapp.
• Botones: reutiliza mg-btn, mg-btn-primary, mg-btn-secondary del tema base.

9. Solución de problemas comunes

10. Recursos adicionales y soporte

• emyi puede ayudarte a:
  • Crear tu primera propiedad paso a paso.
  • Explicar la diferencia entre Estatus y Disponibilidad.
  • Armar el shortcode correcto para tu página.
• Soporte: abre un ticket desde emyi, Reportar un error (Ayuda → Sugerir mejoras → Reportar un error) o escribe a [email protected] indicando el código de la propiedad y capturas relevantes.