{"id":16305,"date":"2026-05-19T10:00:00","date_gmt":"2026-05-19T08:00:00","guid":{"rendered":"https:\/\/www.sigterritoires.fr\/?p=16305"},"modified":"2026-05-18T11:10:21","modified_gmt":"2026-05-18T09:10:21","slug":"plugin-qgis-debutant-introduction","status":"publish","type":"post","link":"https:\/\/www.sigterritoires.fr\/index.php\/plugin-qgis-debutant-introduction\/","title":{"rendered":"[FR]D\u00e9velopper Un Plugin Qgis : Pourquoi Et Comment Cr\u00e9er Un Plugin"},"content":{"rendered":"\n

D\u00e9velopper un plugin QGIS peut sembler r\u00e9serv\u00e9 aux programmeurs exp\u00e9riment\u00e9s. En r\u00e9alit\u00e9, avec quelques bases et une bonne m\u00e9thode, il est tout \u00e0 fait possible de cr\u00e9er ses propres plugins, m\u00eame sans grande exp\u00e9rience en programmation.<\/p>\n\n\n\n

Dans ce tutoriel, nous allons d\u00e9couvrir \u00e0 quoi servent les plugins QGIS<\/strong>, pourquoi ils sont si utiles au quotidien, et surtout comment est structur\u00e9 un plugin QGIS<\/strong> : quels fichiers le composent et quel est leur r\u00f4le.<\/p>\n\n\n\n

Cette s\u00e9rie d\u2019articles s\u2019adresse aux utilisateurs de QGIS d\u00e9butants en Python<\/strong>, aux enseignants, aux agents de collectivit\u00e9s et \u00e0 toutes celles et ceux qui souhaitent automatiser leurs traitements ou cr\u00e9er des outils adapt\u00e9s \u00e0 leurs besoins m\u00e9tiers.<\/p>\n\n\n\n

\n\n\n\n\n\n\n\n
\n\n\n\n
\n
\n
Contenu <\/p>\nToggle<\/span>
Introduction<\/a><\/li>
Pourquoi d\u00e9velopper ses propres plugins QGIS ?<\/a>
Automatiser des t\u00e2ches r\u00e9p\u00e9titives<\/a><\/li>
Adapter QGIS \u00e0 son m\u00e9tier<\/a><\/li>
Apprendre en douceur la programmation<\/a><\/li>
Partager (ou garder pour soi)<\/a><\/li><\/ul><\/li>
De quoi est constitu\u00e9 un plugin QGIS ?<\/a><\/li>
Le fichier __init__.py<\/a><\/li><\/ul><\/li>
Explication ligne par ligne<\/a>
def classFactory(iface):<\/a>
✔ QGIS recherche obligatoirement une fonction portant ce nom : classFactory<\/a><\/li><\/ul><\/li>
from .mon_plugin import Monplugin<\/a><\/li>
return MonPlugin(iface)<\/a><\/li><\/ul><\/li>
R\u00e9sum\u00e9<\/a>
Le fichier metadata.txt<\/a><\/li>
Le fichier principal Python (ex. mon_plugin.py)<\/a><\/li>
Les fichiers optionnels mais tr\u00e8s courants<\/a>
Les interfaces graphiques (.ui)<\/a><\/li>
Les ressources (resources.qrc)<\/a><\/li><\/ul><\/li>
Ce que vous devez retenir pour l\u2019instant<\/a><\/li>
Et dans le prochain article ?<\/a><\/li><\/ul><\/li><\/ul><\/nav><\/div>\n
<\/span>Introduction<\/span><\/h2>\n\n\n\n
QGIS est aujourd\u2019hui l\u2019un des SIG open source les plus utilis\u00e9s au monde. Sa richesse fonctionnelle est impressionnante, mais ce qui fait r\u00e9ellement sa force, c\u2019est sa capacit\u00e9 d\u2019extension gr\u00e2ce aux plugins<\/strong>.<\/p>\n\n\n\n
Un plugin QGIS permet d\u2019ajouter des fonctionnalit\u00e9s personnalis\u00e9es : automatiser des t\u00e2ches r\u00e9p\u00e9titives, cr\u00e9er des outils adapt\u00e9s \u00e0 un m\u00e9tier pr\u00e9cis, tester des m\u00e9thodes nouvelles ou simplement se faciliter la vie au quotidien.<\/p>\n\n\n\n
Ce tutoriel s\u2019adresse volontairement \u00e0 des personnes sans grande exp\u00e9rience en programmation<\/strong>. Il n\u2019a pas pour objectif de faire de vous un d\u00e9veloppeur Python confirm\u00e9, mais de vous donner les bases n\u00e9cessaires pour :<\/p>\n\n\n\n
\n
comprendre comment fonctionne un plugin QGIS,<\/li>\n\n\n\n
modifier un plugin existant,<\/li>\n\n\n\n
cr\u00e9er vos propres outils simples et utiles.<\/li>\n<\/ul>\n\n\n\n
L\u2019id\u00e9e est d\u2019apprendre juste ce qu\u2019il faut<\/em> de Python et de l\u2019architecture QGIS pour devenir autonome.<\/p>\n\n\n\n
\n\n\n\n
<\/span>Pourquoi d\u00e9velopper ses propres plugins QGIS ?<\/span><\/h2>\n\n\n\n
<\/span>Automatiser des t\u00e2ches r\u00e9p\u00e9titives<\/span><\/h3>\n\n\n\n
Si vous utilisez souvent QGIS, vous avez sans doute d\u00e9j\u00e0 encha\u00een\u00e9 plusieurs fois les m\u00eames op\u00e9rations :<\/p>\n\n\n\n
\n
charger des couches,<\/li>\n\n\n\n
appliquer des styles,<\/li>\n\n\n\n
lancer une suite de traitements,<\/li>\n\n\n\n
exporter des r\u00e9sultats.<\/li>\n<\/ul>\n\n\n\n
Un plugin permet de regrouper ces actions en un seul bouton<\/strong>.<\/p>\n\n\n\n
<\/span>Adapter QGIS \u00e0 son m\u00e9tier<\/span><\/h3>\n\n\n\n
Les besoins d\u2019un g\u00e9omaticien, d\u2019un enseignant, d\u2019un agent de collectivit\u00e9 ou d\u2019un chercheur ne sont pas toujours couverts par les outils standards. Un plugin peut int\u00e9grer :<\/p>\n\n\n\n
\n
des r\u00e8gles m\u00e9tiers,<\/li>\n\n\n\n
des contr\u00f4les de coh\u00e9rence,<\/li>\n\n\n\n
des calculs sp\u00e9cifiques.<\/li>\n<\/ul>\n\n\n\n
<\/span>Apprendre en douceur la programmation<\/span><\/h3>\n\n\n\n
D\u00e9velopper un plugin QGIS est une excellente porte d\u2019entr\u00e9e vers Python :<\/p>\n\n\n\n
\n
le r\u00e9sultat est concret et visuel,<\/li>\n\n\n\n
les erreurs sont souvent faciles \u00e0 identifier,<\/li>\n\n\n\n
on peut progresser par petites \u00e9tapes.<\/li>\n<\/ul>\n\n\n\n
<\/span>Partager (ou garder pour soi)<\/span><\/h3>\n\n\n\n
Un plugin peut rester strictement personnel, \u00eatre partag\u00e9 au sein d\u2019une \u00e9quipe, ou \u00eatre diffus\u00e9 publiquement via le d\u00e9p\u00f4t officiel QGIS.<\/p>\n\n\n\n
\n\n\n\n
<\/span>De quoi est constitu\u00e9 un plugin QGIS ?<\/span><\/h2>\n\n\n\n
Un plugin QGIS est avant tout un dossier contenant plusieurs fichiers<\/strong>. Chacun a un r\u00f4le bien pr\u00e9cis. Bonne nouvelle : il n\u2019est pas n\u00e9cessaire de tout comprendre en profondeur d\u00e8s le d\u00e9part.<\/p>\n\n\n\n
Voici la structure minimale d\u2019un plugin :<\/p>\n\n\n\n
MonPlugin\/\n\u251c\u2500\u2500 __init__.py\n\u251c\u2500\u2500 metadata.txt\n\u251c\u2500\u2500 mon_plugin.py\n\u2514\u2500\u2500 resources.qrc (optionnel)\n<\/code><\/pre>\n\n\n\nNous allons passer ces fichiers en revue.<\/p>\n\n\n\n \n\n\n\n<\/span>Le fichier __init__.py<\/code><\/span><\/h2>\n\n\n\nC\u2019est le point d\u2019entr\u00e9e du plugin.<\/p>\n\n\n\n Son r\u00f4le principal est de dire \u00e0 QGIS quelle classe Python doit \u00eatre charg\u00e9e<\/strong> lorsque le plugin est activ\u00e9.<\/p>\n\n\n\n Exemple simplifi\u00e9 :<\/p>\n\n\n <\/div><\/div><\/div><\/div><\/p>\n\n\n\ndef classFactory(iface):\n from .mon_plugin import MonPlugin\n return MonPlugin(iface)\n<\/code><\/pre>\n\n\n<\/div><\/div>\n\n\n\n \u00c0 ce stade, il suffit de retenir que :<\/p>\n\n\n\n \nce fichier est obligatoire,<\/li>\n\n\n\n il fait le lien entre QGIS et votre code principal.<\/li>\n<\/ul>\n\n\n\n<\/span>Explication ligne par ligne<\/strong><\/span><\/h1>\n\n\n\n \n\n\n\n<\/span> def classFactory(iface):<\/code><\/span><\/h2>\n\n\n\n<\/span>✔ QGIS recherche obligatoirement<\/em> une fonction portant ce nom : classFactory<\/code><\/span><\/h3>\n\n\n\nLorsque QGIS lit votreplugin, il appelle automatiquement :<\/p>\n\n\n <\/div><\/div><\/div><\/div><\/p>\n\n\n\nclassFactory(iface)<\/code><\/pre>\n\n\n<\/div><\/div>\n\n\n\n et transmet :<\/p>\n\n\n\n \niface<\/strong><\/code> = l\u2019interface de QGIS (l\u2019objet QgisInterface<\/code>)<\/li>\n\n\n\n cet objet donne acc\u00e8s \u00e0 :la carte (mapCanvas<\/code>)<\/li><\/ul><\/li>\n\n\n\n le menu Plugins<\/li><\/ul><\/li>\n\n\n\n la barre d\u2019outils<\/li><\/ul><\/li>\n\n\n\n la couche activeles messages \/ logs<\/li><\/ul>\n\netc.<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n\n\n\n➡️ C\u2019est l\u2019objet central permettant \u00e0 un plugin d\u2019interagir avec QGIS.<\/p>\n\n\n\n \n\n\n\n<\/span> from .mon_plugin import Monplugin<\/code><\/span><\/h2>\n\n\n\n\nLe signe .<\/strong><\/code> signifie : \u00ab\u00a0dans le m\u00eame dossier que ce fichier\u00a0\u00bb.<\/li>\n\n\n\n QGIS charge donc la classe principale<\/strong> depuis :<\/li>\n<\/ul>\n\n\n\nmon_plugin.py<\/code><\/pre>\n\n\n\nCette classe contient :<\/p>\n\n\n\n \ninitGui()<\/code> \u2192 ajoute les actions, menus, ic\u00f4nes<\/li>\n\n\n\n unload()<\/code> \u2192 retire les \u00e9l\u00e9ments du plugin<\/li>\n\n\n\n les fonctions m\u00e9tiers (activation d\u2019outil, affichage de fen\u00eatre, etc.)<\/li>\n<\/ul>\n\n\n\n➡️ C\u2019est la classe racine du plugin<\/strong>, celle qui contr\u00f4le tout.<\/p>\n\n\n\n \n\n\n\n<\/span> return MonPlugin(iface)<\/code><\/span><\/h2>\n\n\n\nQGIS attend une instance<\/strong> de la classe, pas la classe elle-m\u00eame.<\/p>\n\n\n\n Donc :<\/p>\n\n\n\n \non instancie la classe MonPlugin<\/code><\/li>\n\n\n\n on lui transmet l\u2019interface QGIS (iface)<\/li>\n\n\n\n QGIS utilisera cet objet pour :appeler initGui()<\/code> lors de l\u2019activation du plugin<\/li><\/ul>\n\nappeler unload()<\/code> lors de la d\u00e9sactivation<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n\n\n\n➡️ C\u2019est la cr\u00e9ation concr\u00e8te du plugin<\/strong> dans QGIS.<\/p>\n\n\n\n \n\n\n\n<\/span> R\u00e9sum\u00e9 <\/strong><\/span><\/h1>\n\n\n\n👉 __init__.py<\/strong><\/code> sert \u00e0 indiquer \u00e0 QGIS la classe \u00e0 utiliser pour le plugin.<\/strong><\/p>\n\n\n\n 👉 La fonction classFactory()<\/strong> est obligatoirement pr\u00e9sente dans tout plugin QGIS.<\/p>\n\n\n\n 👉 iface<\/code> est l\u2019acc\u00e8s complet \u00e0 l\u2019interface QGIS.<\/p>\n\n\n\n 👉 Le plugin ne commence r\u00e9ellement \u00e0 fonctionner qu\u2019apr\u00e8s l\u2019instanciation<\/strong> :<\/p>\n\n\n\n MonPlugin(iface)<\/code><\/pre>\n\n\n\n \n\n\n\n<\/span>Le fichier metadata.txt<\/code><\/span><\/h2>\n\n\n\nCe fichier est fondamental : sans lui, QGIS ne reconna\u00eet pas le plugin.<\/p>\n\n\n\n Il contient les informations g\u00e9n\u00e9rales :<\/p>\n\n\n\n \nnom du plugin,<\/li>\n\n\n\n description,<\/li>\n\n\n\n auteur,<\/li>\n\n\n\n version,<\/li>\n\n\n\n version minimale de QGIS.<\/li>\n<\/ul>\n\n\n\nExemple :<\/p>\n\n\n\n [general]\nname=Mon premier plugin\ndescription=Un plugin simple pour apprendre\nversion=0.1\nauthor=Votre nom\nqgisMinimumVersion=3.16\n<\/code><\/pre>\n\n\n\nC\u2019est ce fichier qui appara\u00eet dans le gestionnaire de plugins<\/strong> de QGIS.<\/p>\n\n\n\n \n\n\n\n<\/span>Le fichier principal Python (ex. mon_plugin.py<\/code>)<\/span><\/h2>\n\n\n\nC\u2019est ici que se trouve le c\u0153ur du plugin.<\/p>\n\n\n\n On y trouve g\u00e9n\u00e9ralement :<\/p>\n\n\n\n \nla classe principale du plugin,<\/li>\n\n\n\n les m\u00e9thodes initGui()<\/code> et unload()<\/code>,<\/li>\n\n\n\n le code qui ajoute un bouton ou un menu dans QGIS.<\/li>\n<\/ul>\n\n\n\nTr\u00e8s sch\u00e9matiquement :<\/p>\n\n\n <\/div><\/div><\/div><\/div><\/p>\n\n\n\nclass MonPlugin:\n def __init__(self, iface):\n self.iface = iface\n\n def initGui(self):\n pass\n\n def unload(self):\n pass\n<\/code><\/pre>\n\n\n<\/div><\/div>\n\n\n\n Pas de panique si cela vous semble obscur : chaque \u00e9l\u00e9ment sera expliqu\u00e9 progressivement dans les articles suivants.<\/p>\n\n\n\n \n\n\n\n<\/span>Les fichiers optionnels mais tr\u00e8s courants<\/span><\/h2>\n\n\n\n<\/span>Les interfaces graphiques (.ui<\/code>)<\/span><\/h3>\n\n\n\nQGIS utilise Qt pour les interfaces graphiques. Les fichiers .ui<\/code> sont cr\u00e9\u00e9s avec Qt Designer<\/strong>, sans \u00e9crire de code.<\/p>\n\n\n\n Ils permettent de construire des fen\u00eatres avec :<\/p>\n\n\n\n \nboutons,<\/li>\n\n\n\n listes d\u00e9roulantes,<\/li>\n\n\n\n champs de saisie.<\/li>\n<\/ul>\n\n\n\n<\/span>Les ressources (resources.qrc<\/code>)<\/span><\/h3>\n\n\n\nCe fichier sert \u00e0 regrouper :<\/p>\n\n\n\n \nic\u00f4nes,<\/li>\n\n\n\n images,<\/li>\n\n\n\n autres ressources graphiques.<\/li>\n<\/ul>\n\n\n\nIl est compil\u00e9 en Python pour \u00eatre utilisable dans le plugin.<\/p>\n\n\n\n \n\n\n\n<\/span>Ce que vous devez retenir pour l\u2019instant<\/span><\/h2>\n\n\n\n\u00c0 ce stade, l\u2019essentiel est de comprendre que :<\/p>\n\n\n\n \nun plugin QGIS est une structure de fichiers<\/strong>, pas un gros programme compliqu\u00e9,<\/li>\n\n\n\n chaque fichier a un r\u00f4le pr\u00e9cis,<\/li>\n\n\n\n on peut cr\u00e9er des plugins simples et tr\u00e8s utiles avec peu de code.<\/li>\n<\/ul>\n\n\n\n \n\n\n\n<\/span>Et dans le prochain article ?<\/span><\/h2>\n\n\n\nDans le prochain article, nous verrons :<\/p>\n\n\n\n \ncomment cr\u00e9er un plugin vide \u00e0 l\u2019aide de Plugin Builder<\/strong>,<\/li>\n\n\n\n o\u00f9 placer les fichiers,<\/li>\n\n\n\n comment charger le plugin dans QGIS et le tester.<\/li>\n<\/ul>\n\n\n\nL\u2019objectif sera d\u2019obtenir un premier plugin fonctionnel<\/strong>, m\u00eame s\u2019il ne fait encore presque rien.<\/p>\n\n\n\n 👉 Le plus important n\u2019est pas d\u2019aller vite, mais de comprendre chaque \u00e9tape.<\/em><\/p>\n\n\n\n \n","protected":false},"excerpt":{"rendered":"D\u00e9velopper un plugin QGIS peut sembler r\u00e9serv\u00e9 aux programmeurs exp\u00e9riment\u00e9s. En r\u00e9alit\u00e9, avec quelques bases et une bonne m\u00e9thode, il est tout \u00e0 fait possible de cr\u00e9er ses propres plugins, m\u00eame sans grande exp\u00e9rience en programmation.…<\/p>\n","protected":false},"author":1,"featured_media":16329,"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":[4125,4129,4133,4135,4232,4131,4127],"class_list":["post-16305","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-pluigin","category-qgis-2","tag-creer-un-plugin-qgis","tag-developpement-plugin-qgis-debutant","tag-fichiers-plugin-qgis","tag-plugin-builder-qgis","tag-plugin-qgis-python-fr","tag-structure-dun-plugin-qgis","tag-tutoriel-plugin-qgis"],"aioseo_notices":[],"jetpack_featured_media_url":"https:\/\/i0.wp.com\/www.sigterritoires.fr\/wp-content\/uploads\/2026\/01\/pluginsQGIS1.jpg?fit=409%2C307&ssl=1","jetpack_shortlink":"https:\/\/wp.me\/p6XU0A-4eZ","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/www.sigterritoires.fr\/index.php\/wp-json\/wp\/v2\/posts\/16305","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=16305"}],"version-history":[{"count":0,"href":"https:\/\/www.sigterritoires.fr\/index.php\/wp-json\/wp\/v2\/posts\/16305\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.sigterritoires.fr\/index.php\/wp-json\/wp\/v2\/media\/16329"}],"wp:attachment":[{"href":"https:\/\/www.sigterritoires.fr\/index.php\/wp-json\/wp\/v2\/media?parent=16305"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.sigterritoires.fr\/index.php\/wp-json\/wp\/v2\/categories?post=16305"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.sigterritoires.fr\/index.php\/wp-json\/wp\/v2\/tags?post=16305"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}