Fckeditor2.6.4.1配置.doc

Fckeditor配置Jsp学习 2009-09-23 15:41:03 阅读481 评论1 字号：大中小 以前的在线编辑器都是采用eWebEditor（修改版）,最近网站升级，想换一个在线编辑器，于是试了一下fckeditor，以下是安装配置过程。一、下载二、安装1、解压FCKeditor_.zip得到fckeditor文件夹，整个目录复制到当前项目的webRoot目录下。2、在lib目录上导入以下几个jar说明：以上几个jar文件在fckeditor-java-2.5-bin.zip中，也可以把fckeditor-java-demo-2.5.war放到tomcat的webapps目录下tomcat会自动解压，在WEB-INFlib下就会有以上几个文件。3、配置上传功能(1)修改web.xml文件，添加以下代码： Connector net.fckeditor.connector.ConnectorServlet 1 Connector /fckeditor/editor/filemanager/connectors/* (2)在src文件夹下创建perties文件代码如下：connector.userActionImpl=net.fckeditor.requestcycle.impl.UserActionImpl(demo中是这样写的connector.userActionImpl=net.fckeditor.requestcycle.impl.EnableUserAction测试也是行！)三、测试新建index.jsp,在head标记中添加然后，可以通过两种方式在页面建立一个FCKeditor编辑器。? 内联方式：在页面的form标记中，在需要插入编辑器的地方输入以下代码：var oFCKeditor = new FCKeditor(FCKeditor1);oFCKeditor.BasePath = /项目名/fckeditor/;oFCKeditor.Height=”200”;oFCKeditor.Width”50%”;/oFCKeditor.ToolbarSet=”Basic”;oFCKeditor.ToolbarSet=”Default”;oFCKeditor.Create();代码第二行新建一个FCKeditor的实例，它的名字叫做FCKeditor1，第三行设置编辑器的基本路径，第八行调用它的creat()方法，创建并且输出一个编辑器。这个表单提交到servlet以后，在servlet中就可以通过request.getParameter(“FCKeditor1”)获得输入的内容。注意：编辑器的路径BasePash是指项目中FCKeditor文件所在的路径以”/”结尾。? Textarea替换方式：可以通过在页面的onload事件中添加代码以替换一个已经存在的textarea标记的方式使用FCKeditor,代码如下：script type=text/javascriptwindow.onload = function()var oFCKeditor = new FCKeditor( MyTextarea );oFCKeditor.BasePath = fckeditor/;oFCKeditor.ReplaceTextarea();在body标签下添加textarea标签，代码如下：This is the initial value.注意：第四行FCKeditor创建的实例名FCKeditor1，要与textarea标签的name属性一样。1.1 四、 FCKeditor属性属性描述默认值Width宽度100%Height高度200Value编辑器初始化内容空字符串ToolbarSet工具条集合的名称(内置Default,Basic)DefaultBasePath编辑器的路径/fckeditor/构造方法：var FCKeditor=function(instanceName ,width,height,toolbarset,value)其中instanceName为编辑器输出textarea元素的name属性的值，必须指定。五、在jsp中通过自定义标签调用 可以参考：1. fckeditor-java-demo-2.4.1.war，其目录下的jsp文件里面的代码。2. FCKeditor提供的文档。解压fckeditor-java-2.4.1-bin.zip，打开其目录下site文件下index.html，点击Tag library,往下拉找到使用的例子在jsp中通过自定义标签调用FCKeditor:首先，把FCKeditor提供的核心架包、fckeditor-java-2.4.1目录下lib里面的3个架包（前面两个文件上传使用，后面做日志使用）拷贝到项目下面的WebRoot/WEB-INF/bin下面还应该下载slf4j-simple-1.5.2.jar架包。注意：FCKeditor.tld在核心架包里面，所以不用拷贝。最简单的方法就是直接去fckeditor-java-demo-2.4.1/WEB-INF/lib里面拷贝。FCKeditor自定义标签 (必须加头文件 )先引入自定义标签，然后调用注意：basePath以/开头，并且这个/代表当前项目的路径。一定要赋予value值，并且不能为空字符串，可以为空格。1.2 六、使用配置文件FCKeditor主配置文件fckconfig.js,在fckeditor文件下。中文注释如下所示：FCKConfig.CustomConfigurationsPath = ; /自定义配置文件路径和名称FCKConfig.EditorAreaCSS = FCKConfig.BasePath + css/fck_editorarea.css ; /文本编辑区域的样式表文件路径FCKConfig.EditorAreaStyles = ; /文本编辑区域的样式表风格FCKConfig.ToolbarComboPreviewCSS = ; /工具栏预览CSSFCKConfig.DocType = ; /文档类型FCKConfig.BaseHref = ; /相对链接的基地址FCKConfig.FullPage = false ; /是否允许编辑整个HTML文件,还是仅允许编辑BODY间的内容FCKConfig.StartupShowBlocks = false ; /是否启用显示模块FCKConfig.Debug = false ; /是否开启调试窗口功能FCKConfig.AllowQueryStringDebug = true ; /是否启用网页查询调试功能FCKConfig.SkinPath = FCKConfig.BasePath + skins/default/ ; /FCKeditor皮肤路径FCKConfig.SkinEditorCSS = ; /编辑器的皮肤CSS路径FCKConfig.SkinDialogCSS = ; /对话窗口的皮肤CSS路径FCKConfig.PreloadImages = FCKConfig.SkinPath + images/toolbar.start.gif, FCKConfig.SkinPath + images/toolbar.buttonarrow.gif ; /预装入的图片FCKConfig.PluginsPath = FCKConfig.BasePath + plugins/ ; /插件路径FCKConfig.AutoGrowMax = 400 ; /文本编辑区域允许自动增长的最大高度限制，设置此属性时应同时将/ FCKConfig.Plugins.Add( autogrow ) ;属性的注释去除，配合使用FCKConfig.AutoDetectLanguage = true ; /是否自动检测语言FCKConfig.DefaultLanguage = en ; /默认语言FCKConfig.ContentLangDirection = ltr ; /默认的文字方向,可选ltr/rtl,即从左到右或从右到左FCKConfig.ProcessHTMLEntities = true ; /处理HTML实体FCKConfig.IncludeLatinEntities = true ; /包括拉丁文FCKConfig.IncludeGreekEntities = true ; /包括希腊文FCKConfig.ProcessNumericEntities = false ; /处理数字实体FCKConfig.AdditionalNumericEntities = ; /附加的数字实体FCKConfig.FillEmptyBlocks = true ; /是否填充空块FCKConfig.FormatSource = true ; /在切换到代码视图时是否自动格式化代码FCKConfig.FormatOutput = true ; /当输出内容时是否自动格式化代码FCKConfig.FormatIndentator = ; /当在源码格式下缩进代码使用的字符FCKConfig.EMailProtection = none ; /侦测电子邮件链接FCKConfig.EMailProtectionFunction = mt(NAME,DOMAIN,SUBJECT,BODY) ; /侦测电子邮件链接FCKConfig.StartupFocus = false ; /开启时焦点是否到编辑器,即打开页面时光标是否停留在fckeditor上FCKConfig.ForcePasteAsPlainText = false ; /是否强制粘贴为纯文本内容FCKConfig.AutoDetectPasteFromWord = true ; /是否自动探测从word粘贴文件,仅支持IEFCKConfig.ShowDropDialog = true ; /是否显示下拉菜单FCKConfig.ForceSimpleAmpersand = false ; /是否不把&符号转换为XML实体FCKConfig.TabSpaces = 0 ; /按下Tab键时光标跳格数,默认值为零为不跳格FCKConfig.ShowBorders = true ; /是否合并边框FCKConfig.SourcePopup = false ; /是否弹出FCKConfig.ToolbarStartExpanded = true ; /启动FCKeditor工具栏默认是否展开FCKConfig.ToolbarCanCollapse = true ; /是否允许折叠或展开工具栏FCKConfig.IgnoreEmptyParagraphValue = true ; /是否忽略空的段落值FCKConfig.FloatingPanelsZIndex = 10000 ; /浮动面板索引FCKConfig.HtmlEncodeOutput = false ; /是否将HTML编码输出FCKConfig.TemplateReplaceAll = true ; /是否替换所有模板FCKConfig.TemplateReplaceCheckbox = true ; /是否将实际内容显示在模版窗口中FCKConfig.ToolbarLocation = In ; /工具栏位置FCKConfig.ToolbarSetsDefault /配置默认工具栏中各按钮，适合用于后台编辑FCKConfig.ToolbarSetsBasic /配置基本工具栏按扭，适合前台编辑FCKConfig.EnterMode = p ; /编辑文本时按回车键自动生成标签FCKConfig.ShiftEnterMode = br ; /编辑文本时按Shift+回车键自动生成标签FCKConfig.Keystrokes /自定义键盘快捷键FCKConfig.ContextMenu /定义右键菜单的内容FCKConfig.BrowserContextMenuOnCtrl = false ; /是否允许在编辑区域中当按下Ctrl键时，点击鼠标右键显示浏览器的上下文菜单FCKConfig.BrowserContextMenu = false ; /是否允许在编辑区域中点击鼠标右键显示浏览器的上下文菜单FCKConfig.EnableMoreFontColors = true ; /是否禁止更多颜色选项FCKConfig.FontColors /文字颜色列表FCKConfig.FontFormats /文字格式列表FCKConfig.FontNames /字体列表FCKConfig.FontSizes /字号列表FCKConfig.StylesXmlPath = FCKConfig.EditorPath + fckstyles.xml ; /CSS样式列表的XML文件的位置FCKConfig.TemplatesXmlPath = FCKConfig.EditorPath + fcktemplates.xml ; /模版的XML文件位置FCKConfig.SpellChecker = WSC ; /拼写检查器FCKConfig.IeSpellDownloadUrl = /download.php ; /下载拼写检查器的网址FCKConfig.SpellerPagesServerScript = server-scripts/spellchecker.php ; /拼写检查器脚本路径FCKConfig.FirefoxSpellChecker = false ; /Firefox浏览器拼写检查FCKConfig.MaxUndoLevels = 15 ; /最大可以撤销的次数FCKConfig.DisableObjectResizing = false ; /是否禁止用户调整图像和表格的大小FCKConfig.DisableFFTableHandles = true ; /是否禁用表格工具FCKConfig.LinkDlgHideTarget = false ; /是否隐藏Link窗口的target标签FCKConfig.LinkDlgHideAdvanced = false ; /是否隐藏Link窗口的advanced标签FCKConfig.ImageDlgHideLink = false ; /是否隐藏image窗口的link标签FCKConfig.ImageDlgHideAdvanced = false ; /是否隐藏image窗口的advanced标签FCKConfig.FlashDlgHideAdvanced = false ; /是否隐藏Flash窗口的advanced标签FCKConfig.ProtectedTags = ; /添加HTML套用格式FCKConfig.BodyId = ; /设置编辑器的idFCKConfig.BodyClass = ; /设置编辑器的classFCKConfig.DefaultStyleLabel = ; /设置文本编辑器的风格，默认为空白文档FCKConfig.DefaultFontFormatLabel = ; /设置默认格式FCKConfig.DefaultFontLabel = ; /设置默认字体FCKConfig.DefaultFontSizeLabel = ; /设置默认字体大小FCKConfig.DefaultLinkTarget = ; /设置默认链接目标为(_blank、_self _parent、_top)FCKConfig.CleanWordKeepsStructure = false ; /是否设置直接粘贴为Word格式FCKConfig.RemoveFormatTags /删除文字时是否删除相应的格式FCKConfig.RemoveAttributes /删除文字时是否删除相应的样式FCKConfig.CustomStyles /样式菜单FCKConfig.CoreStyles /设置FCKeditor核心样式FCKConfig.IndentLength = 40 ; /编辑器中缩进量的长度FCKConfig.IndentUnit = px ; /编辑器中缩进量的单位FCKConfig.IndentClasses = ; /FCKeditor允许使用CSS缩进FCKConfig.JustifyClasses = ; /FCKeditor允许使用CSS类文本var _FileBrowserLanguage = php ; /文件浏览器使用的语言var _QuickUploadLanguage = php ; /快速上传使用的语言var _FileBrowserExtension = _FileBrowserLanguage = perl ? cgi : _FileBrowserLanguage ; /文件浏览器扩展var _QuickUploadExtension = _QuickUploadLanguage = perl ? cgi : _QuickUploadLanguage ; /快速上传扩展FCKConfig.LinkBrowser = true ; /是否允许在插入链接时浏览服务器FCKConfig.LinkBrowserURL /插入链接时浏览服务器的URLFCKConfig.LinkBrowserWindowWidth /链接目标浏览器窗口宽度FCKConfig.LinkBrowserWindowHeight /链接目标浏览器窗口高度FCKConfig.ImageBrowser = true ; /是否关闭图片文件浏览服务器的功能FCKConfig.ImageBrowserURL /图片文件浏览服务器的URLFCKConfig.ImageBrowserWindowWidth /图像浏览器窗口宽度FCKConfig.ImageBrowserWindowHeight /图像浏览器窗口高度FCKConfig.FlashBrowser = true ; /是否关闭Flash浏览服务器的功能FCKConfig.FlashBrowserURL /Flash浏览服务器的URLFCKConfig.FlashBrowserWindowWidth /Flash浏览器窗口宽度FCKConfig.FlashBrowserWindowHeight /Flash浏览器窗口高度FCKConfig.LinkUpload = true ; /是否开启文件上传的功能FCKConfig.LinkUploadURL /指定默认上传文件的地址FCKConfig.LinkUploadAllowedExtensions /设置允许上传文件的扩展名FCKConfig.LinkUploadDeniedExtensions = ; /设置允许上传脚本文件的扩展名FCKConfig.ImageUpload = true ; /是否开启图片上传功能FCKConfig.ImageUploadURL /指定默认上传图片文件的地址FCKConfig.ImageUploadAllowedExtensions /设置允许上传图片文件的扩展名FCKConfig.ImageUploadDeniedExtensions = ; /设置允许上传图片脚本文件的扩展名FCKConfig.FlashUpload = true ; /是否开启Flash上传功能FCKConfig.FlashUploadURL /Flash上传文件的地址FCKConfig.FlashUploadAllowedExtensions /设置允许上传Flash文件的扩展名FCKConfig.FlashUploadDeniedExtensions = ; /设置允许上传Flash脚本文件的扩展名FCKConfig.SmileyPath /插入表情图标的路径FCKConfig.SmileyImages /表情图标的文件名称FCKConfig.SmileyColumns = 8 ; /表情窗口显示表情列数FCKConfig.SmileyWindowWidth = 320 ; /表情窗口显示宽度，此窗口会因为表情文件的改变而作调整FCKConfig.SmileyWindowHeight = 210 ; /表情窗口显示高度，此窗口会因为表情文件的改变而作调整FCKConfig.BackgroundBlockerColor = #ffffff ; /编辑器弹出窗口时，背景遮照住的颜色FCKConfig.BackgroundBlockerOpacity = 0.50 ; /编辑器弹出窗口时，背景遮照住的透明度FCKConfig.MsWebBrowserControlCompat = false ;FCKConfig.PreventSubmitHandler = false ;可以根据项目的需要进行修改配置文件,也可以新建一个config.js文件，具体用法如下：1. 在直接修改FCKconfig.js主配置文件。对所有FCKeditor有效。2. 新建一个配置文件config.js（只需要写需要修改的配置项），修改FCKConfig.CustomConfigurationsPath = /项目/config.js.对所有FCKeditor实例都有效。3. 新建一个配置文件config.js（只需要写需要修改的配置项），在页面中调用FCKeditor的时候，进行配置，oFCKeditor.ConfigCustomConfigurationsPath = /config.js，只对当前的FCKeditor有效。注意：1.系统会自动侦测并运用适当的界面语言。2.不能删除主配置文件FCKconfig.js。3.修改配置后要清空浏览器缓存，以免影响结果。（或者访问时强制刷新）具体参考网址：/FCKeditor_2.x/Developers_Guide/Configuration/Configuration_File七、文件上传乱码的问题： 乱码是由服务器保存的时候出现乱码，而不是显示时出现的乱码。使用FCKeditor上传图片会出现很多乱码情况，如下：上传文件名为中文的文件时会出现乱码、创建中文目录名出现乱码。解决这个问题：首先建一个servlet过滤器，解决乱码问题，Servlet过滤器import java.io.IOException;import javax.servlet.Filter;import javax.servlet.FilterChain;import javax.servlet.FilterConfig;import javax.servlet.ServletException;import javax.servlet.S