En el mundo de los Sistemas de Información Geográfica (SIG), QGIS se ha consolidado como una herramienta potente y versátil. Con la posibilidad de ampliar su funcionalidad a través de complementos, los usuarios pueden adaptar la aplicación a sus necesidades específicas.
Sin embargo, en ciertos casos, puede resultar útil o necesario gestionar los complementos de QGIS desde carpetas externas, ya sea para mantener una organización más clara, para utilizar complementos en desarrollo o para integrar herramientas de terceros que no están disponibles en el repositorio oficial.
En este artículo, exploraremos cómo añadir una variable de entorno en QGIS que permite cargar complementos desde una carpeta concreta, facilitando así una mayor flexibilidad y control en la gestión de tus herramientas SIG.
¿Por qué usar una carpeta personalizada para complementos?
Cuando instalamos un complemento de QGIS, el sistema se encarga de acceder al repositorio oficial de complementos de QGIS y descargarlo en nuestro equipo en la carpeta destinada para ello dentro del perfil activo.
Si quieres saber cuál la carpeta acceder en QGIS al menú Configuración > Perfil de Usuario > Abrir la carpeta del perfil activo. Los complementos instalados se encuentran en la carpeta pyhton/plugins.
Si tenemos conocimientos de programación podríamos revisar el código del complemento, estudiarlo y hasta mejorarlo. Sin embargo, si se lanza una nueva actualización y la aceptamos, todo este trabajo se perdería, ya que se borra la versión antigua del complemento y se sustituye por la actual.
También puede ocurrir que estemos desarrollando nuestro propio complemento en el que se gestione un control de versiones (ej. Git) y queremos poder probarlo en QGIS sin tener que trabajar en la carpeta por defecto pyhton/plugins.
Ventajas
Los casos descritos son dos buenos ejemplos donde poder usar las variables de entorno de QGIS y configurar nuestra carpeta personalizada. Entre las ventajas que este sistema se encuentran por tanto:
- Organización: Puedes mantener tus complementos organizados según proyectos, tipos de análisis o desarrollos en curso.
- Desarrollo: Si estás desarrollando complementos personalizados, tenerlos en una carpeta específica facilita las pruebas y actualizaciones.
- Integración: Puedes integrar complementos de terceros sin interferir con los complementos estándar de QGIS, evitando posibles conflictos.
Pasos para añadir una variable de entorno en QGIS
Indicaremos a continuación los pasos a seguir para preparar nuestro entorno y poder trabajar con complementos en carpetas concretas.
1. Identifica la carpeta de complementos
Asegúrate de tener una carpeta donde has almacenado tus complementos personalizados o de terceros. Esta carpeta debe contener todos los archivos necesarios para que QGIS reconozca y cargue los complementos.
Para el ejemplo, supongamos que nuestro desarrollos se encuentran en la carpeta E:\GEOINNOVA\DESARROLLOS\plugins

2. Configura la variable de entorno en QGIS
Para establecer la variable de entorno que indicará a QGIS dónde buscar los complementos:
- Abre QGIS y dirígete al menú Configuración > Opciones.
- En la ventana de Preferencias, busca la sección Sistema.
- Dentro de Sistema, localiza la opción Entorno.
- Haz clic en Añadir una nueva variable.

- Se añadirá una nueva entrada para definir los parámetros de la variable:
- En Aplicar, selecciona la opción “Poner a continuación”
- En Variable, introduce el nombre de la variable que este caso es QGIS_PLUGINPATH.
- En Valor, especifica la ruta completa de la carpeta donde has almacenado tus complementos.

- Guarda los cambios haciendo clic en Aceptar.
3. Reinicia QGIS y verifica la carga de complementos
Es importante reiniciar QGIS para que los cambios en las variables de entorno surtan efecto.
Después de reiniciar QGIS, ve a Complementos > Administrar e instalar complementos. Deberías poder ver y cargar los complementos que estén en la carpeta especificada en la variable de entorno que configuraste.
Consejo. Si están realizando cambios o desarrollando nuevas funcionalidades en complementos y quieres que se carguen en QGIS sin necesidad de reiniciarlo, puedes usar el complemento “Plugin Reloader”.
Conclusión
Configurar una variable de entorno como QGIS_PLUGINPATH no solo mejorará la organización y el desarrollo de tus complementos, sino que también te permitirá personalizar su entorno de trabajo de acuerdo con sus necesidades específicas. Con estos simples pasos, podrás maximizar el potencial de QGIS y optimizar tu flujo de trabajo en el ámbito de los SIG.
Este consejo y otras herramientas de apoyo en la programación con PyQGIS son enseñadas en nuestro “Curso de PyQGIS: Programación de Scripts en Python para QGIS”. Puedes también contactar con el Área de SIG y Desarrollo donde te podremos dar soporte para la creación de complementos de QGIS a medida.
Si tienes alguna duda ¡déjanos comentario a continuación!
¡Excelente y preciso, gracias!