Piano VX WordPress plugin

Installation

  1. In your WordPress dashboard, go to Plugins → Add New and either upload or search for Piano in the plugin directory, then simply click “install” and then “activate.”
  2. If you haven't already, go to our registration page to create a publisher account. Send an email to [email protected] to inquire about VX qualification.
  3. Copy your Application ID and your API token from your Piano dashboard into your general settings for the Piano plugin settings in Wordpress.
  4. Environment: choose between production and sandbox, (dedicated is our internal Sandbox environment for testing, updates and fixes).
  5. Choose between a metered paywall or a hard/keyed paywall. Check here to decide which model is best for you.
    • Metered paywall: enter your paywall ID found in your Piano dashboard → Products → metered paywall.
    • Hard/Keyed - you can choose between locking all content, or choosing which content to lock by selecting tags and URLs.

WordPress plugin: General settings

Pay-per-post vs. Subscriptions

  • Yes = Pay-per-post allows you to sell access to any page or post individually. Creating a term (price) within WP automatically creates that term within your Piano dashboard for reporting, user management, and access rights purposes.
  • No = I only want to sell subscriptions. Choose this option if you have no interest in selling single posts.

First Click Settings: referral sources

  • No external referrers are first click free: choose this option to treat all users the same, regardless of what site or search engine they are coming from.
  • All external referrers are first click free: choose this option to not increment a meter on a user’s first click, when normally a single pageview would be decremented.
  • Only the following domains are enabled for first click free: choosing this option allows you to specify which domains you want to enable first click free for. You could specify twitter.com or google.com, a sister-site, etc..
  • All domains except for the following are enabled for first click free: click this option if you would like to allow all domains to be first click free with certain domain exceptions.

Display mode settings

Choose how you wish to display offers on your website, either inline within the content, or in a modal that obfuscates.
modal→ display modal offer inline→ Display inline offer

Other general settings

  • Disable Piano VX for privileged users - Piano VX will be skipped for WordPress website moderators that are logged in.
  • Enable debugger: choose this option to use the debugger to assist in the detection and correction of errors in the program. Signifying login status and access status in a pop up. Viewable to site admins only.
  • Enable Composer: click this box to enable composer, setting up business rules for user experiences inside your Piano dashboard. To be used with auto-generated Javascript embed code.
  • Enable premium tag in post titles: You can add CSS rules to stylize this premium post tag, such as a small key icon or the PRO icon as seen here:


Put in the CSS file on your website to style the premium tag:

.tinypass-title-premium-no-access { content: 'pro'; } 
.tinypass-title-premium-has-access { display: none; }

Content truncation settings

  • Hide all content: to not show any preview, choose this option.
  • Hide everything after “X number” paragraphs: for every page, an inline offer will show after the indicated number of paragraphs.
  • Let me specify myself using the “Piano VX more” tag: maintain the choice to choose where on each post to show an offer, the “Piano VX more” tag will appear in the wysiwyg editor of each page for you to insert on a post at the depth of your choice. The blue icon will show:
  • Let me specify myself using tinypass_no_access filter. Add your own truncation function to, for example, always render the offer after the first video on a certain section on your site.

Default access settings

  • Always keyed – Only subscribers can view this content
  • Never keyed – Anyone can view this content

My Account shortcode

  • Use [tp_my_account] shortcode to display “My Account” module. To allow users to administer their account while on your site, use this shortcode to display the widget. It's white-labeled, and about as easy as it gets to install. In WordPress, create a new page, and paste [tp_my_account] on that page. To allow registrations to your site, in your WordPress dashboard go to Settings → General Settings → Membership



The widget will show up like so for your logged in users, it is highly customizable through your templates.

WordPress Resource Settings

On this tab you have the option to enable the terms you have created in your Piano dashboard.

As you can see in the picture to the right, each term is connected to a resource. The Business and Finance resource has two terms connected to it, an account registration and a paid subscription. You can pick and choose which ones to enable for selection on your site on this resource tab. To connect a resource to specific posts or pages, you will do so within the post or page on WordPress. To associate a resource to certain tags like section, author, content type, date, designate those tags both in WordPress and the resource settings within Piano.



Connecting Resources and Terms within WordPress

For each post and page in WordPress, you have the option of choosing whether that content is always keyed, or never keyed. If you click the box for always keyed, you then can pick which term(s) to use to protect that post or page.