=== CharityGlow — Donations & Fundraising ===
Contributors: amdad
Tags: nonprofit, donation, fundraising, recurring donation, charity
Requires at least: 5.8
Tested up to: 7.1.4
Stable tag: 1.2.3
Requires PHP: 7.4
License: GPLv2
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Free recurring donations, 0% platform fees. Stripe, PayPal, bKash/Nagad via SSLCommerz. Setup wizard, shortcodes, dashboard, and reports.

== Description ==

**CharityGlow** is a WordPress donation and fundraising plugin for nonprofits, NGOs, mosques, churches, schools, and community groups.

Donors can give once or on a schedule. CharityGlow does not charge a platform fee. Stripe, PayPal, and SSLCommerz charge their own processing fees.

**Free recurring donations. 0% CharityGlow platform fee. A setup wizard, shortcodes, a dashboard, and reports.**

https://youtu.be/fqQ52L-WsHA

**Live demo:** https://demo.charityglow.com/

**Website:** https://charityglow.com/

= Why charities use the free plugin =

* **Recurring donations are free** — monthly, quarterly, and yearly through Stripe and PayPal
* **0% platform fee** — CharityGlow does not take a percentage of the gift
* **Stripe** — card donations, one-time and recurring
* **PayPal** — one-time and recurring
* **bKash, Nagad, Rocket, and Upay** through SSLCommerz (one-time, BDT, SSLCommerz merchant account required)
* **Bank transfer** for offline donations
* **Setup wizard** — connect a gateway, create a campaign, copy the shortcode
* **Shortcodes** for the form, campaigns, progress, donor wall, stats, and recent gifts
* **Dashboard and reports** — totals, basic charts, this month, top campaigns, top donors, and gateway totals
* **21 currencies** in Settings (USD, EUR, GBP, CAD, AUD, JPY, INR, BRL, MXN, CHF, CNY, NZD, SEK, NOK, DKK, PLN, SGD, HKD, KRW, ZAR, BDT)

**Start on the free plugin. Upgrade when you need PDF receipts, the form builder, or Elementor.**

= 🎁 Free Setup Assistance =

**Free setup assistance for the first 100 organizations.**

If you need help getting started, we'll help you install, configure, and launch your CharityGlow donation system.

= 💡 Why CharityGlow? =

CharityGlow gives you the core tools needed to start accepting donations and managing fundraising campaigns from your WordPress website.

* Create beautiful donation forms
* Accept one-time and recurring donations
* Connect popular payment gateways
* Create unlimited fundraising campaigns
* Track donations and donors
* Display campaign goals and progress
* Send donor receipts and admin notifications
* Manage donation data from your WordPress dashboard

**Start free, then upgrade when you need more advanced fundraising tools.**

= 💳 Payment Gateways =

* **Stripe** — Credit and debit card donations
* **PayPal** — PayPal and supported guest checkout options
* **SSLCommerz** — bKash, Nagad, Rocket, Upay, bank cards, and internet banking (one-time gifts in BDT; an SSLCommerz merchant account is required)
* **Bank Transfer** — Offline/manual donations

= 🎨 Beautiful Donation Forms =

Choose from 5 included donation form templates:

* Classic
* Inline
* Minimal
* Card
* Wizard

You can also configure preset donation amounts, custom amounts, anonymous donations, and donation comments.

= ❤️ Fundraising Campaigns =

Create unlimited campaigns and give each campaign its own fundraising goal, deadline, featured image, donation form, and progress display.

Use CharityGlow to build campaigns for:

* Emergency fundraising
* Zakat and sadaqah
* Orphan support
* Education
* Medical assistance
* Community projects
* General charity campaigns

= 🔁 Recurring Donations =

Give donors the option to make recurring contributions:

* Monthly
* Quarterly
* Yearly

Recurring payments run through Stripe and PayPal. SSLCommerz and bank transfer accept one-time donations.

= 👥 Donor Management =

Keep donation and donor information organized inside WordPress.

* Donor profiles
* Donation history
* Lifetime value
* Campaign-related donation data
* Recent donations
* Public donor wall with anonymous donation support

= 📊 Reports & Dashboard =

Monitor your fundraising activity from the WordPress dashboard.

* Donation statistics
* Basic charts
* Recent donations
* Campaign progress
* Donation records
* Donor information

= 📧 Donation Receipts & Notifications =

CharityGlow can send:

* Donor email receipts
* Admin donation notifications

Your donors can receive confirmation after a successful donation while administrators stay informed about new donations.

= 📱 Mobile-Friendly =

CharityGlow donation forms are designed to work across:

* Desktop
* Tablet
* Mobile

= 🆓 Free Version =

The free version includes the core tools needed to launch a WordPress donation system.

**Included in Free:**

* 5 donation form templates
* Stripe
* PayPal
* SSLCommerz
* Bank Transfer
* One-time donations
* Recurring donations
* Unlimited campaigns
* Campaign goals and deadlines
* Progress bars
* Featured campaign images
* Donor profiles
* Donation history
* Lifetime donor value
* Dashboard statistics
* Basic charts
* Recent donations
* Donor wall
* Donation comments
* Anonymous donations
* Donation email receipts
* Admin notifications
* 12 shortcodes
* 21 currencies
* Mobile-responsive forms
* GDPR-related data tools

**Free version limitation:** Donation forms include CharityGlow branding.

= 🚀 CharityGlow Pro =

Need more control over your donation forms, receipts, reporting, and page-builder integration?

**CharityGlow Pro adds advanced fundraising tools on top of the free version.**

Recurring donations (monthly, quarterly, yearly) are included in the **free** plugin. Pro adds PDF receipts, advanced reporting, form builder, Elementor widgets, failed-payment emails, and branding control.

Pro features include:

* Advanced form builder
* Multi-step donation forms
* Basic conditional fields
* Custom donation amounts in the form builder
* Popup/modal donation forms
* 10 premium donation templates
* Remove CharityGlow branding
* PDF donation receipts
* Custom receipt logo and branding
* Sequential receipt numbers
* Failed payment email notifications
* Campaign-level reports
* Basic fundraising analytics
* Elementor widgets for donation forms, campaigns, and progress
* Failed payment email notifications for recurring gifts
* Additional payment options and integrations as Pro development expands

*(Donor CSV import/export and popup donation forms are on the Pro roadmap.)*

= 🔥 Why Upgrade? =

The free version is designed to help you start accepting donations quickly.

Upgrade to Pro when you need advanced tools such as:

**Advanced Forms**
* More form layouts
* Multi-step forms
* Conditional fields
* Popup/modal donation forms

**Professional Receipts**
* PDF donation receipts
* Custom receipt branding
* Sequential receipt numbers

**Better Administration**
* Campaign-level reports
* Donor CSV import/export
* Additional analytics

**WordPress Page Builder Integration**
* Elementor widgets for forms, campaigns, and progress

**Branding Control**
* Remove CharityGlow branding from donation forms

= ❤️ Who Is CharityGlow For? =

CharityGlow is suitable for:

* Nonprofits and NGOs
* Charities and fundraising organizations
* Mosques and Islamic organizations
* Churches and religious organizations
* Schools and educational organizations
* Community and social organizations
* Individual fundraising campaigns

= 🧩 Shortcodes =

* `[charityglow_form]` — Main donation form (`[charityglow_donation_form]` is the same form)
* `[charityglow_form campaign_id="123"]` — Donation form linked to a campaign
* `[charityglow_form amounts="10,25,50,100,250"]` — Custom preset donation amounts
* `[charityglow_campaign]` — Single campaign
* `[charityglow_campaigns]` — Display campaigns
* `[charityglow_progress_bar campaign_id="123"]` — Display campaign progress
* `[charityglow_donor_wall]` — Display public donor wall
* `[charityglow_recent_donations]` — Display recent donations
* `[charityglow_stats]` — Display donation statistics
* `[charityglow_zakat_calculator]` — Zakat calculator (cash, gold, silver, business assets, nisab)
* `[charityglow_how_it_works]` — How giving works
* `[charityglow_payment_methods]` — Enabled payment methods
* `[charityglow_donation_success]` — Donation success page
* `[charityglow_donation_failed]` — Donation failed page

= 🔒 Security & Privacy =

CharityGlow is designed to work with established payment providers for payment processing.

* Payment card information is handled by the supported payment provider rather than stored as raw card data by CharityGlow.
* Stripe, PayPal, and SSLCommerz process payments through their own systems.
* Freemius handles Pro licensing, upgrades, and optional analytics. CharityGlow does not send site or usage data to Freemius unless an administrator opts in, activates a license, or starts checkout.
* CharityGlow includes data export and deletion tools to help site administrators manage donor data.
* Review the payment provider's terms and privacy policy, and the Freemius terms and privacy policy, for details about their services.

= 🔧 Installation =

1. Install CharityGlow from the WordPress plugin directory, or upload the `charityglow` folder to `/wp-content/plugins/`.
2. Activate the plugin through the **Plugins** menu in WordPress.
3. Go to **CharityGlow → Settings**.
4. Configure one or more payment gateways.
5. Create your first campaign from **CharityGlow → Campaigns**.
6. Add `[charityglow_form]` to a page where you want to accept donations.

🎁 Free setup assistance is available for the first 100 charities.

= ⚡ Quick Start =

1. Install and activate CharityGlow.
2. Open **CharityGlow → Settings**.
3. Configure Stripe, PayPal, SSLCommerz, and/or Bank Transfer.
4. Create a campaign.
5. Add a CharityGlow donation form to your page.
6. Test your donation flow.
7. Publish your campaign and start accepting donations.

= Quick Start for Stripe Testing =

1. Go to **CharityGlow → Settings**.
2. Enter your Stripe test API keys.
3. Enable test mode.
4. Create a test campaign.
5. Add `[charityglow_form]` to a page.
6. Use Stripe's official test card information when testing payments.

For current Stripe test-card details, see Stripe's documentation.

= Quick Start with SSLCommerz (bKash, Nagad, Rocket) =

1. Go to **CharityGlow → Settings → Payment Gateways**.
2. Enable SSLCommerz.
3. Enter your SSLCommerz Store ID and Store Password.
4. Use your approved sandbox credentials for testing.
5. Set your donation currency to BDT.
6. Add `[charityglow_form]` to a page and test the donation flow.

Use the credentials provided by SSLCommerz for your account. Do not publish real merchant credentials in documentation or support requests.

== Frequently Asked Questions ==

= Which payment gateways are supported? =

CharityGlow supports Stripe, PayPal, SSLCommerz (bKash, Nagad, Rocket, Upay, bank cards, and internet banking), and offline bank transfer. SSLCommerz payments use BDT.

= Does CharityGlow support bKash, Nagad, or Rocket? =

Yes. With an SSLCommerz merchant account, donors can give through bKash, Nagad, Rocket, Upay, supported bank cards, and supported internet banking. SSLCommerz payments use BDT.

= Is SSLCommerz included in the free version? =

Yes. SSLCommerz is included in the free version of CharityGlow. You need an approved SSLCommerz merchant account to accept live payments.

= Can I accept recurring donations? =

Yes. CharityGlow supports monthly, quarterly, and yearly recurring donations through supported payment gateways.

= What donation form templates are available? =

The free version includes five templates: Classic, Inline, Minimal, Card, and Wizard. CharityGlow Pro adds additional premium templates and advanced form tools.

= Is CharityGlow mobile-friendly? =

Yes. Donation forms are designed to work on desktop, tablet, and mobile devices.

= Can I customize donation amounts? =

Yes. You can configure preset donation amounts and allow custom donation amounts. You can also use shortcode attributes such as `[charityglow_form amounts="10,25,50,100,250"]`.

= Does CharityGlow send email receipts? =

Yes. Donors can receive donation receipts by email, and administrators can receive donation notifications.

= Can I create unlimited campaigns? =

Yes. CharityGlow supports unlimited fundraising campaigns.

= Can I track donations by campaign? =

Yes. Campaigns can have their own goals, deadlines, progress displays, and donation records. CharityGlow Pro adds campaign-level reporting.

= Can donors give anonymously? =

Yes. Donors can choose to make their donation anonymous. Their name can be hidden from public donor displays.

= What currencies are supported? =

Settings includes 21 currencies: USD, EUR, GBP, CAD, AUD, JPY, INR, BRL, MXN, CHF, CNY, NZD, SEK, NOK, DKK, PLN, SGD, HKD, KRW, ZAR, and BDT. A gateway can still limit which of those it accepts. SSLCommerz is for BDT.

= Does CharityGlow work with my WordPress theme? =

CharityGlow is designed to work with properly coded WordPress themes. Compatibility can vary depending on the theme and other plugins installed on a site.

= How do I display a campaign progress bar? =

Use the shortcode: `[charityglow_progress_bar campaign_id="123"]`

= Can I show recent donations on my site? =

Yes. Use `[charityglow_recent_donations]` or `[charityglow_donor_wall]` to display recent donations or a public donor wall.

= What is included in CharityGlow Pro? =

CharityGlow Pro adds advanced form building, premium templates, PDF receipts, custom receipt branding, sequential receipt numbers, campaign-level reports, donor CSV import/export, Elementor widgets, failed-payment notifications, and other advanced fundraising features.

= What data is shared with payment providers? =

Payment-related data is sent to the selected payment provider when a donor initiates a payment. Licensing and optional analytics are sent to Freemius only after an administrator opts in, activates a license, or starts checkout. See the **External Services** section below for Stripe, PayPal, SSLCommerz, and Freemius.

== External Services ==

This plugin connects to third-party services for payment processing, and to Freemius for licensing, upgrades, and optional analytics. Payment connections are used when a site administrator enables the corresponding payment gateway and a donor initiates a payment. Freemius is contacted only after an administrator opts in, activates a license, or starts checkout.

= Stripe =

CharityGlow uses Stripe to process credit and debit card donations and supported recurring payments.

**What it's used for:** Processing card donations, recurring payments, and supported payment operations.

**What data may be sent:**
* Payment amount and currency
* Donor name and email address
* Billing information when collected
* Donation metadata such as campaign ID, form ID, and donation ID
* Card/payment information required by Stripe's payment system

**When data is sent:** When a donor submits a donation using Stripe.

**Service Provider:** Stripe, Inc.
* Website: https://stripe.com
* Terms of Service: https://stripe.com/legal/ssa
* Privacy Policy: https://stripe.com/privacy

CharityGlow communicates with Stripe through its API and Stripe's supported payment libraries.

= PayPal =

CharityGlow uses PayPal to process donations through PayPal accounts and supported guest checkout options.

**What it's used for:** Processing donations through PayPal.

**What data may be sent:**
* Payment amount and currency
* Donation/order description
* Return and cancellation URLs
* Donor information required by PayPal
* Donation/invoice ID for tracking

**When data is sent:** When a donor selects PayPal and proceeds to payment.

**Service Provider:** PayPal, Inc.
* Website: https://www.paypal.com
* Terms of Service: https://www.paypal.com/webapps/mpp/ua/useragreement-full
* Privacy Policy: https://www.paypal.com/webapps/mpp/ua/privacy-full

CharityGlow communicates with PayPal through PayPal's supported API endpoints.

= SSLCommerz =

CharityGlow uses SSLCommerz to process one-time donations in BDT through bKash, Nagad, Rocket, Upay, internet banking, and supported bank cards.

**What it's used for:** Processing one-time BDT donations through bKash, Nagad, Rocket, Upay, internet banking, and bank cards.

**What data may be sent:**
* Payment amount and currency
* Donor name, email, and phone number
* Donation/transaction ID
* Return URLs for success, failure, and cancellation
* Merchant/store and transaction references required by SSLCommerz

**When data is sent:** When a donor selects SSLCommerz and proceeds to payment.

**Service Provider:** SSLCOMMERZ Limited
* Website: https://sslcommerz.com
* Terms of Service: https://sslcommerz.com/terms-condition/
* Privacy Policy: https://sslcommerz.com/privacy-policy/

CharityGlow communicates with SSLCommerz through its supported API endpoints.

**Currency limitation:** SSLCommerz payments in CharityGlow are intended for BDT transactions.

= Freemius =

CharityGlow includes the Freemius SDK for Pro and Agency licensing, in-dashboard upgrades, and optional product analytics.

**What it's used for:** License checks, the upgrade checkout, and usage analytics that an administrator can opt into. The free plugin works if the administrator skips the opt-in.

**What data may be sent:**
* Administrator name and email address
* Site address
* WordPress version, PHP version, site language, and the CharityGlow version
* License key, when a paid license is activated
* Plan and billing details entered on the Freemius checkout page

**When data is sent:** Only when an administrator opts in on the Freemius activation screen, activates a license, or starts checkout. Installing or activating the plugin, and ordinary admin or donation pages, do not send site or usage data to Freemius.

**Service Provider:** Freemius, Inc.
* Website: https://freemius.com
* Terms of Service: https://freemius.com/terms/
* Privacy Policy: https://freemius.com/privacy/

== Screenshots ==

1. Donation form with preset amounts, one-time or monthly giving, and card or PayPal
2. Multi-step donation form on the payment step
3. Zakat calculator with a live result, nisab, and the amount due
4. Campaign page with the amount raised and a progress bar
5. Recent donors on a campaign page
6. Dashboard with revenue, donation count, and a chart
7. Donations list with donor, amount, gateway, and status
8. Campaign editor with the amount raised and campaign details
9. Payment gateway settings for Stripe, PayPal, and bank transfer
10. Setup wizard on the connect-a-gateway step

== Changelog ==

= 1.2.3 - 2026-10-31 =
* New: Self-contained widget styles for [charityglow_stats], [charityglow_progress_bar], [charityglow_recent_donations], [charityglow_donor_wall], [charityglow_how_it_works] and [charityglow_payment_methods] — they now look right in any theme (loaded only when a widget is used).
* Fix: Thank-you and failed pages now show the donation result even if the selected page does not contain the shortcode.
* Fix: Removed a PDF library admin notice that appeared in the free version.
* Improved: Redesigned thank-you / failed pages (compact card, smaller share icons, donor and campaign rows).

= 1.2.2 - 2026-10-30 =
* Tested with WordPress 7.1.4.
* New: Free Zakat calculator shortcode `[charityglow_zakat_calculator]` and a Zakat Calculator block (cash, gold, silver, business assets, configurable nisab). Empty gold and silver prices fall back to built-in gram prices, and the calculator uses 2.5% of the entered wealth when nisab cannot be calculated. Pay Zakat opens the donation form when an amount is due.
* New: Donors can tag a gift as General, Zakat, Sadaqah, Lillah, Zakat al-Fitr, or Kaffarah. The tag is stored on the donation and printed on email and PDF receipts. Fund-type totals are a Pro report.
* Fix: The Zakat Calculator admin screen is registered under the CharityGlow menu so it is reachable after install.
* Improvement: Donation form templates (classic, inline, minimal, card, and wizard) use styles scoped to the form. The inline form keeps amount choices on one row.
* Improvement: Existing sites receive the new donation columns, including the fund tag and receipt fields, when the plugin loads. Deactivation is not required. A paid donation that cannot be saved is stored for recovery from wp-admin, including from Stripe payment metadata.
* Fix: A finished Stripe card payment returns the real result instead of a generic connection error when receipt generation fails.
* Improvement: BDT formats with the ৳ symbol and lakh/crore grouping. Turning on SSLCommerz sets BDT and giving types when the site is still on the default currency.
* New: Bangla (bn_BD) translations for the donation form, form scripts, receipts, setup wizard, Settings, the donations list, and Zakat screens.
* Improvement: wp-admin menu and setup wizard use the CharityGlow G mark. The menu icon is a monochrome SVG that follows the admin color scheme.
* Improvement: Readme lists the 21 currencies available in Settings, and the External Services section covers Freemius (licensing, upgrades, and opt-in analytics only).
* New: Admin growth prompts after your first completed donation (free sites) with links to Pro features.
* New: Demo bar option to hide Stripe test card details on the homepage (recommended for demo sites).
* Improvement: Dashboard Pro promo focuses on PDF receipts and board reporting; 14-day guarantee messaging aligned with charityglow.com.
* Improvement: Setup wizard documentation link points to the install guide on charityglow.com/docs.
* Pro: Giving Reports with date presets, campaign and status filters, totals by fund, and CSV, Excel CSV, and PDF export. The report menu is registered only when a Pro or Agency license is active.
* Pro: PDF receipts use the bundled Dompdf library, including Bengali text. A missing Composer file shows an admin notice instead of a PHP warning.
* Pro: The upgrade screen lists the shipped Pro features, including Giving Reports, and the checkout button uses normal admin button padding.

= 1.2.1 - 2026-08-27 =
* New: Data Export & Import System — Full plugin data export/import via JSON format for campaigns, donations, donors, forms, and activity logs.
* Fix: Donation Success Page social sharing — Fixed Facebook sharing and updated LinkedIn and X sharing URLs.
* Fix: Campaign Single Page social sharing — Fixed LinkedIn sharing and updated X sharing.

= 1.2.0 - 2026-05-09 =
* Improvement: Introduced a consistent brand color system across the plugin — Primary Green (#15803D), Secondary Blue (#1E40AF), and Accent Amber (#F59E0B).
* Improvement: Campaign details page redesigned with improved layout, goal/progress display, and donor information presentation.
* Improvement: Setup wizard updated with refreshed UI and smoother onboarding.
* Fix: Multiple CSS conflicts and styling inconsistencies in the admin area.
* Fix: Admin panel color overrides are properly scoped to avoid conflicts with WordPress core styles.

= 1.1.0 - 2026-03-11 =
* New: SSLCommerz payment gateway integration for Bangladesh — bKash, Nagad, Rocket, Upay, bank cards, and internet banking.
* New: BDT (Bangladeshi Taka) currency support.
* Improvement: Payment gateway settings now show a Bangladesh-specific notice for SSLCommerz.
* Improvement: Donation forms display enabled payment options based on administrator settings.

= 1.0.0 - 2026-02-02 =
* Initial release.
* Payment gateways: Stripe, PayPal, Offline/Bank Transfer.
* Form templates: Classic, Inline, Minimal, Card, Wizard.
* Campaign management with goals, deadlines, and progress tracking.
* Donor management with profiles, history, and lifetime value.
* Shortcodes for forms, campaigns, statistics, donor walls, progress bars, and more.
* Email receipts and administrator notifications.
* Analytics dashboard with statistics, charts, and reports.
* Recurring donations: monthly, quarterly, and yearly.
* Multi-currency support with proper formatting.
* Zero-decimal currency support.
* Mobile-responsive donation forms.
* GDPR-related data export and deletion tools.
* Anonymous donations.
* Theme compatibility with properly coded WordPress themes.

== Upgrade Notice ==

= 1.2.3 =
Widgets now have their own styles and look right in every theme. Fixes an empty thank-you page and a PDF notice in the free version. Recommended for all users.

= 1.2.2 =
Tested with WordPress 7.1.4. Adds a free Zakat calculator, gift tags (General, Zakat, Sadaqah, Lillah, Zakat al-Fitr, and Kaffarah), Bangladeshi Taka formatting, and a Bangla translation. Existing sites receive the donation table update without reactivation. Recommended for all users.

= 1.2.1 =
This update adds a full Data Export & Import system and improves social sharing on donation success and campaign pages. Recommended for all users.

= 1.2.0 =
This update introduces the refreshed CharityGlow brand color system, an improved campaign details page, an updated setup wizard, and admin CSS improvements.

= 1.1.0 =
Added SSLCommerz support for Bangladesh donations, including bKash, Nagad, Rocket, Upay, bank cards, and internet banking.

= 1.0.0 =
Initial release of CharityGlow. Start accepting donations with multiple payment gateways, donation forms, fundraising campaigns, donor management, and recurring donations.

= Support =

support@charityglow.com

= Documentation =

https://charityglow.com/docs/install-and-setup-wizard/

= Credits =

* Stripe PHP Library — https://stripe.com
* SSLCommerz — https://sslcommerz.com
* Chart.js — for charts in the admin dashboard
* WordPress Community — for the WordPress platform