Applications

Allow your users to subscribe to content

If your application is able to handle user subscriptions, this section is for you.

Registration

Your users will click on subscribe buttons on some pages. When they do so, a list of the subscription services they used in the past is displayed. This list was not curated by us, but stored in their browser (using localStorage) from services that registered their ability to perform susbcriptions for that user.

You too can quickly and easily register your application for your users by loading an iframe like this: Please note that this is completely transparent for the user!

The name query string is the name of your application and the url is the url of the hander which will be called in your application to perform a subscription (thru a user redirect).

The subscription handler is obviously completely up to you, but it should include at least one of the following:

• {url} will be populated with the location.href of the page on which the user clicked the subscribe button.
• {feeds} will be populated with the href element of each elements corresponding to a feed in the page on which the user clicked.
• {feed} will be populated with the first (if any) of the {feeds} above.

It is also possible to register the user by opening a url in the browser directly. This is particularly useful for standalone (desktop based) feed readers. Use the url https://www.subtome.com/#/register?, with the same params used by the iframe based registration.

Subscription handling

When a user clicks on a SubToMe button, he can pick his favorite subscription application. If it's yours, then, a new browser tab will be created and will point to your application's handler url, feed or feeds (see previous section). Based on the handler you've provided, you will be able to extract the location of the page on which the button was clicked and its feeds.

Your application should then, perform the subscription, by extracting the content it needs. We recommend using the RSS/Atom feeds, but you could also very well extract the links to a Twitter profile for example allow the user to follow that profile. Possibilities are endless.