2. How can I integrate the editor into the
SAKAI system?
The installation is very simple and does
not require even a single line of code on your side and consists of
simply replacing the FCKEditor files with the ones here provided. Follow
the steps bellow:
1) Note: This latest package has been tested against the 2.5.4 Sakai
build, but it could be working also with previous releases. If you want
to be sure it will be working out of the box simply install the latest
Sakai 2.5.4 demo and use it for testing.
2) To replace the FCKEditor with the Sferyx HTMLEditor Applet you will
need simply to replace the editor folder into the running instance of
Sakai with the files here attached,
so rename
the existing "sakai-install/webapps/library/editor/FCKeditor" to "sakai-install/webapps/library/editor/FCKeditor-original"
or something similar in order to keep the original files.
where "sakai-install" - is the root Sakai installation folder.
Now, create new FCKeditor folder on the same place and unzip the
attached files there so it becomes
"sakai-install/webapps/library/editor/FCKeditor/HTMLEditorAppletPro.jar"
"sakai-install/webapps/library/editor/FCKeditor/fckeditor.js"
"sakai-install/webapps/library/editor/FCKeditor/sakai_fckconfig.js"
That's all - there is even no need to restart the Sakai instance -
simply make sure to reload the page shown in your browser and the
iframes inside as it may be showing a cached copy.
3. How to configure the file uploads for the
Sferyx JSyndrome HTML Editor Applet Edition within the SAKAI system?
Note on the file Uploads:
There is only one note to observe - everything will be working as
expected including the file uploads from inside the editor- the only
limitation currently is that the original Sakai
org.sakaiproject.connector.fck.FCKConnector accepts only one file at a
time as this is the capability of the FCKEditor itself, while the Sferyx
HTMLEditor Applet does not have limitations on the number of the
uploaded files and can upload anything, simply currently only one file
will be written down by the FCKConnector although all of them are
actually received by the server. This can be easily changed by simply
modifying the FCKConnector to accept multiple files and it is ready or
install and use the Sferyx's SferyxUploadConnector. No need to
modify or configure the Sferyx HTMLEditor Applet further.
To install the SferyxUploadConnector you
will need to copy the class file into your Sakai installation at the
following location:
"sakai-install/webapps/sakai-fck-connector/WEB-INF/classes/org/sakaiproject/connector/sferyx/SferyxUploadConnector.class"
where "sakai-install" - is the root Sakai installation folder.
The full classname of the connector is
org.sakaiproject.connector.sferyx.SferyxUploadConnector and you will
need to modify the web.xml file in order to add the servlet entry for
the SferyxUploadConnector. The file in question is:
"sakai-install/webapps/sakai-fck-connector/WEB-INF/web.xml"
You need to add (simply copy&paste) the following lines to
it:
<filter-mapping>
<filter-name>sakai.request</filter-name>
<servlet-name>SferyxUploadConnector</servlet-name>
<dispatcher>REQUEST</dispatcher>
<dispatcher>FORWARD</dispatcher>
<dispatcher>INCLUDE</dispatcher>
</filter-mapping>
<servlet>
<servlet-name>SferyxUploadConnector</servlet-name>
<servlet-class>org.sakaiproject.connector.sferyx.SferyxUploadConnector</servlet-class>
<load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>SferyxUploadConnector</servlet-name>
<url-pattern>/SferyxUpload/*</url-pattern>
</servlet-mapping>
After doing this you are ready and you
will need either to reload the /sakai-fck-connector application from the
Tomcat manager or to restart the Sakai instance.
4. How to enable the Sferyx JSyndrome
HTMLEditor Applet within the Melete Lesson Builder for SAKAI?
The
Melete Lesson
Builder comes already with integration package for Sferyx by
default, you can enable it directly from the user preferences menu.
There is no need to do anything else, it will work out of the box.
5. What advantages could bring the
integration of the Sferyx HTMLEditor Applet, Equation Editor and
PDFExport into the SAKAI system?
In first place this way out of the box
there are delivered both advanced HTML and Equation editing capabilities for the
entire system combined with instant PDF generation capability.
Furthermore, the Sferyx HTMLEditor is capable of publishing many files
simultaneously which is very useful when for example is pasted a Word
document which contains many images and other external linked files.
This way only by submitting the form everything is sent to the server
and the entire document is published within seconds without the need the
user uploads all files separately, renaming them and linking them back
to the document. All this is done automatically by Sferyx, also it is
capable of generating unique image filenames in order to avoid name
collisions. This saves a lot of work both for the users and the
developers and gets the work done within seconds and if you add to the
whole this thing also the PDFExport it can generate on-the-fly PDF files
from the documents and publish them together with the HTML to the
server.
