Upgrade from (previous) version 3

You can upgrade your system from version 3 to version 4 with the help of our Pap3Compatibility plugin.

This plugin contains two things:
1. script for data migration from PAP3 to PAP4 database
2. scripts for compatibility of JavaScript tracking from PAP3 to PAP4


-------------------------------------------------------------------------------
Data migration from PAP3 to PAP4
-------------------------------------------------------------------------------
For migration follow these steps:

1. Install PAP4 to THE SAME DATABASE as PAP3 - this is requirement.
   You don't need to worry about the old PAP3 tables, they will be not
   damaged, PAP4 uses different table names starting with prefix qu_*.
   The old PAP3 installation should be still functional.

2. run script
    http://www.yoursite.com/pap4/pap4/plugins/Pap3Compatibility/pap3topap4.php
   it will start data migration from PAP3 to PAP4.
   The data migration can take few minutes, the script handles PHP expiration
   so you can keep it working until it finishes.
   In the successful end it will write : DATA MIGRATION FINISHED SUCCESSFULLY.

   Your PAP3 installation still works normally, and now also when you log in
   to PAP4 you'll see all the data copied from PAP3.
    
   What is migrated:
     - Campaigns, Banners
     - Affiliates
     - Transactions (impressions, clicks, sales, commissions)
     - Payouts including payout history
     - Most of the settings

   What is not migrated:
     - Merchants and their permissions - in PAP4 you'll have only default
       merchant defined in the PAP4 installation.

3. Manual migration steps:
   3.1 Copy banner files from PAP3 /banners directory to PAP4 directory
         /accounts/default1/banners
   3.2 If you changed parameter names in PAP3 (a_aid, a_bid, etc.) these
       changes were not migrated to PAP4. Log in to PAP4 and set the same
       parameter names as in PAP3.

   3.3 Check all the configuration options in PAP4 and add missing ones, etc.

   3.4 For the tracking compatibility, copy the files from
         ...pap4/plugins/Pap3Compatibility/scripts
       to  
         ...pap4/scripts
       PAP4 uses different JavaScript than PAP3, these scripts will ensure
       that PAP4 will track properly also using PAP3 JavaScript.
          
Until now, PAP3 is still fully functional.

4. rename PAP3 directory /affiliate to /affiliate_old
   and PAP4 directory /pap4 to /affiliate
   This will replace your old installation with the new one.
    
   Renaming PAP4 directory will require you to update the PAP4 license - you
   can do it by opening merchant panel.
    
5. Test it.
   Test that tracking really works - both clicks (referrals)
   and sales.
    
6. Migrate signup form.
   Signup form from PAP3 will not work with PAP4. PAP4 uses its own signup form
   that can be configured very flexibly, including it's template from
   the merchant panel.
    
   You would probably need to modify signup form template to include all fields
   that are used for affiliate. You can do it in merchant panel:
   Configuration -> Affiliate Signup -> Customize design -> Edit signup form
   and adding missing field constants.
    
7. Use new JavaScript for tracking
   Tracking with old PAP3 code should be functional also with PAP4, but it is
   highly recommended to replace it with new PAP4 tracking JavaScript. Without
   this, the new features of PAP4 like DirectLinks, or advanced sale information
   will not work for you.
    
   You should replace scripts for both click tracking and sales tracking.

That's all, you are done.