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

Lansarea plugin-ului dvs.

O dată ce plugin-ul este gata și credeți că el ar putea fi de ajutor pentru unii utilizatori, nu ezitați să-l încărcați la Depozitul oficial al plugin-urilor python. Pe acea pagină puteți găsi instrucțiuni de împachetare și de pregătire a plugin-ului, pentru a lucra bine cu programul de instalare. Sau, în cazul în care ați dori să înființați un depozit propriu pentru plugin-uri, creați un simplu fișier XML, care va lista plugin-urile și metadatele lor, exemplu pe care îl puteți vedea în depozite pentru plugin-uri.

Depozitul oficial al plugin-urilor python

Puteți găsi depozitul oficial al plugin-urilor python la http://plugins.qgis.org/.

Pentru a folosi depozitul oficial, trebuie să obțineți un ID OSGEO din portalul web OSGEO.

O dată ce ați încărcat plugin-ul, acesta va fi aprobat de către un membru al personalului și veți primi o notificare.

Permisiuni

Aceste reguli au fost implementate în depozitul oficial al plugin-urilor:
  • fiecare utilizator inregistrat poate adăuga un nou plugin

  • membrii staff-ului pot aproba sau dezaproba toate versiunile plugin-ului

  • utilizatorii care au permisiunea specială plugins.can_approve au versiunile pe care le încarcă aprobate în mod automat

  • utilizatorii care au permisiunea specială plugins.can_approve pot aproba versiunile încărcate de către alții, atât timp cât aceștia sunt prezenți în lista proprietarilor de plugin-uri

  • un anumit plug-in pot fi șters și editat doar de utilizatorii staff-ului și de către proprietarii plugin-uri

  • în cazul în care un utilizator fără permisiunea plugins.can_approve încarcă o nouă versiune, versiunea plug-inului nu va fi aprobată, din start.

Managementul încrederii

Membrii personalului pot acorda încredere creatorilor de plugin-uri, bifând permisiunea plugins.can_approve în cadrul front-end-ului.

Detaliile despre plugin oferă legături directe pentru a crește încrederea în creatorul sau proprietarul.plugin-ului.

Validare

Metadatele plugin-ului sunt importate automat din pachetul arhivat și sunt validate, la încărcarea plugin-ului.

Iată câteva reguli de validare pe care ar trebui să le cunoașteți atunci când doriți să încărcați un plugin în depozitul oficial:

  1. numele folderului principal în care este stocat plugin-ul dvs. trebuie să conțină doar caractere ASCII (A-Z și a-z), cifre și caracterele de subliniere (_) și minus (-), și nu poate începe cu o cifră

  2. metadata.txt este necesar

  3. toate metadatele necesare, menționate în tabela de metadate trebuie să fie prezente

  4. the version metadata field must be unique

Structura plugin-ului

Following the validation rules the compressed (.zip) package of your plugin must have a specific structure to validate as a functional plugin. As the plugin will be unzipped inside the users plugins folder it must have it’s own directory inside the .zip file to not interfere with other plugins. Mandatory files are: netadata.txt and __init__.py But it would be nice to have a README.py and of course an icon to represent the plugin (resources.qrc). Following is an example of how a plugin.zip should look like.

plugin.zip
  pluginfolder/
  |-- i18n
  |   |-- translation_file_de.ts
  |-- img
  |   |-- icon.png
  |   `-- iconsource.svg
  |-- __init__.py
  |-- Makefile
  |-- metadata.txt
  |-- more_code.py
  |-- main_code.py
  |-- README.md
  |-- resources.qrc
  |-- resources_rc.py
  `-- ui_Qt_user_interface_file.ui