Ejemplo Web integrada con MultiLinkCRM€¦ · · 2017-03-03Este ejemplo se ha realizado usando la plantilla WP Residence, ... seleccionaremos MultiLinkCRM XML y pondremos aquí

MultiLinkCRM Real Estate CRM www.multilinkcrm.com - 2017

Ejemplo de como hacer una Web inmobiliaria realizada en WordPress © integrada con MultiLinkCRM En este ejemplo veremos como hacer una Web para su inmobiliaria de una forma rápida y muy económica basada en WordPress© y gestionada automáticamente desde MultiLinkCRM. Este ejemplo se ha realizado usando la plantilla WP Residence, www.wpresidence.net , una plantilla muy económica (53 US$ en el momento de crear este documento), que funciona en dispositivos móviles (responsive) y con un elevado número de funcionalidades lo que permite crear un sitio Web muy atractivo y moderno. Por supuesto se puede usar otra plantilla, RealPlaces por ejemplo, pero obviamente habría que modificar la correspondencia de campos lo que tampoco es muy complicado, el plugin usado para hacer la importación, WPAllImport© es compatible con un gran número de ellas, puede encontrar más información en la Web del producto: www.wpallimport.com MultiLinkCRM permite exportar los inmuebles que usted seleccione para enviar a la Web en formato XML, además copia las fotos y las redimensiona al tamaño, luego manda todo por FTP/sFTP a donde se indique y por último lanza automáticamente el proceso de carga. Al final del proceso el usuario con un clic del ratón actualiza su Web de una forma muy simple.


Configuración Lo primero será configurar MultiLinkCRM para que mande los datos, para ello iremos a la pestaña AJUSTES y haremos clic en botón PORTALES, en el desplegable seleccionaremos MultiLinkCRM XML y pondremos aquí los datos de nuestro servidor FTP, una vez hecho esto haremos clic en el botón GUARDAR de la pestaña de edición que se mostrará automáticamente.

Parámetros a configurar: Crear thumbnails. Desmarcar esta opción pues, en principio, no hay que generar muestras de las fotos. Enviar por FTP / Enviar por sFTP Dependiendo del servidor Web que utilicemos. Carpeta trabajo. Debe apuntar a una carpeta existente en la cual el programa dejará los archivos temporales que vaya creando previamente al envío, el contenido de esta carpeta se borra previamente cada vez que se vaya a hacer un envío. Servidor FTP. Nombre del servidor FTP de la Web donde vamos a dejar el XML y las fotos Usuario. Nombre de usuario del servidor FTP o sFTP. Contraseña. Contraseña del servidor FTP o sFTP. Carpeta datos del servidor. Carpeta en donde vamos a dejar el fichero MultiLinkCRM.xml que será importado por el proceso wpallimport en la Web. Carpeta fotos servidor. Carpeta en donde se van a dejar las fotos en el servidor para que se importen por el proceso wpallimport, se mandan con el tamaño que se especifique en las opciones Ancho foto y Alto foto. Esta carpeta, en principio, será la misma que la usada para depositar el fichero de datos aunque puede modificarse si se cambia la ruta de carga de las imágenes en la configuración del script wpallimport. Marca de agua automática. Si se indica un texto aquí, se aplicará automáticamente a todas las fotos para que si alguien la descarga se sepa de donde las ha tomado. Comando a ejecutar después del envío. En este apartado indicaremos los comandos que se ejecutarán automáticamente por MultiLinkCRM una vez completado el proceso


de envío a la Web de datos y fotos, estos comandos dispararán el proceso de carga en el servidor e incorporarán los datos recibidos. NOTA: Más adelante se mostrará de donde obtener estos comandos.

¡¡Muy importante!! Hay que llevar cuidado a la hora de configurar los parámetros “Carpeta datos servidor” y “Carpeta fotos servidor” para que apunten a la carpeta correcta. Verifique esto las veces que haga falta para estar absolutamente seguro o puede montar un estropicio en su Web Más adelante, cuando se explique la configuración del plug-in WPAllImport© se muestra donde encontrar la ruta que ha de indicar aquí


Seleccionar fichas para mandar a la Web Hacer que una ficha se mande a la Web es tan sencillo como seleccionar una casilla:

Para mandar los datos, seleccionaremos la primera pestaña VER OPCIONES que se muestra por defecto al iniciar el programa Ahora elegiremos en el desplegable Nombre portal la opción MultiLinkCRM XML y haremos clic en el botón Enviar a la Web, Para más información sobre la funcionalidad de esta pantalla consultar el manual de MultiLinkCRM.

El programa automáticamente generará el paquete de datos a enviar y a continuación mandará los datos a la Web mediante FTP, conectándose con la configuración anteriormente indicada.


Configuración WordPress Que necesitamos

? Tener instalado WordPress © ? Tener instalado un tema compatible con WPAllImport, por ejemplo WP

Residence, este proceso funciona con muchos otros temas, solo deberá modificar la correspondencia de datos entre el XML y los campos.

? Tener instalado el plug-in WPAllImport versión PRO (99 US$) www.wpallimport.com y si fuera necesario el Add-On requerido para la plantilla que tengamos instalada, consultar la documentación del fabricante.

NOTA: Este ejemplo asume que usted ya ha enviado un fichero XML desde el programa. Tendremos que crear una plantilla en el plug-in WPAllImport que cargará en la Web los datos que recibirá en el XML, para ello haremos lo siguiente: Iremos a All Import y seleccionaremos New Import

Ahora haga clic en la opción “Utilizar archivo existente”, y en el desplegable se mostrará el fichero previamente cargado en la carpeta indicada anteriormente


NOTA IMPORTANTE En esta pantalla vemos que, en la zona inferior se indica la ruta en donde ha de subirse el fichero XML para que lo detecte el plugin, esta ruta puede ser diferente en cada instalación, debe verificarla, anotarla y comprobar que usted sube el fichero XML a esa carpeta y no otra.

Una foma de comprobar si hemos subido el fichero MultiLinkCRM.xml a esa ruta es mediante el navegador, si ponemos la ruta indicada anteriormente añadiendo el nombre del fichero, el contenido de éste debe de mostrarse, si no es así vuelva a verificar todo.


Ahora seleccionamos el fichero MultiLinkCRM.xml que habremos subido previamente. NOTAS: Si no lo hemos subido o está en la carpeta incorrecta no aparecerá en este desplegable. Si lo subimos después de mostrar esta pantalla tendremos que volver a actualizar la página para que aparezca.


Una vez seleccionado o cargado el fichero XML deberemos indicar el tipo de entrada a importar, en este caso Properties El nombre de la categoría en donde vamos a dar de alta los inmuebles que van en el fichero XML puede variar, depende del nombre de la categoría que contiene los inmuebles, normalmente en plantillas estándar será propiedades o properties o algo así, de todas formas lo verá desde el administrador de wordPress.


Ahora haremos clic en la opción Continuar al paso 2


En este paso debemos seleccionar el nodo del fichero XML que contiene los datos del inmueble, en la imagen siguiente vemos que por defecto ha seleccionado uno que no es correcto, lo primero que debemos hacer es cambiarlo:

En la lista de la izquierda buscaremos el valor propertydata y haremos clic en Continuar al paso 3.


En esta pantalla definiremos la correspondencia entre los datos del XML y los de la Web:

Hacemos clic en Custom fields o Campos personalizados dependiendo del lenguaje seleccionado en wordPress. Hacer esto es tan sencillo como hacer clic en la etiqueta del XML que deseamos incluir y la arrastramos hasta el campo, al soltar aparecerá el código necesario para el funcionamiento del programa.


La primera vez que accedamos haremos clic en el botón Ver Campos Detectados

Al hacer esto nos mostrará todos los que detecte:


Ahora iremos asignando a cada campo la etiqueta del dato en el fichero XML, mediante la función arrastrar y soltar (drag and drop) iremos asignando a cada campo el valor correspondiente. CONSEJO Esta asignación se va a guardar y puede modificarse posteriormente, podemos guardarlo y continuar más adelante, no es algo que solo se permita hacer una vez.

Guarde la configuración de importación como una plantilla, en este caso lo hemos llamado MultiLinkCRM pero usted puede poner el nombre que prefiera. Si está modificando una plantilla existente recuerde actualizar las modificaciones que haga con el botón UPDATE TEMPLATE

NOTA: La estructura completa del fichero MultiLinkCRM xml está descrita en la documentación.


Fotos del inmueble

Las fotos tienen un tratamiento especial puesto que a un inmueble le pueden corresponder muchas, no una sola. Para poder resolver esto tenemos que poner un pequeño trozo de código que buscará las fotos que hemos subido y las incorporará a la ficha El código a incluir es similar a este: [FOREACH({photodata/imagen})] http://midominio.es/wp-content/uploads/wpallimport/files/{.}, [ENDFOREACH] La ruta depende básicamente de cómo se gestione en el servidor Web, usted debe adecuarla a su instalación, dado que en cada caso es diferente es su responsabilidad es ajustarlo exactamente, haga pruebas y verifique con el botón Preview & Test que se muestran correctamente. Una forma de ver las rutas es mediante un cliente de FTP, por ejemplo FTPZilla© que nos permitirá acceder al servidor y ver la estructura exacta, anotaremos los paths e iremos probando hasta conseguir que todo funcione correctamente. De todas formas la mejor prueba es montar la URL completa de la imagen, ponerla en el navegador y comprobar si la muestra.


Vemos aquí como incluir este código:


Podemos verificar los resultados pulsando el botón Prueba y Vista Previa ( o Preview & test en inglés) que nos mostrará las imágenes subidas al servidor si todo es correcto. Si no se muestran las fotos fíjese en la ruta de éstas en esta pantalla y corrija la estructura en el código hasta conseguir mostrarlas.

, haciendo clic en el enlace deberemos ver la foto y si hacemos scroll veremos en la parte inferior de esta capa las muestras de las fotos, si no aparecen es que la ruta que hemos puesto para las fotos no es correcta (obviamente deberemos haber subido previamente las fotos para hacer esta prueba).



Tipos de inmuebles Ahora programe como se van a mapear los tipos de inmueble de MultiLinkCRM a WordPress© para ello vaya a la opción Taxonomías, Categorías, Etiquetas Seleccione el check Property Type, especifique que solo tiene un Property Type y arrastre a esa casilla el valor <tipo> del XML, tal como se aprecia en la imagen. Después marque Habilitar Mapeo para Property Type y vaya detallando ahí la tabla de conversión de tipos de inmueble MultiLinkCRM, según se aprecia en la imagen, para añadir nuevas líneas haga clic en Add Another Rule, ponga en la tabla los tipos que utilice.


A continuación vemos la tabla incluyendo los tipos de inmueble que vienen por defecto en MultiLinkCRM


Ahora marcaremos la casilla Property Status (o Acción en la versión española) e indicaremos la gestión principal ahí, la propiedad del XML es <gestionppal>


Una vez completado todo marcaremos la casilla Guardar configuraciones como una plantilla y le asignaremos un nombre, en este se ha puesto MultiLinkCRM Por último hacemos clic en Continue to Step 4

Ahora debemos indicarle que campo va a identificar unívocamente a cada ficha, es decir la referencia de la ficha, igual que antes seleccionamos a la derecha el valor correcto y lo arrastramos y soltamos en el campo. Hay que seleccionar <refpropia>

Por último simplemente le daremos a Guardar y finalizaremos la configuración.


La mayor parte de las características están definidas en Custom Fields, o campos personalizados, se muestra los definidos en este caso:


En este caso la correspondencia de campos, únicamente a título de referencia, es la siguiente: Propiedad personalizada Tag del XML

Coordenadas

property_latitude <coordgpsn>

property_longitude <coordgpsw>

property_google_view 1 (TRUE)

OBSERVACIONES

Orientación <orientacion>

Distancia a la playa <distplaya>

Vistas <entorno>

Sótano <sotano>

Garaje <parking>

Construcción exterior

Certificación Energetico <certenergetica>

Año construcción <anoconst>

Servicios y características

aparcamiento <garaje>

trastero <trastero>

lavadero <lavadero>

terraza <terraza>

piscina <piscina>

zonas_verdes <jardines>

zona_deportiva <instdeportivas>

zona_comunitaria <urbanizacion>

agua <agua>

luz <electricidad>

gas <gas>

calefaccion <calefaccion>

aire_acondicionado <aireacond>

armarios_empotrados <armaempotrados>

puerta_blindada <ptablindada>

cocina_amueblada <cocinaamueblada>

amueblado <amueblado>

semiamueblado NO HAY EQUIVALENCIA

urbanizado NO HAY EQUIVALENCIA

ascensor <ascensor>

portero <conserje>


chimenea <chimenea>

vpo <vpo>

apto_para_discapacitados <accesible>

NOTA ADICIONAL Cuando se crean las fichas en WordPress se les asigna un identificador montado a partir del título del inmueble, si queremos poner un enlace en los correos electrónicos que se envían automáticamente desde MultiLinkCRM a los clientes es necesario poder referenciar la ficha mediante algún dato, el ID de Wordpress no lo sabe el programa y tampoco es cuestión de cada vez que se da de alta una ficha ir a mirar cual tiene y grabarlo manualmente, esto no es operativo. En la definición de la importación hay un campo que se llama POST SLUG (o SLUG DE ENTRADA en español) y sirve precisamente para esto, ahí es donde indicaremos algo que nos permita referenciar la ficha ¿Qué? Obviamente la referencia del inmueble, por supuesto, recuerde que este campo en el feed XML se llama <refpropia> Por defecto la URL corta de una ficha es similar a esta: http://dominio.com/?p=1730 siendo 1730 el ID del inmueble Si ponemos en el POST SLUG la referencia, la URL corta sería algo así como: http://dominio.com/properties/P345 siendo P345 la referencia del inmueble Ese dato está en la opción recuadrada en rojo:


E indicamos, mediante drag&drop el campo correspondiente del fichero XML.

NOTA IMPORTANTE La URL del inmueble tal como la monta por defecto WordPress es mejor para los buscadores, se indexará antes y estará mejor posicionada que si solo está la referencia, es usted quien debe valorar lo que más le interesa en cada caso. Si utiliza el formato por defecto de WordPress consulte la documentación pues MultiLinkCRM incluye funciones para resolver este problema. MultiLinkCRM incluye una función interna que genera un Slug a partir de un texto, esta función es práctica a la hora de generar enlaces en correos automáticos aunque obviamente no tan fiable como la referencia.


Configuración completada A partir de aquí solo es cuestión de probar para ver, en nuestro caso, si la correspondencia es correcta, si añadimos o quitamos algún campo, etc., podemos hacer una importación de prueba con uno o dos registros y ver el resultado de la importación directamente en la interfaz de administración de WordPress, luego los podemos borrar moviéndolos a la papelera. Una vez definido el procedimiento podemos ejecutarlo con Run Import o Ejecutar importación según el idioma, con lo que se cargan los datos del XML y se generan las propiedades correspondientes.


Configuración de los comandos posteriores al envío de la Web Podemos incluir en MultiLinkCRM las instrucciones necesarias para que, una vez cargados con FTP los datos en la Web, al ejecutar éstas se lance el proceso WpAllImport y se incorporen los datos a la Web. Para esto iremos a la opción Manage imports de WPAllImport

Ahora buscaremos la configuración de importación que hemos creado previamente y haremos clic en la opción cron scheduling.

Ahora en la configuración del cron veremos que nos indica las dos url’s que necesitaremos: Trigger Script URL Execution Script URL

Simplemente las copiaremos y la pondremos en la configuración de MultiLinkCRM, tal como se ha visto anteriormente.


Hay que copia los dos comandos, Trigger Script URL y Execution Script URL, uno detrás de otro.

Con esto queda completado el proceso y ya podremos automatizar el proceso de actualización de nuestra Web.


Tratamiento de las rutas remotas en servidores accesibles mediante sFTP El tratamiento de las rutas remotas cuando se accede al servidor mediante sFTP es diferente al protocolo FTP (sFTP no es FTP seguro, es un protocolo diferente). Las rutas se toman desde la carpeta inicial, la carpeta en la que estás cuando te conectas, por ejemplo si nos conectamos a un servidor wordPress© convencional con sFTP, veremos algo parecido a esto:

El programa (se ha utilizado FileZilla para el ejemplo) vemos que al conectarnos nos ha situado en la carpeta siguiente: /home/l6b93882359905/html Si deseamos dejar los datos que mandamos al servidor en la carpeta /home/l6b93882359905/html/wp-content/uploads


Por tanto solo indicaremos el trozo de la ruta que nace en la carpeta donde estamos, es decir deberíamos indicar solo lo siguiente: /wp-content/uploads Es decir la parte final de la ruta. Estos datos hay que indicarlos en los campos: ? Carpeta datos servidor ? Carpeta fotos servidor

NOTA: Hay que poner la misma información en ambos campos. ¡Recuerde seleccionar en el desplegable de la izquierda, recuadrado en rojo, la opción “Enviar por sFTP” Es recomendable crear una carpeta específica para subir los datos y que estos no se mezclen con el resto de la Web, en ese caso habría que añadir a la ruta indicada la nueva carpeta, por ejemplo si creamos la carpeta MultiLinkCRM la ruta a indicar sería la siguiente: /wp-content/uploads/MultiLinkCRM


¡¡¡MUY, MUY IMPORTANTE!!! Verifique siempre las rutas, compruébelo incluso varias veces, haga todas las pruebas que considere necesarias. Subir los datos de varios inmuebles con todas sus fotos a una ruta equivocada podría generar un desastre en su Web. Es su responsabilidad el hacer este proceso correctamente, no se asume ninguna responsabilidad sobre este tema, usted utiliza MultiLinkCRM bajo su propia y exclusiva responsabilidad. Lo más sencillo para hacer pruebas es subir un solo inmueble y marcar la casilla “No mandar fotos” según se aprecia en la imagen, de esta forma solo se mandará el fichero de datos: MultiLinkCRM.xml


Como cambiar el idioma de la plantilla Para cambiar el idioma de la plantilla debe acceder a la Web con un cliente FTP, vaya a la carpeta siguiente: /html/wp-content/themes/NOMBREPLANTILLA/languages Busque un fichero que termina en .po Descárguelo en su PC Ahora debe descargar el programa POEDIT desde este enlace: https://poedit.net/ Hay una versión gratuita y otra de pago, para lo que vamos a hacer con la gratis es suficiente. Debe crear una nueva traducción a partir del fichero existente, éste se llamará en su versión en ingles estadounidense de la siguiente forma: en_US.po La versión en español debe llamarse: es_ES.po


A partir de ahora lo que hay que hacer es traducir para cada uno de los textos definidos en el programa el equivalente en español. Una vez traducido subimos el nuevo archivo creado a la misma carpeta en donde descargamos la traducción en ingles, y cambiamos el idioma del sitio a español mediante el administrador de wordPress, si no lo hubiéramos hecho antes.

Otra alternativa es utilizar el plugin Loco Translate que permite editar las traducciones directamente en el navegador, sin descargar nada. Este plugin puede encontrarlo en el siguiente enlace: https://wordpress.org/plugins/loco-translate/ Hay más alternativas, se han presentado únicamente estas dos a título de ejemplo.


Funciones personalizadas Otra funcionalidad interesante es la posiblidad de incluir funciones personalizadas en las definiciones de importación de WPAllImport. Para incluirlas vaya a la opción Function Editor y ahí puede incluir las funciones que usted necesite.

Usted puede incluir funciones que se ejecuten en eventos concretos, por ejemplo cuando se guarde la ficha, por ejemplo esta función crea un meta personalizado y le asigna como valor el ID de la imagen que acaba de subir. <?php add_action('pmxi_gallery_image', 'my_slider_image', 10, 3); function my_slider_image($pid, $attid, $image_filepath) { add_post_meta($pid,"REAL_HOMES_slider_image",$attid,false); } ?>


MUY IMPORTANTE La información de este documento se proporciona únicamente a título de ejemplo, usted hace uso, bajo su propia y exclusiva responsabilidad de esta información, no podemos garantizar de ninguna manera que sea exacta en todos los casos, nosotros no asumimos ninguna responsabilidad de ningún tipo sobre el uso del contenido de este documento o cualquier problema que provoque la implementación de esta funcionalidad siguiendo o no la información aquí contenida.

Documents

Ejemplo Web integrada con MultiLinkCRM€¦ · · 2017-03-03Este ejemplo se ha realizado usando la plantilla WP Residence, ... seleccionaremos MultiLinkCRM XML y pondremos aquí