Bitcoin Lightning Publisher for WordPress
Bitcoin Lightning Publisher is a Paywall, Donation and Value 4 Value plugin for WordPress to accept instant Bitcoin Lightning payments. It allows you to monetize any digital content with instant microtransactions and receive payments from your visitors directly to your preferred wallet - no need for expensive service providers.
The plugin is the easiest and most flexible plugin to sell your digital content and to receive donations or Value 4 Value payments. Using the Bitcoin Lightning Network you can create the best visitor experience with seamless one-click payments.
Features
Paywall to sell content
Sell any digital content (pay-per-post, pay-per-view, pay-per-download, etc.) with a highly configurable paywall
- WebLN enabled by default for easy on-click payments
- Add a paywall to posts and pages to easily charge for any published content
- Crowdfund option: make the content freely available after a certain amount is received
- Time-in option: keep the article freely available for a certain time and then enable the paywall after that
- Time-out option: make the article freely available after a certain time
- Configure the price in Satoshis, EUR, USD, or GBP (with real-time exchange rate)
- Configure the paywall with a shortcode (
[lnpaywall]) - Or configure the paywall with a Gutenberg Block
- Integrate with other tools and plugins like membership tools to control if the paywall should be enabled (see Paywall Hook section)
Donation/Value4Value payments
The plugin comes with various options to receive donations and Value 4 Value payments.
- Gutenberg block for a donation widget
- Donation widget for themes
- Enable Value 4 Value tags for your website and feeds:
- Enable the Lightning meta tag to allow users to send payments (Value 4 Value)
- Enable the
podcast:valuetag in your RSS feed to receive payments for your podcast
Lightning Node connections
Connect to your existing Bitcoin Lightning node or simply create a new Alby account to instantly receive Lightning payments.
- Alby
- LND
- LNDHub (e.g. BlueWallet)
- LNBits
- BTCPay Server
- Lightning Address
REST-API for full advanced custom usage
For more advanced, custom Lightning integrations you can use the REST API to create and verify invoices. The API also provides a LNURL-pay endpoint. See the REST-API section for details.
Requirements
- WordPress 5.6 or higher
- PHP 7.4 or higher (with internationalization functions)
Demo
Here quick Demo videos showing how to setup and use the plugin:
Installation
Install from the WordPress Plugin directory or:
Download the zip from the latest release and install/activate it through the WordPress Plugin admin panel.
To build the plugin yourself: clone the repository and install the dependency using Composer
git clone https://github.com/getAlby/lightning-publisher-wordpress.git
cd lightning-publisher-wordpress
composer install # (maybe you need to add `--ignore-platform-reqs` if it asks you to update PHP)To build a .zip file of the WordPress plugin run:
./build.sh # this builds a `wordpress-lightning-publisher.zip`Then upload and activate the plugin through the WordPress Plugin admin panel.
Paywall Hook to have custom logic when to enable/disable the paywall
To integrate with other plugins or to write custom conditions on when the paywall should be enabled a hook can be used. This means you can use a custom PHP function to decide if content should be behind the paywall or not.
This for example allows you to make the content available for all users/subscribers but enable the paywall for all other users.
Example
you can add such functions anywhere in your code. e.g. in functions.php
// your function receives two arguments:
// 1. a boolean with the current check (true if the full content would be shown)
// 2. the ID of the post the user accesses
//
// return true if the full content should be shown or false to enable the paywall
function show_full_content_for_post($show_full_content, $post_id) {
// Add your logic to check if the current user can see the post with ID $post_id
// return true; // return true to show the full content (disable the paywall)
// for example:
// if the user has a subscription always show the full content.
// otherwise let the plugin decide (e.g. show the full content if the user already had paid)
if (user_has_a_subscription()) {
return true;
} else {
return $show_full_content
}
}
// Check out the `add_filter` documentation for more information: https://developer.wordpress.org/reference/functions/add_filter/
add_filter('wp_bln_has_paid_for_post', 'show_full_content_for_post', 10, 2);Alternatively you can define a global function wp_bln_has_paid_for_post which gets called. Return true to disable the paywall and show the full content.
function wp_bln_has_paid_for_post($show_full_content, $post_id) {
return true; // show full content - disable the paywall
}Overriding template for unpaid button
Warning: Do not edit these files within the core plugin itself as they are overwritten during the upgrade process and any customizations will be lost.
Use variable $plugin to access plugin options inside of the template file.
Required markup for custom button:
<div class="wp-lnp-wrapper">
<button class="wp-lnp-btn">Custom labeled button</button>
</div>Option 1
Copy file wp-content/plugins/lightning-publisher-wordpress/public/templates/paywall-button-unpaid.php to wp-content/themes/yourtheme/lightning-publisher-wordpress/paywall-button-unpaid.php
The copied file will now override the default template file.
Option 2
If you would prefer to place template file in a custom location, then you can use filter: bln_paywall_unpaid_button_template
- Copy file
wp-content/plugins/lightning-publisher-wordpress/public/templates/paywall-button-unpaid.phpto custom location, egwp-content/themes/yourtheme/plugin-mods/paywall-button-unpaid.php - Use filter
bln_paywall_unpaid_button_templateto override button template path. You can e.g. infunctions.php
// your function receives 1 argument:
// $template_path string, absolute path to template file used to render the button template
//
// return HTML template
function update_bln_paywall_unpaid_button($template_path) {
// Absolute path to template file
$new_path = get_stylesheet_directory() . '/plugin-mods/paywall-button-unpaid.php';
return $new_path;
}
// Check out the `add_filter` documentation for more information: https://developer.wordpress.org/reference/functions/add_filter/
add_filter( 'bln_paywall_unpaid_button_template', 'update_bln_paywall_unpaid_button' );Shortcode
If you do not use the Gutenberg editor you can use the [lnpaywall] shortcode. The content after the shortcode will be behind the paywall.
The following configuration options are possible:
- amount
- currency
- description
- button_text
- total
- timeout
- timein
Example
[lnpaywall amount=2121]
Plugin folder structure
Folder structure is based on https://github.com/DevinVinson/WordPress-Plugin-Boilerplate
bln-publisher.phpis the entrypoint of the pluginincludesis where functionality shared between the admin area and the public-facing parts of the site resideadminis for all admin-specific functionalitypublicis for all public-facing functionalityincludes/class-bln-publisher.phpis the main plugin class which handles including all the related classes.includes/class-bln-publisher-loader.phpis responsible for registering the action and filter hooks, and shortcodes.
REST API
The plugin also provides a set of REST API Endpoints for handling payments and donations.
Initiate Payment for Paywall
- URL:
/lnp-alby/v1/paywall/pay - Method:
POST - Auth Required: No
- Data example
{
post_id: "xxx"
}
Verify Payment for Paywall
- URL:
/lnp-alby/v1/paywall/verify - Method:
POST - Auth Required: No
- Data example
{
post_id: "xxx",
token: "xxx",
preimage: "xxx"
}
LNURL-pay
- URL:
/lnp-alby/v1/lnurlp - Method:
GET - Auth Required: No
{
"status":"OK",
"callback":"http:\/\/wp.play.getalby.com\/wp-json\/lnp-alby\/v1\/lnurlp\/callback",
"minSendable":10000,
"maxSendable":1000000000,
"tag":"payRequest",
"metadata":"[[\"text\/identifier\", \"http:\/\/wp.play.getalby.com\"][\"text\/plain\", \"Alby\"]]"
}
- URL:
/lnp-alby/v1/lnurlp/callback - Method:
GET - Auth Required: No
Initiate a general payment to generate an invoice
- URL:
/lnp-alby/v1/invoices - Method:
POST - Auth Required: No
- Data example
{
amount: 123,
currency: 'btc'
}
Verify Payment for an invoice
- URL:
/lnp-alby/v1/invoices/verify - Method:
POST - Auth Required: No
- Data example
{
token: "xxx", // the token from the invoice creation enpoint
preimage: "xxx"
}
Get support
Do you need help? Create an issue or reach out to us: support[at]getalby.com
About Alby
This plugin is powered by Alby - We create tools to rethink content monetization on the web.
License
GPL 3.0 (as WordPress)
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent