TinyPass Developer's Resources

Tinypass for WordPress

Tinypass now offers two versions of our Wordpress plugin: our v3.0 plugin and our v2.0 plugin.

The v3.0 plugin is our default plugin, built upon our flagship JavaScript paywall solution. Paywall settings are configured through your Publisher Dashboard, and all of the features available in that Publisher Dashboard (metering, curtain, and views counter) are available in this version of the plugin. Documentation for the v3.0 plugin can be found in our publisher docs.

The v2.0 plugin is our legacy plugin, built upon our API. This version of the plugin allows for pay-per-post functionality. Unlike the v3.0 plugin, you configure most of the options for the v2.0 plugin directly in your Wordpress dashboard. Because the v2.0 plugin is built on our API, we recommend that only advanced Wordpress users attempt to use this v2.0 plugin.

To switch between the two versions of the plugin, visit this how-to article in our Publisher Guide

Still unsure of which version of the plugin to use? Contact us at support@tinypass.com and we'll be happy to help.

The documentation below is for our v2.0 plugin.

Installation & Setup

1. To install the v2.0 plugin, or to switch from our default v3.0 plugin to the v2.0 plugin, please follow the steps in this article

2. If you haven't already, go to http://www.tinypass.com/register, create a free publisher account, and follow the simple instructions to register an application for your WordPress site.

3. Once you've created an application in Tinypass for your WordPress site, you'll see a Secret Key and AID. Copy those values and add them to the Tinypass plugin settings in your WordPress dashboard.

4. For testing purposes, you'll see that default values have been provided in the Sandbox fields. This will allow you to test the Tinypass plugin without processing actual payments. Make sure to switch from “Sandbox” to “Live” in Tinypass→Settings when you're ready to start accepting payments.

5. You'll also see an option to *enable* or *disable* Tinypass in your plugin settings. This is just an easy way to turn Tinypass on or off without having to modify any of your particular settings. When Tinypass is *disabled*, any content protected by Tinypass will become open and free to access. When Tinypass is *enabled*, content will be protected according to your settings.

Pay per Post

The most basic way to use Tinypass is what we call “pay per post”. This gives you a quick and easy way to charge for access to content on a single page or post on your WordPress site.

1) To start, go to Tinypass→Pay per post in your WordPress dashboard and click enable to turn on per-post sales. You'll also see the option to specify a message that your readers will see whenever they encounter a post you've protected with Tinypass. That message can be overridden to customize each post – we'll get to that in Step 4.

2) Now, whenever you're editing a page or post in WordPress, you'll see a Tinypass Post Options box, usually to the right of your WYSIWYG editor. (You may need to scroll down to see it.) Click the Modify Options button.

3) Now you'll see a Tinypass Post Options popup window where you'll set the pricing and access rules that Tinypass will use to protect the post. You can set up to three pricing and access options (e.g., $1 for 1 day, $3 for 1 week, $10 for 1 month). Just click the add/remove buttons to manage your pricing options.

For handling foreign currency, pay-what-you-want, and other cool stuff, check out the documentation here.

4) You'll also see the option to customize up to four fields that your readers will see during the purchase process:

– The caption is an optional message that appears below the access period. You might want to use this to highlight the best deal.

– The header and description appear on your page or post, and are generally used to describe what content you're selling.

– The title appears at the top of the checkout window once your reader has started the payment process.

5) Now, just click enable in the top right of the popup window, and click save at the bottom of the popup window. If you click save without enabling Tinypass, the pricing and access details will be saved but the post will not be protected by Tinypass.

6) Now that Tinypass is enabled, the only thing left is to specify the point at which your post will become secure. To specify that point, simply place a Tinypass Break into your post. The Tinypass break function is a small “TP” icon in the toolbar in your WYSIWYG editor. Everything after the Tinypass Break will be protected, and only revealed once your reader has purchased access.

7) A post configured as shown above will appear this way to your readers.


The “paywall” is quickly becoming the most popular way for online publishers to monetize content. In the WordPress world, sites with paywalls are sometimes described as membership sites, subscription sites, metered sites, and so on. With Tinypass, you can use our paywall function to easily accomplish a variety of paid-content objectives.

1) To start, go to Tinypass→Paywall Settings in your WordPress dashboard and read about the two main ways that Tinypass can be used to secure your premium content behind a paywall: Metered and Restricted

Metered simply means that your readers get a certain amount of access to your premium content before they're asked to pay.

Restricted means just that: Your premium content is always secured behind the Tinypass paywall.

Just choose the option you prefer, and set your payment and access parameters according to the following steps.

(Note that there is also an option to turn your Tinypass paywall off completely. If you select this option, any content you've secured behind the paywall will become free and option to access, but your paywall settings will be saved.)

2) Regardless of which paywall approach you've chosen, Tinypass uses standard Wordpress tags to determine what content should be protected. Simply enter the tags you'd like to restrict. For example, if you'd like to put all of the content you've tagged with “archive” and “premium” behind a paywall, just add those tags to the list of protected tags in your Tinypass paywall settings.

3) If you've chosen a metered paywall, here is where you'll set the meter parameters. (If you've chosen a “no preview/restricted” paywall, ignore this step.) You have two ways to give your readers a preview of the content behind your paywall:

View based: This is the probably the most popular method. Just choose a number of views that your readers get in a certain period (e.g., 5 views within 1 month), and once they've reached that limit, they'll be prompted to pay for continued access to the content you've protected using Tinypass.

4) Next you'll set up the pricing details. You can add up to three pricing options. Simply choose the price and the access period (e.g., $2 for access for 1 day). Click add/remove to specify more pricing options.

You can also select the option for Monthly Recurring Billing. This means that your readers will get automatically billed each month for access to your paywall content, unless they choose to cancel.

There's also add a caption that will appear below the price. This is useful for highlighting a “best deal” for example.

5) Now add a Header and Description. This will appear on your page or post when your reader encounters protected content. For example, if you've specified Monthly Recurring Billing, you might want your title to read “Become a Member” and the message could read “To continue reading, please subscribe and you'll get access to all my great content for just $5 a month!”.

You'll also see the option to specify a title for your Purchase Pop-up Window. This is just another opportunity to brand the purchase experience as your own.

For handling foreign currency, pay-what-you-want, and other cool stuff, check out the documentation here.

6) Finally, you have the option to specify a dedicated subscription or selling page. Many sites with paywalls, especially metered paywalls, like to have a dedicated page where interested readers can go to sign up or subscribe directly. Just specify an existing page on your site where you have more details about your subscription options, and Tinypass automatically place a purchase button on that page.

If you do specify a selling page, you'll also need to specify a confirmation page which will be shown to your readers after they make a purchase from the selling page. That page should generally include a “thank you” message and any additional details you'd like to include.

7) Now just make sure to click “Save” at the bottom of the page, and your paywall is up and running!

Pay per Post PLUS a Paywall

You can offer your readers the option to buy access to one single post OR subscribe to all of your premium content by combining the Tinypass Pay per Post feature with your Paywall settings.

It's simple: On any page or post that has a paywall applied to it, just set a per-post price as well. Your readers will see both options. By default, the paywall pricing will appear first, but to show your per-post pricing first, just select that option as shown in Step 5 of the Paywall instructions above.

Content with both paywall and pay-per-post pricing offers will appear this way:

Tinypass for WordPress v1

If you're still on the old version of the plugin, here is the documentation.