 readme  id readmetxt v 11625217 20100130 183328 jorrit exp contents of this file overview required components more information and licence requirements configuration installation troubleshooting plugins teaser break and pagebreak uploading images and files how to enable the builtin file browser modules image assist modules link to content experimental upgrading instructions help contribution credits 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 required components to use fckeditor in drupal you will need to download the fckeditor http ckeditorcom download make sure you download fckeditor not ckeditor if you would like to use ckeditor with drupal please visit http drupalorg project ckeditor more information and licence fckeditor the text editor for internet copyright c 20032008 frederico caldeira knabben licensed under the terms of the gnu lesser general public license http wwwopensourceorg licenses lgpllicensephp for further information visit http ckeditorcom http drupalfckeditornet requirements drupal 6x php 430 or greater fckeditor 25x or greater download fckeditor not ckeditor from http ckeditorcom download configuration note this instruction assumes that you install fckeditor in sites all modules directory recommended 1 unzip the files in the sites all modules directory it should now contain a fckeditor directory 2 download fckeditor from http ckeditorcom download unzip the contents of the fckeditor directory in the sites all modules fckeditor fckeditor directory 3 enable the module as usual from drupal s admin pages 4 grant permissions for use of fckeditor in administer user management permissions note to enable the file browser read also the how to enable the file browser section 5 under administer site configuration fckeditor adjust the fckeditor profiles in each profile you can choose which textareas will be replaced by fckeditor select default toolbar and configure some more advanced settings 6 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 tags   7 to have a better control over line breaks you may disable line break converter in the chosen filter recommended 8 modify the fckeditorconfigjs file to custom your needs optional you may copy the needed configuration lines from the default fckeditor configuration settings sites all modules fckeditor fckeditor fckconfigjs the lines in fckeditorconfigjs will override most settings in fckeditorconfigjs you may define your own toolbars with selected buttons warning clear browser s cache after you modify any of the javascript files if you don t do this you may notice that browser is ignoring all your changes installation troubleshooting if your fckeditor does not show you must check if all files are extracted correctly the directory sites all modules fckeditor fckeditor should have the following files fckeditorjs fckconfigjs fckstylesxml fcktemplatesxml fckeditorphp fckeditorphp4php fckeditorphp5php and a directory named editor the correct directory structure is as follows modules fckeditor fckeditormodule fckeditor samples editor copyheretxt fckconfigjs if you re still having problems scroll down to the help contribution section plugins teaser break and pagebreak by default fckeditor module comes with two plugins that can handle teaser break and pagebreak you can enable any or even both of them 1 open sites all modules fckeditor fckeditorconfigjs and uncomment these three lines fckconfigpluginspath plugins fckconfigpluginsadd drupalbreak fckconfigpluginsadd drupalpagebreak 2 the second step is to add buttons to the toolbar in the same file the button names are drupalbreak drupalpagebreak for example if you have a toolbar with an array of buttons defined as follows image flash table rule specialchar simply add those two buttons at the end of array image flash table rule specialchar drupalbreak drupalpagebreak remember about single quotes 3 note that the tag is not supported by default in drupal you should install the paging module http drupalorg project paging to enable the tag support please refer to the paging module documentation for detailed installation instructions uploading images and files there are three ways of uploading files by using the builtin file browser by using modules like imce image browser or by using the core upload module how to enable the builtin file browser 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 1 to enable file browsing you need to edit the connector configuration file in your fckeditor module directory the file should be in sites all modules fckeditor fckeditor editor filemanager connectors php configphp in this file s you will need to enable the file browser by adding one line that includes file with the special authentication function for drupal filemanagerconfigphp add this code requireonce filemanagerconfigphp straight below this line config userfilesabsolutepath the configphp file also holds some other important settings please take a look at it and adjust it to your needs optional 2 locate file named settingsphp inside your drupal directory usually sites default settingsphp and set cookiedomain variable to the appropriate domain remember to uncomment that line if you not do this fckeditor will claim that file browser is disabled 3 enabling file uploads is a security risk that s why you have to grant a separate permission to enable the file browser to certain groups in administer user management permissions assign the allow fckeditor file uploads permissions 4 lastly adjust the file browser settings for each profile set file browser type to builtin filebrowser modules image assist image assist version 1 and 2 can be integrated with fckeditor it is no longer necessary to copy a javascript file modules link to content experimental link to content module can be integrated with fckeditor attention this module is not yet compatible with fckeditor the unofficial version of link to content module compatible with fckeditor can be downloaded here http drupalfckeditornet download linktocontentfckeditor6x2xdevzip installation follow the instruction from installtxt attached to the linktocontent module then do the following steps to add linktocontent button to the fckeditor toolbar by default fckeditor module comes with two plugins that allows you to use linktocontent and linktonode features you can enable any or even both of them 1 open drupal modules fckeditor fckeditorconfigjs and uncomment these three lines fckconfigpluginspath plugins fckconfigpluginsadd linktonode en pl fckconfigpluginsadd linktomenu en pl 2 the second step is to add buttons to the toolbar in the same file the button names are linktonode linktomenu for example if you have a toolbar with an array of buttons defined as follows link unlink anchor simply add those two buttons at the end of array or somewhere in the middle link unlink linktonode linktomenu anchor remember about single quotes upgrading instructions this instruction assumes that you are upgrading fckeditor module m and fckeditor the editor e at the same time instructions specific for module upgrades are tagged with m steps that must be taken when upgrading fckeditor the editor are marked with e 1 m download the latest version of fckeditor module from http drupalorg project fckeditor it is advised to read release notes before going further 2 e download the latest version of fckeditor from http ckeditorcom download it is advised to read what s new before going further http ckeditorcom whatsnew 3 m back up your database 4 em place the site in offline mode to let the database updates run without interruption and avoid displaying errors to end users of the site 5 e if you have used the fckeditor builtin file browser make a backup of sites all modules fckeditor fckeditor editor filemanager connectors php configphp 6 e if you have configured spellchecker make a backup of sites all modules fckeditor fckeditor editor dialog fckspellerpages spellerpages serverscripts spellcheckerphp 7 e if you have made any changes inside of sites all modules fckeditor fckeditorconfigjs or sites all modules fckeditor fckeditor fckconfigjs write down your changes and add them again after uploading new files eg own toolbar definitions reenable a plugin etc try to not make any changes to fckconfigjs and add everything to fckeditorconfigjs 8 delete old files em simply remove modules fckeditor directory if upgrading both the editor and the module m if you are upgrading module only remember to leave the modules fckeditor fckeditor directory e when upgrading the editor remove contents of modules fckeditor fckeditor directory only warning if you don t remove old files and just rename fckeditor directory instead eg to fckeditorold drupal may use module from the fckeditorold directory 9 m upload fckeditor module extracted files and folders to sites all modules directory 10 e upload fckeditor extracted files and folders from the fckeditor directory to sites modules fckeditor fckeditor ie where copy heretxt file exists 11 e replace the new configphp see step 5 file with the old one or recommended way perform again step with adding requireonce filemanagerconfigphp to configphp 12 e replace the new spellcheckerphp with the old one see step 6 or recommended way configure new spellcheckerphp following the settings from the old file 13 e apply your modifications to default configuration in fckeditorconfigjs file see step 7 14 m if you re using image assist module copy the new imgassistfckeditorjs to modules imgassist folder 15 m run updatephp 16 em put the site back online help contribution if you are looking for more information have any troubles in configuration or if you found an issue please visit the official project page http drupalorg project fckeditor having problems take a look at list of common problems when installing fckeditor http drupalfckeditornet troubleshooting how to tune up fckeditor to your theme and configure spell checker http drupalfckeditornet tricks we would like to encourage you to join our team if you can help in any way if you can translate fckeditor module please use fckeditorpot file as a template located in translations directory and send us the translated file so that we could attach it any help is appreciated credits fckeditor for drupal core functionality originally written by frederico caldeira knabben jorge tite latpro inc fckeditor for drupal 5x originally written by ontwerpwerk wwwontwerpwerknl fckeditor for drupal 6x is currently maintained by cksource team and jorrit schippers http cksourcecom fckeditor the text editor for internet copyright c 20032009 frederico caldeira knabben http ckeditorcom  