Configuration of FCKEditor 2.6.

Table of Contents
Enable Image Upload for PHP.............................................................................................................2
Change Skins of FCKEditor.................................................................................................................3
Available Skins................................................................................................................................3
Skin Configuration...........................................................................................................................3
Customization of the toolbar................................................................................................................4
Available Buttons for Toolbar..........................................................................................................4
Defining custom toolbars.................................................................................................................4
Using custom toolbars in Testlink....................................................................................................4
Spellchecker with Spellerpages (aspell) ..............................................................................................5
Activation of SpellerPages...............................................................................................................5
Spellchecker on Windows Server....................................................................................................5
Spellchecker on Linux Server..........................................................................................................5
Add SpellChecker button to toolbar................................................................................................5
Definition of Templates........................................................................................................................6
XML-structure to create templates..................................................................................................6
"Preview-images" for templates......................................................................................................6
Add templates button to toolbar.......................................................................................................6
Enable CKFinder instead of the built-in Filemanger of FCKEditor....................................................7
What is CKFinder?..........................................................................................................................7
Features............................................................................................................................................7
Download CKFinder........................................................................................................................7
License.............................................................................................................................................7
Install CKFinder..............................................................................................................................7
Enable CKFinder.............................................................................................................................8

Enable Image Upload for PHP

Notice:CKFinder is a great alternative to the built-in filemanager of FCKEditor. CKFinder allows
users to delete, update and rename files. For how to install the CKFinder read "Enable
CKFinder instead of the built-in Filemanger of FCKEditor" in this document.
Open the file FCKEditor/fckconfig.js
Set:

var _FileBrowserLanguage = 'php' ;

var _QuickUploadLanguage = 'php' ;

Open FCKeditor/editor/filemanager/connectors/php/config.php
Replace
$Config['Enabled'] = true ;

by

$Config['Enabled'] = checkUpload();
function checkUpload()
{
session_start();
return (isset($_SESSION['currentUser']));
}

Make sure that the given 'UserFilesPath' folder exists on the server and has write permission.
$Config['UserFilesPath'] = '/UserFiles/' ;

For TestLink we suggest:

$Config['UserFilesPath']='<TL_HOME>/upload_area/fckeditor_upload_area
/';

Replace line:

$Config['UserFilesAbsolutePath'] = '' ;

by
//$Config['UserFilesAbsolutePath'] = '' ;

Open cfg/tl_fckeditor_config.js
Set:
FCKConfig.LinkBrowser = true;
FCKConfig.ImageBrowser = true;
FCKConfig.FlashBrowser = true;

and

FCKConfig.LinkUpload = true;
FCKConfig.ImageUpload = true;
FCKConfig.FlashUpload = true;

if you want to allow Quickupload, which could result in many unsorted uploads.

Change Skins of FCKEditor

Available Skins

default

office2003

silver

Skin Configuration
Open cfg/tl_fckeditor_config.js
Search for:
FCKConfig.SkinPath = FCKConfig.BasePath + 'skins/default/';

Comment this line and uncomment the line that contains the skin you chose.
office2003

FCKConfig.SkinPath = FCKConfig.BasePath + 'skins/office2003/';

silver
FCKConfig.SkinPath = FCKConfig.BasePath + 'skins/silver/';

If you want to stick with the default skin do not make a change.

Customization of the toolbar

Available Buttons for Toolbar

Source

DocProps

Save

NewPage

Preview

Cut

Copy

Paste

PasteText

PasteWord

Print

SpellCheck

Undo

Redo

Find

Replace

SelectAll

RemoveFormat

Form

Checkbox

Radio

TextField

Textarea

Select

Button

ImageButton

HiddenField

Bold

Italic

Underline

StrikeThrough

Subscript

Superscript

OrderedList

UnorderedList

Outdent

Indent

Blockquote

CreateDiv

JustifyLeft

JustifyCenter

JustifyRight

JustifyFull

Link

Unlink

Anchor

Image

Flash

Table

Rule

Smiley

SpecialChar

Style

FontFormat

FontName

PageBreak

FontSize

TextColor

BGColor

FitWindow

ShowBlocks

About

Defining custom toolbars

Open cfg/tl_fckeditor_config.js
Here you can create new ToolbarSets.
Special characters:
'-' creates a seperator in the toolbar.
'/' creates a new "toolbarline"

Using custom toolbars in Testlink

Open custom_config.inc.php
Configure text_editor for each area in testlink ... [see "config.inc.php"]

Spellchecker with Spellerpages (aspell)

Activation of SpellerPages
Open third_party/fckeditor/fckconfig.js
Replace line:

FCKConfig.SpellChecker = 'WSC';

by
FCKConfig.SpellChecker = 'SpellerPages';

Spellchecker on Windows Server

Download aspell from http://aspell.net/win32/ and install.
Open third_party/fckeditor/editor/fck_spellerpages/spellerpages/server-scripts/spellchecker.php
Set
$aspell_prog

= '"C:\Program Files\Aspell\bin\aspell.exe"';

according to the path where you installed aspell.

Set

$lang = 'en_US';

to the required language (e.g. de_DE). Language packs have to be installed!

Spellchecker on Linux Server

Download and install aspell via the packagemanger.
Open third_party/fckeditor/editor/fck_spellerpages/spellerpages/server-scripts/spellchecker.php
Replace line:
//$aspell_prog

= 'aspell';

by
$aspell_prog

= '/usr/bin/aspell';

Replace line:
$aspell_prog

by

//$aspell_prog

= '"C:\Program Files\Aspell\bin\aspell.exe"';
= '"C:\Program Files\Aspell\bin\aspell.exe"';

Set
$lang = 'en_US';

to the required language (e.g. de_DE). Language packs have to be installed!

Add SpellChecker button to toolbar

insert 'SpellCheck' into your ToolbarSet (read "Customization of the Toolbar" in this document)

Definition of Templates
Open third_party/fckeditor/fcktemplates.xml

XML-structure to create templates

<Template title="title" image="image.gif">
<Description> description </Description>
<Html>
<![CDATA[
html-code
]]>
</Html>
</Template>

Special characters in xml

Those special characters must be in xml-format in order to display correct. You may need those
characters for the title and description in the template.
&

&amp;

'

&apos;

<

&lt;

>

&gt;

"

&quot;

&#196;

&#214;

&#220;

&#228;

&#246;

&#252;

&#223;

"Preview-images" for templates

Open third_party/fckeditor/editor/dialog/fck_template/images
Here you can put all the images you want to use for templates. The image to be used is specified in
fcktemplates.xml.

Add templates button to toolbar

insert 'Templates' into your ToolbarSet (read "Customization of the Toolbar" in this document)

Enable CKFinder instead of the built-in Filemanger of

FCKEditor

What is CKFinder?
"CKFinder is a powerful and easy to use Ajax file manager for web browsers. Its simple interface
makes it intuitive and quick to learn for all kinds of users, from advanced professionals to Internet
beginners."

Features

Folders tree navigation: intuitive for all users.

Quality image thumbnails, making it quick to find things.
Multi-language support with automatic user language detection.
Sensitive context menus for files and folders.
Full user control: create, rename and delete folders and files.
Full developer control: all features can be precisely configured with a powerful ACL and
user roles system.
Lightweight interface.
No page refreshes: quick responses.
Secure file uploads: all uploaded files are checked according to the rules set by the
developer.
Full source code included for the server side integration.
Instant integration with FCKeditor and CKEditor

Download CKFinder
You can download CKFinder for PHP here:
http://ckfinder.com/download

License
You can find the full license here: http://ckfinder.com/license
If you did not pay for a license, you may use unlicensed copies of CKFinder for the exclusive
purpose of demonstration. In this case you will be using CKFinder in "demo mode". Without
derogating from the forgoing, you may not use CKFinder in "demo mode" for commercial purposes.
CKFinder shall be used only for evaluation purposes and may not be used or disclosed for any
other purposes, including without limitation, external distribution or software development. You
may not remove demo notices from the interface nor disable the ability to display such notices or
otherwise modify CKFinder. Product support is not offered for CKFinder in "demo mode". [excerpt
from ckfinder license]

Install CKFinder
Copy ckfinder to <TLHOME>/third_party

Enable CKFinder
Open cfg/tl_fckeditor_config.js
uncomment those lines:
FCKConfig.LinkBrowserURL = '../../../ckfinder/ckfinder.html' ;
FCKConfig.ImageBrowserURL = '../../../ckfinder/ckfinder.html?type=Images'
;
FCKConfig.FlashBrowserURL = '../../../ckfinder/ckfinder.html?
type=Flash' ;
FCKConfig.LinkUploadURL =
'../../../ckfinder/core/connector/php/connector.php?
command=QuickUpload&type=Files' ;
FCKConfig.ImageUploadURL =
'../../../ckfinder/core/connector/php/connector.php?
command=QuickUpload&type=Images' ;
FCKConfig.FlashUploadURL =
'../../../ckfinder/core/connector/php/connector.php?
command=QuickUpload&type=Flash' ;

Open third_party/ckfinder/config.php
In the function CheckAuthentication() you must implement some kind of session validation. If not
EVERYONE is allowed to upload,delete or rename Images.
For testing purpose, replace:
return false;

by

session_start();
return (isset($_SESSION['currentUser']));

The baseurl tells ckinfder where to store files on your fileserver. Make sure that the given 'baseUrl'
folder exists in the server and has write permission.
We suggest:
$baseUrl = '<TLHOME>/upload_area/fckeditor_upload_area/';
Open cfg/tl_fckeditor_config.js
Set:
FCKConfig.LinkBrowser = true;
FCKConfig.ImageBrowser = true;
FCKConfig.FlashBrowser = true;

and

FCKConfig.LinkUpload = true;
FCKConfig.ImageUpload = true;
FCKConfig.FlashUpload = true;

if you want to allow Quickupload, which could result in many unsorted uploads.