README.txt in FCKeditor - WYSIWYG HTML editor 5

Overview
--------
This module allows Drupal to replace textarea fields with the
FCKeditor.
This HTML text editor brings many of the powerful functions of known
desktop editors like Word to the web. It's relatively lightweight and
doesn't require any kind of installation on the client computer.

Compatibility
-------------
The integrated File Browser needs a bit of manual configuration,
more information about this in the included in this readme.txt file

Required components
-------------------
To use FCKeditor in Drupal, you will need to download the FCKeditor
http://www.fckeditor.net/

More information and licence
----------------------------
FCKeditor - The text editor for internet
Copyright (C) 2003-2006 Frederico Caldeira Knabben

Licensed under the terms of the GNU Lesser General Public License:
    http://www.opensource.org/licenses/lgpl-license.php

For further information visit:
    http://www.fckeditor.net/

Requirements
------------
  - Drupal 5.x
  - PHP 4.3.0 or greater
  - FCKeditor 2.3.x (http://www.fckeditor.net/)

Installation
------------
  1. Copy the module fckeditor folder to modules/.
  2. Download FCKeditor 2.x from http://www.fckeditor.net and copy
     the distribution files (the contents of the "fckeditor" directory
     from the FCKeditor distribution file) to
     modules/fckeditor/fckeditor.
     
     A quick check to see if it is correct: the files 'COPY_HERE.txt',
     'fckconfig.js' and also the directory 'editor' must exist in the
     same directory,
     
  3. See 'How to enable the File Browser' for additional instructions.

     Also read the security note in this readme

     Alternatives to the built-in file browser are the IMCE module and
     copying the image url into the url textfield.

Configuration
-------------
  1. Modify the fckeditor.config.js file to customize the toolbars to
     your needs (optional).

     You may also copy the needed configuration lines from the default
     FCKeditor configuration settings
     (modules/fckeditor/fckeditor/fckconfig.js), the lines in
     fckeditor.config.js will override most settings.

     It is not advised to change the default toolbars in the
     configuration settings (modules/fckeditor/fckeditor/fckconfig.js)
     because those are included in the FCKeditor package and might
     change without notice when you update the editor.
  
  2. Enable the module as usual from Drupal's admin pages.
  
  3. Under Administer > Settings > FCKeditor, configure the fckeditor
     settings. You can choose which textareas will be replaced by
     FCKeditor, choose the toolbars and configure some more advanced
     settings.

  4. Grant permissions for use of FCKeditor in
     Administer > User Management > Access Control (You only need to
     select either basic or advanced editor for each role that is
     allowed to use the FCKeditor because the advanced will override
     the basic permission)

  5. For the Rich Text Editing to work you also need to configure your
     filters for the users that may access Rich Text Editing. Either
     grant those users Full HTML access or use the following:
      <a> <em> <strong> <small> <sup> <sub> <cite> <blockquote> <code>
      <ul> <ol> <li> <dl> <dt> <dd> <h2> <h3> <h4> <img> <br> <br />
      <p> <div> <span> <b> <i>
     Users that need access to tables might be better of using
     Full HTML

How to enable the File Browser (in FCKeditor 2.3.x)
---------------------------------------------------
The editor gives the end user the flexibility to create a custom file
browser that can be integrated on it. The included file browser allows
users to view the content of a specific directory on the server and
add new content to that directory (create folders and upload files).

To enable the file browser you need to edit the connector
configuration file in your fckeditor module directory, the file should
be in:
/modules/fckeditor/fckeditor/editor/filemanager/browser/default/connectors/php/config.php
and
/modules/fckeditor/fckeditor/editor/filemanager/upload/php/config.php

In this file you will need to enable the file browser:
  $Config['Enabled'] = true ;

To use the drupal files directory you also need to comment out or
remove the following line in the connector configuration:
  $Config['UserFilesPath'] = '/UserFiles/' ;
You may also edit this line to reflect a custom upload path.

Furthermore, you will need to create a "File", "Image", "Flash" and
"Media" subdirectory in your drupal files directory. These directories
must have the same privileges as the drupal files directory. In some
cases these directories must be world writable (chmod 0777).

Security
--------
Note that enabling file uploads is a security risk. That's why there
is a separate permission in Administer > Access Control for enabling
the file browser to certain groups.

Credits
-------
 - FCKeditor for Drupal Core functionality originally written by:
     Frederico Caldeira Knabben
     Jorge Tite (LatPro Inc.)

 - FCKeditor for Drupal 5.x
     Ontwerpwerk (www.ontwerpwerk.nl)

 - FCKeditor - The text editor for internet
     Copyright (C) 2003-2006 Frederico Caldeira Knabben
     http://www.fckeditor.net/