Thank you for purchasing SunShop.
Full Version Version 4.1.9 - Released 4/3/2009
Copyright 2001-2009 Turnkey Web Tools, Inc.

Preparation:

	Before you continue, make sure you have:
	1. A text editor to make changes to the "config.php" file.
	2. A web server or hosted account with PHP and MySQL support.
	3. An FTP program to upload the files and directories. (WSFTP or CuteFTP)
	4. A web browser to run the installation.
	
	Also make sure you know or have access to the following:
	1. Your website FTP username and password.
	2. Your MySQL hostname, username, password and database name.

Download:

	Login to your Turnkey Web Tools account at http://www.turnkeywebtools.com/. 
	Once logged in, select the format and version you would like to download. 
	We always recommend that you download the latest version available. 
	
	Two formats are available for download, tar.gz (tar) and zip. If you are 
	downloading to a Windows machine, select the zip format. After download you 
	can either upload to your server or place locally if you are installing 
	locally. Unix/Linux users should download the tar.gz format for extraction 
	on the machine itself.
	
Choosing Your Distribution:

	Because SunShop uses encryption on a few key files you will also need
	to choose which distribution best suites your needs. You can choose between
	the following 3 versions "Zend", "SGuardian" & "Ioncube".
	
	Quick Install Guide:
	
	http://www.turnkeywebtools.com/install-guide
	
	
Un-Packing:

	After download you should unpack the software. If on Windows, you may use 
	WinZip, WinRar or any other extraction software. If on a Unix/Linux based 
	machine simply run the command "tar -zxvf sunshop_x_x_xxxxx.tar.gz".

File Preparation:

	Before you upload the files you will need to make changes to the "config.php" 
	file located in the "sunshop/include/" directory. Your file should look 
	something like the one located below:
	
	<?PHP
	// Hostname Or IP Of Server
	$servername = "localhost";
	
	// Name of Database
	$dbname = "sunshop40";
	
	// Username And Password To Log Into Database
	$dbusername = "root";
	$dbpassword = "";
	
	// Table Prefixes: Do not change the value after the install has been finished!
	// $dbprefix = "ss_"; // Uncomment this line if this is a new install.
	
	// Persistant Connection To Database
	// $usepconnect = 1;
	?>
	
	Ignoring the lines that begin with "//" edit the variables within the config 
	file to your correct settings. See below for a list of the variables and their 
	functions. 
	
	$servername:  Usually you are fine leaving this at "localhost" but if the 
	actually MySQL database is located on a different server you will need to 
	change this to the proper hostname or IP address.
	
	$dbusername:  Set this to the username you created or was assigned. If you 
	set this up yourself through your hosting companies control panel, you will 
	most likely have to add a prefix to this value.
	
	$dbpassword:  Set this to your assigned or created password.
	
	$dbname:  Set this to the name of the database you created or was 
	assigned. This value may also need a prefix as the username above.
	
	$dbprefix:  By default this is commented out and not used. You will note the 
	"//" in front of this value. If you wish to use this, good if you house other 
	information in the same database, uncomment this line by removing the "//" 
	before the line.

File Upload:

	Once the above procedures have been completed you will need to upload the files 
	to 	your server. If you are installing locally, place the files into the proper 
	directory. To upload simply select the whole unpacked directory and place it on 
	your server. There is no need to do it file by file, and doing so may alter the 
	paths and directory structures.

Installing:

	After your files have been uploaded, point your browser to your server where you 
	uploaded the files. You will need to find the admin path and locate the install 
	file. Example: http://www.yourserver.com/sunshop/install/

	Step 1: Confirm Installation
	
	You will need to read the license agreement and agree in order to continue. If 
	you are unable to see a submit button at this point you should try re uploading 
	the install file.
	
	Step 2: License Key
	
	This step will ensure that you have the proper license key file on your computer 
	as well as check the integrity of the license. If any of the checks fail you will 
	not be able to continue with the install. If the domain name does not pass you 
	most likely entered the wrong domain into the system when you generated your key. 
	If this occurs please contact support so they can reset the key in your client
	account.
	
	Step 3: Configuration Check 
	
	This step will make sure you have the appropriate settings in the config.php file 
	and it will make sure it exists. If the settings are not correct edit the config.php 
	in the admin directory before you attempt to continue.
	
	Step 4: Configuration Check 
	
	The script will attempt to connect to the database using the config.php.
	
	Depending on your settings you may get different results at this point. Below is a 
	list of some results you may get.
	
	"Connection Complete!"
	This means the connection has been made, you may proceed.
	
	"You have specified a non existent database. Trying to create one now..."
	If the database you specified needs to be created it will attempt to do so. If it 
	is unable to create the database you will need to make sure you have the permissions 
	to do so.
	
	"Warning: Access denied for user: ''user@localhost' (Using password: Yes)"
	The look of this error may very but this basically means that the username or 
	password you entered were incorrect. This can also mean that you do not have access 
	to the database.
	
	"Connection Complete! 
	The database already exists."
	This means the database you are trying to connect to already exists. At this point 
	you can choose to continue regularly by selecting "Continue To Next Step" or you can 
	choose to "Continue To Next Step And Reset Tables". If you select the first option 
	it is a good idea to define a value for the "$dbprefix" in the "config.php" as defined 
	in the previous section. This way you do not overwrite any data you have in your 
	database at the present time. If you select the second option, the tables needed will be
	erased and recreated. DO NOT select to reset if you have data you need in the database 
	you defined in your "config.php" file.
	
	"Can't connect to local MySQL server through socket..."
	If you get the above error you must check to make sure that MySQL is running on your 
	server. If you believe it is make sure you have the proper location to the mysql.sock 
	defined in your my.conf file.
	
	If you get any other error message and need assistance please contact us.
	
	Step 5: Creating Tables
	
	At this point you should see only one message "Tables set up successfully". If you get 
	this message continue with the next step.
	
	If you get a message similar to "There seems to be a slight problem with the database..." 
	view the source of the page to get the exact error message. You will find the error at 
	the very bottom of the page. You may need to go back and select reset in order to continue.
	
	Step 6: Add Administrator
	
	In this step you will need to set yourself up as the primary operator. You will need to 
	choose a username, password and email address for the primary account.
	
	Step 7: Setup Successful
	
	Congratulations, you have successfully installed sunshop. At this point be sure 
	to DELETE the "install" directory.
	
	If you receive an error at this point, there was an error sending the email to verify 
	your installation. You dont need to take any immediate action as the install was
	sucessfull but you will need to edit the mail settings in the general settings area..

    *IMPORTANT*
    You will need to chmod 777 images/products/, catalog/, admin/reports/ and the
    admin/backup/ directory.       

Conclusion:

	If you should need any further assistance feel free to email us at any time at 
	support@turnkeywebtools.com. Once again, thank you for purchasing sunshop.