WordPress.org

Ready to get started?Download WordPress

Plugin Directory

!This plugin hasn't been updated in over 2 years. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress.

Coin of the Realm

Reward your readers for linking to your site with digital downloads in this crowdsourcing affiliate system.

  1. Upload plugin-name.php to the /wp-content/plugins/ directory
  2. Activate the plugin through the 'Plugins' menu in WordPress
Uploading files (optional)
  • Open up a ftp connection to your wordpress site
  • Navigate to the /wp-content/plugins/ directory off of the main site
  • Upload the Coin of the realm folder and all sub folders into the directory. Make sure to upload the folder not just the content of the folder.
  • The Plugin is now ready to activate
Activating Coin of the Realm
  • Activate Coin of the Realm in the plugins page
  • Once activated you will get 3 new menus, COTR Products, COTR Badges, and Coin of the Realm
  • To complete the installation go to the Coin of the Realm menu and the base Coin of the Realm sub page
General Setting

The general setting are required for the proper operation of COTR. The general setting establish what the value of one “coin” in in terms of referals and cash. It also determines what features of Coin of the real you want to use. Ideally these setting should be set once upon installation and not changed afterwards as changing the setting can change the value of individual users accounts.

  • Set the number of unique hits that a user needs to bring in to earn a single coin. This value can be any positive whole number greater than 0.
  • Set the Coin Cash value. This can be any positive whole or decimal number that represents the conversion rate for coins into real money when the coin is donated in a donation product. Number greater than 1 mean a coin is worth more than a single dollar (or whatever currency you are using) and conversely decimals less than 1 have the coin worth only cents on the dollar.
  • The Disable Badges drop down should be left to the default of No unless you experience errors on your comment pages after installing COTR. On some custom Templates the badge system has interfeared with the commenting process this drop down is added to deactivate badges in that case.
Notes:
  • The referral worth will not update until you save the page
  • COTR use ip addresses to prevent multiple “referals” from a single user. While this prevents abuse it does make the system rather stingy when giving out coins.
  • Changing the number of referals needed to earn one coin will not change the amount of coins a user has already earned. It is best to set the Referral IP Coin Value once and then modify the coin cost of individual products as needed.
  • Psychologically user respond better to the system when it is easy to earn coins and they can see themselves making progress towards a goal. It is recommended to set the Referral IP Coin Value low at 1 or 2.
Ad Hoc Purchase Settings

The Ad Hoc Purchase Settings allow user to buy products with cash instead of coins earned through referals. Filling out this section transforms the COTR store into a traditional shopping cart system on top of the affliate system set up by the coins. While these setting are optional it’s generally useful to fill out some of them to earn money as well as referrals through the COTR. If you do not fill out these fields the associated buy now buttons for the payment gateway will not apear on the page. COTR allows for two payment gateway system. Paypal for sites with general content and Verotel for site with mature content. While both payment gateways can be active on the same site it is unusual to have both Paypal and Verotel running at the same time.

Note:

At this time there is no way to pick and chose by product what payment gateways are available these are global setting for all products. * Verotel set up requires integrating with your Verotel account. It is best that you contact your rep to walk you through the process. * To accept payment through paypal complete the following steps. 1. Enter in your Paypal log in email in the Paypal handel. 1. Type in the 3 digit currency code for the currency you will be using. You can find a list of all the code paypal uses here: https://cms.paypal.com/us/cgi-bin/?cmd=_render-content&content_ID=developer/e_howto_api_nvp_currency_codes 1. Set the test mode to No. Test mode is used for Paypal sandbox accounts to test out purchaces with out using real money. If you want to use a paypal sandbox account you can set it up here: https://developer.paypal.com/

Messages

The message section is where you set up the dispaly messages for various points in the COTR system. These are raw html code boxes that you can use to put any html text on the page.

  • Fill out the three messages on this page with the HTML and text that you wish to apear
  1. HTML in the Can’t purchase message will appear under every product in the COTR store when a user is not logged in.
  2. HTML in the Donation Thanks message will ONLY appear on the main store entry for a donation if there is no download associated with the donation after a user makes a donation.
  3. The Comment Badge Intro text places HTML code above the badges in a users comment. But only if they have purchased and are displaying a badge.
Template Setting

The Template Setting section set up the layout for the products in the COTR store. Each individual product will have the Template Setting applied to it to determine how it appears.

  • Store List Item Row is an HTML field that displays the product. As well as using standard HTML and CSS formating the feilds uses a number of custom hooksto display product specific information. These hook can be used in the template for global changes to the store or be placed in the product description later.
  1. [product_name] - Places the name of the product in plain text
  2. [product_description] - Places the description field of the product in plain text
  3. [product_image] - Places an image tag that has it’s source correspond to the uploaded “image” of the product
  4. [product_image_url] - Places a plain text url of the source of the “image” uploaded into the product
  5. [product_download_url] - Places a Download now button that can be use to download the product. It is only visible if the product has been purcahced
  6. [product_cost_coins] - Places a text number equal to the cost of the product in coins for free product the hook does no display
  7. [product_cost_cash] - Places a text number equal to cash cost of the product. If the product is free it displays a 0.
  8. [product_buy_now_coins] - Places a “buy now X coins” visible to loged in user who have enough coins to complet the purchace
  9. [product_buy_now_cash] - Places a “Buy now button X USD” on the page for any payment gateway that has been activated in the setting. This button is only visible to logged in users.
  10. [product_coins_awarded] - Places the text “Coins awarded for purchasing this product: X” if the products awards coins
  11. Shop home full description controls if the Store page shows the full description for the products or show an expert for the product with a more button to see the full description. Unless you are particularly verbose in your product description it is best to leave this to yes.
Registering and Loging in

To uses COTR you users much register on your wordpress site and then login. The wordpress site must also have it’s setting changed from the default to allow login.

  • Navigate to the Setting menu and then the General Setting sub menu
  • Locate the Membership heading and check the box next to Anyone can register
  • Once you have allowed registration you must provide you users with a link to the registration page. Place a link to {Base site url}/wp-login.php?action=register somewhere on your site for the user to register.
  • After registering the users must login. You may place the login widget (detailed below) on the page for this purpose or provide a link to the login page: {Base site url}/wp-login.php?
Note

If you are using a content managment system on your site make sure that the New User Default Role is a role not used by the content management system. If you are not careful about this you will open up secure areas of your site.

Note

It has been found with our tests that generally users are reluctant to log in with their email address and prefer to link their login to a social media site. At the writing of this documentation the best plugin to do this we have found is the oneall Social Login Plugin. http://www.oneall.com/services/single-sign-on/

Setup Complete

After completing these steps the Coin of the Realm software will be functional. The next sections cover page layout of COTR and creating products to sell.

Requires: 3.1 or higher
Compatible up to: 3.3.2
Last Updated: 2012-2-19
Downloads: 1,214

Ratings

4 stars
4.7 out of 5 stars

Support

Got something to say? Need help?

Compatibility

+
=
Not enough data

0 people say it works.
0 people say it's broken.

100,3,3