PHP-eSeller

PayPal Buttons

PayPal Buttons ....

There are two methods to construct your shop system : modify your existing web pages by adding buttons and cart displays which is useful if you are only selling a few items, or use the dynamic store front which is based on a template system.

This section explains how to integrate PayPal 'buy now' buttons, 'add to cart' buttons, and the 'cart display' into your existing web pages. If you wish to use the full shopping cart system then refer to shopping cart page.

Adding buy now buttons

Clicking on a 'Buy now' button immediately takes you to the PayPal checkout where you buy that single item.

Buy now buttons are used where you only have a few items to sell and you do not expect purchasers to buy more than one item at a time. If you think that a purchaser would want to buy more than one item, then use the 'Add to cart buttons' described below.

An example of a buy now button is shown here.

The button or buttons may be placed anywhere on an existing web page which makes it easy to integrate into an existing design. The web page can be of php extension or an ordinary htm page.

<form action="http://www.yourservername/eseller/ipn/process.php" method="post">
<input type="hidden" name="item_number" value="item1">
<input type="image" src="https://www.paypal.com/en_US/i/btn/x-click-but23.gif" border="0" name="submit" alt="Make payments with PayPal - it's fast, free and secure!">
</form>

The fields that you enter to create the button are :
  • The action url is http://www.yourservername/eseller/ipn/process.php assuming that you have installed PHP-eSeller at the root of your web site in a folder called 'eseller'.
  • The value of the 'item_number' entry is the item number of the product you wish to create the button for. This is what you entered in the item number field in the Products display of the admin pages, for example item1.
  • The image can be any of the PayPal images or one of your own.

Click on the following button which shows what happens when someone wants to buy PHP-eSeller script.

When the purchaser clicks on the buy now button, the php script will extract all the relevant data from the database and post it to the PayPal server.

Adding cart buttons

The shopping cart system provides 'Add to cart' buttons and 'View cart' buttons enabling a purchaser to add items to a cart before purchase. Physical goods and digital goods can be added to a cart at the same time and purchased at the same time.

This method enables you to add a button or buttons anywhere to an existing web page. The web page can be of php extension or an ordinary htm page.

An example of a cart button is shown here.

Below, is an example of an 'Add to Cart' button.

<form action="http://www.yourservername/eseller/cart/viewcart.php" method="post">
<input type="hidden" name="item_number" value="item1">
<input type="hidden" name="from" value="http://www.yourservername/eseller/cart/button.php">
<input type="hidden" name="action" value="add">
<input type="image" src="https://www.paypal.com/en_US/i/btn/x-click-but22.gif" alt="Add item to cart">
</form>

The fields that you enter to create the button are :
  • The action url is the full url of viewcart.php and will be http://www.yourservername/eseller/cart/viewcart.php assuming that you have installed PHP-eSeller at the root of your web site in a folder called 'eseller'.
  • The value of the 'item_number' entry is the item number of the product you wish to create the button for. This is what you entered in the item number field in the Products display of the admin pages, for example item1.
  • The value of the 'from' field is the full url of the page that the button is placed on and is used by the viewcart.php page to know where to return to.
  • The image can be any of the PayPal images or one of your own.

When you click on the 'Add to Cart' button, you are taken to the viewcart.php page where you may remove items or complete the purchase.

In addition to the 'Add to Cart' button you also need a 'View Cart' button as follows :

<form action="http://www.yourservername/eseller/cart/viewcart.php" method="post">
<input type="hidden" name="from" value="http://www.yourservername/eseller/cart/button.php">
<input type="image" src="https://www.paypal.com/en_US/i/btn/view_cart_02.gif" alt="view cart">
</form>

The fields that you enter to create the button are :
  • The action url is the full url of viewcart.php and will be http://www.yourservername/eseller/cart/viewcart.php assuming that you have installed PHP-eSeller at the root of your web site in a folder called 'eseller'.
  • The value of the from field is the full url of the page that the button is placed on and is used by the viewcart.php page to know where to return to.
  • The image can be any of the PayPal images or one of your own.

Click the following Add to cart button to show what happens when someone wants to add the PHP-eSeller script to the shopping cart.

Click the following View cart button to show what happens when someone wants to add the PHP-eSeller script to the shopping cart.


The View Cart display

An example on how to use the view cart display is in the file 'viewcart.php' which is located in the cart folder.

This file uses an include file cart.php. The file viewcart.php can be easily modified to fit in to your own site.

To use the view cart page, you need to place the following include file onto your web page.

<?php include_once ("includes/cart.php"); ?>

NOTE : you must also put session_start(); at the top of the page.

As a starting point, it may be better to modify the existing viewcart.php file in the cart folder.


Drop down list selection

Use this type of code to allow the selection of different options from a drop down list.

<form action="http://www.yourservername/eseller/ipn/process.php" method="post">
<select name="item_number">
<option value="">Select a product</option>
<option value="item_a">item 1 $10.00</option>
<option value="item_b">item 2 $20.00</option>
<option value="item_c">item 3 $30.00</option>
</select>
<input type="image" src="https://www.paypal.com/en_US/i/btn/x-click-but23.gif" border="0" name="submit" alt="Make payments with PayPal - it's fast, free and secure!">
</form>



Button with hidden custom tag

Use this to add a custom tag to the button. The custom field is sent to PayPal and then returns via the PayPal IPN where it is stored in the tblSalesHistory table.

<form action="http://www.yourservername/eseller/ipn/process.php" method="post">
<input type="hidden" name="item_number" value="test01" />
<input type="hidden" name="custom" value="ref-27" />
<input type="image" src="https://www.paypal.com/en_US/i/btn/x-click-but23.gif" border="0" name="submit" alt="Make payments with PayPal - it's fast, free and secure!">
</form>

Button with input box

Use this to allow the customer to enter specific information into a text box. The information will be returned via IPN where it is stored in the tblSalesHistory table.

<form action="http://www.yourservername/eseller/ipn/process.php" method="post">
<input type="hidden" name="item_number" value="test01" />
<input type="text" name="custom" />
<input type="image" src="https://www.paypal.com/en_US/i/btn/x-click-but23.gif" border="0" name="submit" alt="Make payments with PayPal - it's fast, free and secure!">
</form>


Buy now button with shipping

To add shipping to a buy now button, use the following :

<form action="http://www.yourservername.com/eseller/ipn/process.php" method="post">
<input type="hidden" name="item_number" value="test01" />
<input type="hidden" name="shipping" value="0.02" />
<input type="image" src="https://www.paypal.com/en_US/i/btn/x-click-but23.gif" border="0" name="submit" alt="Make payments with PayPal - it's fast, free and secure!" />
</form>

Buy now button for multiple shipping rates

eSeller cart is unable to handle multiple shipping rates per product. The only way to do this at present is to use single item buy now buttons with a drop down list as follows :

<form action="http://www.yourservername/eseller/ipn/process.php" method="post">
<input type="hidden" name="item_number" value="item10" />
<select name="shipping">
<option value="">Select shipping</option>
<option value="4.00">UK Shipping $4.00</option>
<option value="5.00">US Shipping $5.00</option>
<option value="6.00">International Shipping $6.00</option>
</select>
<br/>
<input type="image" src="https://www.paypal.com/en_US/i/btn/x-click-but23.gif" border="0" name="submit" alt="Make payments with PayPal - it's fast, free and secure!">
</form>


Use http links

You can add items to the cart and remove items from the cart using http links rather than buttons.

To add an item use the following in an http link :

viewcart.php?action=add&item_number=prod_a&from=/eseller/cart/list.php

To remove an item use the following in an http link :

viewcart.php?action=remove&item_number=prod_a&from=/eseller/cart/list.php

where item_number is the name that you have given the product when it was created and from is the url of the page the link is placed on which is used by the viewcart.php page to know where to return to.

Another method is :

viewcart.php?action=add&id=1&from=/eseller/cart/list.php

To remove an item use the following in an http link :

viewcart.php?action=remove&id=1&from=/eseller/cart/list.php

where id is the record id of the item you are adding and from is the url of the page the link is placed on which is used by the viewcart.php page to know where to return to.

Placing your include files onto a page

For those who are not familiar with adding include files to your web page, here is a brief description.

  • First start with a page you have created which matches your layout.
  • Change the file extension to .php The base file name can be anything you want.
  • At the point where you want the display to appear enter :
    <?php include_once("includefilename.php"); ?>
  • Copy your file into the /eseller/store/ folder.

Files which use PHP-eSeller include files need to be placed into the correct folder because it will using other include files from the application.


Conventional PayPal buttons ....

If you wish, you may want to use standard PayPal buttons and the PayPal shopping cart rather than the template driven system or the buttons as described elsewhere on this site. You may do this using the PayPal cart factory, but you have to becareful to enter in the correct item name, item number, cost and currency or otherwise PHP-eSeller will not match the values to the database and hence the purchase will fail.

This method allows you to add the digital download system onto an existing set of PayPal buttons so that you to continue using your existing payment set up.

The PayPal cart factory at :
https://www.paypal.com/cgi-bin/webscr?cmd=_cart-factory
is used to create various buy now buttons, add to cart buttons and view cart buttons.

Creating conventional PayPal Buy Now button

Go to :

https://www.paypal.com/cgi-bin/webscr?cmd=_cart-factory

  • Select the radio 'Buy Now' button option.
  • In 'Item Name', enter in a description of the product.
  • In 'ItemID', enter in the item number of the product which must match the item number that you entered when you created the product in PHP-eSeller.
  • In 'Price', enter in the price of the product which must match the price entered in PHP-eSeller.
  • In 'Currency', enter in the currency which must be the same as you entered in the PHP-eSeller.
  • You may want to set the postage to 0.00 to prevent any postage calculations being added to the digital product.
  • In the 'Customise advanced features' section, enter in :

    notify_url=http://www.yourserver.com/eseller/ipn/confirm.php

    You need to enter in the notify_url which can be found in the admin section of PHP-eSeller global set up page. In the above example, it is assumed that PHP-eSeller is installed in the folder /eseller/.

  • Select 'Use my primary email address'.
  • Click on Save Changes and copy the code on to your web site.

Example Buy now button


Creating conventional PayPal Add to Cart button

The procedure to create an Add to Cart button is the same as described above, but you select the radio 'Add to cart' button option.

Example Add to cart button


Creating conventional PayPal View Cart Button

Example view cart button



Find out more

Pricing : PHP-eSeller costs $55 U.S. Dollars, and yes we sell the product using our own application. Click here to go to the purchase page for further details.

Demo : To view an on-line demo illustrating the admin pages and store front, click here.
The demo is live and you may purchase items to see how the system works. Items are $0.01 or $0.02 in value.   

Enquiries : If you have any questions about the product, go to the contacts page by clicking here.

Showcase : To see how customers have used the application, go to the user sites page by clicking here