プラグインガイドライン

World Workshop2019において、私たちはプラグインの実装のガイドラインについてアイディアを出し合いました。

これはIDempiereコミュニティーへの貢献方法の１つです。

これらのガイドラインにより、プラグインを評価および判断できます。 また、ドキュメントも改善されます。 これらのガイドラインは静的ではなく、時間とともに更新されます。 ご提案がございましたら、フォーラムでお問い合わせください。

最初のステップとして、すべてのコミュニティプラグインには次のものが必要です。:

1. ドキュメント
   1. インストール方法 - 下記のリストを確認して下さい。.
   2. What does it do? What is the purpose of the plugin?
   3. Include screenshots and videos - if possible. The idea is to show the community what they will get when installing the plugin.
   4. Technical Documentation - It there are special aspects to consider when trying to extend or contribute to the plugin, please document those technical aspects.
      1. Access to the source code (no broken links) - mandatory. Please note we want to support real open source, not those repositories that are update publicly every year, outdated against a private repository that gets frequent updates and is not visible for community.
      2. Access to the source code of the documentation (e.g. not only a pdf).
      3. List of plugin dependencies.
      4. List of similar or related solutions.
2. It must be easy to install in existing iDempiere instances (plugins that require a modified core to install must be considered a fork or a distro, not a real plugin) - via the OSGi or Felix consoles with no extra steps is preferred. If there are more steps needed or additional configurations that cannot be done through 2packs, they should be well justified and documented.
   1. Includes 2pack
   2. Just install in the OSGi or Felix console and start it.
   3. The Binaries are available
   4. One-click start
      1. If Chuck prefers to separate the plugin into several files we allow him to do up to four-click-installation if it is very well documented.
3. Plugin status
   1. Is the plugin compatible with the latest stable version of iDempiere?
   2. Date and version of the last review.

For best practices when developing community plugins you can follow the tutorials here Plug-In Development, in there it is well explained how to extend iDempiere without affecting the core.

Additionally, the community could asses the plugin quality with the following information:

• Is there someone who tested it other than the developer/sponsor?
• Who uses it and how?

• Code quality peer review / make sure that the plugin follows best practices (f.e. closing prepare statements to avoid memory leaks).
  • Someone (not the developer) has to review the code
  • Don't use hardcoded IDs
  • Close cursors in "finally" blocks
  • Security peer review - does the plugin open security breaches?