Piano VX Drupal 7 plugin


From your Drupal dashboard, go to Modules and click “Install new module.” Find the VX plugin in the Drupal directory on drupal.org or upload the plugin directly. Please get in touch with us for the Piano VX Drupal plugin: sales@piano.io or through your Piano client services contact.

Install the plugin following the directions in Drupal, and you will be greeted by a success message. Module Install

Piano Settings in Drupal

Once installed, return to the Modules page in Drupal, click Configure on the Piano VX module to connect Drupal to Piano VX. These settings are known as your Connection Settings in Drupal.

Copy paste your application ID and API token from your Piano dashboard homepage to Drupal.

Choose your environment, production or sandbox.

Pick your business model, choosing between metered paywall or hard/keyed paywall. If opting for a metered paywall, enter in your paywall ID found in your Piano dashboard under products → metered paywall. If your business model involves Composer, choose Hard/keyed paywall.

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.

Other General Settings

  • Disable Piano VX for privileged users: Piano VX will be skipped for Drupal 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 to stylize this premium post tag, such as a small key icon or the PRO icon as seen here:

Use the following to add your own CSS to stylize the premium post tag:

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

First click settings

  • 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

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

Resource settings

On this page 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 Drupal. To associate a resource to certain tags like section, author, content type, dates, designate those tags both in Drupal and the resource settings within Piano.

Connecting content to terms and resources

  • There is more than one way to connect a post or article to your terms and resources. Once you have configured your resource settings in Drupal (and after you have created terms → resources → offers), you can then mark resources in Piano by their tag within Drupal, or you can choose within the Drupal dashboard what posts that you want to protect. To do so, navigate to the Content tab in your Drupal dashboard and choose Edit on that post. As seen below:

  • If using the <!–vxmore–> tag to specify when in an article to show your offer, you can place that in the article now.
  • Scroll to the bottom of the post and you are presented with a menu of options, click into the Piano VX content settings

  • From these content settings, you will be able to choose to key or not key the content. If keyed (protected/gated), select which resource to include that content in.
  • Check out the video below to see it all in action. (This is a non-metered model, debugger enabled, the System template of default offer has edited HTML, and the offer is presented in a modal window). If the video doesn't show at first, please reload the page.