 readme contents of this file overview required components more information and license requirements installation configuration installation troubleshooting plugins teaser break and pagebreak plugins mediaembed plugins imce uploading images and files how to install ckfinder modules link to content experimental setting up filters upgrading instructions help contribution credits overview this module allows drupal to replace textarea fields with the ckeditor 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 ckeditor in drupal you will need to download the ckeditor http ckeditorcom more information and licence ckeditor the text editor for the internet copyright c 20032011 cksource frederico knabben all rights reserved licensed under the terms of the gnu lesser general public license http wwwopensourceorg licenses lgpllicensephp for further information visit http ckeditorcom http drupalckeditorcom requirements drupal 6x php 430 or greater ckeditor 31 or greater http ckeditorcom installation configuration note this instruction assumes that you install ckeditor in sites all modules directory recommended 1 unzip the files in the sites all modules directory it should now contain a ckeditor directory 2 download ckeditor from http ckeditorcom download unzip the contents of the ckeditor directory in the sites all modules ckeditor ckeditor or sites all libraries ckeditor directory note you can skip uploading samples and source folders 3 enable the module as usual from drupal s admin pages 4 grant permissions for use of ckeditor 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 ckeditor adjust the ckeditor profiles profiles determine what options are available to users based on systemwide roles in each profile you can choose which textareas will be replaced by ckeditor select default toolbar and configure some more advanced settings note user 1 must be assigned a system role that corresponds to the privileges required if no role is assigned to user 1 they will have the privileges of authenticated user 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  fore easier usage copying all tags are below in one line  if you re going to use ckeditor with filtered html input format please read also setting up filters section 7 to have a better control over line breaks you may disable line break converter in the chosen filter recommended 8 modify the ckeditorconfigjs file to custom your needs optional configuration options are available here http docscksourcecom ckeditorapi symbols ckeditorconfightml developers documentation for ckeditor http docscksourcecom ckeditor3x developersguide in ckeditorconfigjs 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 ckeditor does not show you must check if all files are extracted correctly the directory modules ckeditor ckeditor or libraries ckeditor should have the following files ckeditorjs configjs contentscss and directories skins themes lang images alternative directory can be sites all libraries ckeditor module automatically recognize proper path to editor libraries directory is default path when drush is used to download editor javascript the correct directory structure is as follows modules ckeditor ckeditormodule ckeditoradmininc ckeditor source images lang plugins skins themes copyheretxt ckeditorjs if you re still having problems scroll down to the help contribution section plugins teaser break and pagebreak by default ckeditor module comes with two plugins that can handle teaser break and pagebreak both plugins are automatically enabled 1 to add drupalbreak and drupalpagebreak buttons to the toolbar open sites all modules ckeditor ckeditorconfigjs and add them to the toolbar definition both buttons are enabled in drupalfiltered and drupalfull toolbars by default the drupalbreak button will automatically disappear from the toolbar on textareas where teaser cannot be created 2 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 if you don t install paging module the drupalpagebreak will automatically disappear plugins mediaembed mediaembed is a simple plugin that can be helpful when embedding youtube movies for example to enable it do the following 1 open drupal modules ckeditor ckeditorconfigjs 2 uncomment the following lines remove in ckeditorconfigjs configextraplugins configextraplugins mediaembed mediaembed ckeditorpluginsaddexternal mediaembed drupalsettingsckeditormodulepath plugins mediaembed 3 add button to the toolbar the button name is mediaembed for example if you have a toolbar with an array of buttons defined as follows link unlink anchor simply add button at the end of array or somewhere in the middle link unlink mediaembed anchor remember about single quotes plugins imce ckeditor comes with an imce plugin that adds a button to the toolbar that opens imce in a new window this might be helpful if you want to avoid having to open the image dialog and then clicking the browse server button and instead open imce with a single click to enable it do the following 1 open drupal modules ckeditor ckeditorconfigjs 2 uncomment the following lines remove in ckeditorconfigjs configextraplugins configextraplugins imce imce ckeditorpluginsaddexternal imce drupalsettingsckeditormodulepath plugins imce 3 add button to the toolbar the button name is imce for example if you have a toolbar with an array of buttons defined as follows link image simply add button at the end of array or somewhere in the middle link image imce remember about single quotes uploading images and files there are three ways of uploading files by using commercial file browser like ckfinder http ckfindercom by using modules like imce webfm image browser or by using the core upload module to select preferred file browser under administer site configuration ckeditor adjust ckeditor profiles in each profile you can choose which file browser will be used in file browser settings section note to choose imce webfm or image browser you should install an appropriate drupal module first how to install ckfinder ckfinder is an ajax based file manager created by ckeditor developers http ckfindercom 1 download ckfinder for php http ckfindercom download 2 unpack ckfinder to the directory with the ckeditor module into sites all modules ckeditor ckfinder the correct directory structure is as follows modules ckeditor ckeditormodule ckeditoradmininc ckfinder core ckfinderphp configphp ckeditor source images ckeditorjs 3 grant allow ckfinder file uploads permission in administer user management permissions note if you don t see such permission then it means that ckeditor didn t find ckfinder and you have probably uploaded ckfinder into wrong directory 4 open ckfinder configuration file sites all modules ckeditor ckfinder configphp and do the following i remove the checkauthentication function don t worry this function is defined in filemanagerconfigphp see below function checkauthentication  