Roundcube Framework
Back to top  

rcube_plugin_api

The plugin loader and global API

package

Framework
subpackage

PluginAPI

Methods

Private constructor

__construct()

Save the given HTML content to be added to a template container

add_content(string $html, string $container)

Arguments

$html

string

HTML content

$container

string

Template container identifier

This method handles requests like _task=mail&_action=plugin.foo It executes the callback function that was registered with the given action.

exec_action(string $action)

Arguments

$action

string

Action name

Triggers a plugin hook.

exec_hook(string $hook, array $args = array()) : array

This is called from the application and executes all registered handlers

Arguments

$hook

string

Hook name

$args

array

Named arguments (key->value pairs)

Response

array

The (probably) altered hook arguments

check if we should prevent this plugin from initialising

filter( $plugin) : boolean

Arguments

$plugin

Response

boolean

Get information about a specific plugin.

get_info( $plugin_name) : array

This is either provided my a plugin's info() method or extracted from a package.xml or a composer.json file

Arguments

$plugin_name

Response

array

Meta information about a plugin or False if plugin was not found

This implements the 'singleton' design pattern

get_instance() : \rcube_plugin_api
static

Response

\rcube_plugin_api

The one and only instance if this class

Returns loaded plugin

get_plugin( $name) : \rcube_plugin

Arguments

$name

Response

\rcube_plugin

Plugin instance

Include a plugin script file in the current HTML page

include_script(string $fn)

Arguments

$fn

string

Path to script

Include a plugin stylesheet in the current HTML page

include_stylesheet(string $fn)

Arguments

$fn

string

Path to stylesheet

Initialize plugin engine

init( $app,  $task = '')

This has to be done after rcmail::load_gui() or rcmail::json_init() was called because plugins need to have access to rcmail->output

Arguments

$app

$task

Checks whether the given task is registered by a plugin

is_plugin_task(string $task) : boolean

Arguments

$task

string

Task name

Response

boolean

True if registered, otherwise false

Check if a plugin hook is currently processing.

is_processing(string $hook = null) : boolean

Mainly used to prevent loops and recursion.

Arguments

$hook

string

Hook to check (optional)

Response

boolean

True if any/the given hook is currently processed, otherwise false

Load the specified plugin

load_plugin( $plugin_name,  $force = false,  $require = true) : boolean

Arguments

$plugin_name

$force

$require

Response

boolean

True on success, false if not loaded or failure

Load and init all enabled plugins

load_plugins( $plugins_enabled,  $required_plugins = array())

This has to be done after rcmail::load_gui() or rcmail::json_init() was called because plugins need to have access to rcmail->output

Arguments

$plugins_enabled

$required_plugins

Returns list of loaded plugins names

loaded_plugins() : array

Response

array

List of plugin names

Let a plugin register a handler for a specific request

register_action(string $action, string $owner, mixed $callback, string $task = null)

Arguments

$action

string

Action name (_task=mail&_action=plugin.foo)

$owner

string

Plugin name that registers this action

$callback

mixed

Callback: string with global function name or array($obj, 'methodname')

$task

string

Task name registered by this plugin

Register a handler function for template objects

register_handler(string $name, string $owner, mixed $callback)

Arguments

$name

string

Object name

$owner

string

Plugin name that registers this action

$callback

mixed

Callback: string with global function name or array($obj, 'methodname')

Allows a plugin object to register a callback for a certain hook

register_hook(string $hook, mixed $callback)

Arguments

$hook

string

Hook name

$callback

mixed

String with global function name or array($obj, 'methodname')

Register this plugin to be responsible for a specific task

register_task(string $task, string $owner)

Arguments

$task

string

Task name (only characters [a-z0-9_-] are allowed)

$owner

string

Plugin name that registers this action

Make the given file name link into the plugins directory

resource_url(string $fn) : string

Arguments

$fn

string

Filename

Response

string

Callback for template_container hooks

template_container_hook(array $attrib) : array

Arguments

$attrib

array

Response

array

Allow a plugin object to unregister a callback.

unregister_hook(string $hook, mixed $callback)

Arguments

$hook

string

Hook name

$callback

mixed

String with global function name or array($obj, 'methodname')

Properties

instance

instance :
static

Type(s)

dir

dir :

Type(s)

url

url :

Type(s)

task

task :

Type(s)

initialized

initialized :

Type(s)

output

output :

Type(s)

handlers

handlers :

Type(s)

allowed_prefs

allowed_prefs :

Type(s)

allowed_session_prefs

allowed_session_prefs :

Type(s)

active_plugins

active_plugins :

Type(s)

plugins

plugins :

Type(s)

plugins_initialized

plugins_initialized :

Type(s)

tasks

tasks :

Type(s)

actions

actions :

Type(s)

actionmap

actionmap :

Type(s)

objectsmap

objectsmap :

Type(s)

template_contents

template_contents :

Type(s)

exec_stack

exec_stack :

Type(s)

deprecated_hooks

deprecated_hooks :

Type(s)