[wordpress插件] Coin of the Realm领域的硬币

Coin of the Realm is a system that allows WordPress publisher to reward their readers for linking back to the word press blog.

The Realm of Realm是一个系统，允许WordPress发布者通过链接回Word Press博客来奖励其读者。

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.

它的核心是为普通用户建立的会员系统，而不是将众包采购纳入标准会员模型的公司。

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.

领域硬币的工作方式是生成指向所有页面的唯一链接，并在WordPress视域中为每个注册用户发布。

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系统中生成一个引荐。

COTR converts referrals into coins that the registered user can use to buy things in the automatically generated store page.

COTR将推荐人转换为硬币，注册用户可以使用该硬币在自动生成的商店页面中购买商品。

Coin of the realm supports 3 types of reward products;

该领域的硬币支持3种类型的奖励产品；

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.

COTR支持Paypal和Verotel付款网关进行购物。

For more information visit the COTR message board.

有关更多信息，请访问COTR留言板。

"nofollow">Message Board

“ nofollow”>留言板

Notes:

注意：

• The referral worth will not update until you save the page
• 在您保存页面之前，推介价值不会更新

• COTR use ip addresses to prevent multiple ?referals?

• COTR使用IP地址来防止多个“推荐”？

  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.

最好一次设置引荐IP代币值，然后根据需要修改单个产品的代币成本。

• 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.

建议将引荐IP代币值设置为1或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.

填写此部分，将COTR商店转变为传统的购物车系统，该系统位于由硬币建立的附属系统之上。

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.

虽然这些设置是可选的，但通常填写其中一些来赚钱以及通过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.

COTR允许两个支付网关系统。

Paypal for sites with general content and Verotel for site with mature content.

Paypal用于具有常规内容的网站，而Verotel用于具有成熟内容的网站。

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.

虽然两个支付网关都可以在同一站点上处于活动状态，但是同时运行Paypal和Verotel并不常见。

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.

* Verotel设置需要与您的Verotel帐户集成。

It is best that you contact your rep to walk you through the process.
  

最好与您的代表联系，以逐步完成该过程。
  

* To accept payment through paypal complete the following steps.
  

*要通过Paypal接受付款，请完成以下步骤。
  

1. Enter in your Paypal log in email in the Paypal handel.
  

1.在Paypal交易记录中输入您的Paypal登录电子邮件。
  

1. Type in the 3 digit currency code for the currency you will be using.

1.输入您要使用的货币的3位数字货币代码。

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
  

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.

1.将测试模式设置为“否”。测试模式用于Paypal沙箱帐户，无需使用真实货币即可测试出购买商品。

If you want to use a paypal sandbox account you can set it up here:
  

如果要使用贝宝沙箱帐户，可以在此处进行设置：
  

https://developer.paypal.com/

https://developer.paypal.com/

Messages

消息

The message section is where you set up the dispaly messages for various points in the COTR system.

消息部分是您在COTR系统中为各个点设置显示消息的地方。

These are raw html code boxes that you can use to put any html text on the page.

这些是原始html代码框，可用于在页面上放置任何html文本。

• Fill out the three messages on this page with the HTML and text that you wish to apear
• 用您希望显示的HTML和文本填写此页面上的三则消息

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将会显示在COTR商店中的每个产品下方。

3. 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.
4. 如果捐赠后没有与捐赠相关联的下载，则“捐赠感谢”消息中的HTML仅会出现在捐赠的主商店条目上。

5. The Comment Badge Intro text places HTML code above the badges in a users comment.

6. 评论徽章简介文本将HTML代码放在用户评论的徽章上方。

   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.

“模板设置”部分设置COTR商店中产品的布局。

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.

• “商店列表项目行”是显示产品的HTML字段。

  As well as using standard HTML and CSS formating the feilds uses a number of custom hooksto display product specific information.

  除了使用标准的HTML和CSS格式外，这些字段还使用了许多自定义的钩子来显示特定于产品的信息。

  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_name] –用纯文本形式放置产品名称

3. [product_description] – Places the description field of the product in plain text
4. [product_description] –将产品的描述字段以纯文本格式

5. [product_image] – Places an image tag that has it?s source correspond to the uploaded ?image?

6. [product_image] –放置一个图像标签，其来源对应于上载的“ image”？

   of the product

产品的

7. [product_image_url] – Places a plain text url of the source of the ?image?

8. [product_image_url] –放置？image源的纯文本url？

   uploaded into the product

上传到产品中

9. [product_download_url] – Places a Download now button that can be use to download the product.

10. [product_download_url] –放置可立即用于下载产品的立即下载按钮。

    It is only visible if the product has been purcahced

仅在购买产品后才可见

11. [product_cost_coins] – Places a text number equal to the cost of the product in coins for free product the hook does no display
12. [product_cost_coins] –将一个等于产品成本的文本数字放入硬币中，钩子不显示免费产品

13. [product_cost_cash] – Places a text number equal to cash cost of the product.

14. [product_cost_cash] –放置一个等于产品现金成本的文本数字。

    If the product is free it displays a 0.

如果该产品免费，则显示0。

15. [product_buy_now_coins] – Places a ?buy now X coins?

16. [product_buy_now_coins] –放置一个？现在购买X个硬币？

    visible to loged in user who have enough coins to complet the purchace

拥有足够硬币来完成购买的登录用户可见

17. [product_buy_now_cash] – Places a ?Buy now button X USD?

18. [product_buy_now_cash] –放置“立即购买”按钮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.

此按钮仅对已登录的用户可见。

19. [product_coins_awarded] – Places the text ?Coins awarded for purchasing this product: X?

20. [product_coins_awarded] –放置文本？购买此产品获得的硬币：X？

    if the products awards coins

如果产品奖励硬币

21. 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.

22. 商店主页的完整描述控制着“商店”页面显示产品的完整描述还是显示带有更多按钮的产品专家以查看完整的描述。

    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.

要使用COTR，您的用户需要在您的wordpress网站上进行很多注册然后登录。

The wordpress site must also have it?s setting changed from the default to allow login.

WordPress网站还必须将其设置从默认设置更改为允许登录。

• 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.

在您网站的某个位置放置一个指向{Base site url} /wp-login.php?action=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?

为此，您可以在页面上放置登录小部件（下面详细介绍）或提供指向登录页面的链接：{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.

在撰写本文档时，我们发现最好的插件是oneall社交登录插件。

http://www.oneall.com/services/single-sign-on/

http://www.oneall.com/services/single-sign-on/

Setup Complete

设置完成

After completing these steps the Coin of the Realm software will be functional.

完成这些步骤后，Realm软件的Coin将起作用。

The next sections cover page layout of COTR and creating products to sell.

下一节将介绍COTR的页面布局以及创建要销售的产品。

Tools

工具

The follow section details the tools you now have available to you after setting up COTR

以下部分详细介绍了设置COTR后您现在可以使用的工具

Store Page

商店页面

Upon the fist install of COTR and new page is created on your site.

首先安装COTR，然后在您的站点上创建新页面。

The name of the page will be ?

页面的名称将是？

Store?.

商店吗？

• If you edit the store page you will find a single hook that generates the store.

• 如果您编辑商店页面，则会找到一个生成商店的钩子。

  [sb_vc_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.

为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.

• 这是主要的小部件，可为用户提供有关Realm帐户的Coin操作的所有信息。

• This information can also be places on a page with the [vc_widget_content] short code
• 此信息也可以放在带有[vc_widget_content]短代码的页面上

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]
• 此信息也可以使用短代码[vc_available_downloads]放置在页面上

Coin of the Realm Personal Link

领域个人链接硬币

• This widget displays the personal link of what ever page it?s for the user without any other formatting or information.
• 此小部件无需显示任何其他格式或信息，即可为用户显示该页面的个人链接。

• This information can also be placed on the page with the short code [wp_vc_personal_link]
• 此信息也可以使用短代码[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.

• 此信息也可以使用短代码[vc_donation_progress product_id = X]放置在页面上，其中X是捐赠产品的ID号。

  The button has two optional switches to hide parts of the the display hide_description=1 hide_buttons=1.

该按钮具有两个可选开关，以隐藏部分显示hide_description = 1 hide_buttons = 1。

1. Upload plugin-name.php to the /wp-content/plugins/ directory
2. 将 plugin-name.php 上载到 / wp-content / plugins / 目录

3. Activate the plugin through the ‘Plugins’ menu in WordPress
4. 通过WordPress中的“插件”菜单激活插件

Uploading files (optional)

上传文件（可选）

• Open up a ftp connection to your wordpress site
• 打开与您的wordpress网站的ftp连接

• Navigate to the /wp-content/plugins/ directory off of the main site
• 导航到主站点之外的/ wp-content / plugins /目录

• Upload the Coin of the realm folder and all sub folders into the directory.

• 将realm文件夹和所有子文件夹的Coin上载到目录中。

  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
• 激活后，您将获得3个新菜单，COTR产品，COTR徽章和领域硬币

• To complete the installation go to the Coin of the Realm menu and the base Coin of the Realm sub page
• 要完成安装，请转到Realm菜单的Coin和Realm子页面的基本Coin

General Setting

常规设置

The general setting are required for the proper operation of COTR.

一般设置是正确运行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.

该值可以是大于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.

大于1的数字表示硬币的价值大于一美元（或您使用的任何货币），反之，小于1的小数则表示该硬币仅值一分钱。

• The Disable Badges drop down should be left to the default of No unless you experience errors on your comment pages after installing COTR.

• 除非安装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.

在某些自定义模板上，徽章系统与评论过程有关，在此情况下添加了此下拉菜单以停用徽章。