Widget Inmuebles por Tag

Muestra inmuebles que tienen asociado un tag (etiqueta) sincronizada desde CRMs como Wasi. Puedes usarlo como Widget (desde el personalizador / widgets) o como ShortCode dentro de una página/entrada.

---

📝 Descripción #

Este widget permite listar únicamente los inmuebles que poseen un tag determinado. Es útil para mostrar secciones como “Destacados”, “Proyectos”, “Novedades”, etc., sin tocar la lógica de los inmuebles: basta con que el CRM (o el sistema de sincronización) haya asociado ese tag al inmueble.

Si no hay inmuebles con el tag indicado, el widget muestra el mensaje “Sin Resultados”.

---

⚙️ Funcionamiento #

El widget recibe una colección $inmuebles (filtrada por el tag solicitado) y renderiza las tarjetas usando el Componente Card:

<div class="row">
    <?php if (count($inmuebles) > 0) : ?>
        <?php foreach ($inmuebles as $cont => $inmueble) : ?>
            <div class="col-xs-12 col-md-4 card-space">
                <?php visualinmu_load_template("inmuebles/componentes/card.php", get_defined_vars()); ?>
            </div>
        <?php endforeach; ?>
    <?php else : ?>
        <label> Sin Resultados </label>
    <?php endif; ?>
</div>

Campos de configuración del Widget #

• Valor del Tag (obligatorio): valor del tag que identifica los inmuebles a listar (ej. DESTACADO, PROJECT, OFERTA).
• Máximo de Inmuebles (opcional): límite de items a mostrar (ej. 8).

En la UI de Widgets verás esos campos (ej. Valor del Tag y Maximo de Inmuebles) — completa el valor del tag y, si quieres, un límite máximo.

ShortCode #

Puedes insertar el widget como shortcode en cualquier página:

[visualinmu_propertys_tag_value_shortcode tag_value="Project"]

Ejemplo con límite (si tu versión del plugin soporta el parámetro max; en muchas implementaciones existe — prueba este formato):

[visualinmu_propertys_tag_value_shortcode tag_value="Project" max="8"]

---

🎨 Personalización / Qué se puede cambiar #

• Número de columnas
  Actualmente usa col-md-4 (3 columnas en pantallas ≥ md). Para cambiar el número de columnas edita la clase Bootstrap en el contenedor de cada card (col-xs-12 col-md-4) a, por ejemplo, col-md-6 (2 columnas) o col-md-3 (4 columnas).
• Máximo de items
  Cambia el control del widget Maximo de Inmuebles o pasa max en el shortcode (si está disponible) para limitar la cantidad mostrada.
• Texto “Sin Resultados”
  Cambia el <label> Sin Resultados </label> por el texto o HTML que desees (puedes incluir un CTA o enlace para ver todos los inmuebles).
• Apariencia de las tarjetas
  El contenido y estilo de cada tarjeta se controlan desde el Componente Card. Para modificar iconos, etiquetas o estructura, edita inmuebles/componentes/card.php. (ver Referencias abajo)
• Destino de los links
  Por defecto pueden abrir en la misma ventana; si deseas abrir en nueva pestaña modifica los enlaces dentro del Card.
• Cache / Performance
  Si la lista por tag no cambia con frecuencia, considera cachear la consulta (transients) para mejorar rendimiento en páginas muy visitadas.

---

✅ Ejemplos de uso práctico #

• Widget: Añadir el widget en la sidebar o en una sección de la home, configurar:
  • Valor del Tag: DESTACADO
  • Maximo de Inmuebles: 8
• Shortcode en una landing: [visualinmu_propertys_tag_value_shortcode tag_value="PROYECTO_X" max="6"]
• Salida HTML (ejemplo simplificado):

<div class="row">
  <div class="col-xs-12 col-md-4 card-space">[Card del Inmueble A]</div>
  <div class="col-xs-12 col-md-4 card-space">[Card del Inmueble B]</div>
  ...
</div>

---

📂 Archivos relacionados / Confirmación #

El widget usa templates externos para renderizar cada inmueble:

• inmuebles/componentes/card.php — (Componente Card): renderiza la tarjeta de cada inmueble.
  👉 Referencia / documento: Personalización del Componente Card:
  https://homlity.com/docs/pagina-buscar-inmueble/personalizacion-componente-card/?v=7f0c663dc5fa

Confirmación: la lógica de renderizado de cada tarjeta no está dentro del archivo principal del widget: se llama al template visualinmu_load_template("inmuebles/componentes/card.php", ...). Si necesitas cambiar qué datos aparecen en la tarjeta, edita ese archivo.