=================================== EXTENSION INSTALLATION INSTRUCTIONS =================================== Initial release of FCKeditor extension. I have disabled some advance features, like image upload etc, so your users won't start uploading pile of junk on your forum. Install: -------- Before installing make sure you have disabled all other editors, like Dojo and Tinymce. If you used to use a HTMLformatter/Markdown/Textile/BBCode, then leave them enabled. If you now install and enable FCKeditor after them, then all old posts will continue to use the old formatter, and new ones will use FCKeditor. There are two files to be downloaded. one is the extension that you just downloaded and one if the FCKeditor files which need to be downloaded from (http://www.fckeditor.net/download/) In order for Vanilla to recognize an extension, it must be contained within it's own directory within the extensions directory. So, once you have downloaded and unzipped the extension files, you can then place the folder containing the default.php file into your installation of Vanilla. The path to your extension's default.php file should look like this: 1) /path/to/vanilla/extensions/FCKeditor/default.php 2) Download FCKeditor from (http://www.fckeditor.net/download/) 3) unzip it in /path/to/vanilla/js/FCKeditor/ the path to fckconfig.js should look like this: /path/to/vanilla/js/FCKeditor/fckconfig.js 4) Copy the included Video folder to /js/FCKeditor/editor/plugins/ that will enable the embedding of youtube and google video FCkeditor comes with lot of files that you don't need. All folders starting with an underscore can be removed. Once this is complete, you can enable the extension through the "Manage Extensions" form on the settings tab in Vanilla. Customization: -------------- The extension comes with some neat skins to use. Uncomment the ones you like from config.js file if u are using Add Comments Extension set this to false in default.php $Configuration["FCKEDITOR_LOGINREQUIRED"] = true; You use the build in preview button or use the use Preview Post plugin (http://lussumo.com/addons/?PostBackAction=AddOn&AddOnID=84) You will have to make some changes to preview post to make it work with fckeditor. Its a very simple patch mentioned here (http://lussumo.com/community/discussion/3989/conflict-between-fckeditor-and-preview-post-21/#Item_3) You can customize which buttons appear on the toolbar. The file to edit is called config.js in your /path/to/vanilla/extensions/FCKeditor/config.js. Change only this file, don't touch the original configuration files that come with FCKeditor package. There are lot of buttons you can enable, but i advice you to keep it clean and simple and only provide the essentials. If you really do need to provide more functions you will have to read FCKeditor documentation (http://wiki.fckeditor.net/Developer%27s_Guide/Configuration/Toolbar) Attachments: ------------- Its best if u use the Attachments Extension by Jazzman, cause users can upload only in their own folders. BUt if Attacments ins't working for you this is a good alternative. You can allow your users to upload images or flash file etc and attach them to comments. It requires a bit of work, and it works so so, if you do it correctly 1) First by default all upload capabilities are disabled, So open up config.js and change ImageUpload and ImageBrowser to true, like below. FCKConfig.ImageUpload = true ; FCKConfig.ImageBrowser = true ;// Not recommended to allow browsing of ur server. it is really dangerous. 2) Next open up fckconfig.js, its in /js/fckeditor/ folder. Change line 179 and 180 to this var _FileBrowserLanguage = 'php' ; var _QuickUploadLanguage = 'php' ; 3) Uploading file. open up config.php file which lies in the /js/fckeditor/editor/filemanager/upload/php/. This is where you configure your paths and which files to upload. There are 3-4 lines you have to edit $Config['Enabled'] = true ; $Config['UserFilesPath'] = '/vanilla/uploads/' ; //same folder as Atachment extension. If you want to use absolute path, then change this line to the the upload directory $Config['UserFilesAbsolutePath'] = '' ; If you want Different folder for different type of content, for eg, an image goes in the image directory. then change this $Config['UseFileType'] = true ; 4) Optional, NOT RECOMMENDED, You do not want ur users checking out what others have uploaded. you do not want users browsing your server. Browsing file. Open up config.php file which lies in the /js/fckeditor/editor/filemanager/browser/default/connectors/php/. This is where you configure all your paths, and which file to browse. There are 2-3 lines you have to edit $Config['Enabled'] = true ; $Config['UserFilesPath'] = '/vanilla/uploads/' ; If you want to use absolute path, then change this line to the the upload directory $Config['UserFilesAbsolutePath'] = '' ; All done now fire up the editor. click on "Insert/Edit Image" button and select upload then browse to see if it works. Support: -------- For Support and Bug report go to his URL http://lussumo.com/community/discussion/5575/fckeditor/