User Guide - osCommerce
- 22/05/2008 8:38 PM
Applicable Plans: All Standard VPS, all Advanced VPS, all Premier VPS plans
from oscommerce.com . . .
osCommerce is an online shop e-commerce solution that offers a wide range of out-of-the-box features that allows online stores to be setup fairly quickly with ease, and is available for free as an Open Source based solution released under the GNU General Public License. Today, osCommerce has been taken to the next level, moving towards an e-commerce framework solution that not only remains easy to setup and maintain, but also making it easier for store administrators to present their stores to their customers with their own unique requirements.
eApps is pleased to offer osCommerce for your use. In the tradition of osCommerce, we have packaged osCommerce for simplicity of configuration. This User Guide is not a replacement for documentation provided by the osCommerce project team, but will help you get started in using osCommerce in your eApps Hosting Virtual Private Server.
Requirements
The osCommerce application must be installed in your VPS service. This can be done by selecting it when you order the eApps VPS hosting service or by installing it using the Control Panel after the service has been provisioned. To see if osCommerce is already installed, login to your Control Panel, click on the System tab, and then click on the All Applications icon. If it is not visible in the installed list, you may install it by clicking on the Add Application icon from the System tab and selecting osCommerce, then clicking Next. PHP is also required. Perform the same steps that you performed for PHP that you did for os Commerce. Once you have verified that these two applications are installed, you may proceed.
Activating osCommerce for your Sites
IMPORTANT: When you activate osCommerce for your first site, you should immediately create your Administator login as explained in the Accessing osCommerce as Administrator section as explained in a later section of this document.Even though osCommerce is installed in your VPS subscription it is not enabled for your site(s) yet. The reason for this is because you may want osCommerce to only be activated for some of your sites. To enable osCommerce for a site, click on the Site tab, click on the osCommerce icon, then click the Disable button, then the Enable button. Once you click this sequence osCommerce will be installed for that site. This step must be repeated for each site for which you want to use osCommerce.
Changing the Default URL - By default, osCommerce will be installed at http://yourdomain.com/oscommerce, where yourdomain.com is the domain name for the site you have activated osCommerce for. You can change the default URL as follows.
Having your domain name resolve to osCommerce
If you want to set up your shop as the default page for your site, do the following, from the Site tab:
Website Settings > Custom Settings > Edit
Now add this line:
DocumentRoot /home/webadmin/yourdomain.com/html/oscommerce
Save. Edit the /home/webadmin/yourdomain.com/html/oscommerce/includes/configure.php file throught the File Manager or command line and change these lines from:
includes/configure.php
define('HTTP_COOKIE_PATH', '/oscommerce/');
define('HTTPS_COOKIE_PATH', '/oscommerce’);
define('DIR_WS_HTTP_CATALOG', '/oscommerce/’);
define('DIR_WS_HTTPS_CATALOG', '/oscommerce/');
to:
includes/configure.php
define('HTTP_COOKIE_PATH', '/');
define('HTTPS_COOKIE_PATH', '/');
define('DIR_WS_HTTP_CATALOG', '/');
define('DIR_WS_HTTPS_CATALOG', '/');
Edit the /home/webadmin/yourdomain.com/html/oscommerce/admin/includes/configure.php and change these lines from:
define('DIR_WS_ADMIN', '/oscommerce/admin/');
define('DIR_WS_CATALOG', '/oscommerce/');
to:
define('DIR_WS_ADMIN', '/admin/');
define('DIR_WS_CATALOG', '/');
Check your new site. The osCommerce page should display at http://yourdomain.com
Having another URL resolve to osCommerce
If you would like to have osCommerce installed, but pointed to a different URL, like yourdomain.com/shop for example, you will need to add this line to the Website Settings > Custom Settings > Edit:
Alias /shop /home/webadmin/yourdomain.com/html/oscommerce
Save. Edit the /home/webadmin/yourdomain.com/html/oscommerce/includes/configure.php file through the File Manager or command line and change these lines from:
includes/configure.php
define('HTTP_COOKIE_PATH', '/oscommerce/');
define('HTTPS_COOKIE_PATH', '/oscommerce’);
define('DIR_WS_HTTP_CATALOG', '/oscommerce/’);
define('DIR_WS_HTTPS_CATALOG', '/oscommerce/');
to:
includes/configure.php
define('HTTP_COOKIE_PATH', '/shop/');
define('HTTPS_COOKIE_PATH', '/shop/');
define('DIR_WS_HTTP_CATALOG', '/shop/');
define('DIR_WS_HTTPS_CATALOG', '/shop/');
Edit the /home/webadmin/html/oscommerce/admin/includes/configure.php and change these lines from:
define('DIR_WS_ADMIN', '/oscommerce/admin/');
define('DIR_WS_CATALOG', '/oscommerce/');
to:
define('DIR_WS_ADMIN', '/shop/admin/');
define('DIR_WS_CATALOG', '/shop/');
Accessing osCommerce as Administrator
IMPORTANT: When you activate osCommerce for your first site, you should immediately create your Administator login as explained in the next section.
Once you activate osCommerce, you must create your Administrator login user. To give you more flexibility, you will be able to specify your own Administrator profile information. Go to http://yourdomain.com/oscommerce/admin and proceed as instructed.
Removing osCommerce
If you decide to delete your shop you can just disable it from the Site Tab:
> osCommerce > disable
If you want to completly remove osCommerce from the applications in your VPS service, it is advised that you first disable it on each site it was enabled on, and after that go to:
System tab -> all applications -> Uninstall -> select osCommerce -> Update
Links to other information
osCommerce Home Page: http://www.oscommerce.com/