Shopping Cart: osCommerce 2.x

Install Guides

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
• Click the Tools link in the navigation
• Click the Database Manager icon
• Create a MySQL database and make note of the database name, user and password

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 ACL Manager under the Tools link in your hosting control panel, set ReadWriteDelete for the *_web user on the /tmp folder you just created, the /includes/configure.php file and the /admin/includes/configure.php file. 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