CKFinder2.x 入门

CKFinder是一款强大的基于浏览器的ajax文件管理工具,通常与CKEditor整合使用,当然也可以单独使用。CKFinder支持多种语言,官网地址为 http://ckfinder.com/ ,目前他的java版已经发布,不过不同于CKEditor,CKFinder是收费的,如果不购买license,就只能用于学习演示,不能用于商业用途,除非......(你知道的)。

 

一、下载及安装

 

http://ckfinder.com/download 选择java版下载(我下载时是2011年5月30日发布的 2.0.2.1 ),解压后可以看到里面有一个“_sources”文件夹和一个“CKFinderJava.war”的war包,我们可以部署这个war包,它里面有一些小例子和CKFinder的相关链接。然后,可以在“_sources\CKFinder for Java\WebApp\src\main\webapp”中、或者直接解压开“CKFinderJava.war”包,找到我们需要的东西,并进行如下操作:

 

ckfinder文件夹拷贝到工程目录下(如WebRoot\ckfinder)

将 CKFinder WEB-INF 下的 config.xml 文件拷贝到你工程的 WEB-INF 文件夹下

WEB-INF/lib 中的jar包拷贝到你工程的 WEB-INF/lib下

将 CKFinder web.xml 中的配置拷贝到你工程的 web.xml 中

Xml代码 复制代码  收藏代码
  1. <servlet>  
  2.     <servlet-name>ConnectorServlet</servlet-name>  
  3.     <servlet-class>com.ckfinder.connector.ConnectorServlet</servlet-class>  
  4.     <init-param>  
  5.         <param-name>XMLConfig</param-name>  
  6.         <param-value>/WEB-INF/config.xml</param-value>  
  7.     </init-param>  
  8.     <load-on-startup>1</load-on-startup>  
  9. </servlet>  
  10. <servlet-mapping>  
  11.     <servlet-name>ConnectorServlet</servlet-name>  
  12.     <url-pattern>  
  13.         /ckfinder/core/connector/java/connector.java   
  14.     </url-pattern>  
  15. </servlet-mapping>  
 

默认情况下,处于安全性考虑,CKfineder是被禁止的,要启用CKFinder,我们可以将 config.xml 中的<enabled>的值改为true。CKFinder 更推荐重写 checkAuthentication方法以达到此目的。

 

二、以 jsp tag 方式创建CKFinder实例

 

CKFinder单独使用时,可以以 jsp tag 方式创建其实例。

 

首先在jsp页面中引入CKFinder标签库

 

Java代码 复制代码  收藏代码
  1. <%@ taglib uri="http://ckfinder.com" prefix="ckfinder" %>  
<%@ taglib uri="http://ckfinder.com" prefix="ckfinder" %>

 

然后就可以通过如下代码在需要的位置创建一个CKFinder实例

 

Html代码 复制代码  收藏代码
  1. <ckfinder:ckfinder basePath="/CKEditor_test/ckfinder/" />  
<ckfinder:ckfinder basePath="/CKEditor_test/ckfinder/" />
 

其中,basePath 是唯一必选参数,当然也可以在此指定其他参数配置,如实例长度、宽度等

 

Java代码 复制代码  收藏代码
  1. <ckfinder:ckfinder basePath="/CKEditor_test/ckfinder/" width="700" height="500" />  
<ckfinder:ckfinder basePath="/CKEditor_test/ckfinder/" width="700" height="500" />
 

三、集成CKEditor

 

    有三种方式集成CKEditor,可以根据需要,任选其一。

 

通过<ckfinder:setupCKEditor>标签集成

 

    使用 <ckfinder:setupCKEditor> 标签集成CKEditor时,需要确保CKFinder于CKEditor都成功安装,并且在 /WEB-INF/lib下载入了 ckeditor-java-core-3.x.jar包(可在 http://ckeditor.com/download 页面CKEditor for Java处下载zip包)。

 

<ckfinder:setupCKEditor>接受四个参数:

basePath - 必选参数,指定 CKFinder文件夹路径。

editor - 可选参数,要集成的 CKEditor实例的名称,如果不指定,将与当前页面中所有的CKEditor实例集成。

flashType - 可选参数, CKFinder中“Flash”类型资源 type 的名称。

imageType - 可选参数, CKFinder中“Images”类型资源 type 的名称。

 

<ckfinder:setupCKEditor> 必须在 <ckeditor> 标签之前 被插入。如:

 

Html代码 复制代码  收藏代码
  1. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">  
  2. <%@page pageEncoding="UTF-8" contentType="text/html; charset=UTF-8"%>  
  3. <%@ taglib uri="http://ckeditor.com" prefix="ckeditor" %>  
  4. <%@ taglib uri="http://ckfinder.com" prefix="ckfinder" %>  
  5. <html xmlns="http://www.w3.org/1999/xhtml">  
  6.     <body>  
  7.         <form action="display.jsp" method="post">  
  8.             <textarea cols="80" id="editor1" name="editor1" rows="10"></textarea>                  
  9.             <input type="submit" value="Submit" />  
  10.         </form>  
  11.         <ckfinder:setupCKEditor basePath="/CKEditor_test/ckfinder/" editor="editor1" />  
  12.         <ckeditor:replace replace="editor1" basePath="/CKEditor_test/ckeditor/" />  
  13.     </body>      
  14. </html>  
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<%@page pageEncoding="UTF-8" contentType="text/html; charset=UTF-8"%>
<%@ taglib uri="http://ckeditor.com" prefix="ckeditor" %>
<%@ taglib uri="http://ckfinder.com" prefix="ckfinder" %>
<html xmlns="http://www.w3.org/1999/xhtml">
	<body>
		<form action="display.jsp" method="post">
			<textarea cols="80" id="editor1" name="editor1" rows="10"></textarea>				
			<input type="submit" value="Submit" />
		</form>
		<ckfinder:setupCKEditor basePath="/CKEditor_test/ckfinder/" editor="editor1" />
		<ckeditor:replace replace="editor1" basePath="/CKEditor_test/ckeditor/" />
	</body>	
</html>
 

 

通过CKFinder.setupCKEditor集成

 

首先需要再页面中引入 ckeditor.jsckfinder.js 文件。

 

setupCKEditor接受四个参数;

 

Js代码 复制代码  收藏代码
  1. CKFinder.setupCKEditor( editorObj, config[, imageType, flashType] )  

 

editorObj - CKEditor实例,如果不指定,将与当前页面中所有的CKEditor实例集成

config - 一个包含指定配置的对象,或者仅指定 CKFinder 的 basePath。

imageType - 当Image Properties 对话框启动 CKFinder 时,type 处指定的名称。

flashType - 当 Flash Properties 对话框启动 CKFinder 时,type 处指定的名称。

 

例1

 

下面的例子展现了如何将 CKFinder 与 editor1 集成并且在第二个参数处仅指定 CKFinder 的 b ase path。

 

Js代码 复制代码  收藏代码
  1. var editor = CKEDITOR.replace( 'editor1' );   
  2. CKFinder.setupCKEditor( editor, '/CKEditor_test/ckfinder/' );  

 

例2

 

第二个参数也可以为 一个包含指定配置的对象。

 

Js代码 复制代码  收藏代码
  1. var editor = CKEDITOR.replace( 'editor1' );   
  2. CKFinder.setupCKEditor( editor, { basePath : '/CKEditor_test/ckfinder/', rememberLastFolder : false } ) ;  
 

例3

 

当第一个参数为 null 时,CKFinder 可以与所有的 CKEditor 集成。

 

Js代码 复制代码  收藏代码
  1. CKFinder.setupCKEditor( null'/CKEditor_test/ckfinder/' );   
  2. var editor = CKEDITOR.replace( 'editor1' );  
 

可以在“_samples”文件夹中查看更多的例子。


在 CKEditor 中手工集成 CKFinder

 

首先需要再页面中引入 ckeditor.jsckfinder.js 文件。在创建 CKEditor 实例的时候,需要加入CKFinder 的配置。

 

Html代码 复制代码  收藏代码
  1. CKEDITOR.replace( 'editor1' ,   
  2. {   
  3.     filebrowserBrowseUrl : '/CKEditor_test/ckfinder/ckfinder.html',   
  4.     filebrowserImageBrowseUrl : '/CKEditor_test/ckfinder/ckfinder.html?type=Images',   
  5.     filebrowserFlashBrowseUrl : '/CKEditor_test/ckfinder/ckfinder.html?type=Flash',   
  6.     filebrowserUploadUrl : '/CKEditor_test/ckfinder/core/connector/java/connector.java?command=QuickUpload&type=Files',   
  7.     filebrowserImageUploadUrl : '/CKEditor_test/ckfinder/core/connector/java/connector.java?command=QuickUpload&type=Images',   
  8.     filebrowserFlashUploadUrl : '/CKEditor_test/ckfinder/core/connector/java/connector.java?command=QuickUpload&type=Flash',   
  9.     filebrowserWindowWidth : '1000',   
  10.     filebrowserWindowHeight : '700'   
  11. }          
  12. );  
CKEDITOR.replace( 'editor1' ,
{
	filebrowserBrowseUrl : '/CKEditor_test/ckfinder/ckfinder.html',
	filebrowserImageBrowseUrl : '/CKEditor_test/ckfinder/ckfinder.html?type=Images',
	filebrowserFlashBrowseUrl : '/CKEditor_test/ckfinder/ckfinder.html?type=Flash',
	filebrowserUploadUrl : '/CKEditor_test/ckfinder/core/connector/java/connector.java?command=QuickUpload&type=Files',
	filebrowserImageUploadUrl : '/CKEditor_test/ckfinder/core/connector/java/connector.java?command=QuickUpload&type=Images',
	filebrowserFlashUploadUrl : '/CKEditor_test/ckfinder/core/connector/java/connector.java?command=QuickUpload&type=Flash',
	filebrowserWindowWidth : '1000',
	filebrowserWindowHeight : '700'
}		
);
 

当在 CKEditor 的 “上传” 标签页直接向服务器上传文件时,需要设置 QuickUpload 指令参数。filebrowserUploadUrl 设置完毕后,可以为不同类型的资源设置指定的上传子文件夹。

 

Html代码 复制代码  收藏代码
  1. CKEDITOR.replace( 'editor1' ,   
  2. {   
  3.     filebrowserBrowseUrl : '/CKEditor_test/ckfinder/ckfinder.html',   
  4.     filebrowserImageBrowseUrl : '/CKEditor_test/ckfinder/ckfinder.html?type=Images',   
  5.     filebrowserFlashBrowseUrl : '/CKEditor_test/ckfinder/ckfinder.html?type=Flash',   
  6.     filebrowserUploadUrl : '/CKEditor_test/ckfinder/core/connector/java/connector.java?command=QuickUpload&type=Files<SPAN class=st0>&currentFolder=/archive/</SPAN>  
  7.   
  8.   
  9.   
  10. ',   
  11.     filebrowserImageUploadUrl : '/CKEditor_test/ckfinder/core/connector/java/connector.java?command=QuickUpload&type=Images<SPAN class=st0>&currentFolder=/cars/</SPAN>  
  12.   
  13.   
  14.   
  15. ',   
  16.     filebrowserFlashUploadUrl : '/CKEditor_test/ckfinder/core/connector/java/connector.java?command=QuickUpload&type=Flash',   
  17.     filebrowserWindowWidth : '1000',   
  18.     filebrowserWindowHeight : '700'   
  19. }          
  20. );  
CKEDITOR.replace( 'editor1' ,
{
	filebrowserBrowseUrl : '/CKEditor_test/ckfinder/ckfinder.html',
	filebrowserImageBrowseUrl : '/CKEditor_test/ckfinder/ckfinder.html?type=Images',
	filebrowserFlashBrowseUrl : '/CKEditor_test/ckfinder/ckfinder.html?type=Flash',
	filebrowserUploadUrl : '/CKEditor_test/ckfinder/core/connector/java/connector.java?command=QuickUpload&type=Files&currentFolder=/archive/



',
	filebrowserImageUploadUrl : '/CKEditor_test/ckfinder/core/connector/java/connector.java?command=QuickUpload&type=Images&currentFolder=/cars/



',
	filebrowserFlashUploadUrl : '/CKEditor_test/ckfinder/core/connector/java/connector.java?command=QuickUpload&type=Flash',
	filebrowserWindowWidth : '1000',
	filebrowserWindowHeight : '700'
}		
);

 

指定的子文件夹必须是服务器上已经存在的(如上例中 archivecars 文件夹)

  • 0
    点赞
  • 1
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值