Piano for WordPress
You can download the Piano (tinypass) plugin from the WordPress plugin directory – or, in your WordPress dashboard, go to Plugins > Add New and search for the “tinypass” plugin. For more information about how to use WordPress and their plugins, go to http://codex.wordpress.org. Also, Piano is proud to be a member of the WordPress Featured Partner Program, which means you can use Piano within the hosted WordPress Enterprise and WordPress VIP programs.
Please note: Are you looking for pay-per-post functionality? Check out our v2.0 plugin documentation in our Developer guide here. Note that the 2.0 version of the plugin is a bit more advanced, so proceed only if you are well-versed in WordPress! Publishers currently using v2.0 of the Piano plugin should contact support@Piano.io before upgrading to the v3.0 plugin.
The documentation below is for the v3.0 plugin. This is the default version that gets installed when you activate our plugin.
To get Piano up and running on your WordPress site, you will first need sign in to your Piano account.
Click on ‘Start’ next to Paywall you want to set up on your WordPress site and configure your Paywall to meet your particular business needs. Check out the Paywall article for configuration instructions.
Once you have created your Paywall, the only thing we’ll need to continue the setup within WordPress is your Paywall ID. Your Paywall ID can be found on the left hand side of the Paywall Management screen.
Copy your Paywall ID to your clipboard as you will need it later during the plugin installation.
In your WordPress dashboard go to Plugins > Add New along the left-hand rail. From the Install Plugin page, you can either upload Piano (Tinypass) if you have already downloaded the plugin in .zip format to your machine, or you can search for the Piano (Tinypass) plugin and simply click “Install Now” followed by “Activate Plugin.”
Along the left hand rail of your WordPress dashboard you will now see the installed Piano tab. Hover over the Piano tab and select ‘Paywall’ to pull up the setup page which is broken out into three sections.
Enter your Paywall ID
This is the number which you copied from the left-hand side of the Paywall Management screen on the Piano Publisher Dashboard.
Tag your Premium Content
Here you’ll need to determine a tag or tags that mark premium content. Tags are extremely important in implementing the Piano Paywall on WordPress.
First, you’ll need to determine what tag or tags will be associated with premium content. Simply add those tags in the area marked “Select the tags of the content you want to be restricted.” Note that at least one post on your website must already be associated with this tag, otherwise you’ll see an error message when you click save later on.
Then you’ll need to tag existing premium posts with the same restricted tag, as well as all subsequent posts you wish to restrict.
A special word about tags – they are incredibly important. You need to associate your posts with a tag(s) in order to protect access to your post using Piano. If a post does not have a tag associated with it, Piano cannot protect the post via the WordPress plugin.
Customize the integration
There are currently two additional features that you can enable/disable depending on your needs.
Track on home page visit – this feature allows you to count a visit to the home page as a view if you have Previews activated within your Piano Dashboard. Typically only views to restricted content are counted but you do have the option of counting a visit to the home page as a view as well.
Disable Piano for privileges users – if you have additional users set up within WordPress such as Editors, Authors, Contributors, etc. this will disable the Paywall functionality for them so when they are adding or editing content and then view it on your site they won’t encounter a paywall.
Click ‘Save Changes’ above and then click on the ‘General’ tab under Piano in your WordPress account.
The General tab
There are a couple of important things to note about this screen. Under ‘Environment’ you see that you have the option of two settings, Sandbox and Live. The environment automatically defaults to Sandbox.
If you want to test your paywall first, go to http://sandbox.piano.io/ and create a Sandbox Publisher account. Your Piano account is not associated with your Sandbox account, they are completely separate.
Sandbox mode is meant for testing purposes only and is a completely separate dashboard (You’ll be able to tell by the “Sandbox” banner in the top right corner). The Sandbox is an exact replica of the Piano Publisher Dashboard, except when you implement the Sandbox paywall, when it’s time to complete the purchase process, no real money is required. For more information please visit the Sandbox documentation.
Shortcode – embedding the curtain to a link
Under ‘Other’ you have the ability to copy and paste a WordPress ‘short code’ link into Posts or Pages so you can generate a link that will open the Piano popup on that page.
You might use this feature on Posts or Pages where you want to outline the benefits of subscribing and having them click on a link to subscribe. This allows you to trigger the Paywall from that page instead of requiring a visitor to first find your premium content and triggering the Paywall from there.