User Guide

Thank you for purchasing from CodeShack!

Your support will help keep our website up and running, and will help us provide you with more quality content!

If you have any issues don't hesitate to contact us via our website or directly to our email at support@codeshack.io.

Requirements

I recommend you read the following tutorials on our website (if you haven't already):

1. https://codeshack.io/shopping-cart-system-php-mysql/

You will need the following:

1. XAMPP or a web-server with PHP, MySQL & phpMyAdmin, if you've purchased web hosting you will only need to upload the files to your web directory.
2. A code editor, you can use notepad to edit the PHP files but I don't recommend it, instead download one of the following: Notepad++, Visual Studio Code, or Atom.

Instructions

1. Open the XAMPP control panel and start Apache and MySQL
2. Upload/import the "shoppingcart.sql" file in phpMyAdmin
   NOTE: If you get a MySQL permissions error you might need to create the database manually.
3. Copy/cut one of the packages folder into your web directory (htdocs/www etc)
4. Rename the directory to "shoppingcart" and go to http://localhost/shoppingcart/ in your web browser
5. Basic: Edit the "function.php" file and update the MySQL details (if you need to) in the "pdo_connect_mysql" function
   Advanced: Edit the "config.php" and update the database variables, you can also change them with the "Admin Panel", click the "Settings" link.
6. You can add new products directly in phpMyAdmin, click the "products" table and click the "Insert" tab, ignore the ID column as this will auto increment
   NOTE: Advanced users can add new products and products images via the admin panel, make sure the user has their "admin" column set to 1 in the MySQL "accounts" table.
7. Enjoy coding and thank you for supporting us!

How to set-up PayPal

1. The shopping cart system needs be on a production server, PayPal sends a request to the IPN file on every purchase made, this will not work on your local computer unless the shopping cart pages can be accessed remotely.
2. Log-In via the "My Account" page with an admin account, and click the "Admin" link.
3. Click the "Settings" tab and update the PayPal variables.
4. PayPal is currently in test mode, while being in test mode you can make dummy payments etc, you can create sandbox accounts here: https://developer.paypal.com/developer/accounts/
5. If you're ready to start accepting payments with PayPal you can set the "paypal testmode" variable to false.
6. Make sure you update the IPN URL on the "Settings" page and update it in your PayPal account, click here for the guide on how to set this up.

FAQs

1. Why am I getting a MySQL error?
   Make sure you edit the "functions.php" file and update the connection details, you might need to change the hostname if yours is different, and make sure you've uploaded the SQL file in phpMyAdmin.
2. How do I download the zip file again if I've accidently deleted/lost it?
   The download link is in your email, if you do not have it you can use this link: https://codeshack.io/receiptresend/ to request a new email.

Updates

15/08/2020

• Added option prices, you can now add individual prices for product options.

12/08/2020

• Products can now have an unlimited quantity, set the product quantity to -1 in the admin panel
• Added the registration form to the "My Account" page.
• Added new feature: Order Details Email (email sent to the user when they've purchased a product)

08/07/2020

• Added the logout icon to the top navigation bar.
• Added product categories and product options.

12/05/2020

• Updates to come in the future: product options, product categories
• Country drop-down box added to the check out page.
• Fixed bugs and updated the database structure.
• You no longer need to change every file to update the currency or change variables, you can do this with the admin panel.
• The "advanced" and "advanced_paypal" packages are no longer separate, they are now combined, you can disable PayPal payments via the admin panel or by directly editing the "config.php" file.
• Admin panel has been added to the shopping cart system.

08/01/2020

• Created the "User Guide".

04/12/2019

• Added the "advanced_paypal" package for advanced users, you can now use PayPal with the shopping cart system.
• Improved code.

Upcoming Plans 2020+

These plans may or may not happen, there is no estimated date and time on any upcoming changes.

• Add Stripe payment gateway, users will be able to directly make credit card payments.
• Combine all payment gateway packages into one package.
• Add an admin panel so you can create products, upload images, edit payment settings, but this might come at a cost, will require much more code and time.
• Add-ons.