Please update the README.txt file for the 6.0 version. In particular, there are references to paths that either no longer exist or have moved since the upgrade.

Comments

Dr Jay’s picture

Sorry, I'm a bufoon and was reading the wrong section for the paths. Documentation seems fine except the lingering reference to 5.x (which somebody else has already reported). Please close this support request.

bhavers’s picture

Hi,
As a newcomer to Drupal and the FCKeditor module i want to give you my view on it.
I found still some inconsistencies in the README.txt documentation and i think it could be improved a bit for people who are completely new. I've listed my suggestions below. FCKeditor seems to work fine, thanks for the good work!
I'm using:
Drupal 6.1
FCKeditor module 6.x-1.1-beta2
FCKeditor 2.5.1

README.TXT suggestions:
- Replace "Drupal 5.x" with "Drupal 5.x and 6.x"

If suggest to add:
- Step 1: unzip the files in the sites/all/modules directory. It should now contain a fckeditor directory.
- Step 2: Download FCKeditor from http://www.fckeditor.net/download, unzip the contents of the fckeditor directory in the fckeditor/fckeditor directory.

The following lines contain some incorrect labels:
- "2. Grant permissions for use of FCKeditor in Administer > User Management > Access Control" --> Access Control doesn't exist and needs to be "Permissions"
- "3. Under Administer > Settings > FCKeditor, create the fckeditor profiles. ". Settings doesn't exist and should be "Site configuration"
I suggest to improve the configuration instructions by listing concrete steps and have a measurable result at the end. Instead of saying "create the profiles" i would include an example, here's one:
- Edit the Advanced profile
- Under Basic setup --> select administrator user
- Under File browser settings --> set the Allow basic and advanced file management settings to true
- Save changes.

Add an extra step after the current step 3:
- Edit fckeditor\fckeditor\editor\filemanager\connectors\php\config.php
set: $Config['Enabled'] = true ;
- write down (or change) the value of $Config['UserFilesPath'] (which is probably '/userfiles/'), it's the path where uploaded files will be stored
- create the upload directory, for example /userfiles/ relative to the web directory (not to the drupal directory)
- give write permissions to the directory.

This is how you can test wether FCKeditor works correctly and you are able to upload images:
1. Create content and select Page
2. You should see the FCKeditor now instead of the plain text editor.
3. Select the insert/edit image icon in the FCKEditor
4. You should now see the "Image properties" popup window.
5. The third tab should be Upload. Give it a try.
Enabling uploading of images is not without security risks, please read the rest of this readme to see alternative solutions.

That's it, feel free to contact me if i can be of any help on this.

wwalc’s picture

Category: support » task

Your tips are very helpful.
I have included some of your suggestions in the new readme.txt (should be available in dev release tomorrow).

Regarding "I suggest to improve the configuration instructions by listing concrete steps and have a measurable result at the end.":
this is generally a good idea, but I have some doubts that it will make the included instruction much longer, thus harder to read.
Additionally, adding sample steps may cause that some users will follow blindly given examples.

However, as I wrote this is a very good idea to have an instruction for newcomers with complete examples.
Would you like to write the FCKeditor handbook? It could be listed here:
http://drupal.org/node/206739
(Here is some information on how such document should look like: http://drupal.org/about/authoring)

It would be great to have there as much useful information for other people as possible, so if anyone would like to join and write
something, I strongly encourage you to do it, feel invited!

wwalc’s picture

Status: Active » Fixed
Anonymous’s picture

Status: Fixed » Closed (fixed)

Automatically closed -- issue fixed for two weeks with no activity.