-------------------------------------------------
	FCKEditor 2.0b - JSP Integration Pack
-------------------------------------------------


---------------
Contents:
---------------

1 - Preface
2 - Installation
3 - Usage
4 - Building
5 - Future plans
6 - Further information and support

--------------------
1 - Preface
--------------------

This is the JSP Integration Pack for using FCKeditor inside a java server page without
the complexity of using a Java scriptlets or the javascript api.
I hope you find it usefull.



--------------------
2 - Installation
--------------------

Installing FCKeditor in a JSP environment is quite easy:
 - First install the FCKeditor as described in the _documentation/Using FCKeditor/Javascript.html file
 - Copy the files in the _jsp/dist directory in the WEB-INF dir of your web application
   (the jar file in WEB-INF/lib and the tld in WEB_INF/)
 - Add in your web.xml the following servlet configuration:

	<servlet>
		<servlet-name>Connector</servlet-name>
		<servlet-class>com.fredck.FCKeditor.connector.ConnectorServlet</servlet-class>
		<init-param>
			<param-name>baseDir</param-name>
			<param-value>/UserFiles/</param-value>
		</init-param>
		<load-on-startup>1</load-on-startup>
	</servlet>
	
	<servlet-mapping>
		<servlet-name>Connector</servlet-name>
		<url-pattern>/editor/filemanager/browser/default/connectors/jsp/connector</url-pattern>
	</servlet-mapping>

 - Put in the FCKconfig.js the following configuration:

	FCKConfig.LinkBrowserURL = FCKConfig.BasePath + "filemanager/browser/default/browser.html?Connector=connectors/jsp/connector";

 - Now you can start using the _samples/jsp/sample01.jsp and _samples/jsp/sample02_tag.jsp to test the JSP integration



--------------------
3 - Usage
--------------------

Take a look at the test files and in the javadoc api provided in the distribution.
Anyway, for the lazy ones, here is a simple example

First put this taglib definiton at the top of the JSP page
<%@ taglib uri="/WEB-INF/FCKeditor.tld" prefix="FCK" %>

then the tag:

	<FCK:editor
		id="EditorAccessibility"	//Unique name of the editor
		width="80%"			//Width
		height="120"			//Height
		toolbarSet="Accessibility"	//Toolbar name
	>This is another test. <BR><B>The "Second" row.</B></FCK:editor>

A more advance example, that show how to use the inner tags to overrides any of the settings specified in
the config.js file

	<FCK:editor id="EditorDefault" basePath="/FCKeditor/">
		<FCK:config name="StyleNames" value="Style 1;Style 2; Style 3" />
		<FCK:config name="FontNames" value="Arial;Courier New;Times New Roman;Verdana" />
		This is some <B>sample text</B>.
	</FCK:editor>


--------------------
4 - Building
--------------------

Inside the _jsp directory there are the source files for the tags (_jsp/src) and the ant build file (build.xml)

The ant build file provides the following tasks:
 - all: Clean build and dist directories, then compile
 - clean: Delete old build and dist directories
 - compile: Compile Java sources
 - dist: Create binary distribution
 - javadoc: Create Javadoc API documentation
 - release: Create Release Distribution

To start building the class you first need to modify the "catalina.home" property inside the build.xml,
then type "ant dist" to compile, create the javadoc API description and generate the jar library to be copied in the WEB-INF


--------------------
5 - Future plans
--------------------

 * Provide the ability to pass a Map of advanced configuration instead of using the inner tags
 * Integrate with Struts (so that FCKeditor can retrive and pass informations from Form Beans)



--------------------
6 - Further informations and support
--------------------

For further informations refers to http://www.fckeditor.net/
For support specific with this JSP integration taglib send an email to simo@users.sourceforge.net