Title: Coin of the Realm Author: drowemos Published: 2012-02-19 Last modified: 2012-02-19 --- Szukaj wtyczek Wtyczka **nie została przetestowana z trzema ostatnimi głównymi wydaniami WordPressa**. Może nie być już utrzymywana lub obsługiwana, co może skutkować problemem ze zgodnością z nowszymi wersjami WordPressa. ![](https://s.w.org/plugins/geopattern-icon/coin-of-the-realm.svg) # Coin of the Realm Autor: [drowemos](https://profiles.wordpress.org/drowemos/) [Pobierz](https://downloads.wordpress.org/plugin/coin-of-the-realm.zip) * [Szczegóły](https://pl.wordpress.org/plugins/coin-of-the-realm/#description) * [Recenzje](https://pl.wordpress.org/plugins/coin-of-the-realm/#reviews) * [Instalacja](https://pl.wordpress.org/plugins/coin-of-the-realm/#installation) * [Rozwój](https://pl.wordpress.org/plugins/coin-of-the-realm/#developers) [Wsparcie](https://wordpress.org/support/plugin/coin-of-the-realm/) ## Opis 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](http://community.910cmx.com/index.php?/forum/148-wordpress-coin-of-the-realm/) ### 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 1. 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. 2. 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_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 4. [product_cost_coins] – Places a text number equal to the cost of the product in coins for free product the hook does no display 5. [product_cost_cash] – Places a text number equal to cash cost of the product. If the product is free it displays a 0. 6. 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. ## Instalacja 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 * 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. ## Najczęściej zadawane pytania [Message Board](http://community.910cmx.com/index.php?/forum/148-wordpress-coin-of-the-realm/) The basic idea is to give WordPress authors a way to reward their readers for sharing the WordPress site. The viral sharing of a website is key to its success you could even say that sharing of sites is the coin of the realm (get it nudge nudge wink wink) but there has been no tool to reward this essential behavior. ## Recenzje Wtyczka nie ma jeszcze żadnej recenzji. ## Kontrybutorzy i deweloperzy „Coin of the Realm” jest oprogramowaniem open source. Poniższe osoby miały wkład w rozwój wtyczki. Zaangażowani * [ drowemos ](https://profiles.wordpress.org/drowemos/) * [ Sean Barton ](https://profiles.wordpress.org/seanbarton/) [Przetłumacz wtyczkę “Coin of the Realm” na swój język.](https://translate.wordpress.org/projects/wp-plugins/coin-of-the-realm) ### Interesuje cię rozwój wtyczki? [Przeglądaj kod](https://plugins.trac.wordpress.org/browser/coin-of-the-realm/), sprawdź [repozytorium SVN](https://plugins.svn.wordpress.org/coin-of-the-realm/) lub czytaj [dziennik rozwoju](https://plugins.trac.wordpress.org/log/coin-of-the-realm/) przez [RSS](https://plugins.trac.wordpress.org/log/coin-of-the-realm/?limit=100&mode=stop_on_copy&format=rss). ## Meta * Wersja **2.4** * Ostatnia aktualizacja **15 lat temu** * Włączone instalacje **10+** * Wersja WordPressa ** 3.1 lub nowszej ** * Testowano do **3.3.2** * Język * [English (US)](https://wordpress.org/plugins/coin-of-the-realm/) * Tagi * [affiliate](https://pl.wordpress.org/plugins/tags/affiliate/)[badges](https://pl.wordpress.org/plugins/tags/badges/) [crowdsourcing](https://pl.wordpress.org/plugins/tags/crowdsourcing/)[donations](https://pl.wordpress.org/plugins/tags/donations/) [shopping cart](https://pl.wordpress.org/plugins/tags/shopping-cart/) * [Widok zaawansowany](https://pl.wordpress.org/plugins/coin-of-the-realm/advanced/) ## Oceny Nie przesłano jeszcze żadnych recenzji. [Twoja opinia](https://wordpress.org/support/plugin/coin-of-the-realm/reviews/#new-post) [Zobacz wszystkierecenzje.](https://wordpress.org/support/plugin/coin-of-the-realm/reviews/) ## Zaangażowani * [ drowemos ](https://profiles.wordpress.org/drowemos/) * [ Sean Barton ](https://profiles.wordpress.org/seanbarton/) ## Wsparcie Masz coś do dodania? Potrzebujesz pomocy? [Zobacz forum wsparcia](https://wordpress.org/support/plugin/coin-of-the-realm/) ## Złóż datek Czy chcesz wesprzeć rozwój wtyczki? [ Wspomóż wtyczkę ](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=QPLJWKU3DJUJY)