Configuration
The settings are in Pybara Donate in your WordPress admin menu. Until the setup is complete, a notice in your WordPress admin lists the steps left, each linking to its place in the settings.
Get ready to take donations
Section titled “Get ready to take donations”- Connect your recipient wallet, in the Recipient Wallet card.
- Verify your website with a DNS record, in the Website verification card.
- Accept the Terms of Service and click Save Settings, at the bottom of the page.
- Place the widget on a page, as shown in the Embed card.
The widget appears once the first three are done. There is nothing else to do: your site is registered with its first donation, and then appears in Pybara Wallet’s Manage → Sites.
Enable
Section titled “Enable”The toggle at the top turns the widget on or off everywhere it is placed, without losing your settings. Useful to pause donations without uninstalling the plugin.
Recipient Wallet
Section titled “Recipient Wallet”The wallet donations are paid into. Click Connect Pybara Wallet, confirm your WordPress password, then sign in to Pybara Wallet: the plugin saves the wallet’s principal and shows it, with the date it was saved. Update connects a different wallet the same way.
Pybara Wallet gives you your donation history, withdrawals to exchanges such as Kraken or Coinbase, and AutoStable.
Website verification
Section titled “Website verification”Donations are paid only to a wallet your domain allows. You allow it by publishing a DNS record, with your domain provider:
| Type | Name | Value |
|---|---|---|
TXT |
_pybara-payto |
Your recipient wallet’s principal |
The card shows the exact record for your site, with copy buttons, and which domain’s DNS settings it goes in. Once it is published, click Check: the card reads Verified, and the widget appears. Until then, the widget stays hidden, so a donor never meets a donation that cannot go through.
One record covers all your subdomains. A new record can take a few minutes to appear.
If the record lists a different wallet from the one saved, the card says so and offers Use this wallet instead, or the record to publish for keeping yours.
Your Rate
Section titled “Your Rate”Your commission per donation. Process your first donation this year to lock its rate for life; once locked, the card says so. See Pricing.
Accepted Tokens
Section titled “Accepted Tokens”The tokens donors can give with. The list is read-only and follows Pybara: a token Pybara disables disappears from it. See Supported Tokens.
Settlement
Section titled “Settlement”Volatile token donations can be converted to a stablecoin as they settle. This is set in Pybara Wallet, for every site paid into that wallet: see AutoStable.
Widget
Section titled “Widget”How the donation widget looks and behaves. A live preview shows your changes.
| Setting | What it does | Default |
|---|---|---|
| Currency | The fiat currency amounts are shown in: USD, EUR, GBP, CAD, AUD, CHF, JPY, BRL, MXN, INR, SGD, HKD, NOK, SEK, DKK, PLN or NZD. Donations are always paid in the token the donor picks. | USD |
| Preset Amounts | Up to 5 suggested amounts, shown as buttons. Type a number and press Enter or comma to add it; × removes it. At least one is required. | 5, 10, 25, 50 |
| Allow custom amount | Lets donors type any amount besides the presets. | On |
| Allow recurring donations | Lets donors give every week, month or year. | On |
| Default Frequency | The frequency selected when the widget opens: Weekly, Monthly or Yearly. Shown when recurring donations are on. | Monthly |
| Default Duration | The length selected when the widget opens: 3, 6, 12 or 24 months, or Unlimited. Shown when recurring donations are on. | 12 months |
| Theme | Light, Dark, or Auto, which follows the page’s background, including a theme switcher or the visitor’s dark mode. | Light |
| Accent Color | The color of buttons, active states and links, as a hex value or from the picker. Colors too light or too dark to read are adjusted. | Black |
| Title | The heading above the amounts. Leave blank for none. | — |
| Description | A line below the title, such as a short campaign message. Leave blank for none. | — |
| Button Label | The text on the donate button: “Give”, “Support”, “Back us”… | Donate |
If Pybara pauses the widget or recurring donations, during a security response or maintenance for instance, the card shows Currently disabled by Pybara. While the widget is paused it shows nowhere; while recurring donations are, one-time donations still work. Your settings are kept, and both come back on their own.
After Donation
Section titled “After Donation”- Thank You Message: what the donor sees after giving. Leave blank for the widget’s default message.
- Redirect URL (optional): a page to send the donor to instead, such as your own thank-you page.
Place the widget wherever donations should be taken, in any of three ways:
- Block: add the Pybara Donate block in the editor.
- Shortcode: paste
[pybara_donate]in any post, page or widget area. - Theme template: add
<?php echo do_shortcode('[pybara_donate]'); ?>to a template file.
See Embedding for details.
Terms of Service
Section titled “Terms of Service”Tick I have read and agree to the Pybara Terms of Service and Privacy Policy, then click Save Settings. Settings take effect on the live widget at once. When the terms change, the plugin asks again.
Language
Section titled “Language”The widget follows your WordPress site language (Settings → General → Site Language) in English, French, Spanish and German. For any other site language, it follows the visitor’s browser language.