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 Site setup in the main menu which will take you to the global set up page.
The only required entries are :
- your PayPal email address - this should be the primary email address you have registered with PayPal
- your admin email address - this will be the email 'from' address and so should have the same domain as the site that the application is installed on, or otherwise customers may not receive their emails
- 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. Not that entering a url will not work.
Other entries can be left for now and filled in later.
Note that you do not have to make any changes to you PayPal 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 file name 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 ssytem.
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 file names 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 test
Click on 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 bypassess PayPal. To fully test the system with PayPal perform the following test.
Perform a PayPal test
The best method to do a test with PayPal is with a second 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.
