PLG getDocumentationUrl
In some situations, Geeklog will need a link to a plugin's documentation. The following plugin API function provides this information:
function PLG_getDocumentationUrl($type, $file)
Where $type
is the internal name of the plugin (e.g. 'spamx') and $file
is a name for the part of the documentation being requested.
On the plugin side, this would be implemented as
function plugin_getdocumentationurl_foo($file)
Documentation Links
Currently, $file
can be one of the following:
- 'index' - a link to the index page of the plugin's documentation
- 'config' - a link to the part of the plugin's documentation where the configuration options are explained (see below for details)
We may want to add support for more values of $file
in the future, e.g. 'help' to link to the plugin's help, etc.
Conventions
- When the plugin does not offer the file type requested, it should return
false
or an empty string. - The URLs do not have to be in the same directory or even on the same site.
- The caller should not make any assumptions about the URLs.
- The documentation doesn't have to be provided as static HTML pages - it could just as well be created dynamically, i.e. link to a .php script.
Config Links
Geeklog will request a file type 'config' to link to a description of the plugin's configuration options from the Configuration admin panel (the (?) links next to the configuration options).
Geeklog will attach an anchor of the form #desc_optionname to the supplied URL, assuming that such an anchor exists on the page so that the user will be taken directly to the description of the option in question.