Aths Donations Progress Bar
| 开发者 | athlios |
|---|---|
| 更新时间 | 2026年6月6日 12:38 |
| 捐献地址: | 去捐款 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.0 |
| 版权: | GPL-3.0-or-later |
| 版权网址: | 版权信息 |
详情介绍:
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.
安装:
- Upload the plugin folder to
/wp-content/plugins/. - Activate the plugin through the WordPress Plugins screen.
- Go to Settings > Aths Donations.
- Open PayPal Developer, sign in with the PayPal account that receives donations, and create a REST app from Apps & Credentials.
- Enable Transaction Search for the same REST app. PayPal may take up to 9 hours before the permission works.
- Copy the app Client ID and Secret into the plugin settings. Use Sandbox credentials with Sandbox mode and Live credentials with Live mode.
- Set the currency, fundraising target, privacy options, and donation button details.
- Save, run a manual sync, then add
[aths_donations]to a page, post, or Shortcode block. - Alternatively, add the Aths Donations Progress Bar widget from Appearance > Widgets.
常见问题:
Can this connect to any PayPal account?
It can connect to a PayPal account when the site owner has REST app credentials for that account and Transaction Search is enabled for the app.
Why do recent donations not appear immediately?
PayPal states that executed transactions can take up to several hours to appear in Transaction Search.
How are donor names masked?
When masking is enabled, each name part keeps the configured number of leading characters and replaces the rest with asterisks.
Where are PayPal credentials stored?
The PayPal Client ID and Secret are stored in the WordPress options table for this site. The secret is only used server-side to request a PayPal API access token.
What donor data is stored?
The plugin stores synced transaction ID, donor name, date, amount, currency, and item note data returned by PayPal. Public output can mask donor names and can hide amounts or dates.
更新日志:
1.0.43
- Expanded the Frankfurter external-service disclosure with clearer data, privacy, and terms links for WordPress.org review.
- Normalized the main plugin file line endings for Plugin Check readiness.
- Updated the WordPress.org Tested up to metadata to 7.0 for Plugin Check readiness.
- Removed unverified repository links from plugin metadata and readme before WordPress.org submission.
- Removed the public container background and box shadow from the donation display.
- Resolved Plugin Check findings for translation loading, sync notice nonce handling, widget renderer output, and Google Fonts asset versioning.
- Standardized WordPress.org review metadata and added external-service disclosures for PayPal, Frankfurter, and Google Fonts.
- Added a widget container padding option so widget output can match padded text-widget layouts.
- Added a WordPress widget for placing the donation display in widget areas without using a shortcode.
Older changes are available in
changelog.txt.