Ir al contenido principal

Instalación y actualización de plugins para WordPress

Bienvenido al ecosistema nuby. Esta guía le permitirá integrar su sitio web en WordPress con la potencia de nuestro software inmobiliario. A través de estos plugins, habilitará funcionalidades clave como el inicio de sesión unificado, el área de clientes para propietarios e inquilinos, y la integración de componentes visuales.

Instalación.📋 Conceptos Clave antes de empezar

Arrendasoft

Para externalentender login:

mejor el proceso, aclaramos algunos términos técnicos mencionados en la instalación:

  • Instancia de nuby (URL Arrendasoft): Es la dirección web única de su empresa en nuestro software (ej. https://su-inmobiliaria.arrendasoft.co). Esta URL es el "puente" que conecta su sitio web con sus datos en nuby.

  • Plugins Arrendasoft: Notará que los archivos tienen el nombre "Arrendasoft". Esto es correcto; son los componentes oficiales que impulsan la tecnología de nuby.

  • Actualización Automática: Nuestros plugins están diseñados para actualizarse solos, garantizando que siempre tenga las últimas mejoras de seguridad y funcionalidad sin esfuerzo extra.


🚀 Fase 1: Descarga de los Plugins

Para garantizar que instale la versión más reciente y segura, utilizamos un sistema de descarga directa desde nuestros repositorios.

Existen 3 plugins esenciales. El procedimiento de descarga es el mismo para todos:

  1. Se debe

    Haga consultarclic en el enlace del archivo JSONde información (update-info.json) del plugin enque ladesea siguiente ruta:
    https://arrendasoft.co/wordpress_plugins/arrendasoft_external_login/update-info.json.
    Este archivo tiene 3 elementos: new_version, package y url.

    {
      "new_version": "1.0.0",
      "package": "https://arrendasoft.co/wordpress_plugins/arrendasoft_external_login/arrendasoft_external_login.1.0.0.zip",
      "url": "https://arrendasoft.co/wordpress_plugins/arrendasoft_external_login/"
    }
    descargar.

  2. Del archivo

    Verá JSONun copiartexto técnico; busque la propiedadlínea que dice "package".

  3. Copie la dirección web (URL) que aparece junto a "package" y(termina en .zip).

  4. Pegue esa dirección en su navegador para descargar el archivo zip,instalador.

    luego instalarlo usando la forma tradicional:
    1. Ir al menú plugins.
    2. Hacer clic en el botón "Agregar nuevo plugin".
    3. Hacer clic en el botón "Subir plugin".
    4. Cargar el archivo zip descargado.
  • Activar el plugin haciendo clic en el texto "activar" que se encuentra debajo del nombre del plugin cuando estamos en la lista

    Enlaces de pluginsdescarga:

    del
    sistema.
  • Ingresaraajustesosettingsplugin, esta sección cuenta con las siguientes opciones:
    sideseahabilitarlavalidaciónel login usando
    Plugin Función delPrincipal Habilitar autenticación Arrendasoft: una casillaEnlace de selecciónInformación
    External enLogin Conecta la base de datos de Arrendasoft.usuarios de nuby con su web.Ver archivo info
    Customer AreaHabilita el portal de autogestión para sus clientes.Ver archivo info
    Web Components APIPermite mostrar inmuebles y buscadores en su sitio.Ver archivo info
  • 💡 Consejo Pro: No se preocupe por el código que ve en los enlaces JSON. Solo necesita la dirección del .zip para obtener el instalador.


    🛠️ Fase 2: Instalación en WordPress

    Una vez tenga los archivos .zip descargados en su computador:

    1. Ingrese al panel administrativo de su WordPress (/wp-admin).

    2. En el menú lateral, vaya a Plugins > Añadir nuevo.

    3. Haga clic en el botón Subir plugin (parte superior).

    4. Seleccione el archivo .zip que descargó y haga clic en Instalar ahora.

    5. Al finalizar, haga clic en Activar plugin.

    Repita estos pasos para los tres plugins listados anteriormente.


    ⚙️ Fase 3: Configuración (Paso Crítico)

    El plugin Arrendasoft External Login es el corazón de la integración. Debe configurarlo correctamente para que todo funcione.

    1. Vaya a Ajustes (o Settings) del plugin "Arrendasoft External Login".

    2. Complete los siguientes campos:

    • Habilitar autenticación Arrendasoft: ✅ Marque esta casilla. Esto activa la validación de usuarios contra su base de datos en nuby.

    • URL Arrendasoft: este es el enlace aIngrese la instanciadirección completa de Arrendasoft,su lainstancia cualen esnuby obligatoria(ej: parahttps://su-empresa.arrendasoft.co).

      • Nota: Es vital que elesta pluginURL funcionesea ,correcta. ejemplo:Si https://my.arrendasoft.co.tiene dudas, consulte con nuestro equipo de soporte.

    • URL Redirect Customer Area: esDefina el "slug" o nombre de la página donde se tendráalojará el área de clientes,clientes Ej:(ej: mi-area-de-clientes,zona-clientes loo cualcustomer-area).

      redireccionará
      • El sistema redirigirá a https://my.web-arrendasoft.co/mi-area-de-clientes.su-web.com/zona-clientes. PorAsegúrese defectode tomarácrear laesta página llamadaen customer-area.WordPress posteriormente.

    • Borrar la configuración deal Arrendasoftdesactivar: login(Opcional) cuandoMárquela solo si desea que se desactiveborren ellos plugin: es una casilla para si se desea borrar la configuración de Arrendasoft logindatos al desactivardesinstalar el plugin.

    ✅ Validación

    Antes de guardar, use el botón "Probar la conexión a la API de Arrendasoft:Arrendasoft".

    • Si la conexión es unexitosa: botón¡Felicidades! botónSu parasitio verificarya siestá seconectado estáncon retornandonuby.

      datos
    • correctamente,
    • este

      Si funcionafalla: despuésVerifique que la "URL Arrendasoft" no tenga espacios ni errores de haberescritura.

      guardado la URL de Arrendasoft.
    • Guardar cambios: el botón con el que guardamos los ajustes realizados en el formulario.

    Finalmente,

    Arrendasofthaga customerclic area:
    en Guardar cambios.


    🔄 Fase 4: Actualización de Plugins

    Mantener sus plugins actualizados es vital para la seguridad y el acceso a nuevas funciones.

    Actualización Automática (Recomendada)

    El plugin Web Components API y las versiones recientes de los otros plugins están configurados para actualizarse automáticamente. WordPress detectará las nuevas versiones y las instalará sin que usted tenga que intervenir.

    Actualización Manual

    Si necesita forzar una actualización o la automática no se ha ejecutado:

    1. Se debe

      Vaya consultara ella archivosección JSONPlugins delen pluginsu WordPress.

    2. Busque los plugins de Arrendasoft en la siguiente ruta:
      https://arrendasoft.co/wordpress_plugins/arrendasoft_customer_area/update-info.json.
      Este archivo tiene 3 elementos: new_version, package y url.

      {
        "new_version": "1.0.0",
        "package": "https://arrendasoft.co/wordpress_plugins/arrendasoft_customer_area/arrendasoft_customer_area.1.0.0.zip",
        "url": "https://arrendasoft.co/wordpress_plugins/arrendasoft_customer_area/"
      }
      lista.

    3. Del archivo

      Si JSONhay copiaruna lanueva propiedadversión, verá un aviso amarillo indicando "package"Hay yuna descargarnueva elversión archivodisponible".

      zip, luego instalarlo usando la forma tradicional:
      1. Ir al menú plugins.
      2. Hacer

        Haga clic en el botónenlace "Agregaractualícela nuevoahora" plugin".

      3. para
      4. Haceraplicar cliclos encambios elinmediatamente.

        botón "Subir plugin".
      5. Cargar el archivo zip descargado.
    4. Activar el plugin haciendo clic en el texto "activar" que se encuentra debajo del nombre del plugin cuando estamos en la lista de plugins del sistema.
    Arrendasoft web components API:
    1. Se debe consultar el archivo JSON del plugin en la siguiente ruta:
      https://arrendasoft.co/wordpress_plugins/arrendasoft_web_components_api/update-info.json.
      Este archivo tiene 3 elementos: new_version, package y url.
      {
        "new_version": "1.0.0",
        "package": "https://arrendasoft.co/wordpress_plugins/arrendasoft_web_components_api/arrendasoft_web_components_api.1.0.0.zip",
        "url": "https://arrendasoft.co/wordpress_plugins/arrendasoft_web_components_api/"
      }
    2. Del archivo JSON copiar la propiedad "package" y descargar el archivo zip, luego instalarlo usando la forma tradicional:
      1. Ir al menú plugins.
      2. Hacer clic en el botón "Agregar nuevo plugin".
      3. Hacer clic en el botón "Subir plugin".
      4. Cargar el archivo zip descargado.
    3. Activar el plugin haciendo clic en el texto "activar" que se encuentra debajo del nombre del plugin cuando estamos en la lista de plugins del sistema.

    Actualización automática.

    El plugin de web components API ya está configurado para que se marque solo la opción de actualización automática, ya con esto es suficiente que actualicemos el archivo JSON y el archivo zip para que el mismo wordpress se encargue de hacer la actualización de forma automática. Para los otros 2 plugin se ha implementado la misma funcionalidad y los clientes nuevos la tendrán por defecto, pero para los clientes que ya tienen instalados los plugins(al momento de la creación de este manual), es necesario hacer la actualización de forma manual.

    Actualización manual.

    En el caso de que la actualización automática presente alguna dificultad, siempre tendremos la opción de la actualización manual, para esto nos dirigimos a la administración de plugins y estando en el listado de los mismos, se nos mostrará debajo de cada plugin que tenga una actualización disponible un mensaje indicando que hay una actualización disponible con enlaces a la revisión de los detalles de la versión y a la aplicación inmediata de la misma.

    image.png