X-Git-Url: https://scm.cri.ensmp.fr/git/ckeditor.git/blobdiff_plain/256592bf803e851aa7fc953e08a6e9e58d970f8c..871bad8291b6dbc29d489d95d185458caab25158:/skins/ckeditor/_source/core/plugindefinition.js diff --git a/skins/ckeditor/_source/core/plugindefinition.js b/skins/ckeditor/_source/core/plugindefinition.js new file mode 100644 index 0000000..d9dc526 --- /dev/null +++ b/skins/ckeditor/_source/core/plugindefinition.js @@ -0,0 +1,83 @@ +/* +Copyright (c) 2003-2011, CKSource - Frederico Knabben. All rights reserved. +For licensing, see LICENSE.html or http://ckeditor.com/license +*/ + +/** + * @fileOverview Defines the "virtual" {@link CKEDITOR.pluginDefinition} class, which + * contains the defintion of a plugin. This file is for documentation + * purposes only. + */ + +/** + * (Virtual Class) Do not call this constructor. This class is not really part + * of the API. It just illustrates the features of plugin objects to be + * passed to the {@link CKEDITOR.plugins.add} function. + * @name CKEDITOR.pluginDefinition + * @constructor + * @example + */ + +/** + * A list of plugins that are required by this plugin. Note that this property + * doesn't guarantee the loading order of the plugins. + * @name CKEDITOR.pluginDefinition.prototype.requires + * @type Array + * @example + * CKEDITOR.plugins.add( 'sample', + * { + * requires : [ 'button', 'selection' ] + * }); + */ + +/** + * A list of language files available for this plugin. These files are stored inside + * the "lang" directory, which is inside the plugin directory, follow the name + * pattern of "langCode.js", and contain a language definition created with {@link CKEDITOR.pluginDefinition#setLang}. + * While the plugin is being loaded, the editor checks this list to see if + * a language file of the current editor language ({@link CKEDITOR.editor#langCode}) + * is available, and if so, loads it. Otherwise, the file represented by the first list item + * in the list is loaded. + * @name CKEDITOR.pluginDefinition.prototype.lang + * @type Array + * @example + * CKEDITOR.plugins.add( 'sample', + * { + * lang : [ 'en', 'fr' ] + * }); + */ + + /** + * Function called on initialization of every editor instance created in the + * page before the init() call task. The beforeInit function will be called for + * all plugins, after that the init function is called for all of them. This + * feature makes it possible to initialize things that could be used in the + * init function of other plugins. + * @name CKEDITOR.pluginDefinition.prototype.beforeInit + * @function + * @param {CKEDITOR.editor} editor The editor instance being initialized. + * @example + * CKEDITOR.plugins.add( 'sample', + * { + * beforeInit : function( editor ) + * { + * alert( 'Editor "' + editor.name + '" is to be initialized!' ); + * } + * }); + */ + + /** + * Function called on initialization of every editor instance created in the + * page. + * @name CKEDITOR.pluginDefinition.prototype.init + * @function + * @param {CKEDITOR.editor} editor The editor instance being initialized. + * @example + * CKEDITOR.plugins.add( 'sample', + * { + * init : function( editor ) + * { + * alert( 'Editor "' + editor.name + '" is being initialized!' ); + * } + * }); + */