public package Foswiki::Plugins

See PublishedAPI for packages intended to be used by Plugin and Contrib authors, or browse all packages.
See also Developing plugins, Developer's Bible, Technical Overview

Perl Module:

Child packagesChild packages

• Foswiki::Plugins::AutoViewTemplatePlugin
• Foswiki::Plugins::CommentPlugin
• Foswiki::Plugins::CompareRevisionsAddonPlugin - This is a helper plugin for the CompareRevisionsAddon package.
• Foswiki::Plugins::EditTablePlugin
• Foswiki::Plugins::EmptyPlugin - Foswiki plugins 'listen' to events happening in the core by registering an interest in those events. They do this by declaring 'plugin handlers'. These are simply functions with a particular name that, if they exist in your plugin, will be called by the core.
• Foswiki::Plugins::HistoryPlugin
• Foswiki::Plugins::InterwikiPlugin - Recognises and processes special links to other sites defined using "inter-site syntax".
• Foswiki::Plugins::JQueryPlugin - Container for jQuery and plugins
• Foswiki::Plugins::MailerContribPlugin
• Foswiki::Plugins::PatchFoswikiContribPlugin - List details of patch files installed by Patch*Contribs
• Foswiki::Plugins::PreferencesPlugin
• Foswiki::Plugins::RenderListPlugin
• Foswiki::Plugins::SlideShowPlugin
• Foswiki::Plugins::SmiliesPlugin
• Foswiki::Plugins::SpreadSheetPlugin
• Foswiki::Plugins::TWikiCompatibilityPlugin
• Foswiki::Plugins::TablePlugin
• Foswiki::Plugins::TinyMCEPlugin
• Foswiki::Plugins::TwistyPlugin
• Foswiki::Plugins::WysiwygPlugin - This plugin is responsible for translating TML to HTML before an edit starts and translating the resultant HTML back into TML.

public package Foswiki::Plugins

This module defines the singleton object that handles Plugins loading, initialization and execution.

This class uses Chain of Responsibility (GOF) pattern to dispatch handler calls to registered plugins.

PUBLIC constant $VERSION

This is the version number of the plugins package. Use it for checking if you have a recent enough version.

PUBLIC $SESSION

This is a reference to the Foswiki session object. It can be used in plugins to get at the methods of the Foswiki kernel.

You are highly recommended to only use the methods in the Foswiki::Func interface, unless you have no other choice, as kernel methods may change between Foswiki releases.

ClassMethod new( $session )

Construct new singleton plugins collection object. The object is a container for a list of plugins and the handlers registered by the plugins. The plugins and the handlers are carefully ordered.

ObjectMethod finish()

Break circular references.

ObjectMethod load($allDisabled) → $loginName

Find all active plugins, and invoke the early initialisation. Has to be done after prefs are read.

Returns the user returned by the last initializeUserHandler to be called.

If allDisabled is set, no plugin handlers will be called.

ObjectMethod settings()

Push plugin settings onto preference stack

ObjectMethod enable()

Initialisation that is done after the user is known.

ObjectMethod getPluginVersion() → $number

Returns the $Foswiki::Plugins::VERSION number if no parameter is specified, else returns the version number of a named Plugin. If the Plugin cannot be found or is not active, 0 is returned.

ObjectMethod addListener( $command, $handler )

• $command - name of the event
• $handler - the handler object.

Add a listener to the end of the list of registered listeners for this event. The listener must implement invoke($command,...), which will be triggered when the event is to be processed.

ObjectMethod dispatch( $handlerName, ...)

Dispatch the given handler, passing on ... in the parameter vector

ObjectMethod haveHandlerFor( $handlerName ) → $boolean

• $handlerName - name of the handler e.g. preRenderingHandler

Return: true if at least one plugin has registered a handler of this type.