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:

  1. Download and unzip this file (you've done that if you're reading this)
  2. 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.
  3. 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.
  4. 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:
  5. When you login to your admin area, select CKEditor from the list of editors on applicable pages.
  6. (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)
  7. (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