{"id":16307,"date":"2026-05-26T10:00:00","date_gmt":"2026-05-26T08:00:00","guid":{"rendered":"https:\/\/www.sigterritoires.fr\/?p=16307"},"modified":"2026-05-23T14:51:53","modified_gmt":"2026-05-23T12:51:53","slug":"creer-plugin-qgis-plugin-builder","status":"publish","type":"post","link":"https:\/\/www.sigterritoires.fr\/index.php\/creer-plugin-qgis-plugin-builder\/","title":{"rendered":"[FR]D\u00e9velopper Un Plugin Qgis : Cr\u00e9er Un Plugin Avec Plugin Builder"},"content":{"rendered":"\n

Cr\u00e9er un plugin QGIS<\/a> est beaucoup plus simple qu\u2019il n\u2019y para\u00eet, surtout lorsque l\u2019on d\u00e9bute en programmation. Gr\u00e2ce \u00e0 Plugin Builder<\/strong>, il est possible de g\u00e9n\u00e9rer en quelques minutes la structure compl\u00e8te d\u2019un plugin, sans \u00e9crire de code complexe.<\/p>\n\n\n\n

Dans ce deuxi\u00e8me article du tutoriel, nous allons voir comment cr\u00e9er un premier plugin QGIS avec Plugin Builder<\/strong>, \u00e9tape par \u00e9tape : installation de l\u2019outil, choix du template, d\u00e9sactivation des options avanc\u00e9es et g\u00e9n\u00e9ration du plugin.<\/p>\n\n\n\n

L\u2019objectif est d\u2019obtenir rapidement un plugin fonctionnel dans QGIS<\/strong>, afin de comprendre le fonctionnement g\u00e9n\u00e9ral avant d\u2019entrer progressivement dans le code Python.<\/p>\n\n\n\n

\n\n\n\n
<\/p>\n\n\n\n
\n\n\n\n
\n
\n
Contenu <\/p>\n Toggle<\/span>
Cr\u00e9er un premier plugin avec Plugin Builder<\/a><\/li>
Qu\u2019est-ce que Plugin Builder ?<\/a><\/li>
Installer Plugin Builder<\/a><\/li>
Lancer l\u2019assistant de cr\u00e9ation<\/a><\/li>
Les informations g\u00e9n\u00e9rales du plugin<\/a>
Nom et description<\/a><\/li>
Version et auteur<\/a><\/li><\/ul><\/li>
Les param\u00e8tres techniques importants<\/a>
Choix du template<\/a><\/li>
Options \u00e0 d\u00e9cocher pour d\u00e9buter<\/a><\/li>
Classe du plugin<\/a><\/li>
Menu et ic\u00f4ne<\/a><\/li><\/ul><\/li>
G\u00e9n\u00e9ration du plugin<\/a><\/li>
O\u00f9 placer le plugin ?<\/a><\/li>
Activer le plugin dans QGIS<\/a><\/li>
Comprendre ce que Plugin Builder a cr\u00e9\u00e9<\/a><\/li>
Erreurs fr\u00e9quentes chez les d\u00e9butants<\/a><\/li>
Ce que vous avez appris<\/a><\/li>
Et dans le prochain article ?<\/a><\/li><\/ul><\/nav><\/div>\n
<\/span>Cr\u00e9er un premier plugin avec Plugin Builder<\/span><\/h2>\n\n\n\n
Dans le premier article<\/a>, nous avons vu \u00e0 quoi servent les plugins QGIS et de quels fichiers ils sont constitu\u00e9s. Passons maintenant \u00e0 la pratique.<\/p>\n\n\n\n
Dans cet article, l\u2019objectif est simple : cr\u00e9er un plugin QGIS fonctionnel, sans \u00e9crire de code complexe<\/strong>, afin de comprendre le cycle de base du d\u00e9veloppement d\u2019un plugin.<\/p>\n\n\n\n
Nous allons utiliser un outil indispensable pour les d\u00e9butants : Plugin Builder<\/strong>.<\/p>\n\n\n\n
\n\n\n\n
<\/span>Qu\u2019est-ce que Plugin Builder ?<\/span><\/h2>\n\n\n\n
Plugin Builder est un plugin officiel de QGIS qui permet de g\u00e9n\u00e9rer automatiquement l\u2019ossature d\u2019un plugin.<\/p>\n\n\n\n
Il cr\u00e9e pour vous :<\/p>\n\n\n\n
\n
la structure des dossiers,<\/li>\n\n\n\n
les fichiers Python essentiels,<\/li>\n\n\n\n
le fichier metadata.txt<\/code>,<\/li>\n\n\n\n
un plugin imm\u00e9diatement chargeable dans QGIS.<\/li>\n<\/ul>\n\n\n\nPlugin Builder \u00e9vite les erreurs de d\u00e9part et permet de se concentrer sur l\u2019essentiel : comprendre et modifier un plugin existant<\/strong>.<\/p>\n\n\n\n \n\n\n\n<\/span>Installer Plugin Builder<\/span><\/h2>\n\n\n\n\nOuvrez QGIS<\/li>\n\n\n\n Allez dans Extensions \u2192 Installer\/G\u00e9rer les extensions<\/strong><\/li>\n\n\n\n Recherchez Plugin Builder<\/strong><\/li>\n\n\n\n Installez-le<\/li>\n<\/ol>\n\n\n\nUne fois install\u00e9, Plugin Builder est accessible depuis le menu Extensions<\/strong>.<\/p>\n\n\n\n \n\n\n\n<\/span>Lancer l\u2019assistant de cr\u00e9ation<\/span><\/h2>\n\n\n\n\nMenu Extensions \u2192 Plugin Builder \u2192 Plugin Builder<\/strong><\/li>\n\n\n\n L\u2019assistant de cr\u00e9ation s\u2019ouvre<\/li>\n<\/ol>\n\n\n\nVous allez devoir renseigner plusieurs informations. Pas d\u2019inqui\u00e9tude : certaines sont purement descriptives.<\/p>\n\n\n\n \n\n\n\n<\/span>Les informations g\u00e9n\u00e9rales du plugin<\/span><\/h2>\n\n\n\n<\/span>Nom et description<\/span><\/h3>\n\n\n\n\nNom du plugin<\/strong> : nom lisible par l\u2019utilisateur (ex. MonPremierPlugin<\/em>)<\/li>\n\n\n\n Description<\/strong> : courte phrase expliquant l\u2019utilit\u00e9 du plugin<\/li>\n<\/ul>\n\n\n\nCes informations appara\u00eetront dans le gestionnaire de plugins QGIS.<\/p>\n\n\n\n <\/span>Version et auteur<\/span><\/h3>\n\n\n\n\nVersion<\/strong> : commencez simplement par 0.1<\/code><\/li>\n\n\n\n Auteur<\/strong> : votre nom ou celui de votre organisation<\/li>\n<\/ul>\n\n\n\n \n\n\n\n<\/span>Les param\u00e8tres techniques importants<\/span><\/h2>\n\n\n\n<\/span>Choix du template<\/span><\/h3>\n\n\n\nPlugin Builder propose plusieurs templates<\/strong> (mod\u00e8les de plugin).<\/p>\n\n\n\n Pour d\u00e9buter, il est fortement recommand\u00e9 de choisir :<\/p>\n\n\n\n \nTemplate : Tool button with dialog<\/strong> (outil avec bouton et fen\u00eatre)<\/li>\n<\/ul>\n\n\n\nCe template est le plus p\u00e9dagogique :<\/p>\n\n\n\n \nil cr\u00e9e un bouton dans QGIS,<\/li>\n\n\n\n il pr\u00e9pare une fen\u00eatre graphique simple,<\/li>\n\n\n\n il correspond \u00e0 la majorit\u00e9 des plugins courants.<\/li>\n<\/ul>\n\n\n\nIl servira de base solide pour les articles suivants.<\/p>\n\n\n\n <\/span>Options \u00e0 d\u00e9cocher pour d\u00e9buter<\/span><\/h3>\n\n\n\nPour un premier plugin, il est conseill\u00e9 de d\u00e9cocher toutes les options avanc\u00e9es<\/strong>, notamment :<\/p>\n\n\n\n \nInternationalization (traductions)<\/li>\n\n\n\n Help (documentation int\u00e9gr\u00e9e)<\/li>\n\n\n\n Unit testing<\/li>\n\n\n\n Packaging avanc\u00e9<\/li>\n<\/ul>\n\n\n\nCes fonctionnalit\u00e9s sont utiles pour des plugins aboutis, mais elles alourdissent inutilement la structure<\/strong> pour un d\u00e9butant.<\/p>\n\n\n\n Nous les aborderons plus tard, lorsque les bases seront bien ma\u00eetris\u00e9es.<\/p>\n\n\n\n <\/span>Classe du plugin<\/span><\/h3>\n\n\n\nPlugin Builder vous demande le nom de la classe principale.<\/p>\n\n\n\n Exemple :<\/p>\n\n\n\n \nNom du plugin : MonPremierPlugin<\/code><\/li>\n\n\n\n Classe : MonPremierPlugin<\/code><\/li>\n<\/ul>\n\n\n\nPar convention, on utilise la m\u00eame casse pour \u00e9viter toute confusion.<\/p>\n\n\n\n <\/span>Menu et ic\u00f4ne<\/span><\/h3>\n\n\n\nVous pouvez indiquer :<\/p>\n\n\n\n \nle menu dans lequel appara\u00eetra le plugin (souvent Extensions<\/em>)<\/li>\n\n\n\n une ic\u00f4ne (optionnelle \u00e0 ce stade)<\/li>\n<\/ul>\n\n\n\nVous pourrez modifier ces choix plus tard sans difficult\u00e9.<\/p>\n\n\n\n \n\n\n\n<\/span>G\u00e9n\u00e9ration du plugin<\/span><\/h2>\n\n\n\nUne fois tous les champs remplis :<\/p>\n\n\n\n \nCliquez sur Generate<\/strong><\/li>\n\n\n\n Choisissez le dossier de destination<\/li>\n<\/ol>\n\n\n\nPlugin Builder cr\u00e9e alors automatiquement le dossier du plugin avec tous les fichiers n\u00e9cessaires.<\/p>\n\n\n\n \n\n\n\n<\/span>O\u00f9 placer le plugin ?<\/span><\/h2>\n\n\n\nPour que QGIS reconnaisse le plugin, il doit se trouver dans le dossier des plugins utilisateur.<\/p>\n\n\n\n Selon le syst\u00e8me :<\/p>\n\n\n\n \nWindows<\/strong> : C:\/Users\/\u2026\/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💡 Astuce : Plugin Builder propose g\u00e9n\u00e9ralement ce dossier par d\u00e9faut.<\/p>\n\n\n\n \n\n\n\n<\/span>Activer le plugin dans QGIS<\/span><\/h2>\n\n\n\n\nOuvrez Extensions \u2192 Installer\/G\u00e9rer les extensions<\/strong><\/li>\n\n\n\n Onglet Install\u00e9es<\/strong><\/li>\n\n\n\n Cochez votre plugin<\/li>\n<\/ol>\n\n\n\nSi tout s\u2019est bien pass\u00e9, le plugin appara\u00eet dans le menu et peut \u00eatre activ\u00e9.<\/p>\n\n\n\n 👉 \u00c0 ce stade, le plugin ne fait presque rien\u2026 et c\u2019est normal.<\/p>\n\n\n\n \n\n\n\n<\/span>Comprendre ce que Plugin Builder a cr\u00e9\u00e9<\/span><\/h2>\n\n\n\nAvant d\u2019aller plus loin, prenez le temps d\u2019ouvrir les fichiers g\u00e9n\u00e9r\u00e9s :<\/p>\n\n\n\n \n__init__.py<\/code><\/li>\n\n\n\n metadata.txt<\/code><\/li>\n\n\n\n le fichier principal Python<\/li>\n<\/ul>\n\n\n\nVous devriez maintenant reconna\u00eetre les \u00e9l\u00e9ments d\u00e9crits dans l\u2019article pr\u00e9c\u00e9dent.<\/p>\n\n\n\n \n\n\n\n<\/span>Erreurs fr\u00e9quentes chez les d\u00e9butants<\/span><\/h2>\n\n\n\n\nle plugin n\u2019appara\u00eet pas \u2192 mauvais dossier<\/li>\n\n\n\n erreur au chargement \u2192 faute de casse dans le nom de la classe<\/li>\n\n\n\n QGIS refuse le plugin \u2192 version minimale incorrecte<\/li>\n<\/ul>\n\n\n\nCes erreurs sont normales : elles font partie de l\u2019apprentissage.<\/p>\n\n\n\n \n\n\n\n<\/span>Ce que vous avez appris<\/span><\/h2>\n\n\n\n\u00c0 la fin de cet article, vous savez :<\/p>\n\n\n\n \ninstaller Plugin Builder,<\/li>\n\n\n\n g\u00e9n\u00e9rer un plugin QGIS vide,<\/li>\n\n\n\n l\u2019installer localement,<\/li>\n\n\n\n l\u2019activer dans QGIS.<\/li>\n<\/ul>\n\n\n\nVous avez franchi une \u00e9tape cl\u00e9 : vous \u00eates officiellement d\u00e9veloppeur de plugin QGIS<\/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 ajouter un bouton \u00e0 QGIS,<\/li>\n\n\n\n comment afficher une fen\u00eatre simple,<\/li>\n\n\n\n comment structurer le code sans se perdre.<\/li>\n<\/ul>\n\n\n\n👉 Un plugin qui ne fait rien aujourd\u2019hui est un plugin puissant demain.<\/em><\/p>\n\n\n\n \n","protected":false},"excerpt":{"rendered":"Cr\u00e9er un plugin QGIS est beaucoup plus simple qu\u2019il n\u2019y para\u00eet, surtout lorsque l\u2019on d\u00e9bute en programmation. Gr\u00e2ce \u00e0 Plugin Builder, il est possible de g\u00e9n\u00e9rer en quelques minutes la structure compl\u00e8te d\u2019un plugin, sans \u00e9crire…<\/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":[1945,62],"tags":[4147,4149,4135,4232,4151,4153,4127],"class_list":["post-16307","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-pluigin","category-qgis-2","tag-creer-un-plugin-qgis-debutant","tag-generer-un-plugin-qgis","tag-plugin-builder-qgis","tag-plugin-qgis-python-fr","tag-premier-plugin-qgis","tag-template-plugin-qgis","tag-tutoriel-plugin-qgis"],"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-4f1","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/www.sigterritoires.fr\/index.php\/wp-json\/wp\/v2\/posts\/16307","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=16307"}],"version-history":[{"count":0,"href":"https:\/\/www.sigterritoires.fr\/index.php\/wp-json\/wp\/v2\/posts\/16307\/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=16307"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.sigterritoires.fr\/index.php\/wp-json\/wp\/v2\/categories?post=16307"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.sigterritoires.fr\/index.php\/wp-json\/wp\/v2\/tags?post=16307"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}