| IMPORTANT SECURITY WARNING: Adding
scripts to your site is a security risk
no matter where it is hosted. Hackers
are always looking for security
holes in scripts (such as ZenCart)
that they can exploit to send out spam
or propagate viruses & scams. This could
also mean severe damage to your website
and other websites on the server. MacHighway
asks that you frequently check zencart.com (external
link) for important updates to your shopping cart
system to prevent such exploits. |
What you would use this for: To offer an online catalog and shopping cart for your visitors to view a description of products and make purchases.
What You Need:
An FTP client (Transmit - external link)
A MySQL Database (if you don't already have one setup for your site, please request one)
1. Go to http://www.zencart.com (external link) and download the latest ZenCart installation by clicking the "Download Zen Cart Now!" graphic. We'll refer to this as the zencart.zip file.
2. If the installation package doesn't expand automatically, double click the zencart.zip file. This should force the compressed files in zencart.zip to expand into a folder that begins with "zen-cart", followed by a version number. We'll refer to this folder as the zencart folder from now on.
3. Upload the contents of the zencart folder into your public_html folder on the server. Alternatively you could create a folder inside your public_html to upload into (i.e. public_html/zencart).
4. Change the file permissions on the following folders on the server to 777:
/cache/
/images/ (including all subdirectories), /attributes, /dvd, /large, /large/dvd, /medium, and /upload /includes/languages/english/html_includes
/media/
/pub/
/admin/backups
and /admin/images/graphs/
To change file permissions using Transmit, highlight each folder individually and press command + i. In the window that pops up, you can either type 777 into the bottom field or make sure all boxes are checked.
5. Rename /includes/dist-configure.php to configure.php. After renaming it, set the file permissions to 777.
6. Rename /admin/includes/dist-configure.php to configure.php. After renaming it, set the file permissions to 777. (This is different from step 5. This includes folder is inside of the admin folder)
7. Navigate into the zc_install folder. There will be a file in there called .htaccess. If you don't see this file, in Transmit go under the View menu and select "Show Invisible Files". Highlight the .htaccess file by clicking on it. Go under the "File" menu and select "Edit with Transmit" to edit the .htaccess file. You should see a text file that includes:
# $Id: .htaccess 3781 2006-06-16 04:33:28Z drbyte $
# The following disables mod_security in apache, which may be necessary during installation
# This file should only be used INSIDE the zc_install folder. Using the following directive elsewhere can
# cause security problems on your site. Talk to your webhost if you are concerned about its effects.
<IfModule mod_security.c>
SecFilterEngine Off
SecFilterScanPOST Off
</IfModule>
You'll need to edit this file so that the lines without hash marks, are hashed. Your end product should look like this:
# $Id: .htaccess 3781 2006-06-16 04:33:28Z drbyte $
# The following disables mod_security in apache, which may be necessary during installation
# This file should only be used INSIDE the zc_install folder. Using the following directive elsewhere can
# cause security problems on your site. Talk to your webhost if you are concerned about its effects.
#<IfModule mod_security.c>
#SecFilterEngine Off
#SecFilterScanPOST Off
#</IfModule>
Go to the "File" menu and select "Save" to save the .htaccess file. It will automatically be uploaded back to the server. You can now close the .htaccess edit screen.
8. Point your web browser to http://www.yourwebsite.com/zc_install/ (If you installed ZenCart into a sub-folder it would be http://www.yourwebsite.com/zencartfolder/zc_install/)
9. Click "Continue" at the welcome screen, on the next page, read through the GNU license then click "I have read and agree to abide by the Terms and Conditions as stated above." Click "Continue".
10. The next page is the system inspection page. Contact us via e-mail (support@machighway.com) stating your domain name to request allow overides to be turned on. There may be a few yellow explination point icons next some items. Don't worry about these. If you have any red "X"'s next to any items, these need to be fixed. Refer back to steps 4 and 5. Once everything checks out ok, click the "Install" button at the bottom of the page.
11. The next page is the Database Setup page. Look below for example settings for this page.
Database Type: "MySQL"
Database Host: your mysql server (Replace "your mysql server" with the location of your MySql database as indicated in the e-mail "From MacHighway: Your MySQL access is set up".)
Database Username: your MySql username (usually your machighway ftp username)
Database Password: your MySql password
Database Name: yourMySQLusername_db (usually your machighway ftp username followed by _db)
Store Identifier (Table-Prefix): "Leave this section blank"
Database Sessions: Yes (this is the default setting, you can change it to no if you'd like)
SQL Cache Method: None (this is the default setting, you can change it if you'd like)
Session/SQL Cache Directory: /Library/WebServer/WebSites/YourUsername/public_html/cache (replace YourUsername with your machighway ftp username) (if you installed ZenCart to a subdirectory remember to include that after /public_html/)
Next, click the "Save Database Settings" button at the bottom of the page.
12. The next page is the system settings page. Look below for example settings. The # sign after the secure portion of the web address depends on what server your site is on. If you need SSL setup on your site, or are unsure what SSL server you are on, please contact us.
Physical Path: /Library/WebServer/WebSites/YourUsername/public_html/ (replace YourUsername with your machighway ftp username) (if you installed ZenCart to a subdirectory remember to include that after /public_html/)
URL to your Zen Cart store: http://www.yoursite.com (if you installed ZenCart to a subdirectory remember to include it!)
HTTPS Domain: https://secure#.machighway.com/www.yoursite.com (if you installed ZenCart to a subdirectory remember to include it!)
HTTPS Server URL: https://secure#.machighway.com/www.examplesite.com (if you installed ZenCart to a subdirectory remember to include it!)
Check both "Enable SSL", and "Enable SSL in Admin Area" if you already have SSL setup. Next, click the "Save System Settings" button at the bottom of the page.
13. Select "No" next to the "Do you want to use phpBB forums" question, then click the "Save phpBB Settings" button. (If you'd like to use phpBB with your ZenCart system you can set that up later. We offer step by step instruction in our how to's support section.)
14. The next page is your Store Setup page. Fill in the blanks and click the "Save Store Settings" button at the bottom of the page.
15. The next page is used to setup an administrator account. Use the following settings:
Administrator's Username: YourUsername (or any username you would like to use)
Administrator's Password: YourPassword (or any password you would like to use)
Administrator's Email: your e-mail address
Click the "Save Admin Settings" button at the bottom of the page.
16. Congratulations! You have successfully installed Zen Cart™ on your system! Delete the install folder from your webspace. /public_html/zc_install
18. Set the file permission for /includes/configure.php and /admin/includes/configure.php to 644.
19. You're done! You can now start using your ZenCart system!
| IMPORTANT SECURITY WARNING: Adding
scripts to your site is a security risk
no matter where it is hosted. Hackers
are always looking for security
holes in scripts (such as ZenCart)
that they can exploit to send out spam
or propagate viruses & scams. This could
also mean severe damage to your website
and other websites on the server. MacHighway
asks that you frequently check zencart.com (external
link) for important updates to your shopping cart
system to prevent such exploits. |
|
