ITERAS

Each page/post gets a little box where you can choose whether to paywall it or not. The plugin then associates a little bit of extra metadata with the post (stored with the key “iteras_paywall”).

Then when that post is served, the plugin first checks if the visitor has a valid access pass from the ITERAS server.

If not you can setup the plugin to cut off the content and instead insert call to action content (sign up to get access or login). Or you can also setup the plugin to redirect to another landing page.

Make a test subscriber inside Iteras, fill in the plugin settings, add a test post that you set to be behind the paywall, then experiment with the layout. Once you’re happy, you can add the paywall to real posts.

You can insert a login iframe in the content by using the WordPress shortcode [iteras-paywall-login paywallid="abc123,def456"].

You can insert an ordering iframe for signing up for a subscription or ordering a product with the shortcode [iteras-ordering orderingid="subscribenow"].

You can insert a self-service iframe to allow subscribers to manage their subscriptions with the shortcode [iteras-selfservice].

The [iteras-return-to-page url='/some/url/?p=123'] is useful if you need to link to another page in the call to action content. It will append the current page to the given URL so that the visitor is redirected back to the original page after having completed an ordering flow or having logged in. NOTE: due to limitations in the WordPress parser, when you put [iteras-return-to-page] in an HTML tag attribute, you need to be aware of single quotes and double quotes. <a href="[iteras-return-to-page url='/some/url/?p=123']">sign up!</a> works while <a href="[iteras-return-to-page url="/some/url/?p=123"]">sign up!</a> doesn’t!

These shortcodes, except [iteras-return-to-page], are internally converted to calls to the ITERAS Javascript API. You can pass more parameters if you need to, e.g. next, see the API documentation for more details. The profile parameter is implicit and comes from your plugin settings.

There’s a few shortcodes for controlling content based on the users logged in status. For showing content when the user has access use [iteras-if-logged-in paywallid="abc123,def456"]Content only shown if the user is logged in and has access[/iteras-if-logged-in]. [iteras-if-not-logged-in] does the opposite. [iteras-if-logged-in-link paywallid="abc123,def456"]Content[/iteras-if-logged-in-link] will automatically insert a link to the subscriber landing page that is configured with the plugin, alternatively a url attribute can be supplied, while login_text can we used to customize the link text. These shortcodes only work with server validation enabled.

Yes! Add the GET-parameter orderproduct to a link to your ordering page, e.g. /buysubscription/?orderproduct=12MPro. This will select the “12MPro” product when the user gets to the form.

It is possible to override the decision of which content should be paywalled. Add a hook to the iteras_override_content_paywall filter to define a function that should have the last say in if the content should be paywalled or not. This can for example be used for handling share links the gives the user access eventhough they don’t have a login. This could look something like this:

/**
 * Override the decision to paywall the particular content
 *
 * @param integer $post_paywall_ids The paywalls that give access to the post, if empty the post would not be paywalled be default
 * @param object $post Reference to the post being potentially paywalled
 * @param boolean $user_authorized If the user has a valid iteraspass that has the appropriate access
 * @param array $paywall_config Contains the Iteras plugin configuration
 */
function make_paywall_decision($post_paywall_ids, $post, $user_authorized, $paywall_config) {
  // example of generated share token
  error_log(openssl_encrypt(json_encode(array('shared_by'=>"John Doe", 'post_id' => $post->ID)), "aes-128-cbc", "somesecret"));

  $token = $_GET['token'];
  if (isset($token)) {
    $share = json_decode(openssl_decrypt($token, "aes-128-cbc", "somesecret"));
    if (isset($share) and $share->post_id == $post->ID) {
      echo "Shared by " . $share->shared_by;
      // signal that the paywall should not be applied
      return false;
    }
  }

  // return the paywall ids to apply the paywall as normal
  return $post_paywall_ids;
}

add_filter('iteras_override_content_paywall', 'make_paywall_decision', 10, 4);

When you link to other pages, you may be losing the return information needed to redirect the visitors. Send the URL through [iteras-return-to-page] as described above to forward the return information.

When an iframe is embedded directly, the return information is inserted automatically, but when you put the iframe on another page and link to that, the iframe needs to know where the visitors come from to be able to return them correctly.

No. But it’s not hard to get one – if you are interested in learning more about ITERAS, please visit iteras.dk and contact us.

You will need to do a custom integration. The plugin attaches to the the_content hook in WordPress which in some situations is called mutiple times by 3rd party plugins.

In this case set the “Paywall integration method” to “Custom” and add the paywall code manually to the theme or plugin you are using. This can be done either by wrapping the post body with the shortcode [iteras-paywall-content]...[/iteras-paywall-content] or by calling Iteras::get_instance()->potentially_paywall_content(...) which returns the content wrapped with the paywall.

If you discover a security issue, please contact us. You can also report it through Patchstack.