Skip to content

Latest commit

 

History

History
72 lines (52 loc) · 1.85 KB

Plugin-Guidelines.md

File metadata and controls

72 lines (52 loc) · 1.85 KB

Plugin Guidelines

Note:

All file attachments (except for images) should be in tar.gz, tar.bz or zip format.

Plugin Creation

Plugin Namespaces

User submitted plugin pages can be created by simply entering http://docs.cacti.net/userplugin: followed by the name of your plugin. ie: http://docs.cacti.net/userplugin:my_new_plugin

Plugin Defaults

When creating a plugin for the first time, it is automagically populated with a standard set of defaults. Please complete as many of the sections as possible to maintain the site standard.

plugin Data Entry

The very first section is the Data Entry area. Completing this section will allow for the plugin to be listed on the Plugins page.

Sample Data Entry

---- dataentry plugin_style ----
type:userplugin <-- do not change
userplugin_nspage:my_new_plugin <-- do not change
author_page:wiki:user:my_name
description: A valid description
version:1.0.0
homepage_url: http://example.com
date: 2009-01-30
email: [email protected]
license: GPLv2
plugins_tags: syslog
----

Template Tags

At the very bottom of the Plugin_Data_Entry after 'plugins_tags', you can enter tags that will allow for filtering via the 'tag cloud' at the top of the Plugins page

Attempt to make these tags as generic as possible, while still retaining meaningful information. For example, 'syslog' is sufficient, 'capturing, syslog, wicked cool, damn near magic' is unnecessary.

Note: All tags should be in lowercase to avoid duplication of tags.

Plugin Deletion

Remove everything in the page except for DELETEME and the admins will purge it.

If there is a file attached to the page, leave the link to the file and place DELETEME beside it.

In 'Edit Summary' ensure you enter DELETEME as it will make it easier to find under Recent Changes.

Copyright (c) 2004-2019 The Cacti Group