El plugin IRDFeed se conecta diariamente al Feed de Inmovilla y carga las propiedades en tu web, sin interferir con la interfaz visual.
Para poder utilizarlo, es necesario solicitar la creación del Feed a Inmovilla, que suelen tenerlo operativo en uno o dos días. Una vez que esté operativo, ya podemos instalar IRDFeed para Inmovilla y configurarlo.
Una vez que esté activo, en la parte inferior del menú lateral del backend de tu web, aparecerá la entrada para la configuración del plugin con el texto “IrdFeed Inmovilla”.
A continuación se indican cada uno de los campos y sus posibles valores.
Url feed
Es la url de feed proporcionada por Inmovilla, tiene el formato https://procesos.apinmo.com/xml/v2/AAA/BBB-web.xml,siendo AAA y BBB un número variable de letras y números.
Importante: no olvides poner el protocolo correctamente, en este caso, https.
Modo
Normalmente trabajamos con webs que se encuentran en producción, por lo que no es conveniente hacer pruebas que sean públicas. Para ello existe este campo, admite dos valores:
- draft: crea las propiedades en modo borrador.
- cualquier otro valor: publica las propiedades importadas, recomendamos que indiques publish, por coherencia.
Bloques
Si tu hosting tiene un procesador limitado o poca memoria RAM, es posible que la carga inicial de propiedades no puedas hacerla de golpe, o simplemente que solamente quieras cargar un pequeño número de propiedades para evaluar la configuración realizada. Para ello, debes indicar en este campo el tamaño de los bloques a cargar o lo que es lo mismo, el número de propiedades a cargar.
Si queremos que cargue todas las propiedades, indicaremos el valor 0.
Último bloque
Relacionado con el anterior. Es el último bloque sobre el que se realizó la última carga. Para aquellas configuraciones que cargan la totalidad de propiedades, tiene el valor 0.
Nombre del formulario
La mayor parte de los plugins inmobiliarios utilizan el Custom form con nombre “property”, si el tuyo ha sido original y decide utilizar otro nombre, solamente tienes que sustituirlo.
IMPORTANTE: Si utilizas el plugin Polylang para el multiidioma, no te olvides de activar el Custom form en tu configuración de Polylang antes de ejecutarlo por primera vez: Languages -> Setting Custom post types and Taxonomies: Activate languages and translations management for the custom post types and the taxonomies.
Campo título
Atributo del feed que contiene el título de la propiedad. Normalmente será el valor “titulo”.
Campo contenido
Atributo del feed que contiene la descripción de la propiedad. Normalmente será el valor “descrip”.
Precontenido y Postcontenido
En algunos casos, el plugin inmobiliario utilizado (por ejemplo, Real Homes), incorpora determinado código oculto (en forma de comentario html), para indicar el inicio y el final de la descripción. Si tu plugin hace esto, solamente tienes que indicarlo aquí, en caso contrario, déjalo en blanco.
Prefijo fotos
Parte común del campo del feed en el que se indica la url de las fotos de la propiedad. Normalmente será el valor “foto”.
Tipo galería
Según el plugin o el formato que utilices, tendrá diferentes valores:
- plana: se crea un post_meta con valores múltiples para guardar las fotos
- concatenada: se crea un campo con separador “,” entre los id’s de las fotos.
- defecto: se crea un campo serializado.
Campo galería
Nombre del atributo post_meta en el que se guardan los valores de las imágenes si debe ser con un número para indicar orden.
Thumbnail galería
Si tu plugin tiene un atributo para guardar el id de la foto principal, se creará este campo. Nomalmente tiene valor “_thumbnail_id_” o vacío.
Nombre meta galería
Si en lugar de tener un conjunto de campos con el mismo prefijo para la galería, tiene solamente uno y sin numeración.
Prefijo planos
Parte común del campo del feed en el que se indica la url de los planos de la propiedad. Normalmente será el valor “plano”.
Campo planos
Nombre del atributo post_meta en el que se guardan los identificadores serializados de los planos.
Campo referencia del feed en web
Nombre del atributo post_meta en el que se guarda el identificador único de la propiedad para Inmovilla. Normalmente será el valor “idfeed”.
Clave feed
Atributo del feed que contiene el identificador único de la propiedad. Normalmente será el valor “id”.
Campo de no actualización
Nombre del atributo post_meta mediante el que se rompe el vínculo de sincronización de una propiedad en la web con la propiedad en Inmovilla. Normalmente será el valor “noupdate”.
Valor de no actualización
Relacionado con el atributo anterior. Valor que debe tener el campo para que no se sincronice la propiedad. Admite cualquier valor distinto de vacío.
Horas para baja si no se actualiza
Número de horas que deben pasar para que una propiedad no actualizada se pase a borrador al final de proceso. Si tiene valor 0, se ignora el campo. Es una de las dos alternativas para dar de baja propiedades en la web si ya no están publicadas en Inmovilla.
Borrado inicial.
Indicador de borrado de todas las propiedades antes de iniciar el proceso de actualización. Si tiene valor “S” borra todas las propiedades en cada ejecución del proceso.
Idiomas
Idiomas a importar. En cada línea se indica los idiomas a importar y su conversión. Cada una de las líneas se separan los valores por “;”, estando formada por tres valores: código de idioma en la web (el que determine el plugin, que normalmente será una codificación ISO), idioma del feed (numérico) e idioma alternativo en el feed si el campo título o descripción no vienen indicados para este idioma en alguna propiedad.
Por ejemplo si indicamos fr;4;1 estamos importando los textos al idioma francés (fr) en nuestra web obteniéndolos del campo que reserva Inmovilla para el francés (4) y si no existe para alguna propiedad, mostrará el texto en castellano (1).
Los idiomas en los que pueden venir textos para Inmovilla en la fecha de redacción de este documento son:
1 Castellano
2 Ingles
3 Aleman
4 Frances
5 Holandes
6 Noruego
7 Ruso
8 Portugues
9 Sueco
10 Finlandes
11 Chino
12 Catalan
15 Italiano
16 Euskera
17 Polaco
Campos
Campos a importar. En cada línea se indica los campos a importar y su conversión. Cada una de las líneas se separan los valores por “;”, estando formada por tres valores: nombre del campo en el feed, nombre del campo en la web (post_meta) y conversión.
Las conversiones se indican en el campo conversiones. Adicionalmente hay unas conversiones reservadas por ser frecuentes:
- no: No se hace ninguna conversión.
- sumar: Suma el valor de dos campos del feed, por ejemplo, si quiero sumar baños y aseos, indicaré en el primero de los tres atributos “aseos:banyos”.
- unir: Concatena con “,” dos atributos, por ejemplo, si quiero concatenar la longitud y la latitud, indicaré en el primero de los tres atributos “latitud:altitud”. En el caso de esta operación, también podemos utilizar la concatenación de varios campos son cadenas de texto fijas, por ejemplo: si en el primer atributo indicamos “energiavalor:[kWh/m² /]:emisionesvalor:[Kg CO2/m²]”, nos generará un resultado del tipo “100 kWh/m² / 50 Kg CO2/m², al sustituir los campos por su valor y manteniendo el texto entre corchetes fijo.
Conversiones
Conversiones a aplicar en los campos. En cada línea se indica las conversiones a aplicar. Cada una de las líneas se separan los valores por “;”, estando formada por tres valores: nombre de la conversión, valor informado en el feed y valor por el que debe ser sustituido. Si no encuentra el valor del feed, lo mantiene tal y como aparecía en el xml. Si el tercer atributo es vacío, trata el atributo del feed como no informado.
Por ejemplo, si indico terraza;0;; no crearé el campo terraza si en el feed viene informado el valor 0
Si indico sino;0;no y en el feed me aparece un valor 0, se tranformará en “no”.
Si viene el valor 8 en un campo para el que solamente he definido valores del feed del 1 al 5, mantendré el valor 8 en el campo.
Campos taxonomía
Igual que Campos, pero en lugar de crear un post_meta crea una taxonomía con el valor transformado (si no existe).
Campos serializados
Se utiliza para plugins que incorporan un campo multivaluado para reflejar distintas características de un campo. Se compone de cuatro atributos: el nombre del campo en la web, el nombre de la agrupación (normalmente, una taxonomía), el nombre del campo en el feed y la conversión a aplicar.
Por ejemplo, si en las características de la vivienda el plugin agrupa por interior y exterior, podríamos definir:
web_caracteristicas;interior;calefaccion;sino
web_caracteristicas;interior;aire;sino
web_caracteristicas;exterior;piscina;sino
web_caracteristicas;exterior;tenis;sino
Campos fijos
La mayoría de plugins inmobiliarios guardan en cada post datos de configuración de algún elemento de presentación, como la unidad de medida a utilizar, el tipo de mapa o el tipo de galería.
Se indican los atributos nombre del campo en la web y el valor a asignar
Conversiones de contenido
Transformación a aplicar en el texto de la descripción. Se indica una por línea, informando primero el valor a buscar en el atributo del feed y en segundo lugar el valor por el que se debe sustituir. Para mostrar correctamente los párrafos de Inmovilla, debe tener al menos la línea “~;”
Probar la configuración
Tras crear la configuración completa, es aconsejable realizar una prueba con pocas propiedades y verificar los datos obtenidos y los esperados.
Para ello, guardamos con el botón “Guardar” de la parte inferior de la pantalla y en la respuesta del guardado, nos aparecerán antes de los campos unas cuantas líneas de confirmación de la información guardada. En ese momento, podemos pulsar en el enlace “Lanzar ahora” o bien abrirlo en una nueva ventana/pestaña y verificar el proceso.
Cuando finalice la ejecución del script, nos mostrará las trazas de la información que ha procesado con un mensaje final de “Fin de la carga”.
En ese momento debemos verificar manualmente las propiedades cargadas.
Programación
Inmovilla actualiza el feed una única vez por día en horario nocturno. Normalmente entre la una y las cuatro de la madrugada. Si quieres saber cuando se genera el tuyo, abre la url de feed y vete al final, te indicará la fecha y hora de generación.
Dejando un margen suficiente (porque las programaciones nunca son exactas), programa un proceso en tu servidor del script run.php que se encuentra en la carpeta public del plugin irdfeed, algo así como:
/plugins/irdfeedinmovilla/public/run.php
Es una tarea que se realiza una única vez y en cada ejecución recupera los parámetros de la configuración.
Última edición: Julio 2023
Versión del plugin: 1.1.2