function ctools_plugin_get_function

Get a function from a plugin, if it exists. If the plugin is not already loaded, try ctools_plugin_load_function() instead.

Parameters

$plugin_definition: The loaded plugin type.

$function_name: The identifier of the function. For example, 'settings form'.

Return value

string The actual name of the function to call, or NULL if the function does not exist.

51 calls to ctools_plugin_get_function()
ctools_access in includes/context.inc
Determine if the current user has access via a plugin.
ctools_access_add_restrictions in includes/context.inc
Apply restrictions to contexts based upon the access control configured.
ctools_access_ajax_edit_item in includes/context-access-admin.inc
Form to edit the settings of an access test.
ctools_access_ajax_edit_item_submit in includes/context-access-admin.inc
Submit handler for argument settings.
ctools_access_ajax_edit_item_validate in includes/context-access-admin.inc
Validate handler for argument settings.

... See full list

File

includes/plugins.inc, line 790

Code

function ctools_plugin_get_function($plugin_definition, $function_name) {
    // If cached the .inc file may not have been loaded. require_once is quite safe
    // and fast so it's okay to keep calling it.
    if (isset($plugin_definition['file'])) {
        // Plugins that are loaded from info files have the info file as
        // $plugin['file'].  Don't try to run those.
        $info = ctools_plugin_get_info($plugin_definition['plugin module'], $plugin_definition['plugin type']);
        if (empty($info['info file'])) {
            require_once DRUPAL_ROOT . '/' . $plugin_definition['path'] . '/' . $plugin_definition['file'];
        }
    }
    if (!isset($plugin_definition[$function_name])) {
        return NULL;
    }
    if (is_array($plugin_definition[$function_name]) && isset($plugin_definition[$function_name]['function'])) {
        $function = $plugin_definition[$function_name]['function'];
        if (isset($plugin_definition[$function_name]['file'])) {
            $file = $plugin_definition[$function_name]['file'];
            if (isset($plugin_definition[$function_name]['path'])) {
                $file = $plugin_definition[$function_name]['path'] . '/' . $file;
            }
            require_once DRUPAL_ROOT . '/' . $file;
        }
    }
    else {
        $function = $plugin_definition[$function_name];
    }
    if (function_exists($function)) {
        return $function;
    }
}