Confluence 2.5.6 : Plugin Self-Configuration
This page last changed on Mar 06, 2007 by jnolen.
Plugins can specify internal links within Confluence to configure themselves. This is useful where your plugin requires any configuration or user specific settings to work. For example, the Google Maps plugin requires a Google API Key from Google (which needs to be configured on each server) before it will work properly.
Plugin configuration - to add a configuration link for the whole plugin, place a single param element with the name configure.url within the plugin-info element at the top of the plugin descriptor: <plugin-info> <description>A macro which displays Google maps within a Confluence page.</description> <vendor name="Atlassian Software Systems Pty Ltd" url="http://www.atlassian.com/"/> <version>0.1</version> <param name="configure.url">/admin/plugins/gmaps/configurePlugin.action</param> </plugin-info> Plugin module configuration - to add a configuration link for a single module, place the same param element with the name configure.url within the descriptor element for that module: <macro name="gmap" class="com.atlassian.confluence.ext.gmaps.GmapsMacro" key="gmap"> <description>The individual map macro.</description> <param name="configure.url">/admin/plugins/gmaps/configureMacro.action</param> </macro> Here is an image showing where the Configure links appear for both a plugin and an individual module: |
![]() |
Document generated by Confluence on Oct 10, 2007 18:36 |