@monetized/widgets
v0.0.5
Published
A set of custom elements to prompt your users to buy the premium content at Monetized, and for validating their entitlement tokens.
Downloads
5
Readme
@monetized/widgets
A set of custom elements to prompt your users to buy the premium content at Monetized, and for validating their entitlement tokens.
<monetized-link-riser>
Adds a pop-under to:
- Check if there's an entitlement token available set in page URL.
- If it's set, ensure it's a valid token.
- If token is invalid or doesn't exist, find the corresponding page at https://www.monetized.link and prompt user to get access there.
Usage
<!doctype html>
<html lang="en">
<head>
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<!-- You can use npm CDNs like unpkg to import the custom element -->
<script
type="module"
src="https://unpkg.com/@monetized/widgets/monetized-link-riser.js"
></script>
<!-- Or, self-host it -->
<script type="module" src="monetized-link-riser.js"></script>
</head>
<body>
<p>Some content on your website</p>
<!-- Add the riser widget -->
<monetized-link-riser></monetized-link-riser>
</body>
</html>Advanced Usage
You can use a custom name for this component too.
<script type="module">
import { MonetizedLinkRiser } from 'https://unpkg.com/@monetized/widgets/monetized-link-riser.js';
customElements.define('some-custom-name', MonetizedLinkRiser);
</script>
<some-custom-name></some-custom-name>Pass the strict attribute for strict checking - ensures the token corresponds to only the page monetized at https://www.monetized.link
<monetized-link-riser strict></monetized-link-riser>
<!-- Note that this attribute doesn't expect any value. To unset, remove the attribute. -->@monetized/api
Use Monetized's public API to validate entitlement of tokens, and directing users to correct pages where they can buy your link.
npm install @monetized/apiAvailable methods
import {
getPage,
findPage,
verifyToken,
verifyTokenStrict,
} from '@monetized/api';getPage
Get a page by page ID
GET https://www.monetized.link/api/content/info/:pageIdfindPage
Find a page by monetized URL
GET https://www.monetized.link/api/content/find?q={monetizedPageUrl}&publication={optional-publication-id}verifyToken
Check whether given token is valid. Validates corresponds to public key at .well-known/jwks.json.
verifyTokenStrict
Same as above, but also ensures the token corresponds to given URL/page-id.