Post Installation ...
This section describes what to do after you have installed the application on your web server. At this point the application should be working so that you can log on to the admin section and click through the displays.
The following is not meant to replace the full explanation of each administration display, but provides a quick test to check operation.
Basic set up
Log on to the administration displays of IPNMonitor and click on Global Site setup in the main menu which will take you to the global set up page.
The only required entries are :
- the installation url where ipnmonitor has been installed - for example http://www.yourservername.com/ipnmonitor/
- the default location where your digital files will be placed which for a Linux server this will be something like /server1/root/files/ or in the case of a Windows server this will look something like c:\inetpub\files\. The application checks that this folder exists before it is saved. Note that entering a url will not work.
The digital files are normally protected with an htaccess file to stop anyone directly accessing the files with the url.
Now click on the PayPal Setup in the main menu, which will take you to the PayPal specific set up page.
The only required entries are :
- your PayPal email address - this should be the primary email address you have registered with PayPal
- make sure the tick box is ticked to say you are going to use PayPal
Now click on the Google Setup in the main menu, which will take you to the Google specific set up page.
The only required entries are :
- your Google Merchant ID and Google Merchant Key
- tick the Goolge sandbox checkbox if you are going to use Google sadnbox and the merchant ID and key are applicable to Google sandbox.
- make sure the tick box is ticked to say you are going to use Google checkout
Other entries can be left for now and filled in later.
Note that you do not have to make any changes to you PayPal or Google account to identify the PayPal IPN or anything like that.
Create a product
To be able to test if the system is working, you need to create a new product :
Click on Product list in the main menu which will allow you to create a new product item.
Click on the Create button and fill in the required fields.
At this stage enter any test data into the fields.
Click on Save when finished.
In the Product list, you will see the newly created item. Now click on the File Download link. This is where you enter your file details. You need to enter a valid file name.
The filename will be similar to : /home/user/files/test.doc when on a Unix system or something like c:\data\www\files\test.doc for a Windows system.
Do not try to use a http: url web address as that will not work.
When you create your files, it is recommended that you use lower case letters for the filename and you do not use spaces within the filenames.
- lower case letters only (Unix type servers are case sensitive so using a mixture of lower / upper case letters can cause confusion)
- no spaces in filenames (Some browsers may not correctly recognize the file types if spaces are used)
- Only use letters and numbers for filenames, not quote marks etc
- Make sure that the filename has the correct extension for the file type, for example .mp3 or .pdf.
Perform a local PayPal test
Click on PayPal Testing in the main menu. This will display a list of products that you have created. To test a particular product, click on Select Local Test.
This will display a page with a number of entries. You only need to enter the payer email address as all other fields have been filled in by the system.
Enter a valid email address.
Press Perform Test and you should see a page which displays the details of the sent emails. If you go to your email accounts you should see these emails.
Login to the download area with the given username and password and download the test file.
If this has been successful, it indicates that the application, emails and database are all working correctly. It does not check the operation with PayPal as this is a local test which bypasses PayPal. To fully test the system with PayPal perform the following test.
Perform a Live PayPal test
The best method to do a test with PayPal is with a second PayPal account or purchase using a credit card which is not already being used on a PayPal account. You cannot make a purchase from your own account.
Create a product with a small value of say $0.01
Click on the File Download link for the product and enter a filename.
Go to http://www.yourservername.com/ipnmonitor/index.php
You should see a button for the product you have created.
Click on the button and it should take you to PayPal where you can purchase the item using your second PayPal account.
You should receive an email from PayPal detailing the payment and an email from IPNMonitor with your login details.
Login to the site using the given username and password and download the test file.
Correct completion of this test indicates the system is working correctly with your PayPal account.
Perform a Google Test
To test Google, click on the 'Product List' link in the menu which will display a list of products.
For the product that you want to test, click on the 'Show Button' link.
If you are using live Google checkout, you will need a second Google account to purchase the product from. If you are using the sandbox Google checkout, you will need a second Google sandbox account to purchase the product from.
Click on the button and it should take you to Google where you can purchase the item from your second Google account.
Creating the look and feel
Now that you know the application is installed and working correctly with PayPal, you can descide on how you will display your product items.
