• I have installed Zen Cart to a directory. How do I rename or move that directory?

    Scenario: I have been building my ZC behind the scenes at: http://www.mysite1.com/shop/
    I am nearly ready to go live with it at: http://www.mysite1.com/

    Will there be any problems with my ZC if I just move the entire thing to my main directory?
    Is there anything I need to change in my database or config files?

    Moving your site to another folder on your server

    1. Determine the new foldername where your Zen Cart files will be running from
    2. Go into Admin > Configuration > Sessions and change the Session Directory to reflect the new folder name. If you cannot do this, see the alternate approach in step 5 below.
    3. Move/Rename the folder. You may need to use your FTP program to do this.
    4. Your /includes/configure.php and /admin/includes/configure.php files are used to point Zen Cart to the right folders. In those files you need to update several entries to match the new path information:
      • DIR_FS_LOGS (if present or uncommented)
      • DIR_FS_SQL_CACHE (if present or uncommented)

        And in older versions (ie: v1.3.9h and older) you'll need to also adjust these in your /admin/includes/configure.php file. They don't need adjusting in v1.5.0 or newer:
      • DIR_WS_ADMIN
      • DIR_WS_HTTPS_ADMIN (in admin)
      • DIR_FS_ADMIN (in admin)

      Note that the configure.php files are normally "read-only". You'll need to change their permissions to "writable" before you can upload your changes. Be sure to note level the permissions were at before changing, so that you can put them back to the read-only permissions again after updating.
    5. If you could not set the Session Write Directory in step 1 above, you can use a utility to do it for you. The goal is to make sure that the new path information (specifically the DIR_FS_SQL_CACHE setting in your new configure.php file) matches the Session Write Directory setting. If it doesn't, you may end up with difficulties logging in to the Admin area or maintaining login sessions in the store. The Fix Cache Key Utility from the Plugins > Troubleshooting Tools area on the main Zen Cart site will help you to do this if you need assistance. There is no harm running it to have it check that things are set properly. Be sure to delete the file from your server when done.

    Other Articles of Interest:
    How do I set file permissions?
    What do the permissions numbers / CHMOD mean?
    Making configure.php file read-only

    NOTE: It's NOT recommended to use any upper-case letters in your folder/directory names. Stick to lower-case if possible.
Zen-Cart, Internet Selling Services, Klamath Falls, OR