[ Index ]

PHP Cross Reference of DokuWiki

title

Body

[close]

/lib/plugins/ -> base.php (summary)

Admin Plugin Prototype

Author: Christopher Smith
License: GPL 2 (http://www.gnu.org/licenses/gpl.html)
File Size: 211 lines (7 kb)
Included or required: 2 times
Referenced: 0 times
Includes or requires: 0 files

Defines 1 class

DokuWiki_Plugin:: (19 methods):
  getInfo()
  getPluginType()
  getPluginName()
  getPluginComponent()
  getLang()
  locale_xhtml()
  localFN()
  setupLocale()
  getConf()
  loadConfig()
  readDefaultSettings()
  email()
  external_link()
  render()
  plugin_localFN()
  plugin_locale_xhtml()
  plugin_email()
  plugin_link()
  plugin_render()


Class: DokuWiki_Plugin  - X-Ref

All DokuWiki plugins to extend the admin function
need to inherit from this class

getInfo()   X-Ref
General Info

Needs to return a associative array with the following values:

author - Author of the plugin
email  - Email address to contact the author
date   - Last modified date of the plugin in YYYY-MM-DD format
name   - Name of the plugin
desc   - Short description of the plugin (Text only)
url    - Website with more information on the plugin (eg. syntax description)

getPluginType()   X-Ref
No description

getPluginName()   X-Ref
No description

getPluginComponent()   X-Ref
No description

getLang($id)   X-Ref
getLang($id)
use this function to access plugin language strings
to try to minimise unnecessary loading of the strings when the plugin doesn't require them
e.g. when info plugin is querying plugins for information about themselves.

param: $id     id of the string to be retrieved
return: string  string in appropriate language or english if not available

locale_xhtml($id)   X-Ref
locale_xhtml($id)

retrieve a language dependent file and pass to xhtml renderer for display
plugin equivalent of p_locale_xhtml()

param: $id     id of language dependent wiki page
return: string  parsed contents of the wiki page in xhtml format

localFN($id)   X-Ref
localFN($id)
prepends appropriate path for a language dependent filename
plugin equivalent of localFN()


setupLocale()   X-Ref
setupLocale()
reads all the plugins language dependent strings into $this->lang
this function is automatically called by getLang()


getConf($setting)   X-Ref
getConf($setting)

use this function to access plugin configuration variables

loadConfig()   X-Ref
loadConfig()
merges the plugin's default settings with any local settings
this function is automatically called through getConf()


readDefaultSettings()   X-Ref
read the plugin's default configuration settings from conf/default.php
this function is automatically called through getConf()

return: array    setting => value

email($email, $name='', $class='', $more='')   X-Ref
email
standardised function to generate an email link according to obfuscation settings


external_link($link, $title='', $class='', $target='', $more='')   X-Ref
external_link
standardised function to generate an external link according to conf settings


render($text, $format='xhtml')   X-Ref
output text string through the parser, allows dokuwiki markup to be used
very ineffecient for small pieces of data - try not to use


plugin_localFN($id)   X-Ref
No description

plugin_locale_xhtml($id)   X-Ref
No description

plugin_email($e, $n='', $c='', $m='')   X-Ref
No description

plugin_link($l, $t='', $c='', $to='', $m='')   X-Ref
No description

plugin_render($t, $f='xhtml')   X-Ref
No description



Generated: Fri Jan 19 01:30:01 2007 Cross-referenced by PHPXref 0.7