Author: Olaf Lederer
This universal shopping cart script is powered by MySQL and works with external customer and product data.
DB_cart Class is a MySQL shopping cart script and can be used with 3rd party product catalogues and membership systems. The whole MySQL database structure is neutral to existing systems. In the current version it's possible to handle the shopping cart (add, update and empty) and checkout process (set the shipment address and e-mail the order). For existing cart users (customers) the items of the cart are still available while until his next visit and are available during checkout. The package includes all application files and example data to test all functions. Since version 1.10 its possible to use this class with product data where the stock value is variable. Notice the additional example files (they are explained at the end). Since version 1.13 the order messages are parsed via external files (de, nl or en language).
Standard class
"on Stock" extenstion
Requirements:
PHP 4, MySQL 3.23 or higher, access to a smtp server (windows only) and some knowledge in OOP
First of all, the examples files have all information, you only need to:
Please note that this class is supposed for mature php/MySQL enabled web hosts. It's possible that the script will not work f.e. on free web hosts!.
You can use this class on two ways:
In this manual are only the important files explained which are needed to use the class. If you like to try the other examples check the notes inside the files.
db_config.php
There are several constant variables defined, to use this class nothing but the database connection variables have to be changed. If you need to change them read the notes inside the file. The next values are important to modify:
db_cart_example.php
This file get the product information from the example table "db_cart_example_customer" and stores this data in a record set. The data can be used for the presentation on the page. The following information is used later by the class:The product ID, the name and the price.
The next code is optional and gets some customer data from the example table "db_cart_example_customer" and will store the customer number and the e-mail address into a session. You can use other variables for these session variables too.
One of the advantages of this class is the possibility to use product data which doesn't belong to this class. You can handle the data for a product like this:
This form is placed inside a loop (row 1 and 13) and will be submitted to the continue script (row 2, check the config file for the real name). Notice the presentation part on the rows 3 to 6. It's possible to put here more informations (images, further specs.) if in your datasource is this information available. The input element "quantity" is required and is the only input field in this form (row 7). The rows 8 to 10 holds other informations which are used by the class. At last there is a sbumit button at row 11.
Further you need to create an new instance of the class: $myCart = new db_cart($_SESSION['custom_num']); The session variable is need to use it inside the current order.
At the end of the script is a link named "checkout", if this link is used the following code is executed:
First there is a check if there are products in the cart, if yes the user is redirected to the checkout page (row 3) and if not a message is set (row 5).
To show all messages use this code: <?php echo $myCart->error; ?>
The method $myCart->show_ordered_rows() is called for the table with ordered products at the end of the file. How to show order rows is described together with the checkout file next.
db_cart_continue.php
This file is new since version 1.12 and is used to make the order proces more clear to the customer. After the customer has added a rpoduct to the cart this page will show up. On this page its possible to change the amount for the current product and there navigation links to the previous page or to the check out page.
On row 2 there is a test to obtain the amount of an existing order row for the current product. Next if there is already an order row this one will only updated with the new amount (row 7 and 8). Otherwise the default method handle_cart_row is used to create a new order row. If the constant SHOW_CONTINUE is set to false the user is redirected to the product page other wise he will see the continue page again.
db_cart_checkout_example.php
This example file is used for several tasks:
To show dynamicly the orderrows in your own page its possible to store the data in array. This is done while calling this method: $myCheckout->show_ordered_rows() The data is showed with this code:
The table row with data is placed in a foreach loop (row 3) and all order row values are available in the $myCheckout->order_array. Notice the key names which are used to show the different values (row 5 to 12). Inside the last table cel is a small form with an input field and a submit button. This form is used to update each order row (row 12 and 13). If the new quantity value for a row is null, the row is automaticly deleted.
If the update button is clicked the method $myCheckout->update_row($_POST['row_id'], $_POST['quantity']) is used to update the order row.
If the user clicks on the "Cancel all" links the method $myCheckout->cancel_order() is called and all order rows, the order and the shipement data is removed. The user will be redirected to the product list.
This script shows an example how to obtain customer/shipment data from a third party data source, here from the example table "db_cart_example_customer".
Inside the script there is a check if a shipment record already exists. If not the the example table is used to get this data which will be stored in a record set (row 2 to 5). In the next rows the class variables are filled with the data from the recordset (row 7 to 11). At last the new data will be stored in the shipment table with the method $myCheckout->insert_new_shipment(). If a shipment record already exists the method $myCheckout->set_shipment_data() is called.
If you click on "Order now" or "Continue shopping" the shipmment data is automaticly saved while calling this code:
If the submit value is "Order now!" the order is processed by calling the method $myCheckout->check_out($cust_email) (use an additional form field for the $cust_email variable or use it from the external customer table) otherwise the user is redirected to the product list.
There are two functions at the top of the script, this functions are used to create dynamicly formlelements. If you need more information about this functions check this url: http://www.finalwebsites.com/snippets.php
The values of the total amount and the VAT amount are showed by calling the methods $myCheckout->format_value($myCheckout->show_total_value()) and $myCheckout->format_value($myCheckout->create_total_VAT()). Both values are formatted by the method "format_value()".
db_cart_confirm.php
This file is only used to show the data after the order is mailed to the user and the admin. Use this kind of pages to give more information to the user about what is happen.
These example files are extended versions from the examples above. Only the new additional functions and code is explained here. If you need to know somthing about the other code check the parent examples above. First you have to use for all you application files this inluded file:
require($_SERVER['DOCUMENT_ROOT']."/classes/db_cart/db_cart_4stock.php");
Further you have to create objects like this:
$myCart = new db_stock_cart($_SESSION['custom_num']);
db_cart_stock_example.php
The code to obtain the example product data is a little bit different since we need the stock value: $query_new = "SELECT art_no, amount AS on_stock, price, art_descr FROM db_cart_stock_article_example ORDER BY art_no";
The next important code is used to the new stock and price value to test them against existing open order rows for the current customer.
In the first row is a check against a session if the check was already done before. If not then the script will buid a string with the article numbers from the existing order rows (row 2). This string uis used to query the product example tabel. Inside the loop (row 6 to 11) the array $stock_array is filled with values from database, don't change the key names of this array!. On row 12 is the method update_stock_values called. This is used to update the existing order rows. Notice the additional code later in the html table will show the stock value from the result set <?php echo $row_new['on_stock']; ?>
db_cart_checkout_stock_example.php
In this field is not so much changed because there is only a check to prevent orders with amount bigger then the stock value and the stock value is listed in the table.
Notice the addional row no. 2, there is test for the current order amount and the stock value.
Next some code to get the stock values from the example table:
There is again the function called to build the string with the article number to search the records from the product example table. Inside the loop is an array build with the article number as key and the stock value as value.
This stock value is placed in order table like this: $stock_array[$val['product_id']];
db_cart_stock_confirm.php
In this file is an additional function to update the stock values after the order is processed:
First get the shipment information for this order (row 1) then loop through the array with order rows to update the related product row with the new quantity of the product.