WordPress Referral v3.1.0

Very effective Wordpress referral system

• created: 08/15/2013
• latest update: 06/16/2015
• by: OceanicBreeze
• website: markessence.com
• email: hello@markessence.com

Thank you for purchasing WP Referral. If you have any questions that are beyond the scope of this help file, please feel free to email via my user page contact form here. Thanks so much!

WP Referral is a very useful plugin that extends your Wordpress website with a very effective referral system.

Works with standalone Wordpress, WooCommerce, WP e-Commerce or any other shopping cart system that uses the default Wordpress registration process.

What functionalities you'll have:

• pay your affiliates via PayPal MassPay
• access referral stats via https://developers.facebook.com/apps
• logged in users can have access to a referral link via shortcode
• administrators can provide banners to their users virtually from every source
• logged in users can have access to a referral banners via shortcode
• logged in users can see their downline (successfully recommend people) via shortcode
• default user profiles are extended with referral information
• administrators can see all users, their User ID their Referral ID in Wordpress admin
• administrators can see full referral stats per user
• administrators have full sortable referral stats
• administrators can see full monthly referral stats
• a cookie can be enabled to track referrals that do not sign up directly from the link provided (this is optional via plugin settings page)

With this plugin you can easily extend your Wordpress installation with a referral system. Immediately after the plugin activation you'll be able to give your users the ability to refer your website/blog and also to check how many and who really did registered all of this just by inserting a shortcode on any page or post.

The administrators have three different pages to manage their referral system:

• Overview Stats Page
  A chart with full year statistics for new users and new referred users. If there are users regstered in other year than current one you'll have that year listed and you can easily change the year for the statistics just by clicking it. You have also a table with all active users and their activity.
• Transactions Page
  A very detailed table with all your transactions.
• Payment Page
  A very detailed table with all your qualified affiliates for payment. Here you can select individual affiliates and for each one you can also select for how many referrals do you want to pay.
• Settings Page
  Here you can set the cookie life (disable cookie by setting 0 value; any other value will be used as days) and the credits to us (1 means that you give credits to us; any other value means that you do not want to give credits to us).
• Info Page
  Here you'll have a collection of all your available short-codes along with some useful info.

The installation steps are very easy and the last one is optional. Default setting is with WP Referral cookie disabled.

1. Extract all files from the wp-referral.zip archive (You can use WinZip, 7zip, unArchiver, etc. )
2. Upload wp-referral folder to the /wp-content/plugins/ directory
3. Activate the plugin through the 'Plugins' menu in WordPress
4. Set WP Referral cookie preferences by accesing 'Settings' -> 'WP Referral' plugin options page
5. Set WP Referral registration URL preferences by accesing 'Settings' -> 'WP Referral' plugin options page (Use this option if you have custom registration page like /register/. The default registration page is /wp-login.php?action=register)
6. Set PayPal MassPay credentials by editing the config.php file located in /wp-referral/PayPal/includes/. For security reasons we did not and will not include PayPal credentials settings in the Settings page.

Note: By default WP Referral cookie is disabled. That means that if someone access the generated referral link (http://www.yourdomain.com/wp-login.php?action=register&ref=CODE) and does not register right away (close the page, navigate on other page, etc.) any further registration will not be counted for user CODE. If you enable WP Referral cookie by setting a value for cookie life (in days) then you can be sure that even the user browse away from /wp-login.php?action=register&ref=CODE and registers later he will be counted for user CODE.

You can use WP Referral registration URL option to redirect users to other URL than the registration page.

After these steps you have a working referral system installed. For simple and advanced usage of this plugin please see Usage section.

To enable referral system into your Wordpress website all you have to do is to follow the installation instructions above. After plugin activation you can:

1. Use the builtin referral link generator shortcode below to display anywhere in your pages or posts a link that registered users can provide in order to have people register.

   [referral_link]

   This shortcode will output something like "http://www.yourdomain.com/wp-login.php?action=register&ref=CODE" where www.yourdomain.com is your Wordpress website/blog and CODE is your registered id.

2. Use the builtin referral banner generator shortcode below to display anywhere in your pages or posts a banner that registered users can provide in order to have people register. You can use inside [referral_banner] shortcode any image you like (you can upload via WordPress Media or you can use an image that is hosted somewhere else).

   [referral_banner] image tag [/referral_banner]

   This shortcode will output a banner with referral link appended and also the code that user can copy and paste (example <a href="http://www.yourdomain.com/wp-login.php?action=register&ref=CODE"><img src="http://www.example.com/image.jpg" /></a>).

3. Use the builtin downline listing shortcode below to display the total number of successfully recommended people along with a list of them (first name and initial of the last name).

   [referral_downline]

   This shortcode will output the total number of successfully recommended people and a list of them. We recommend that you should use this shortcode on their profile page.

4. Use the builtin Facebook shortcode below to display Facebook Share & Send buttons
   
   to display the button for the default registration page and referral code, use:

   [referral_fb]

   to display the button for the current page and referral code, use:

   [referral_fb_current]

5. Use the builtin Twitter shortcode below to display Twitter button
   
   to display the button for the default registration page and referral code, use:

   [referral_twitter]

   to display the button for the current page and referral code, use:

   [referral_twitter_current]

6. Use the builtin Google+ shortcode below to display Google+ button
   
   to display the button for the default registration page and referral code, use:

   [referral_googleplus]

   to display the button for the current page and referral code, use:

   [referral_googleplus_current]

7. Use the builtin LinkedIn shortcode below to display LinkedIn button
   
   to display the button for the default registration page and referral code, use:

   [referral_linkedin]

   to display the button for the current page and referral code, use:

   [referral_linkedin_current]

Useful usage tips

You can use this plugin to attract more registered users. Install this plugin and think of rewarding existing users for example if they refer another 100 users and so on. The possibilities are endless.

Important! Now you can translate all front-end text by editing .po and .mo files located in /languages/ folder. Remember that your files must be named like wpreferral-es_ES.po and wpreferral-es_ES.mo

Thank you for purchasing WP Referral.
If you like WP Referral please do not forget to rate our work.

WP Referral uses tablesorter, a client-side table sorting jQuery plugin written by Christian Bach.

To see our full Envato portfolio click here.