Installation

npm

You can install with npm.

npm install web-monetization-exclusive-content

Once installed, you can either use the minified version by referencing it from the dist directory.

<script src="./node_modules/web-monetization-exclusive-content/dist/wm-exclusive-content.min.js"></script>

Or if you have a build step, you can require the module.

const WebMonetizationExclusiveContent = require("web-monetization-exclusive-content");

unpkg

If you want to use the component from the unpkg CDN then you can.

You can get the latest version using the bare URL. See more options on https://unpkg.com/.

<script src="https://unpkg.com/web-monetization-exclusive-content"></script>

Usage

Wrap your ad code inside a <template> element then in the <wm-exclusive-content> component.

<wm-exclusive-content>
  <template><p>Thank you for supporting this site!</p></template>
</wm-exclusive-content>

The <template> makes the exclusive content inert (it doesn't render or fetch any linked resources). If the browser doesn't support web monetization (because document.monetization is not present) the exclusive content will not be rendered at all.

If the browser does support Web Monetization the <wm-exclusive-content> will not show anything.

Attributes

• template: A CSS selector that points to a <template> elsewhere on the page.

  If your ad code lives elsewhere on the page, you can point to it with the ad-template attribute.

  Example:

  <wm-exclusive-content template="#exclusive-content"></wm-exclusive-content>
  
  <!-- later down the page -->
  
  <template id="exclusive-content">
    <!-- exclusive content -->
  </template>
  

LICENSE

MIT (c) 2020 Phil Nash