Shopping Cart: osCommerce 2.x

Step 1: Create a database via your hosting control panel, refer to your setup email for login information. If your site does not have a control panel please request a MySQL database setup for your domain by opening a support ticket.

• Log in to your hosting control panel
• Mouse over Databases and click MySQL
• Click the Create Database
• Create the database and make note of the database name including the part before the underscore
• Click the Create User
• Enter a username, password and check the database you just created, click Save

Step 2: Download the latest stable version zip from the osCommerce web site

Step 3: Extract the zip file to a directory on your computer

Step 4: Upload all the osCommerce files contained in the /catalog folder via FTP to the location on the web server where you want to install the shopping cart, for example a /store folder or the root folder of your web site if you want the store to be the home page.

Step 5: In this same folder create a folder to contain session data, the name of this folder is not important but for this example we'll name it /tmp.

Step 6: Before starting the install some write permissions need to set. This can be done via the File Manager in your WebsitePanel. Navigate to the wwwroot folder and locate the folders and/or files, click the lock icon. Check the Write options as well as the Child Objects (for folders) option and click Set Permissions.  If you do not have a control panel please open a support ticket to request the permission changes.

Step 7: Point your browser to the /install directory on your web site where you uploaded the osCommerce files and follow the installation steps.

Step 8: On the database step use for hostname and fill in the information you noted when creating your database

Step 9: When completed click the Administration Tool button, you'll most likely encounter a permission error line near the top so you have to point the session directory to a location the script can write to. Click the Sessions option in the navigation and edit the Session Directory setting to have the full server path (D:/full/path/to/tmp - you can copy part of the path from the error above) to the /tmp folder you created earlier.

Step 10: Delete the /install folder from the FTP and set the permissions on the /includes/configure.php file back to Read via your hosting control panel. You are now ready to use and edit your store.

Step 11: It is possible the software will display an error claiming it can still write to the configure file even though permissions for the web user have been set back to Read only. In this case you can do one of the following things to get rid of the error.

• Open the /includes/application_top.php file in a text editor and set the WARN_CONFIG_WRITEABLE parameter to false.
• Submit a support ticket asking to change the file properties to Read Only. Keep in mind you will no longer have access to the file at all.

To keep your site and store application secure it is important to install software updates as soon as possible! Check with the publisher of the software frequently if any updates are available.

Add Feedback