{"id":16363,"date":"2026-05-28T10:00:00","date_gmt":"2026-05-28T08:00:00","guid":{"rendered":"https:\/\/www.sigterritoires.fr\/?p=16363"},"modified":"2026-05-23T14:55:54","modified_gmt":"2026-05-23T12:55:54","slug":"crear-plugin-qgis-con-plugin-builder","status":"publish","type":"post","link":"https:\/\/www.sigterritoires.fr\/index.php\/es\/crear-plugin-qgis-con-plugin-builder\/","title":{"rendered":"[ES]Desarrollar un Plugin QGIS: Crear un Plugin con Plugin Builder"},"content":{"rendered":"\n

Crear un plugin QGIS es mucho m\u00e1s sencillo de lo que parece, incluso cuando se empieza en programaci\u00f3n. Gracias a Plugin Builder<\/strong>, es posible generar en pocos minutos la estructura completa de un plugin, sin escribir c\u00f3digo complejo.<\/p>\n\n\n\n

En este segundo art\u00edculo del tutorial, veremos c\u00f3mo crear un primer plugin QGIS con Plugin Builder<\/strong>, paso a paso: instalaci\u00f3n de la herramienta, elecci\u00f3n del template, desactivaci\u00f3n de opciones avanzadas y generaci\u00f3n del plugin.<\/p>\n\n\n\n

El objetivo es obtener r\u00e1pidamente un plugin funcional en QGIS<\/strong>, para comprender el funcionamiento general antes de adentrarnos progresivamente en el c\u00f3digo Python.<\/p>\n\n\n\n

\n\n\n\n\n\n\n
\n\n\n\n
\n
\n
Contenu <\/p>\nToggle<\/span>
Crear un primer plugin con Plugin Builder<\/a><\/li>
\u00bfQu\u00e9 es Plugin Builder?<\/a><\/li>
Instalar Plugin Builder<\/a><\/li>
Iniciar el asistente de creaci\u00f3n<\/a><\/li>
Informaci\u00f3n general del plugin<\/a>
Nombre y descripci\u00f3n<\/a><\/li>
Versi\u00f3n y autor<\/a><\/li><\/ul><\/li>
Par\u00e1metros t\u00e9cnicos importantes<\/a>
Elecci\u00f3n del template<\/a><\/li>
Opciones que conviene desactivar al empezar<\/a><\/li>
Clase del plugin<\/a><\/li>
Men\u00fa e icono<\/a><\/li><\/ul><\/li>
Generaci\u00f3n del plugin<\/a><\/li>
\u00bfD\u00f3nde colocar el plugin?<\/a><\/li>
Activar el plugin en QGIS<\/a><\/li>
Comprender lo que ha creado Plugin Builder<\/a><\/li>
Errores frecuentes en principiantes<\/a><\/li>
Lo que has aprendido<\/a><\/li>
\u00bfY en el pr\u00f3ximo art\u00edculo?<\/a><\/li><\/ul><\/nav><\/div>\n
<\/span>Crear un primer plugin con Plugin Builder<\/span><\/h2>\n\n\n\n
En el primer art\u00edculo vimos para qu\u00e9 sirven los plugins QGIS y de qu\u00e9 archivos est\u00e1n compuestos. Ahora pasamos a la pr\u00e1ctica.<\/p>\n\n\n\n
El objetivo de este art\u00edculo es sencillo: crear un plugin QGIS funcional sin escribir c\u00f3digo complejo<\/strong>, para entender el ciclo b\u00e1sico del desarrollo de un plugin.<\/p>\n\n\n\n
Para ello utilizaremos una herramienta esencial para principiantes: Plugin Builder<\/strong>.<\/p>\n\n\n\n
\n\n\n\n
<\/span>\u00bfQu\u00e9 es Plugin Builder?<\/span><\/h2>\n\n\n\n
Plugin Builder es un plugin oficial de QGIS que permite generar autom\u00e1ticamente la estructura b\u00e1sica de un plugin.<\/p>\n\n\n\n
Crea por ti:<\/p>\n\n\n\n
\n
la estructura de carpetas,<\/li>\n\n\n\n
los archivos Python esenciales,<\/li>\n\n\n\n
el archivo metadata.txt<\/code>,<\/li>\n\n\n\n
un plugin que se puede cargar inmediatamente en QGIS.<\/li>\n<\/ul>\n\n\n\nPlugin Builder evita errores comunes al inicio y permite centrarse en lo esencial: comprender y modificar un plugin existente<\/strong>.<\/p>\n\n\n\n \n\n\n\n<\/span>Instalar Plugin Builder<\/span><\/h2>\n\n\n\n\nAbre QGIS<\/li>\n\n\n\n Ve a Complementos \u2192 Administrar e instalar complementos<\/strong><\/li>\n\n\n\n Busca Plugin Builder<\/strong><\/li>\n\n\n\n Inst\u00e1lalo<\/li>\n<\/ol>\n\n\n\nUna vez instalado, Plugin Builder estar\u00e1 disponible en el men\u00fa Complementos<\/strong>.<\/p>\n\n\n\n \n\n\n\n<\/span>Iniciar el asistente de creaci\u00f3n<\/span><\/h2>\n\n\n\n\nMen\u00fa Complementos \u2192 Plugin Builder \u2192 Plugin Builder<\/strong><\/li>\n\n\n\n Se abre el asistente de creaci\u00f3n<\/li>\n<\/ul>\n\n\n\nDeber\u00e1s completar varios campos. No te preocupes: algunos son solo descriptivos.<\/p>\n\n\n\n \n\n\n\n<\/span>Informaci\u00f3n general del plugin<\/span><\/h2>\n\n\n\n<\/span>Nombre y descripci\u00f3n<\/span><\/h3>\n\n\n\n\nNombre del plugin<\/strong>: nombre legible para el usuario (por ejemplo, MiPrimerPlugin<\/em>)<\/li>\n\n\n\n Descripci\u00f3n<\/strong>: frase corta que explica la utilidad del plugin<\/li>\n<\/ul>\n\n\n\nEstos datos aparecer\u00e1n en el gestor de complementos de QGIS.<\/p>\n\n\n\n \n\n\n\n<\/span>Versi\u00f3n y autor<\/span><\/h3>\n\n\n\n\nVersi\u00f3n<\/strong>: comienza simplemente con 0.1<\/code><\/li>\n\n\n\n Autor<\/strong>: tu nombre o el de tu organizaci\u00f3n<\/li>\n<\/ul>\n\n\n\n \n\n\n\n<\/span>Par\u00e1metros t\u00e9cnicos importantes<\/span><\/h2>\n\n\n\n<\/span>Elecci\u00f3n del template<\/span><\/h3>\n\n\n\nPlugin Builder ofrece varios templates (modelos de plugin).<\/p>\n\n\n\n Para comenzar, se recomienda encarecidamente<\/strong> elegir:<\/p>\n\n\n\n Template: Tool button with dialog<\/strong><\/p>\n\n\n\n Este template es el m\u00e1s did\u00e1ctico porque:<\/p>\n\n\n\n \ncrea un bot\u00f3n en QGIS,<\/li>\n\n\n\n prepara una ventana gr\u00e1fica sencilla,<\/li>\n\n\n\n corresponde a la mayor\u00eda de los plugins habituales.<\/li>\n<\/ul>\n\n\n\nSer\u00e1 una base s\u00f3lida para los siguientes art\u00edculos.<\/p>\n\n\n\n \n\n\n\n<\/span>Opciones que conviene desactivar al empezar<\/span><\/h3>\n\n\n\nPara un primer plugin, es aconsejable desmarcar todas las opciones avanzadas<\/strong>, especialmente:<\/p>\n\n\n\n \nInternationalization (traducciones)<\/li>\n\n\n\n Help (documentaci\u00f3n integrada)<\/li>\n\n\n\n Unit testing<\/li>\n\n\n\n Empaquetado avanzado<\/li>\n<\/ul>\n\n\n\nEstas funcionalidades son \u00fatiles en plugins m\u00e1s avanzados, pero complican innecesariamente la estructura para principiantes.<\/p>\n\n\n\n Las abordaremos m\u00e1s adelante, cuando las bases est\u00e9n bien asentadas.<\/p>\n\n\n\n \n\n\n\n<\/span>Clase del plugin<\/span><\/h3>\n\n\n\nPlugin Builder solicita el nombre de la clase principal del plugin.<\/p>\n\n\n\n Ejemplo:<\/p>\n\n\n\n \nNombre del plugin: MiPrimerPlugin<\/code><\/li>\n\n\n\n Clase: MiPrimerPlugin<\/code><\/li>\n<\/ul>\n\n\n\nPor convenci\u00f3n, se utiliza el mismo nombre y capitalizaci\u00f3n para evitar confusiones.<\/p>\n\n\n\n \n\n\n\n<\/span>Men\u00fa e icono<\/span><\/h3>\n\n\n\nPuedes indicar:<\/p>\n\n\n\n \nel men\u00fa en el que aparecer\u00e1 el plugin (normalmente Complementos<\/strong>),<\/li>\n\n\n\n un icono (opcional en esta etapa).<\/li>\n<\/ul>\n\n\n\nEstas opciones se pueden modificar m\u00e1s adelante sin dificultad.<\/p>\n\n\n\n \n\n\n\n<\/span>Generaci\u00f3n del plugin<\/span><\/h2>\n\n\n\nUna vez completados todos los campos:<\/p>\n\n\n\n \nHaz clic en Generate<\/strong><\/li>\n\n\n\n Elige la carpeta de destino<\/li>\n<\/ol>\n\n\n\nPlugin Builder crea autom\u00e1ticamente la carpeta del plugin con todos los archivos necesarios.<\/p>\n\n\n\n \n\n\n\n<\/span>\u00bfD\u00f3nde colocar el plugin?<\/span><\/h2>\n\n\n\nPara que QGIS reconozca el plugin, debe estar en la carpeta de plugins del usuario.<\/p>\n\n\n\n Seg\u00fan el sistema operativo:<\/p>\n\n\n\n \nWindows<\/strong> C:\/Users\/...\/AppData\/Roaming\/QGIS\/QGIS3\/profiles\/default\/python\/plugins<\/code><\/li>\n\n\n\n Linux<\/strong> ~\/.local\/share\/QGIS\/QGIS3\/profiles\/default\/python\/plugins<\/code><\/li>\n\n\n\n macOS<\/strong> ~\/Library\/Application Support\/QGIS\/QGIS3\/profiles\/default\/python\/plugins<\/code><\/li>\n<\/ul>\n\n\n\n💡 Consejo: Plugin Builder suele proponer esta carpeta por defecto.<\/p>\n\n\n\n \n\n\n\n<\/span>Activar el plugin en QGIS<\/span><\/h2>\n\n\n\n\nAbre Complementos \u2192 Administrar e instalar complementos<\/strong><\/li>\n\n\n\n Ve a la pesta\u00f1a Instalados<\/strong><\/li>\n\n\n\n Marca tu plugin<\/li>\n<\/ol>\n\n\n\nSi todo ha ido bien, el plugin aparece en el men\u00fa y puede activarse.<\/p>\n\n\n\n 👉 En este punto, el plugin casi no hace nada\u2026 y eso es completamente normal.<\/p>\n\n\n\n \n\n\n\n<\/span>Comprender lo que ha creado Plugin Builder<\/span><\/h2>\n\n\n\nAntes de continuar, t\u00f3mate un momento para abrir los archivos generados:<\/p>\n\n\n\n \n__init__.py<\/code><\/li>\n\n\n\n metadata.txt<\/code><\/li>\n\n\n\n el archivo Python principal<\/li>\n<\/ul>\n\n\n\nAhora deber\u00edas reconocer los elementos descritos en el art\u00edculo anterior.<\/p>\n\n\n\n \n\n\n\n<\/span>Errores frecuentes en principiantes<\/span><\/h2>\n\n\n\n\nel plugin no aparece \u2192 carpeta incorrecta<\/li>\n\n\n\n error al cargar \u2192 problema de may\u00fasculas\/min\u00fasculas en el nombre de la clase<\/li>\n\n\n\n QGIS rechaza el plugin \u2192 versi\u00f3n m\u00ednima de QGIS incorrecta<\/li>\n<\/ul>\n\n\n\nEstos errores son normales y forman parte del aprendizaje.<\/p>\n\n\n\n \n\n\n\n<\/span>Lo que has aprendido<\/span><\/h2>\n\n\n\nAl final de este art\u00edculo, ya sabes:<\/p>\n\n\n\n \ninstalar Plugin Builder,<\/li>\n\n\n\n generar un plugin QGIS vac\u00edo,<\/li>\n\n\n\n instalarlo localmente,<\/li>\n\n\n\n activarlo en QGIS.<\/li>\n<\/ul>\n\n\n\nHas superado una etapa clave: ya eres desarrollador de plugins QGIS<\/strong>.<\/p>\n\n\n\n \n\n\n\n<\/span>\u00bfY en el pr\u00f3ximo art\u00edculo?<\/span><\/h2>\n\n\n\nEn el siguiente art\u00edculo veremos:<\/p>\n\n\n\n \nc\u00f3mo a\u00f1adir un bot\u00f3n a QGIS,<\/li>\n\n\n\n c\u00f3mo mostrar una ventana sencilla,<\/li>\n\n\n\n c\u00f3mo estructurar el c\u00f3digo sin perderse.<\/li>\n<\/ul>\n\n\n\n👉 Un plugin que hoy no hace nada puede convertirse ma\u00f1ana en una herramienta potente.<\/p>\n\n\n\n \n","protected":false},"excerpt":{"rendered":"Crear un plugin QGIS es mucho m\u00e1s sencillo de lo que parece, incluso cuando se empieza en programaci\u00f3n. Gracias a Plugin Builder, es posible generar en pocos minutos la estructura completa de un plugin, sin escribir…<\/p>\n","protected":false},"author":1,"featured_media":16328,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"give_campaign_id":0,"_bbp_topic_count":0,"_bbp_reply_count":0,"_bbp_total_topic_count":0,"_bbp_total_reply_count":0,"_bbp_voice_count":0,"_bbp_anonymous_reply_count":0,"_bbp_topic_count_hidden":0,"_bbp_reply_count_hidden":0,"_bbp_forum_subforum_count":0,"sfsi_plus_gutenberg_text_before_share":"","sfsi_plus_gutenberg_show_text_before_share":"","sfsi_plus_gutenberg_icon_type":"","sfsi_plus_gutenberg_icon_alignemt":"","sfsi_plus_gutenburg_max_per_row":"","_monsterinsights_skip_tracking":false,"_monsterinsights_sitenote_active":false,"_monsterinsights_sitenote_note":"","_monsterinsights_sitenote_category":0,"_jetpack_newsletter_access":"","_jetpack_dont_email_post_to_subs":false,"_jetpack_newsletter_tier_id":0,"_jetpack_memberships_contains_paywalled_content":false,"_jetpack_memberships_contains_paid_content":false,"footnotes":"","jetpack_post_was_ever_published":false},"categories":[3442,1357],"tags":[4155,4655,4159,4157,4658],"class_list":["post-16363","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-pluigin-es","category-qgis-es","tag-desarrollo-de-plugins-qgis","tag-plugin-builder-qgis-es","tag-plugin-qgis-con-python","tag-plugin-qgis-para-principiantes","tag-tutorial-plugin-qgis-es"],"aioseo_notices":[],"jetpack_featured_media_url":"https:\/\/i0.wp.com\/www.sigterritoires.fr\/wp-content\/uploads\/2026\/01\/pluginsQGIS2.jpg?fit=409%2C307&ssl=1","jetpack_shortlink":"https:\/\/wp.me\/p6XU0A-4fV","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/www.sigterritoires.fr\/index.php\/wp-json\/wp\/v2\/posts\/16363","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.sigterritoires.fr\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.sigterritoires.fr\/index.php\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.sigterritoires.fr\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.sigterritoires.fr\/index.php\/wp-json\/wp\/v2\/comments?post=16363"}],"version-history":[{"count":0,"href":"https:\/\/www.sigterritoires.fr\/index.php\/wp-json\/wp\/v2\/posts\/16363\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.sigterritoires.fr\/index.php\/wp-json\/wp\/v2\/media\/16328"}],"wp:attachment":[{"href":"https:\/\/www.sigterritoires.fr\/index.php\/wp-json\/wp\/v2\/media?parent=16363"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.sigterritoires.fr\/index.php\/wp-json\/wp\/v2\/categories?post=16363"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.sigterritoires.fr\/index.php\/wp-json\/wp\/v2\/tags?post=16363"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}