
REQUIREMENTS
============

The minimum requirement by this project that your Web server supports PHP 5.4.0.


INSTALLATION
============

Extract the archived file into the root of your website. This will create a 'oscb' directory.

We highly recommend to rename this directory for security reasons (e.g. your_directory).



BASE URL
========

Use this address as Base URL param in configuration dialog of the new OSC version (Modules -> Connectors -> OSCommerce Connector Service):

https://your_domain/your_directory/

(see manual: https://wiki.oscommerce.com/index.php?title=Importing_Data_from_Older_osCommerce_Version_to_New_One#new_osc_version)



Authorization
=============

### Command line

Use this command line to get your secure key from your_directory:

	php yii bridge/show-secure-key


### Web 

Edit the your_directory/compat/configure.php file and uncomment the line #12 (delete two first symbols //). 
The result string should be like this:
define('ALLOW_TO_CREATE_SECURE_FILE', TRUE);

Open this page in you web browser:

https://your_domain/your_directory/index.php?r=site/create-sec-file

Check your_directory for below file name:

SECFILE_nnnnnnnnnnnnnnnnnnnnnnnnnn

Open it, store secure key and delete the file for security reasons

Edit again the your_directory/compat/configure.php file and comment the line #12 (add // at the beginning of the line)
The result string should be like this:
//define('ALLOW_TO_CREATE_SECURE_FILE', TRUE);


Troubleshooting
===============

File configure.php is not found
-------------------------------

Configuration file of OSCommerce 2.x is not found automatically. You have to find it and copy its full name (with path) to clipboard.

Edit the your_directory/compat/configure.php file, go to the line 19 and paste full file name inside quotes like this

	$configure_filename = '/home/user_name/public_html/catalog/includes/configure.php';

Save the changed file.


File 'filename' is found but DB_DATABASE is empty
-------------------------------------------------

Configuration file of OSCommerce 2.x is found but it has unexpected format. 



