內容簡介
Coin of the Realm 是一個系統，允許 WordPress 出版者為連結回到他們的部落格的讀者提供獎勵。它在本質上是一個為一般用戶設置的聯盟系統，將群眾籌資和標準的聯盟模型結合起來。
Coin of the Realm 的工作方式是為每個已註冊用戶在 WordPress 網站上的所有頁面和文章生成唯一的連結。當該用戶在其他網站上使用該連結參考該網站時，每個點選該連結的讀者都會在 COTR 系統中產生一個推薦。COTR 將推薦轉換為幣，註冊用戶可以使用這些幣在自動生成的商店頁面上購買東西。
Coin of the Realm 支持三種類型的獎勵產品：數位下載、評論徽章和捐款活動。這些產品在商店界面中很容易創建，可以使用推薦產生的幣或常規貨幣購買。COTR 支持 PayPal 和 Verotel 付款閘道進行購買。
有關更多信息，請訪問 COTR 留言板。
注意事項：
- 推薦價值不會更新，直到您保存頁面。
- COTR 使用 IP 地址防止單個用戶產生多個“推薦”行為。這可以防止濫用，但在發放幣時會讓系統變得吝嗇。
- 更改賺取一個幣所需的推薦數量不會改變用戶已經賺取的幣數量。最好先設置 Referral IP Coin Value，然後根據需要修改個別產品的幣成本。
- 心理學上，當系統易於賺取幣時，用戶對系統的反應更好，並且可以看到自己朝著目標取得進展。建議將 Referral IP Coin Value 設置低為1或2。
即時購買設置
即時購買設置允許用戶用現金而不是通過推薦賺取幣來購買產品。填寫此部分可以將 COTR 商店轉換為傳統的購物車系統，並基於幣設置的聯盟系統。雖然這些設置是可選的，但通常最好填寫其中一些，以通過 COTR 賺取金錢和推薦。
如果您不填寫這些字段，與付款網關相關聯的立即購買按鈕將不會出現在頁面上。COTR 允許兩種付款網關系統。通用內容的 PayPal 和成人內容的 Verotel。雖然兩個付款網關都可以在同一個站點上運行，但同時運行 PayPal 和 Verotel 是不尋常的。
注意事項：
- 目前沒有辦法按產品選擇可用的付款網關，這些是所有產品的全局設置。
- Verotel 設置需要與您的 Verotel 帳戶進行整合。最好聯繫您的銷售代表指導您完成此過程。
- 要通過 PayPal 收款，請完成以下步驟。
1. 在 PayPal handel 中輸入您的 PayPal 登錄電子郵件。
2. 輸入您將使用的貨幣的三位數貨幣代碼。您可以在此處找到 PayPal 使用的所有代碼列表：https://cms.paypal.com/us/cgi-bin/?cmd=_render-content&content_ID=developer/e_howto_api_nvp_currency_codes
3. 測試模式設置為否。測試模式用於 PayPal 沙盒帳戶，以測試購買，而不使用真正的資金。如果要使用 PayPal 沙盒帳戶，可以在此處設置：https://developer.paypal.com/
訊息
消息部分是您設置顯示消息的位置。省略譯文。
外掛標籤
開發者團隊
原文外掛簡介
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.
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.
For more information visit the COTR message board.
Message Board
Notes:
The referral worth will not update until you save the page
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
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
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.
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.
[product_name] – Places the name of the product in plain text
[product_description] – Places the description field of the product in plain text
[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
[product_cost_coins] – Places a text number equal to the cost of the product in coins for free product the hook does no display
[product_cost_cash] – Places a text number equal to cash cost of the product. If the product is free it displays a 0.
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
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.
Tools
The follow section details the tools you now have available to you after setting up COTR
Store Page
If you edit the store page you will find a single hook that generates the store. [sb_vc_store].
Add any text and formatting around the hook to generate your store.
Widgets and Shortcodes
There are several Widgets and Shortcodes that are added for operation of the COTR.
Coin of the Realm
This is the main widget that give the user all the information for the operation of the Coin of the Realm account.
This information can also be places on a page with the [vc_widget_content] short code
Coin of the Realm Available Downloads
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.
This information can also be placed on a page with the use of the short code [vc_available_downloads]
Coin of the Realm Personal Link
This information can also be placed on the page with the short code [wp_vc_personal_link]
Coin of the Realm Login Widget
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.
Coin of the Realm Donation Progress Widget
This widget is used to display the progress of a donation product where ever it is place.
The donation prodcut drop down will show all donation products by their title. Do display a product select it from the dropdown
The show summary text switches on and off a line of text that states the donation target and how much has been achieved.
The show donation buttons switches on and off the donate now buttons in the widget
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.
