Aths Donations Progress Bar

Aths Donations Progress Bar is created by Athlios. It connects to a PayPal REST app, syncs recent account transactions through PayPal Transaction Search, and displays a fundraising progress bar with a newest-first donor list.

Features:

• PayPal sandbox/live connection settings.
• Daily sync plus manual sync from the settings screen.
• Donor list sorted from newest to oldest.
• Optional donor name masking with a configurable number of visible characters.
• Configurable fundraising target and currency.
• Configurable initial amount for donations received before installing the plugin.
• Configurable filled progress bar color.
• Optional text color, background color, and font size controls for the public display.
• Optional curated font-family dropdown with theme default, browser-safe fonts, and selected Google Fonts.
• Optional custom message under the progress bar and thank-you message under the donations list.
• Left, center, or right alignment controls for custom text and thank-you text.
• Optional PayPal donation button using a hosted button ID or business email.
• Simple PayPal donation link option for PayPal.me or PayPal Donate URLs.
• Automatic currency conversion into the selected display currency during sync.
• Sync period options for a full calendar year or a rolling number of days.
• Shortcodes for combined display and button-only display.
• Legacy WordPress widget for widget areas and widget-based sidebars.

PayPal note: the PayPal REST app must have Transaction Search enabled. PayPal may take several hours to make new transactions available through that API.

Shortcodes

[aths_donations] displays the progress bar, donation button, and donor list.

[aths_donations show_button="0"] hides the donation button.

[aths_donations show_list="0"] hides the donor list.

[aths_donations limit="10"] changes the number of donors shown.

[aths_donation_button] displays only the donation button.<h3>Widget</h3>

The plugin adds an Aths Donations Progress Bar widget for widget areas and widget-based sidebars. The widget can show or hide the progress bar, Donate button, and supporter list, limit the number of supporters shown, and set padding around the widget content.

External Services

This plugin connects to external services only when the site owner configures features that require them.

PayPal is used to connect to the site owner’s PayPal REST app, request an OAuth access token, search account transactions through Transaction Search, and send visitors to PayPal when they click a configured Donate button. The plugin sends the configured PayPal Client ID and Secret to PayPal for authentication, sends the selected sync date range and optional transaction event-code filter to PayPal Transaction Search, and receives transaction data such as transaction ID, payer name, amount, currency, date, status, and item note. The public Donate button may also load a PayPal-hosted button mark image from paypalobjects.com.

PayPal Developer Agreement: https://www.paypal.com/us/legalhub/paypal/xdeveloper-full
PayPal Privacy Statement: https://www.paypal.com/privacy

Frankfurter is used for exchange-rate lookup when synced PayPal donations use a different currency from the selected display currency. The plugin sends currency codes such as EUR and USD to Frankfurter only when donations are synced and currency conversion is needed. It does not send donor names, transaction IDs, PayPal credentials, donation notes, or site visitor data to Frankfurter.

This service is provided by Frankfurter / lineofflight. The public API is documented at https://frankfurter.dev/. Frankfurter states in its FAQ that the API itself does not collect personal data, but the public app runs behind Cloudflare for performance and Cloudflare may collect basic analytics/performance information. Frankfurter is open source under the MIT license.

Frankfurter API documentation and privacy information: https://frankfurter.dev/
Frankfurter license / terms: https://github.com/lineofflight/frankfurter/blob/main/LICENSE
Cloudflare Privacy Policy: https://www.cloudflare.com/privacypolicy/
Cloudflare Website and Online Services Terms: https://www.cloudflare.com/website-terms/

Google Fonts is used only when the site owner chooses one of the Google Font presets in Visual Settings. In that case, the public page loads the selected font stylesheet from Google Fonts. If Theme default or a browser-safe font is selected, Google Fonts is not loaded by this plugin.

Google Fonts privacy information: https://developers.google.com/fonts/faq/privacy