Skip to content

About

Buy me a Coffee is a free WordPress plugin that allows you to accept donations from your visitors. It is a simple and effective way to monetize your content. You can accept donations via PayPal or Stripe.

Resources

Stars

7 stars

Watchers

2 watching

Forks

Repository files navigation

Buy Me a Coffee — WordPress Plugin

Monetize members-only content, accept one-time donations, and run recurring subscriptions via Stripe and PayPal — directly into your own account, with zero commission.

compress-main-banner members-only-banner example-section

Current version: 1.2.8 · Full Changelog

Plugin Site · User Guide · Demo · WordPress.org

Quick Navigation


Why Buy Me a Coffee

  • Monetize posts and pages with paid membership levels and built-in paywall CTA
  • Accept one-time and recurring donations on your own WordPress site
  • Receive payments directly to your Stripe or PayPal account
  • Manage supporters, subscriptions, and activity from a modern admin dashboard
  • Customize donation forms with shortcodes, block support, and page templates

What's New in 1.2.x

1.2.9

  • Paywall — offers only the membership levels selected for that post
  • Membership checkout — shows a log in link when the email already has an account

1.2.8

  • Payment handling — smoother Stripe payments for zero-decimal currencies like JPY and KRW
  • Membership access — improved handling for refunds, restored payments, removed supporters, and subscription period changes
  • Settings — membership and email notification toggles now save reliably
  • Setup — improved default membership level setup on new installs

1.2.7

  • Onetime membership access - Now onetime membership access can be managed

1.2.6

  • Memberships and content monetization — create paid levels, protect posts/pages, and show a built-in paywall CTA
  • Members dashboard — search active members, view levels, renewal dates, billing intervals, and subscription status
  • Post access controls — choose allowed membership levels and teaser word counts from the editor
  • Admin polish — top navigation, safer supporter links, and production route guards

1.2.1

  • Adds Subscription management
  • Adds Design Update v2
  • Adds Coffee theme and UI polish
  • Adds Account creation email details
  • Adds Active subscription helper and synced user meta
  • Fixes Subscription query issue
  • Fixes Payment flow and release pipeline
  • Improves Subscriber account history view
  • Improves Admin loader experience
  • Redesigns All Page styling

1.2.0

  • Stripe Recurring Subscriptions — monthly or yearly billing with full webhook lifecycle management
  • Refunds — issue Stripe and PayPal refunds directly from the admin panel
  • Activity Log — persistent event timeline for every payment, subscription, email, and webhook event

See CHANGELOG.md for the complete version history.


Features

Capability Details
Memberships Paid levels with monthly/yearly pricing, rewards, active members, and content monetization
Content access Members-only posts/pages with editor controls, teaser previews, and paywall CTA
Payments Stripe (on-site) and PayPal Pro
Recurring subscriptions Monthly or yearly via Stripe with full webhook lifecycle
Refunds Stripe and PayPal refunds from the admin panel
Activity log Per-supporter and per-subscription event timeline
Forms and templates Customizable donation button, form, and page template
Shortcodes and block Gutenberg block + classic shortcodes
Supporter profiles Full supporter, transaction, and activity history
Analytics dashboard Donation stats, recent activity, and summaries
Email notifications Custom donor and admin email templates
Dark mode Full admin dark mode with system preference detection
Admin SPA Full-page Vue 3 app with sidebar navigation

Quick Start

  1. Install and activate the plugin
  2. Open Buy Me a Coffee -> Quick Setup
  3. Connect Stripe and/or PayPal credentials
  4. Add [buymecoffee_button] or [buymecoffee_form] to any page
  5. Publish and start collecting donations

Requirements

  • WordPress 4.5+
  • PHP 7.4+
  • Stripe and/or PayPal account

Installation

  1. Download the latest release zip and upload via Plugins → Add New → Upload Plugin, or install directly from the WordPress plugin directory.
  2. Activate the plugin.
  3. Go to Buy Me a Coffee → Quick Setup to configure your payment gateways.

Development

npm install       # install dependencies
npm run dev       # Vite dev server with HMR (localhost:3000)
npm run build     # production build → assets/
npm run package   # build + create distributable zip

Built assets output to assets/ with a manifest.json for cache-busted URLs. Entry points are defined in vite.config.js.

Stack: Vue 3 · Vue Router · Element Plus · Vite · Tailwind CSS · PHP 7.4+


Common Shortcodes

  • [buymecoffee_button] - Donation button with popup
  • [buymecoffee_form] - Inline donation form
  • [buymecoffee_basic] - Basic donation template
Need setup help?

Use the User Guide for a complete walkthrough, including gateway configuration and shortcode placement.


Third-Party Services


Changelog

See CHANGELOG.md.


Contributing

Go to the GitHub repository — see package.json for the full list of scripts and dependencies.


Tip

Design System Guide: See dev/blog-post-ui-redesign.md for the full UI redesign process, token architecture, and implementation approach.

License

GPLv2 or later — see LICENSE.

About

Buy me a Coffee is a free WordPress plugin that allows you to accept donations from your visitors. It is a simple and effective way to monetize your content. You can accept donations via PayPal or Stripe.

Resources

Stars

7 stars

Watchers

2 watching

Forks

Releases

Packages

Used by

Contributors

Languages