Optional Donation

Overview

The Optional Donation feature lets you add a voluntary contribution button to your dPanel-managed sites. It is entirely optional for end‑users and does not affect any core functionality.

Enabling the Feature

Log in to the dPanel admin dashboard.
Navigate to Settings → Donations.
Toggle Enable Optional Donation to On.
Save changes.

Configuration Options

You can fine‑tune the donation widget using the donation.yml configuration file located in the site’s root directory.

# donation.yml
enabled: true            # Set to false to disable the widget
provider: "paypal"      # Supported: paypal, stripe, custom
amounts:
  - 5
  - 10
  - 20
currency: "USD"
button_text: "Support Us"

provider – Choose the payment processor.
amounts – Pre‑defined donation amounts displayed to users.
currency – ISO currency code (e.g., USD, EUR).
button_text – Custom text for the donation button.

Display Locations

The widget can be placed in multiple locations:

Header – Add to the site header for maximum visibility.
Footer – Less intrusive, appears at the bottom of each page.
Sidebar – Ideal for blogs or content‑heavy sites.

To set the location, edit the donation.yml file:

location: "footer"  # Options: header, footer, sidebar

Monitoring Donations

All transactions are logged in the Donations tab of the admin panel. You can export the data as CSV for accounting purposes.

FAQ

Is the donation truly optional? Yes, users can ignore the widget without any impact on site usage.
Do I need a commercial license? No, the optional donation feature is available in all dPanel editions.
Can I customize the appearance? Absolutely – use custom CSS in your theme to style the widget.

For more details, see the dPanel Documentation Hub.