fckeditor 插件开发参考文档

适合初开发FCK插件的朋友们，这里有一个关于插件开发的实例可以参考我们之前发表的文章。

一、插件的目录结构

插件的目录名称必须与插件名称一致，且必须包含一个fckplugin.js文件。可以选择包含一个lang目录，用于实现界面的国际化。每个文件定义一种语言，文件名不包含.js，通过FCKConfig.Plugins.Add()进行注册。如果实现的插件命令没有界面，也可以不需要支持任何语言。

以findreplace插件的目录结构为例：

/editor/plugins/findreplace/fckplugin.js

/editor/plugins/findreplace/lang/en.js

/editor/plugins/findreplace/lang/zh.js

在fckplugin.js文件中定义你的插件，并注册该命令，同时创建一个工具栏按钮。

注册代码说明：

代码如下：

注册命令，使用RegisterCommand（命令名，命令）。例如：

FCKCommands.RegisterCommand('My_Find', new FCKDialogCommand(FCKLang['DlgMyFindTitle'], FCKLang['DlgMyFindTitle'], FCKConfig.PluginsPath + 'findreplace/find.html', 340, 170));

同样，注册替换命令并创建工具栏按钮。这些按钮需要先创建，然后再注册。例如：

var oFindItem = new FCKToolbarButton('My_Find', FCKLang['DlgMyFindTitle']);

oFindItem.IconPath = FCKConfig.PluginsPath + 'findreplace/find.gif';

FCKToolbarItems.RegisterItem('My_Find', oFindItem);

var oreplaceItem = new FCKToolbarButton('My_Replace', FCKLang['DlgMyReplaceTitle']);

oreplaceItem.IconPath = FCKConfig.PluginsPath + 'findreplace/replace.gif';

FCKToolbarItems.RegisterItem('My_Replace', oreplaceItem);

二、安装插件

安装前，将解压后的包复制到editor/plugins目录下，然后按照以下步骤进行。

1、确定按钮在工具栏的位置

最好在定制的配置文件中，新建一个工具栏来包含新的插件。定制配置文件的代码如下：

FCKConfig.ToolbarSets['PluginTest'] = [ ['Source'], ['Placeholder'], ['My_Find', 'My_Replace'], ... ] ;

这里的...表示其他工具栏项。

2、添加插件

同样，可以在定制文件中添加插件。可以将插件放置在默认目录下，或者在FCKConfig.Plugins.Add方法的第三个参数中指定插件所在位置。这样，你就可以轻松地将新开发的FCK插件集成到编辑器中，为用户提供更多便捷的功能。无论是查找还是替换，新插件都能帮助用户更高效地编辑文本。在编程世界里，对功能进行定制和扩展常常离不开插件的支持。今天我们要的是关于FCKConfig对象如何添加插件的方法。这是一种强大的功能，允许开发者为应用程序增加额外的功能和特性。让我们深入理解一下这个过程。

我们需要了解FCKConfig对象中的插件添加方法。通过调用FCKConfig.Plugins.Add方法，我们可以轻松添加插件到系统中。这个方法需要三个参数：插件名称（pluginName）、可用语言列表（availableLanguages）和插件路径（pathToPlugin）。其中插件名称指的是你要添加的插件的名称或者目录名称，可用语言列表是以逗号分割的字符串，表示插件支持的语言，插件路径则是插件所在的绝对路径。

如果你需要在默认位置添加插件，可以像下面这样操作：

```javascript

FCKConfig.Plugins.Add('findreplace', 'en,it');

```

如果你想在其他位置添加插件，你需要提供插件的绝对路径。你需要确定FCKConfig的BasePath，然后通过字符串操作得到插件的路径。接着，你就可以按照下面的方式添加插件了：

```javascript

var sOtherPluginPath = FCKConfig.BasePath.substr(0, FCKConfig.BasePath.length - 7) + 'editor/plugins/';

FCKConfig.Plugins.Add('placeholder', 'en,it', sOtherPluginPath);

FCKConfig.Plugins.Add('tablemands', null, sOtherPluginPath);

```

在这个例子中，我们首先定义了插件的路径sOtherPluginPath，然后通过FCKConfig.Plugins.Add方法添加了名为placeholder和tablemands的插件。这些插件支持的语言分别是en和it，以及没有特定语言限制（null）。通过这种方式，我们可以灵活地添加和管理插件，以满足不同的需求。需要注意的是，这些代码需要在特定的编程环境中运行，以确保FCKConfig对象和其他相关功能可用。通过FCKConfig的插件管理功能，我们可以轻松地为应用程序添加新的特性和功能，从而增强其灵活性和可扩展性。这样我们就可以根据需要定制我们的应用程序，使其更加符合用户的期望和需求。