Woo Donate - Stellar Donations and Tips

WooCommerce Stellar donations and tips: accept XLM/USDC with donor walls

by StaveIndustries · github.com/staveindustries/woo-donate · website

★ 0stars

Install

Download source zip No release zip yet

This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.

Install straight from GitHub with WP-CLI:

wp plugin install https://github.com/staveindustries/woo-donate/archive/refs/heads/main.zip

No built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.

Readme github.com/staveindustries/woo-donate ↗

WordPress plugin that accepts XLM/USDC donations on Stellar. Standalone: no WooCommerce required. Donors give through a shortcode form, payments are matched by unique memo, and confirmed donors appear on a donor wall.

Shortcodes

[stellar_donate] - donation form (amount, asset, optional name).
[stellar_donor_wall limit="20"] - confirmed donors, newest first.

Requirements

PHP 7.4+, WordPress 6.0+
A Stellar wallet (testnet for testing, mainnet for live)

Install steps

Clone or download this repo into wp-content/plugins/woo-donate/.
Activate Woo Donate in WP Admin - Plugins.
Go to Settings - Stellar Donations: set wallet address, asset, network.
Add [stellar_donate] and [stellar_donor_wall] to any page.

How matching works

Each donation gets a unique memo (DON-{id}-{6char}). A cron job checks Horizon every 10 minutes and confirms donations whose amount + asset + memo match. Expired ones (past the payment window) are marked expired.

One-command local demo (Docker)

docker compose up -d
# open http://localhost:8081, finish the WP installer
# Plugins - activate Woo Donate; Settings - Stellar Donations to configure

Tests

composer install && composer test   # offline PHPUnit suite

Contributing

See CONTRIBUTING.md. Good first issues are labeled for newcomers.

License

MIT - see LICENSE.