Dans les deux premiers articles, nous avons pos\u00e9 les bases : comprendre ce qu\u2019est un plugin QGIS<\/a> et cr\u00e9er un plugin vide \u00e0 l\u2019aide de Plugin Builder<\/a>. Il est maintenant temps de donner un comportement visible<\/strong> \u00e0 notre plugin.<\/p>\n\n\n\n

Dans cet article, nous allons apprendre \u00e0 :<\/p>\n\n\n\n

\n
ajouter un bouton dans l\u2019interface de QGIS,<\/li>\n\n\n\n
comprendre le code g\u00e9n\u00e9r\u00e9 par Plugin Builder,<\/li>\n\n\n\n
afficher une fen\u00eatre (dialog) simple.<\/li>\n<\/ul>\n\n\n\n
L\u2019objectif n\u2019est pas encore de faire quelque chose de complexe, mais de comprendre le m\u00e9canisme fondamental<\/strong> de tout plugin QGIS.<\/p>\n\n\n\n
\n\n\n\n
<\/span>Rappel : le plugin g\u00e9n\u00e9r\u00e9 par Plugin Builder<\/span><\/h2>\n\n\n\n
Lorsque nous avons choisi le template Tool button with dialog<\/em>, Plugin Builder a d\u00e9j\u00e0 pr\u00e9par\u00e9 beaucoup de choses pour nous :<\/p>\n\n\n\n
\n
un bouton dans la barre d\u2019outils,<\/li>\n\n\n\n
un menu dans QGIS,<\/li>\n\n\n\n
une fen\u00eatre graphique associ\u00e9e.<\/li>\n<\/ul>\n\n\n\n
M\u00eame si cela fonctionne d\u00e9j\u00e0, il est essentiel de comprendre comment tout cela est reli\u00e9<\/strong>.<\/p>\n\n\n\n
\n\n\n\n
<\/span>Le fichier principal du plugin<\/span><\/h2>\n\n\n\n
Ouvrez le fichier Python principal de votre plugin (par exemple mon_premier_plugin.py<\/code>).<\/p>\n\n\n\n
Vous y trouverez une classe principale qui porte le nom du plugin. C\u2019est elle qui pilote tout le comportement.<\/p>\n\n\n
<\/div><\/div><\/div><\/div><\/p>\n\n\n\nclass MonPremierPlugin:\n def __init__(self, iface):\n self.iface = iface\n<\/code><\/pre>\n\n\n<\/div><\/div>\n\n\n\n 👉 iface<\/code> est l\u2019objet qui permet au plugin de dialoguer avec QGIS (menus, couches, messages\u2026).<\/p>\n\n\n\n \n\n\n\n<\/span>La m\u00e9thode initGui()<\/code> : point d\u2019entr\u00e9e visuel<\/span><\/h2>\n\n\n\nLa m\u00e9thode initGui()<\/code> est appel\u00e9e automatiquement lorsque le plugin est activ\u00e9 dans QGIS.<\/p>\n\n\n\n C\u2019est ici que sont d\u00e9finis :<\/p>\n\n\n\n \nle bouton dans la barre d\u2019outils,<\/li>\n\n\n\n l\u2019entr\u00e9e de menu,<\/li>\n\n\n\n l\u2019action associ\u00e9e.<\/li>\n<\/ul>\n\n\n\nExtrait typique :<\/p>\n\n\n <\/div><\/div><\/div><\/div><\/p>\n\n\n\ndef initGui(self):\n self.action = QAction(\n QIcon(':\/plugins\/MonPremierPlugin\/icon.png'),\n 'Mon premier plugin',\n self.iface.mainWindow()\n )\n self.action.triggered.connect(self.run)\n self.iface.addToolBarIcon(self.action)\n<\/code><\/pre>\n\n\n<\/div><\/div>\n\n\n\n M\u00eame sans comprendre chaque ligne, retenez que :<\/p>\n\n\n\n \nune action<\/strong> est cr\u00e9\u00e9e,<\/li>\n\n\n\n elle est reli\u00e9e \u00e0 une m\u00e9thode (run<\/code>),<\/li>\n\n\n\n elle est ajout\u00e9e \u00e0 l\u2019interface de QGIS.<\/li>\n<\/ul>\n\n\n\n \n\n\n\n<\/span>La m\u00e9thode run()<\/code> : quand on clique sur le bouton<\/span><\/h2>\n\n\n\nLa m\u00e9thode run()<\/code> est appel\u00e9e lorsque l\u2019utilisateur clique sur le bouton du plugin.<\/p>\n\n\n\n Dans le template g\u00e9n\u00e9r\u00e9, elle sert principalement \u00e0 afficher une fen\u00eatre<\/strong>.<\/p>\n\n\n <\/div><\/div><\/div><\/div><\/p>\n\n\n\ndef run(self):\n self.dlg.show()\n<\/code><\/pre>\n\n\n<\/div><\/div>\n\n\n\n 👉 \u00c0 ce stade, le plugin ne fait qu\u2019une chose : ouvrir un dialogue.<\/p>\n\n\n\n \n\n\n\n<\/span>📦 Ce que fait vraiment un bouton dans QGIS<\/span><\/h3>\n\n\n\n\nLorsqu\u2019on clique sur un bouton dans QGIS, il ne se passe rien de \u00ab magique \u00bb.<\/p>\n\n\n\n Un bouton de plugin est simplement un d\u00e9clencheur<\/strong> : il appelle une fonction Python pr\u00e9cise.<\/p>\n\n\n\n Concr\u00e8tement, le fonctionnement est toujours le m\u00eame :<\/p>\n\n\n\n \nle plugin cr\u00e9e une action<\/strong> (QAction<\/code>),<\/li>\n\n\n\n cette action est associ\u00e9e \u00e0 une fonction (par exemple run()<\/code>),<\/li>\n\n\n\n lorsque l\u2019utilisateur clique sur le bouton, QGIS ex\u00e9cute cette fonction<\/strong>.<\/li>\n<\/ol>\n\n\n\nDans notre cas, la fonction run()<\/code> se contente d\u2019afficher une fen\u00eatre. Mais plus tard, cette m\u00eame fonction pourra :<\/p>\n\n\n\n \nlire des param\u00e8tres saisis par l\u2019utilisateur,<\/li>\n\n\n\n analyser des couches,<\/li>\n\n\n\n lancer des traitements,<\/li>\n\n\n\n produire des r\u00e9sultats.<\/li>\n<\/ul>\n\n\n\n👉 Un bouton QGIS ne fait qu\u2019une chose : lancer du code Python.<\/strong> Toute la puissance du plugin se trouve dans ce code.<\/p>\n<\/blockquote>\n\n\n\n \n\n\n\n<\/span>Comprendre la fen\u00eatre (dialog<\/code>)<\/span><\/h2>\n\n\n\nLa fen\u00eatre affich\u00e9e est d\u00e9finie dans un fichier .ui<\/code>, cr\u00e9\u00e9 avec Qt Designer.<\/p>\n\n\n\n Ce fichier est ensuite charg\u00e9 en Python, ce qui permet :<\/p>\n\n\n\n \nd\u2019afficher la fen\u00eatre,<\/li>\n\n\n\n de r\u00e9cup\u00e9rer les valeurs saisies par l\u2019utilisateur,<\/li>\n\n\n\n de connecter des boutons \u00e0 du code.<\/li>\n<\/ul>\n\n\n\nPour l\u2019instant, nous allons simplement modifier le contenu visuel.<\/p>\n\n\n\n \n\n\n\n<\/span>Modifier le texte de la fen\u00eatre<\/span><\/h2>\n\n\n\nOuvrez le fichier .ui<\/code> avec Qt Designer<\/strong>.<\/p>\n\n\n\n Essayez par exemple :<\/p>\n\n\n\n \nde changer le titre de la fen\u00eatre,<\/li>\n\n\n\n de modifier un label,<\/li>\n\n\n\n d\u2019ajouter un bouton.<\/li>\n<\/ul>\n\n\n\nEnregistrez le fichier, rechargez le plugin dans QGIS, puis cliquez sur le bouton.<\/p>\n\n\n\n 👉 Vous venez de modifier l\u2019interface d\u2019un plugin QGIS sans \u00e9crire de code Python.<\/p>\n\n\n\n \n\n\n\n<\/span>Tester et recharger le plugin<\/span><\/h2>\n\n\n\n\u00c0 chaque modification du code ou de l\u2019interface :<\/p>\n\n\n\n \nD\u00e9sactivez le plugin dans le gestionnaire d\u2019extensions<\/li>\n\n\n\n R\u00e9activez-le<\/li>\n<\/ol>\n\n\n\nOu utilisez l\u2019option Recharger le plugin<\/strong> si vous avez install\u00e9 l\u2019extension d\u00e9di\u00e9e.<\/p>\n\n\n\n \n\n\n\n<\/span>Erreurs fr\u00e9quentes \u00e0 ce stade<\/span><\/h2>\n\n\n\n\nrien ne se passe au clic \u2192 m\u00e9thode run()<\/code> non connect\u00e9e<\/li>\n\n\n\n erreur au chargement \u2192 faute de casse dans les noms<\/li>\n\n\n\n fen\u00eatre vide \u2192 fichier .ui<\/code> mal r\u00e9f\u00e9renc\u00e9<\/li>\n<\/ul>\n\n\n\nCes probl\u00e8mes sont normaux et font partie du processus.<\/p>\n\n\n\n \n\n\n\n<\/span>Ce que vous avez appris<\/span><\/h2>\n\n\n\n\u00c0 l\u2019issue de cet article, vous savez :<\/p>\n\n\n\n \no\u00f9 est cr\u00e9\u00e9 le bouton d\u2019un plugin QGIS,<\/li>\n\n\n\n comment une action est connect\u00e9e \u00e0 du code,<\/li>\n\n\n\n comment afficher et modifier une fen\u00eatre.<\/li>\n<\/ul>\n\n\n\nVous avez d\u00e9sormais la brique essentielle de tout plugin QGIS interactif<\/strong>.<\/p>\n\n\n\n \n\n\n\n<\/span>Et dans le prochain article ?<\/span><\/h2>\n\n\n\nDans l\u2019article suivant, nous verrons :<\/p>\n\n\n\n \ncomment r\u00e9cup\u00e9rer des valeurs saisies dans la fen\u00eatre,<\/li>\n\n\n\n comment interagir avec les couches QGIS,<\/li>\n\n\n\n comment structurer le code pour aller plus loin.<\/li>\n<\/ul>\n\n\n\n👉 \u00c0 partir d\u2019ici, votre plugin commence vraiment \u00e0 devenir utile.<\/em><\/p>\n\n\n\n \n","protected":false},"excerpt":{"rendered":"Ajouter un bouton dans l\u2019interface de QGIS est souvent la premi\u00e8re \u00e9tape concr\u00e8te lorsqu\u2019on d\u00e9veloppe un plugin. C\u2019est ce qui transforme un simple script Python en outil r\u00e9ellement utilisable par l\u2019utilisateur. Dans ce troisi\u00e8me article du…<\/p>\n","protected":false},"author":1,"featured_media":16327,"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":[1945,62],"tags":[176,4202,279,4204,58],"class_list":["post-16308","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-pluigin","category-qgis-2","tag-bouton","tag-dialogue","tag-plugin","tag-plugin-builder-fr","tag-qgis"],"aioseo_notices":[],"jetpack_featured_media_url":"https:\/\/i0.wp.com\/www.sigterritoires.fr\/wp-content\/uploads\/2026\/01\/pluginsQGIS3.jpg?fit=409%2C307&ssl=1","jetpack_shortlink":"https:\/\/wp.me\/p6XU0A-4f2","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/www.sigterritoires.fr\/index.php\/wp-json\/wp\/v2\/posts\/16308","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=16308"}],"version-history":[{"count":0,"href":"https:\/\/www.sigterritoires.fr\/index.php\/wp-json\/wp\/v2\/posts\/16308\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.sigterritoires.fr\/index.php\/wp-json\/wp\/v2\/media\/16327"}],"wp:attachment":[{"href":"https:\/\/www.sigterritoires.fr\/index.php\/wp-json\/wp\/v2\/media?parent=16308"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.sigterritoires.fr\/index.php\/wp-json\/wp\/v2\/categories?post=16308"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.sigterritoires.fr\/index.php\/wp-json\/wp\/v2\/tags?post=16308"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}