• Constructing Buy Now Buttons for PHP-eSeller

  • PHP-eSeller

    PHP-eSeller is a shopping cart in PHP where you can add "Buy now" buttons on to an existing web page to sell digital downloads as well as physical items.

    It is also possible to create standard PayPal buttons using PayPal's button factory system and integrate the buttons with PHP-eSeller. This will give PayPal type 'Add to Cart' and 'View Cart' buttons using the PayPal cart system.

    If you wish to use the full shopping cart system then refer to PHP shopping cart page.

  • PHP-eSeller

    Adding Buy Now Buttons

    Clicking on a 'Buy now' button immediately takes you to the PayPal checkout where you buy that single digital download or a single physical 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.

    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="recid" value="6">
    <input type="image" src="https://www.paypal.com/en_US/i/btn/x-click-butcc.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 (those in bold text) 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 hidden field is the record id of the product you wish to create the button for. This is the value that in the Products display in the admin pages.
    • The image can be any of the PayPal images or one of your own.
    • 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.

  • PHP-eSeller

    Adding Add to Cart and View Cart Buttons

    Add to cart and view cart buttons can be created manually as shown below.

    These 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.

    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.

    Add to Cart Buttons

    <form action="https://www.yourserver.com/phpeseller/basket/yourbasket.php" method="post">
    <input type="hidden" name="recid" value="34">
    <input type="hidden" name="action" value="add">
    <input type="hidden" name="from" value="https://www.yourserver.com/phpeseller/basket/examples.php">
    <input type="image" src="https://www.paypal.com/en_US/i/btn/x-click-but22.gif" alt="Add item to cart">
    </form>

    You need to enter the action url which is the full url of the yourbasket.php page. This is located in the installation folder which in the example above is https://www.yourserver.com/phpeseller and then followed by the location of yourbasket.php which is /basket/yourbasket.php

    You also need the record id of the product item. In the example above this is "34". You can get the record id of the item by looking at the product list in the admin area.

    You also need the action hidden field value, which will be "add".

    You can enter a "from" url which is the full url that you want the page to return to when you click on "Continue Shopping" link.

    The button image can be any image that you want. I have used a standard PayPal image.

    The following buttons are linked to my demo site.

    Physical Item 1

    Physical Item 2

    Digital Item 1


    View Cart Button

    And finally, a view cart button to display the shopping basket.

    <form action="https://www.yourserver.com/phpeseller/basket/yourbasket.php" method="post">
    <input type="hidden" name="from" value="https://www.yourserver.com/phpeseller/basket/examples.php">
    <input type="image" src="https://www.paypal.com/en_US/i/btn/view_cart_02.gif" alt="view cart">
    </form>

    You need to enter the action url which is the full url of the yourbasket.php page. This is located in the installation folder which in the example above is https://www.yourserver.com/phpeseller and then followed by the location of yourbasket.php which is /basket/yourbasket.php

    You can enter a "from" url which is the full url that you want the page to return to when you click on "Continue Shopping" link.

    The button image can be any image that you want. I have used a standard PayPal image.

    The following button is linked to my demo site.

  • PHP-eSeller

    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="recid">
    <option value="">Select a product</option>
    <option value="1">item 1 $10.00</option>
    <option value="2">item 2 $20.00</option>
    <option value="3">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>


  • PHP-eSeller

    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. You might use this in situations where you want some extra information to be returned when the customer makes a purchase such as phone number.

    <form action="http://www.yourservername/eseller/ipn/process.php" method="post">
    <input type="hidden" name="recid" value="1" />
    <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>

  • PHP-eSeller

    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 custom field of the tblSalesHistory table.

    <form action="http://www.yourservername/eseller/ipn/process.php" method="post">
    <input type="hidden" name="recid" value="1" />
    <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>


  • PHP-eSeller

    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 advantage with creating buttons through PayPal is that you can add on other selling details which are not available in PHP-eSeller. For example, you can use the postage calculation system in PayPal rather than the one in PHP-eSeller.

    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.


  • PHP-eSeller

    Creating conventional PayPal Buy Now button

    Go to :

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

    PayPal create button
    • 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. To do this make sure you select the "use specific amount" radio button.
    • Select 'Use my primary email address' radio button.
    • In the 'Customise advanced features' section, (Section 3), there is a section called "Add advanced variables". Tick the tick box and 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/.

      You can also optionally add in a "return url" and a "cancel url" in Section 3.

    • Click on Create Button or Save Changes and copy the button code on to your web site.

     

    Example Buy Now Button

     

    The values entered in this button much match all the product item details becuase the values will be checked by the confirm.php file. The advantage is that you can enter specialised PayPal variables. The button is also encrypted, but that should not be an issue as the confirm.php script checks the values anyway. The disadvantage is that if you change price or other value, you have to recreate the button.

  • PHP-eSeller

    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.

     

  • PHP-eSeller

    Creating conventional PayPal View Cart Button

    After you have created a button, you should be given the option of creating a "View Cart" button which will display the PayPal cart system.