Configuration
Navigate to Pybara Donate → Settings in your WordPress admin.
Enable/Disable
Section titled “Enable/Disable”Toggle the plugin on or off. When disabled, the donation widget will not render on your site even if embedded via shortcode or block. This is useful for temporarily pausing donations without uninstalling the plugin.
Recipient Setup
Section titled “Recipient Setup”This is where you connect your receiving wallet — the address where donations land.
Option 1: Pybara Wallet (Recommended)
Section titled “Option 1: Pybara Wallet (Recommended)”Click Connect Pybara Wallet to authenticate with Internet Identity and automatically link your Pybara Wallet principal. This is the fastest and most secure method.
Option 2: Other Wallet
Section titled “Option 2: Other Wallet”Select Other wallet and paste your principal ID manually. This works with any ICP-compatible wallet or canister:
- Oisy — oisy.com
- Plug — plugwallet.ooo
- NFID — nfid.one
After pasting your principal, click Verify Principal to confirm it is valid and reachable on the IC mainnet.
Accepted Tokens
Section titled “Accepted Tokens”Read-only panel showing which tokens are currently active on the Pybara protocol. Donors can pay with any displayed token. The list updates automatically if a token is ever disabled at the protocol level.
Widget Settings
Section titled “Widget Settings”Controls how the donation widget looks and behaves.
Choose how the widget colors its background and text:
- Light — white background, dark text (default)
- Dark — dark background, light text
- Auto — detects the surrounding page background and switches automatically. Updates reactively if a JavaScript theme switcher or OS dark-mode preference changes.
Accent Color
Section titled “Accent Color”The highlight color used for buttons, active states, and links. Enter a hex value (e.g. #7c3aed) or use the color picker. The widget automatically clamps low-contrast values to remain legible.
Currency
Section titled “Currency”Select the fiat currency used to display amounts in the widget. This is a display preference — donations are always settled in the chosen crypto token on-chain.
Supported currencies: USD, EUR, GBP, CAD, AUD, CHF, JPY, BRL, MXN, INR, SGD, HKD, NOK, SEK, DKK, PLN, NZD.
Preset Amounts
Section titled “Preset Amounts”Configure up to 5 suggested donation amounts shown as buttons in the widget. Type a number and press Enter or comma to add it as a tag. Click × to remove.
- Maximum: 5 amounts
- Default: 5, 10, 25, 50
- At least one amount is required
Allow Custom Amount
Section titled “Allow Custom Amount”When enabled, donors can type any amount in addition to the preset buttons. Enabled by default.
Allow Recurring Donations
Section titled “Allow Recurring Donations”When enabled, donors can set up recurring pledges. Enabled by default.
Default Frequency
Section titled “Default Frequency”Visible when recurring is enabled. Sets which frequency option is pre-selected when a donor opens the widget: Weekly, Monthly (default), or Yearly.
Default Duration
Section titled “Default Duration”Visible when recurring is enabled. Sets the pre-selected pledge length: 3 months, 6 months, 12 months (default), 24 months, or Unlimited.
Widget Text
Section titled “Widget Text”Optional text fields that appear directly in the donation widget.
Heading displayed above the amount selector. Leave blank for no heading.
Description
Section titled “Description”Sub-heading below the title. Useful for a short campaign message. Leave blank to omit.
Button Label
Section titled “Button Label”Text on the donate button. Defaults to Donate. Use this to match your campaign voice — “Give”, “Support”, “Back us”, etc.
After Donation
Section titled “After Donation”Thank You Message
Section titled “Thank You Message”Text shown to the donor after a successful donation. Leave blank to use the default (“You’re all set!”).
Thank You Redirect URL
Section titled “Thank You Redirect URL”If set, the donor is redirected to this URL after a successful donation instead of seeing the thank you message. Useful for a custom thank you page.
Your Rate
Section titled “Your Rate”Displays your current commission rate and its status. Recipients who process their first donation in 2026 or 2027 lock in that rate for life.
Language
Section titled “Language”The widget language is derived automatically from your WordPress site language (Settings → General → Site Language). No configuration needed.
Supported languages: English, French, Spanish, German. For any other WordPress locale, the widget falls back to the visitor’s browser language.
Availability
Section titled “Availability”Some features can be temporarily suspended at the protocol level by Pybara — for example during a security response or scheduled maintenance. When this happens:
- Widget suspended — the donation widget will not render even if the plugin is enabled. Your settings are preserved and the widget resumes automatically when the suspension is lifted.
- Recurring suspended — the recurring donations option is hidden from donors. One-time donations continue to work normally.
When a suspension is active, a notice appears on the plugin settings page.
Settlement
Section titled “Settlement”Volatile token donations can be automatically converted to a stablecoin at the time of settlement. See AutoStable for setup and options.
Save Settings
Section titled “Save Settings”Click Save Settings at the bottom of the page. Settings take effect immediately on the live widget.