Installing the ShopAdmin add-on into osCommerce

Quick start

Installing the ShopAdmin add-on into osCommerce involves two essential steps:

  1. Download the zip file that you receive when you sign up, and unzip it into the admin folder of your osCommerce installation. This zip file is a package containing the following files:
    apsona_config.php
    apsona_dashboard.js
    apsona_functions.php
    apsona_index.php
    apsona_init_filters.sql
    apsona_init_reports.sql
    apsona_JSON.php
    apsona_svc.php
    

    All the files must be copied into your the admin folder of your osCommerce installation. This will set up ShopAdmin to be accessible via the URL apsona_index.php within your osCommerce system.

  2. Access the URL apsona_index.php instead of index.php within your admin area. For example, after you log in,
    if your store admin URL is

    http://my-store.com/catalog/admin/index.php

    then your ShopAdmin URL is

    http://my-store.com/catalog/admin/apsona_index.php

    The first time you access the ShopAdmin URL, the add-on tries to create a link to the ShopAdmin window in your Admin Tools menu. It does this by trying to modify the file catalog/admin/includes/boxes/tools.php. The add-on might not succeed in doing so, depending on the file’s permissions and whether or not the file has already been modified. After you have accessed the ShopAdmin URL once, you can inspect this file and manually add the link if needed.

Note also that, unlike with many other osCommerce add-ons, you do not need to run the SQL files included in the package. ShopAdmin automatically detects whether they need to be run, and runs them if necessary. This approach is intentional, so as to make the installation process as easy as possible.

Troubleshooting

Sometimes the host configuration or the shopping cart setup prevents Apsona ShopAdmin from operating correctly. Here are some common errors and how you might be able to fix them.