Sean Barton

drowemos

<p>Coin of the Realm is a system that allows WordPress publisher to reward their readers for linking back to the word press blog.  It?s at its heart an affiliate system set up for the general user instead of companies combining crowd sourcing into the standard affiliate model.</p>
<p>The way Coin of the realm works is by generating unique links to all of the pages and post on a WordPress sight for each Registered user.  When that user uses the link to reference the sight on some other website every reader who click on the link generates a referral in the COTR system.  COTR converts referrals into coins that the registered user can use to buy things in the automatically generated store page.</p>
<p>Coin of the realm supports 3 types of reward products; digital downloads, comment badges, and donation drives.  These products are quick to create in the store interface and can be purchased with either referral generated coins or with regular currency.  COTR support both the paypal and verotel payment gateways for making purchases.</p>
<p>For more information visit the COTR message board.</p>
<p><a href="http://community.910cmx.com/index.php?/forum/148-wordpress-coin-of-the-realm/" title="Coin of the Realm Message Board" rel="nofollow ugc">Message Board</a></p>
<h3>Notes:</h3>
<blockquote>
<ul>
<li>The referral worth will not update until you save the page</li>
<li>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. </li>
<li>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.</li>
<li>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.</li>
</ul>
</blockquote>
<p>Ad Hoc Purchase Settings</p>
<p>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.<br />
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.</p>
<h3>Note:</h3>
<blockquote>
<p>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.<br />
  * Verotel set up requires integrating with your Verotel account.  It is best that you contact your rep to walk you through the process.<br />
  * To accept payment through paypal complete the following steps.<br />
  1. Enter in your Paypal log in email in the Paypal handel.<br />
  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:<br />
  https://cms.paypal.com/us/cgi-bin/?cmd=_render-content&content_ID=developer/e_howto_api_nvp_currency_codes<br />
  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:<br />
  https://developer.paypal.com/</p>
</blockquote>
<h3>Messages</h3>
<p>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.</p>
<ul>
<li>Fill out the three messages on this page with the HTML and text that you wish to apear</li>
</ul>
<ol>
<li>HTML in the Can?t purchase message will appear under every product in the COTR store when a user is not logged in.</li>
<li>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.</li>
<li>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. </li>
</ol>
<p>Template Setting</p>
<p>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.</p>
<ul>
<li>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.</li>
</ul>
<ol>
<li>[product_name] – Places the name of the product in plain text</li>
<li>[product_description] – Places the description field of the product in plain text</li>
<li>[product_image] – Places an image tag that has it?s source correspond to the uploaded ?image? of the product</li>
<li>[product_image_url] – Places a plain text url of the source of the ?image? uploaded into the product</li>
<li>[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</li>
<li>[product_cost_coins] – Places a text number equal to the cost of the product in coins for free product the hook does no display</li>
<li>[product_cost_cash] – Places a text number equal to cash cost of the product.  If the product is free it displays a 0.</li>
<li>[product_buy_now_coins] – Places a ?buy now X coins? visible to loged in user who have enough coins to complet the purchace</li>
<li>[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.</li>
<li>[product_coins_awarded] – Places the text ?Coins awarded for purchasing this product: X? if the products awards coins </li>
<li>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.</li>
</ol>
<p>Registering and Loging in</p>
<p>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.</p>
<ul>
<li>Navigate to the Setting menu and then the General Setting sub menu</li>
<li>Locate the Membership heading and check the box next to Anyone can register</li>
<li>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.</li>
<li>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?</li>
</ul>
<h3>Note</h3>
<blockquote>
<p>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.</p>
</blockquote>
<h3>Note</h3>
<blockquote>
<p>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/</p>
</blockquote>
<p>Setup Complete</p>
<p>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.</p>
<h3>Tools</h3>
<p>The follow section details the tools you now have available to you after setting up COTR</p>
<p>Store Page</p>
<p>Upon the fist install of COTR and new page is created on your site.  The name of the page will be ? Store?.</p>
<ul>
<li>If you edit the store page you will find a single hook that generates the store. [sb_vc_store].   </li>
<li>Add any text and formatting around the hook to generate your store.</li>
</ul>
<p>Widgets and Shortcodes</p>
<p>There are several Widgets and Shortcodes that are added for operation of the COTR.</p>
<h3>Coin of the Realm</h3>
<ul>
<li>This is the main widget that give the user all the information for the operation of the Coin of the Realm account. </li>
<li>This information can also be places on a page with the [vc_widget_content]  short code</li>
</ul>
<h3>Coin of the Realm Available Downloads</h3>
<ul>
<li>This widget is only visible if  the user has made a purchase or if you have entered text into the no available download text box on the widget.  The widget provides links to all products that the user has purchased for ease of retrieval.</li>
<li>This information can also be placed on a page with the use of the short code  [vc_available_downloads]</li>
</ul>
<h3>Coin of the Realm Personal Link</h3>
<ul>
<li>This widget displays the personal link of what ever page it?s for the user without any other formatting or information.</li>
<li>This information can also be placed on the page with the short code [wp_vc_personal_link]</li>
</ul>
<h3>Coin of the Realm Login Widget</h3>
<ul>
<li>This widget proved a small login box where it is placed instead of forcing the user to go to a login page.  It is only visible when users are not loged in.</li>
</ul>
<h3>Coin of the Realm Donation Progress Widget</h3>
<ul>
<li>This widget is used to display the progress of a donation product where ever it is place.  </li>
<li>The donation prodcut drop down will show all donation products by their title.  Do display a product select it from the dropdown</li>
<li>The show summary text switches on and off a line of text that states the donation target and how much has been achieved.</li>
<li>The show donation buttons switches on and off the donate now buttons in the widget</li>
<li>This information can also be placed on a page with the use of the short code [vc_donation_progress product_id=X] where X is the id number of the donation product.  The button has two optional switches to hide parts of the the display hide_description=1 hide_buttons=1.</li>
</ul>


Coin of the Realm

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

stevevls

sergeyvlasov

davegrun

<p>The GTS Translation plugin provides human quality translation by allowing you to combine automatic translation and human post-editing (crowdsourcing). Your blog content is initially translated by our translation server. The content is then post-edited by human translators through our online editing system. You can use the GTS community of translators, or you can assign the post-editing to your own community of translators to maintain complete control of the process.</p>
<p>When you use the GTS Translation plugin, translated content is cached in your WordPress database and indexed by search engines. This will increase the traffic to your website and grow your international readership.</p>
<p><strong>Features:</strong></p>
<ul>
<li>Guaranteed to increase your traffic by at least 30% after 2 months; some customers have seen over 100% increase in traffic</li>
<li>Supports over 30 languages</li>
<li>Uses private, secure translation server</li>
<li>Publish translated content immediately or following review</li>
<li>Crowdsourcing: create your own community of translators or use our community</li>
<li>SEO: translates Permalink URL names and meta tags</li>
<li>Custom online, side-by-side editor makes post-editing easy</li>
<li>Translated posts can be retweeted</li>
</ul>
<h3>Uninstalling</h3>
<p>Simply click the “Delete” link in the plugin management window.  This will delete all of your translated data, so<br />
please be careful!</p>
<h3>Virtual Host Setup</h3>
<h3>How to setup the Virtual Host feature on the GTS Plugin</h3>
<p>By default, the translated versions of your website/blog resolves to a URL address which is a subdirectory of your site’s URL address. For example,<br />
the Spanish version of your site resolves to http://mywebsite.com/language/es.</p>
<p>With the GTS Translation Plugin Virtual Host feature you can publish translated versions of yor website/blog under a separate subdomain or top-level<br />
domain (TLD). So for example, if your blog is www.mywebsite.com you can serve the Spanish version from www.mywebsite.es.  Alternately, you can use<br />
 subdomains (e.g. es.mywebsite.com) so that you don’t have to buy a domain for each language.</p>
<p>To implement the virtual hosts feature, follow these steps:</p>
<h3>1. Configure DNS</h3>
<p><strong>For Top Level Domains:</strong></p>
<ol>
<li>Register your new domain (e.g. www.mywebsite.es.) with a recognized domain registrar.</li>
<li>In your DNS zone, set the A record for www.mywebsite.es to point to the IP address of your web server.</li>
</ol>
<p><strong>For Subdomains:</strong></p>
<ol>
<li>Create a CNAME alias for your web server (e.g. es.mywebsite.com)</li>
</ol>
<p>How to complete these steps will depend on your hosting provider.  If you get stuck, please follow up with your support team.</p>
<h3>2.  Configure your Web Server</h3>
<p>Please note that all of the translated blogs will be hosted from the same WordPress installation as your current blog.</p>
<p><strong>For Hosted Blogs:</strong></p>
<p>Your hosting provider will provide a control panel to map a hostname to a Document Root.  For each translated host name, enter the exact same Document<br />
Root as your blog.</p>
<p><strong>For Self-hosted Blogs:</strong></p>
<p>These instructions are only valid for Apache.  If you use IIS or another web server, please consult the relevant documentation.</p>
<p>First off, you need to be set up with Name Based Virtual Hosts (http://httpd.apache.org/docs/2.0/vhosts/name-based.html).  Once you have your blog’s<br />
virtual host set up, add the new hostname to the ServerAlias directive.</p>
<blockquote>
<pre><code><VirtualHost *:80>

  ServerName     www.mywebsite.com
  ServerAlias    www.mywebsite.es
  DocumentRoot   /path/to/wordpress/install

  # Other configuration here...

</VirtualHost>
</code></pre>
</blockquote>
<p>If you have multiple aliases, remember that the ServerAlias can be a list or can include wildcards…it can save time!</p>
<h3>3.  Configure the GTS Plugin</h3>
<p>This is the easiest part:</p>
<ol>
<li>Go to the “GTS Settings” admin page.</li>
<li>Enter the host name in the “Virtual Host” input next to the desired language.</li>
<li>Click the “Save Changes” button.</li>
</ol>
<p>Voila, translated links will point to your new host!</p>
<h3>Security</h3>
<p>While providing high quality translation with our crowdsourced post-editing functionality, it’s of the utmost importance<br />
to ensure the security of your blog.  We provide functionality that is out-of-band of the traditional WordPress publishing<br />
cycle.  As such, our plugin adds a hook into your blog that allows GTS to programmatically update the translated content<br />
in your local WordPress database.  We’ve put a lot of thought into ensuring that our system can use this hook while locking<br />
it against any potential malicious users.</p>
<p>The first step to securing our system is to make sure that it’s really <em>you</em> and your blog requesting that your blog be<br />
signed up for translation.  First, we only accept registration requests that originate from the WP admin page of the blog<br />
that will be translated.  When the user clicks off of the admin page, a digital fingerprint is created and saved to your<br />
WP database, and then it’s sent over an SSL-encrypted channel to our server.  When the registration request reaches our<br />
server, we will open an HTTP connection back to the requesting blog and verify that a) it has our plugin installed, and b)<br />
using an encryption technique called hashing, that the fingerprint matches.  If one of those checks fail, we won’t register<br />
 the blog for translation.</p>
<p>Now that we’ve verified the blog, we’ll assign you a Blog ID and an API Access Key.  These will be automatically added to<br />
your configuration panel via the registration panel, plus they will be sent to your administrator email address.  We will<br />
use these two strings for identifying your blog and to ensure that information isn’t tampered either en-route to us.  It<br />
will also be used by your blog to verify that translated content posted back to your blog is legitimate.  Again, we use<br />
an encryption technique called hashing.  Whenever your blog sends a translation request to us or we send translated content<br />
back to you, we create a signature (or hash) of that content PLUS the API Access Key (if you’re really interested in details,<br />
using the SHA-1 algorithm).  Provided that the API Access Key is kept secret, this technique is extremely secure and resistant<br />
to tampering.  The odds of a malicious person guessing your API key are astronomical : more than 1 in 10^229.  However,<br />
as with any password, security depends on keeping it secret.  If at any time, you think that your key has been compromised,<br />
GTS will deactivate the current key and issue you a new one.</p>
<p>Other measures we take to secure data coming back to your blog include using a whitelist of IP addresses that are allowed<br />
to use the hook for posting translated content and limiting the size of the post to ~250KB so that, even if all other measures<br />
fail, an attacker can’t eat up all the memory on your machine.</p>
<p>We have dedicated lots of thought to locking down this system, and we are very confident that it’s secure.<br />
After reading this, we hope you will be too!</p>


GTS Translation Plugin

This plugin is guaranteed to drive more international traffic to your site by providing high quality translation, and SEO of your translated content.

Coin of the Realm vs GTS Translation Plugin