EasyIPN - Online Help / Guide

Installation

Preperations

Before you will start with the installation process, please make sure you have the following things ready:

  1. Hosting account which has PHPv4/5 installed
  2. MySQL (v4/5/5.1/5.2) server

Let's start by creating a MySQL database. You can create a seperate database that will contain EasyIPN's data, or you can use an existing one. EasyIPN's tables have a name prefix so you will be able to identify them easily. In any way, before you continue, be sure that you have a working MySQL database and username / password to use with EasyIPN.

Configuration

Unpack the easyipn.zip file into a temporary local directory. Open the config.php file with a text editor, and change it carefully. Read it through, it is well documented. You should config the following settings:

  1. Email Configuration - define your server address, username and password (this info should be provided to you by the hosting company that you use).
  2. Database Configuration - the same as above. Use an exsiting database name, you should create if it doesn't exists. Set EasyIPN's tables name prefix. This will allow you to install EasyIPN multiple times on the same database or at a database that already is been used by other programs.
  3. Config the rest of the file as instructed by the comments.

Upload Files

Upload the files from the local temporary directory to your hosting server via FTP. Upload the EasyIPN files into a seperate directory at your server.

Run Installation Script

Point your browser to the [easyipn]/admin directory (where [easyipn] is the URL to the directory where you uploaded the files) and the installation will start by it's own. Your config file will be validated, the databse tables will be created and you will have to choose an admin password, please don't give it to anyone.

After the installation is finished, you will be able to login into the EasyIPN administration backend. You will be able to upload your digital products, create your automatic PayPal Buy Now buttons and embed them into your existing webpages.

User Guide

Upload Digital Products

Login to the administration panel and click on the "Upload Product File" button.

Choose the product from your local disk and click "Upload".

After uploading your product, you will be able to associate it with one or more PayPal Buy Now buttons. Each PayPal button is associated with a single file. When a customer purchases the product, a unique download link will be sent to him, and he will be able to download the product that you had associated with the button.

Create New Buy Now Buttons

From the administration panel, click on "Add".

The Add Product window will be opened, and you will be able to create a new PayPal Buy Now button. All fields are mandatory except from the description field, which is optional.

Fill up all the details, determine your product price and select the currency you are working with.

Associate the product from the "Product File" drop down list box, this list is being initialized when the "Add Product" page loads. It contains all the files that exists in your products directory (configured through the config.php file).

As for the "Return URL" and "Cancel Return URL", enter a URL of a page that will be shown to the customer after a successful payment or after he cancels an orders while it is in progress.

You also have tool-tips all over the EasyIPN administration backend, that will guide you through setting up new buttons.

Embedding The Button Into Your Webpages

After you uploaded your files and created your PayPal buttons, you are ready to embed them into your existing web pages. In order to do that you'll have to write small pieces of PHP code, don't worry, you'll just copy & paste the code from the examples. The PHP code uses the class.easyipn.php file in order to generate the PayPal buttons. Learn how to do that easily by looking at these examples.

Here is one such example, that prints a PayPal button which is idetified by its name.

include_once(dirname(__FILE__) . "/easyipn/core/class.easyipn.php");

$ei = new EasyIPN();
// get the product by its name
$myProduct = $ei->GetProductByName("My Product Name");

if ($myProduct) {
    $myProduct->PrintPPButtonText();
}


Final Words

In any case you have problems with EasyIPN, we are ready to help you do what you need!

Please use the contact form in order to send us your questions, you might want to look at the F.A.Q. as well.

Thanks,
EasyIPN.com Team.