Documentation

πŸͺ™ Easy BTC Donate

The simplest way to accept Bitcoin and Lightning Network donations on your WordPress site.


✨ Features

  • ⚑ Lightning Network Support – Accept instant payments via Lightning Address or LNURL
  • β‚Ώ Bitcoin Onchain – Traditional Bitcoin payments with any address format
  • πŸ“Š Statistics Dashboard – Track donation clicks and payment method preferences
  • πŸ’± Currency Conversion – Real-time EUR/USD/GBP to BTC rates via CoinGecko
  • πŸ“± QR Code Generation – Automatic QR codes for easy mobile payments
  • 🎨 Beautiful Design – Modern, responsive interface that works everywhere
  • πŸ”’ Privacy Focused – No tracking, no cookies, no data collection
  • πŸ†“ 100% Free – No subscriptions, no premium versions, forever free

πŸš€ Quick Start

Installation

  1. Download ZIP
  2. Upload to WordPress: Plugins β†’ Add New β†’ Upload Plugin
  3. Activate the plugin
  4. Go to BTC Donations β†’ Settings
  5. Add your Bitcoin and/or Lightning address
  6. Use shortcode on any page

Setup

Bitcoin:

BTC Donations β†’ Settings
β†’ Enter your Bitcoin address
β†’ Set default amount and currency
β†’ Save Settings

Lightning (Optional):

BTC Donations β†’ Settings
β†’ Check "Enable Lightning"
β†’ Enter Lightning address (e.g., user@strike.me)
β†’ Save Settings

Display:

Support with Bitcoin

Your donation helps us continue our work πŸ™

⚑ Lightning Setup Guide

Popular Lightning Services

Strike

  • Website: strike.me
  • Free account
  • Lightning address: yourname@strike.me

Alby (Global)

  • Website: getalby.com
  • Free and premium options
  • Lightning address: yourname@getalby.com

Wallet of Satoshi (Simple)

  • Mobile wallet
  • Free
  • Lightning address: yourname@walletofsatoshi.com

πŸ“Š Statistics

The plugin includes a statistics dashboard that tracks:

  • Total Clicks – How many times users clicked „Donate Now“
  • Payment Methods – Split between Bitcoin and Lightning (with percentages)
  • Monthly Stats – Current month vs. last month

Note: Stats track button clicks, not actual payments.


πŸ”’ Privacy

This plugin is designed with privacy as a priority:

What We DON’T Collect

  • ❌ No personal information
  • ❌ No IP addresses
  • ❌ No cookies
  • ❌ No tracking

What We DO Store

  • βœ… Admin settings (your Bitcoin/Lightning addresses)
  • βœ… Anonymous click statistics

❓ Frequently Asked Questions

Do I need my own Bitcoin node?

No! You only need a Bitcoin address from any wallet.

Do I need my own Lightning node?

No! Use free services like Strike or Alby to get a Lightning address.

Does it verify payments?

No. This is a simple donation form. You’ll see payments in your Bitcoin/Lightning wallet.

What currencies are supported?

EUR, USD, GBP, and BTC with real-time conversion via CoinGecko API.

Is it GDPR compliant?

Yes! No personal data is collected.

Can I customize the design?

Yes! You can override the default CSS with your theme’s custom CSS.


πŸ“ Changelog

v1.2.3 – 2024-01-14

  • Added: Donate link in plugin actions

v1.2.0 – 2024-01-14

  • Added: Statistics dashboard

v1.1.0 – 2024-01-14

  • Added: Lightning Network support

v1.0.0 – 2024-01-14

  • Initial release

πŸ“„ License

GPL v2 or later


πŸ’š Support the Project