CKEditor addon for Zen Cart v1.xx
License
CKEditor is licensed under GPL. For complete terms of the license, see http://ckeditor.com/license for more details on acceptable use.
Installing CKEditor for Zen Cart v1.xx
Installation is simple:
- Download and unzip this file (you've done that if you're reading this)
- In the unzipped folder, you'll see several variations of an "admin" foldername, offering options for various ZC versions. Find the one the matches your site's version, and rename it to "admin". Delete or ignore the other "admin_xxxxxx" folders, as they will not be relevant to you.
- Now, since your server's "admin" folder has actually been renamed to something other than "admin", go find out what that foldername is on your server now. You'll need that new foldername in the next step.
- Upload the various files from your PC to your website, placing each file in the same folder where you found it in the zip, ie:
- /admin/includes/ckeditor.php goes to your website into your existing /renamed-admin/includes/ folder.
- /admin/includes/languages/english/extra_definitions/ckeditor.php is added to your /renamed-admin/includes/languages/english/extra_definitions/ folder
- /editors/ckeditor/ (the entire folder) gets copied to your /editors/ folder
- When you login to your admin area, select CKEditor from the list of editors on applicable pages.
- (Recommended) You can also set your default editor choice via Admin->Configuration->My Store->HTML Editor (note: this may not take effect until you log in the next time)
- (Optional) You can change the folder in which the editor files live, by renaming the folder and adding the following line to your admin/includes/configure.php file:
define('DIR_WS_EDITORS', 'the new name of your folder/');
If you are using an external add-in for uploading images or other content, then this step moves from optional to recommended, for security reasons.
Upgrading from earlier CKEditor integrations into Zen Cart
To upgrade simply (after identifying the correct "admin" foldername for your site) copy the two folders (admin and editors) to your Zen Cart root folder.
If you have renamed your admin folder, you will of course need to rename the admin folder to match it.
Ensure that existing files are over-written. For the /editors/ckeditor folder, you may want to preserve your config.js file if you had previously customized it. Otherwise, replace the entire folder's contents on the server, removing all previous files under the ckeditor folders.
Upgrading to future CKEditor versions
This package contains CKEditor unaltered from its original distribution as prepared by ckeditor.com. None of the files have been changed, although the "samples" folder has been removed, as it is for demonstration purposes and not needed for normal use.
You can easily update your CKEditor installation in the future by downloading the latest CKEditor files from ckeditor.com and uploading the resulting /ckeditor/ folder to your site's /editors/ckeditor/ folder, replacing what's there. There's no need to change the files in the /admin/ folders merely for CKEditor version upgrades.
(Advanced) You can use the supplied build-config.js file if you want to take the existing configuration and recreate it using the new version. Details are on the ckeditor.com download page.
If you do this, be sure to manually merge customizations of the config.js file.
Donations
If you find this add-on module helpful, please consider showing your appreciation by making a donation to support the Zen Cart project.
Version History
- v3.2.1 - Addon for Zen Cart v1.3.8/v1.3.9.
Contains CKEditor v3.2.1 published 09-April-2010 at ckeditor.com
- v3.2.1a - Addon for Zen Cart v1.3.9 but should work with earlier 1.3 versions.
Fixes editor not displayed in some browsers bug.
Adds play nicely features for running multiple editors in parallel.
Avoids multiple jQuery loading.
Supports editor directory renaming
- v3.4 - Addon for Zen Cart v1.3.9 but should work with earlier 1.3 versions.
Upgrades the version of CKEditor to 3.4 (release 17 Aug 2010)
- v3.6 - Addon for Zen Cart v1.3.9/v1.5.0 but should work with earlier 1.3 versions.
Upgrades the version of CKEditor to 3.6.2 (release 13 Sep 2011)
- v3.7 - Compatible with Zen Cart v1.3.9 and v1.5.0 - Upgraded to CKEditor v3.6.3 (Apr 2012), and fixed a small SSL bug in the integration for Zen Cart.
- v3.7b - re-fixed SSL issue
- v3.7c - Documentation tweak
- v3.7d - Updated CKEditor to v3.6.5. Compatible with ZC v1.3.9, v1.5.0, v1.5.1
- v3.7e - Updated CKEditor to v3.6.6. Compatible with ZC v1.3.9, v1.5.0, v1.5.1, v1.6.0
- v3.7f - Updated CKEditor to v4.1-full, June 2013
- v3.7g - Updated CKEditor to v4.1.2-full. Compatible with ZC v1.3.9, v1.5.0, v1.5.1, v1.6.0
- v3.7h - Updated CKEditor to v4.3.1-std. Compatible with ZC v1.3.9, v1.5.0, v1.5.1, v1.5.2, v1.6.0
- v3.7i - Updated CKEditor to v4.3.1-custom. And added customized config.js file. Includes all supported languages. Compatible with ZC v1.3.9, v1.5.X, v1.6.0
- v3.7j - Updated CKEditor to v4.3.4-custom. Added YouTube plugin. Updated customized config.js file. Compatible with ZC v1.3.9, v1.5.X, v1.6.0
- v3.7k - Updated CKEditor to v4.4.0-custom. Added iFrame plugin. Updated customized config.js file. Compatible with ZC v1.3.9, v1.5.X, v1.6.0
- v3.7m - Updated CKEditor to v4.4.5-custom (standard plus iFrame and YouTube plugins, and all languages, and customized config.js file). Compatible with ZC v1.3.9, v1.5.x, v1.6.0
- v3.7n - Updated CKEditor to v4.4.6-custom (standard plus iFrame and YouTube plugins, and all languages, and customized config.js file). Compatible with ZC v1.3.9, v1.5.x, v1.6.0