Outdated version of the documentation. Find the latest one here.

Releasing your plugin

Once your plugin is ready and you think the plugin could be helpful for some people, do not hesitate to upload it to Dépôt officiel des extensions Python. On that page you can find also packaging guidelines about how to prepare the plugin to work well with the plugin installer. Or in case you would like to set up your own plugin repository, create a simple XML file that will list the plugins and their metadata, for examples see other plugin repositories.

Dépôt officiel des extensions Python

Vous pouvez trouver le dépôt officiel des extensions python à http://plugins.qgis.org/.

Afin d’utiliser le dépôt officiel, vous devez détenir un identifiant OSGEO, à partir du portail web OSGEO.

Une fois que vous avez téléversé votre extension, elle sera approuvée par un membre du staff et une notification vous sera adressée.

Permissions

Ces règles ont été implémentées dans le dépôt officiel des extensions:
  • tout utilisateur enregistré peut ajouter une nouvelle extension

  • les utilisateurs membres du staff sont habilités à approuver ou non chacune des versions de toutes les extensions

  • Les utilisateurs qui ont l’autorisation spéciale plugins.can_approve ont leurs versions d’extension automatiquement approuvées

  • Les utilisateurs ayant l’autorisation spéciale plugins.can_approve peuvent approuver les versions téléversées par d’autres, dès lors qu’ils sont dans la liste des *propriétaires * de l’extension

  • a particular plugin can be deleted and edited only by staff users and plugin owners
  • Si un utilisateur ne disposant pas de la permission plugins.can_approve téléverse une nouvelle version, cette version de l’extension est automatiquement signalée comme non approuvée.

Trust management

Staff members can grant trust to selected plugin creators setting plugins.can_approve permission through the front-end application.

The plugin details view offers direct links to grant trust to the plugin creator or the plugin owners.

Validation

Plugin’s metadata are automatically imported and validated from the compressed package when the plugin is uploaded.

Voici quelques règles de validation auxquelles vous devriez faire attention quand vous souhaitez charger votre extension sur le dépôt officiel:

  1. le nom du dossier principal contenant votre extension ne doit contenir que des caractères ASCII (A-Z et a-z), des chiffres et les caractères underscore(_) et moins (-), sans cependant commencer par un chiffre

  2. metadata.txt est requis

  3. Toutes les métadonnées requises listées dans metadata table doivent être présentes.

  4. the version metadata field must be unique