Report an issue
Class

CKEDITOR.plugins

class singleton

Manages plugins registration and loading.

Note This object is an instance of CKEDITOR.resourceManager.

Filtering

Properties

Methods

  • constructor( basePath, fileName ) → resourceManager

    Creates a resourceManager class instance.

    Parameters

    basePath : String

    The path for the resources folder.

    fileName : String

    The name used for resource files.

    Returns

    resourceManager
  • inherited

    add( name, [ definition ] )

    Registers a resource.

    CKEDITOR.plugins.add( 'sample', { ... plugin definition ... } );
    

    Parameters

    name : String

    The resource name.

    [ definition ] : Object

    The resource definition. CKEDITOR.pluginDefinition

  • inherited

    addExternal( names, path, [ fileName ] )

    Registers one or more resources to be loaded from an external path instead of the core base path.

    // Loads a plugin from '/myplugins/sample/plugin.js'.
    CKEDITOR.plugins.addExternal( 'sample', '/myplugins/sample/' );
    
    // Loads a plugin from '/myplugins/sample/my_plugin.js'.
    CKEDITOR.plugins.addExternal( 'sample', '/myplugins/sample/', 'my_plugin.js' );
    
    // Loads a plugin from '/myplugins/sample/my_plugin.js'.
    CKEDITOR.plugins.addExternal( 'sample', '/myplugins/sample/my_plugin.js', '' );
    
    // Loads a plugin from '/myplugins/sample/my_plugin.js'.
    CKEDITOR.plugins.addExternal( 'sample', '/myplugins/sample/my_plugin.js' );
    

    Parameters

    names : String

    Comma-separated resource names.

    path : String

    The path of the folder containing the resource.

    [ fileName ] : String

    The resource file name. If not provided and the path argument ends with a slash (/), the default plugin.js filename is used. Otherwise, if not provided and the path argument does not end with a slash (/) or if an empty string is provided, the function assumes that the path argument contains the full path.

  • inherited

    get( name ) → Object

    Gets the definition of a specific resource.

    var definition = CKEDITOR.plugins.get( 'sample' );
    

    Parameters

    name : String

    The resource name.

    Returns

    Object

    The registered object.

  • inherited

    getFilePath( name ) → String

    Get the file path for a specific loaded resource.

    alert( CKEDITOR.plugins.getFilePath( 'sample' ) ); // '<editor path>/plugins/sample/plugin.js'
    

    Parameters

    name : String

    The resource name.

    Returns

    String
  • inherited

    getPath( name ) → String

    Get the folder path for a specific loaded resource.

    alert( CKEDITOR.plugins.getPath( 'sample' ) ); // '<editor path>/plugins/sample/'
    

    Parameters

    name : String

    The resource name.

    Returns

    String
  • inherited

    load( name, callback, [ scope ] )

    Loads one or more resources.

    CKEDITOR.plugins.load( 'myplugin', function( plugins ) {
        alert( plugins[ 'myplugin' ] ); // object
    } );
    

    Parameters

    name : String | Array

    The name of the resource to load. It may be a string with a single resource name, or an array with several names.

    callback : Function

    A function to be called when all resources are loaded. The callback will receive an array containing all loaded names.

    [ scope ] : Object

    The scope object to be used for the callback call.

  • setLang( pluginName, languageCode, languageEntries )

    Loads a specific language file, or auto detect it. A callback is then called when the file gets loaded.

    CKEDITOR.plugins.setLang( 'myPlugin', 'en', {
        title: 'My plugin',
        selectOption: 'Please select an option'
    } );
    

    Parameters

    pluginName : String

    The name of the plugin to which the provided translation should be attached.

    languageCode : String

    The code of the language translation provided.

    languageEntries : Object

    An object that contains pairs of label and the respective translation.