Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Plugins authors should adhere to the following guidelines when developing plugins.

Don’t Edit Standard Plugins

Plugins which Jiwa ships with can be updated whenever the software is upgraded, which will undo any modifications made.

Instead, Copy the plugin, provide a meaningful name and disable the original plugin.

You should also change the Author name to your own name when you copy a plugin.

Name

The plugin name should be concise and convey some meaning as to what the purpose of the plugin is.

...

Ideally, plugins should perform their own discrete functions specific to a purpose.

...

Description

Place a meaningful description in the plugin description.

The description should explain the following:

Purpose of the plugin

A brief summary of what the plugin does. Even if there is an external link to a documentation page, the plugin description should still offer a summary of purpose.

System Settings

If the plugin defines any System Settings, the plugin description should at the very least alert the reader to this fact. The System Setting descriptions can explain each setting, but the plugin description should mention that there are System Settings so the reader can know to examine and set them.

Custom Fields

If the plugin defines any Custom Fields, the plugin description should at the very least alert the reader to this fact. The Custom Field descriptions can explain each setting, but the plugin description should mention that there are Custom Fields so the reader can know to examine and set them.

Deployment Instructions

If there are deployment steps beyond just importing the plugin, then these should be listed in numbered order.

Author

The Author should identify the organisation or individual who authored the plugin.

...