Crear un plugin QGIS es mucho más sencillo de lo que parece, incluso cuando se empieza en programación. Gracias a Plugin Builder, es posible generar en pocos minutos la estructura completa de un plugin, sin escribir código complejo.
En este segundo artículo del tutorial, veremos cómo crear un primer plugin QGIS con Plugin Builder, paso a paso: instalación de la herramienta, elección del template, desactivación de opciones avanzadas y generación del plugin.
El objetivo es obtener rápidamente un plugin funcional en QGIS, para comprender el funcionamiento general antes de adentrarnos progresivamente en el código Python.
Crear un primer plugin con Plugin Builder
En el primer artículo vimos para qué sirven los plugins QGIS y de qué archivos están compuestos. Ahora pasamos a la práctica.
El objetivo de este artículo es sencillo: crear un plugin QGIS funcional sin escribir código complejo, para entender el ciclo básico del desarrollo de un plugin.
Para ello utilizaremos una herramienta esencial para principiantes: Plugin Builder.
¿Qué es Plugin Builder?
Plugin Builder es un plugin oficial de QGIS que permite generar automáticamente la estructura básica de un plugin.
Crea por ti:
- la estructura de carpetas,
- los archivos Python esenciales,
- el archivo
metadata.txt, - un plugin que se puede cargar inmediatamente en QGIS.
Plugin Builder evita errores comunes al inicio y permite centrarse en lo esencial: comprender y modificar un plugin existente.
Instalar Plugin Builder
- Abre QGIS
- Ve a Complementos → Administrar e instalar complementos
- Busca Plugin Builder
- Instálalo
Una vez instalado, Plugin Builder estará disponible en el menú Complementos.
Iniciar el asistente de creación
- Menú Complementos → Plugin Builder → Plugin Builder
- Se abre el asistente de creación
Deberás completar varios campos. No te preocupes: algunos son solo descriptivos.
Información general del plugin
Nombre y descripción
- Nombre del plugin: nombre legible para el usuario (por ejemplo, MiPrimerPlugin)
- Descripción: frase corta que explica la utilidad del plugin
Estos datos aparecerán en el gestor de complementos de QGIS.
Versión y autor
- Versión: comienza simplemente con
0.1 - Autor: tu nombre o el de tu organización
Parámetros técnicos importantes
Elección del template
Plugin Builder ofrece varios templates (modelos de plugin).
Para comenzar, se recomienda encarecidamente elegir:
Template: Tool button with dialog
Este template es el más didáctico porque:
- crea un botón en QGIS,
- prepara una ventana gráfica sencilla,
- corresponde a la mayoría de los plugins habituales.
Será una base sólida para los siguientes artículos.
Opciones que conviene desactivar al empezar
Para un primer plugin, es aconsejable desmarcar todas las opciones avanzadas, especialmente:
- Internationalization (traducciones)
- Help (documentación integrada)
- Unit testing
- Empaquetado avanzado
Estas funcionalidades son útiles en plugins más avanzados, pero complican innecesariamente la estructura para principiantes.
Las abordaremos más adelante, cuando las bases estén bien asentadas.
Clase del plugin
Plugin Builder solicita el nombre de la clase principal del plugin.
Ejemplo:
- Nombre del plugin:
MiPrimerPlugin - Clase:
MiPrimerPlugin
Por convención, se utiliza el mismo nombre y capitalización para evitar confusiones.
Menú e icono
Puedes indicar:
- el menú en el que aparecerá el plugin (normalmente Complementos),
- un icono (opcional en esta etapa).
Estas opciones se pueden modificar más adelante sin dificultad.
Generación del plugin
Una vez completados todos los campos:
- Haz clic en Generate
- Elige la carpeta de destino
Plugin Builder crea automáticamente la carpeta del plugin con todos los archivos necesarios.
¿Dónde colocar el plugin?
Para que QGIS reconozca el plugin, debe estar en la carpeta de plugins del usuario.
Según el sistema operativo:
- Windows
C:/Users/.../AppData/Roaming/QGIS/QGIS3/profiles/default/python/plugins - Linux
~/.local/share/QGIS/QGIS3/profiles/default/python/plugins - macOS
~/Library/Application Support/QGIS/QGIS3/profiles/default/python/plugins
💡 Consejo: Plugin Builder suele proponer esta carpeta por defecto.
Activar el plugin en QGIS
- Abre Complementos → Administrar e instalar complementos
- Ve a la pestaña Instalados
- Marca tu plugin
Si todo ha ido bien, el plugin aparece en el menú y puede activarse.
👉 En este punto, el plugin casi no hace nada… y eso es completamente normal.
Comprender lo que ha creado Plugin Builder
Antes de continuar, tómate un momento para abrir los archivos generados:
__init__.pymetadata.txt- el archivo Python principal
Ahora deberías reconocer los elementos descritos en el artículo anterior.
Errores frecuentes en principiantes
- el plugin no aparece → carpeta incorrecta
- error al cargar → problema de mayúsculas/minúsculas en el nombre de la clase
- QGIS rechaza el plugin → versión mínima de QGIS incorrecta
Estos errores son normales y forman parte del aprendizaje.
Lo que has aprendido
Al final de este artículo, ya sabes:
- instalar Plugin Builder,
- generar un plugin QGIS vacío,
- instalarlo localmente,
- activarlo en QGIS.
Has superado una etapa clave: ya eres desarrollador de plugins QGIS.
¿Y en el próximo artículo?
En el siguiente artículo veremos:
- cómo añadir un botón a QGIS,
- cómo mostrar una ventana sencilla,
- cómo estructurar el código sin perderse.
👉 Un plugin que hoy no hace nada puede convertirse mañana en una herramienta potente.
