A Jekyll plugin to add Web Monetization API payment pointers to your site.
A JavaScript browser API which allows the creation of a payment stream from the user agent to the website.
Find out more about Web Monetization.
To use this plugin and receive payments from Web Monetization you will need a payment pointer. A payment pointer is an address at which you can receive streaming payments from the Web Monetization API. You can set up a payment pointer by creating a digital wallet with one of the providers listed on the Web Monetization API site.
You can read more about payment pointers and receiving money from Web Monetization in the relevant documentation.
Add the gem to the :jekyll_plugins group in your Jekyll site's Gemfile:
group :jekyll_plugins do
gem 'jekyll-web_monetization'
endExecute:
$ bundle installThen in your site's _config.yml add the plugin to the plugins list:
plugins:
- jekyll/web_monetizationOnce you have a payment pointer, add it to your site settings in _config.yml:
payment_pointer: $securewallet.example/~aliceAlso, add the web_monetization liquid tag to the <head> of your layout.
<head>
<!-- other tags in the head -->
{% web_monetization %}
</head>The site-wide payment pointer will be added to all pages on which you use the liquid tag.
If you have multiple authors, you can set a payment pointer per post or page in the YAML front matter. This will over-ride the site-wide payment pointer for that page.
---
payment_pointer: $securewallet.example/~bob
---A site, page or post may be the work of more than one person. This plugin supports providing more than one payment pointer to enable probabilistic revenue sharing.
If, in your _config.yml or front matter for any page, you provide an array of payment pointers or a hash of payment pointers and weights, then the plugin will generate JavaScript to choose a payment pointer on each page load.
You can define an array of payment pointers like this:
payment_pointer:
- $securewallet.example/~alice
- $securewallet.example/~bobEach payment pointer will be given an equal chance of appearing on the page each page load.
You can also give payment pointers different weights. They will then appear on the page in a ratio based on the total weights.
You define this hash of payment pointers and weights like this:
payment_pointer:
$securewallet.example/~alice: 20
$securewallet.example/~bob: 10In this case, Alice's pointer will be added to the page twice as often as Bob's.
After checking out the repo, run bin/setup to install dependencies. Then, run rake spec to run the tests. You can also run bin/console for an interactive prompt that will allow you to experiment.
To install this gem onto your local machine, run bundle exec rake install. To release a new version, update the version number in version.rb, and then run bundle exec rake release, which will create a git tag for the version, push git commits and tags, and push the .gem file to rubygems.org.
Bug reports and pull requests are welcome on GitHub at https://github.com/philnash/jekyll-web_monetization. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the code of conduct.
The gem is available as open source under the terms of the MIT License.
Everyone interacting in the Jekyll::Web::Monetization project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the code of conduct.