=== CharityGlow — Donations & Fundraising ===
Contributors: amdad
Tags: donation, fundraising, charity, stripe, paypal, bkash, nagad
Requires at least: 5.8
Tested up to: 6.9
Stable tag: 1.2.0
Requires PHP: 7.4
License: GPLv2
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Accept donations via Stripe, PayPal, SSLCommerz (bKash, Nagad, Rocket) & Bank Transfer with high-converting forms, recurring donations, and built-in donor CRM.

== Description ==

🚀 **Create high-converting donation forms in minutes and start collecting donations today.**

**CharityGlow** is a modern WordPress donation plugin designed to help nonprofits, NGOs, mosques, and fundraising organizations **increase donations — not just collect them.**

👉 Simple setup. Powerful features. No coding required.

---

🔥 **See It In Action (Live Demo)**  
👉 https://demo.charityglow.com/  
👉 https://charityglow.com/

---

🎁 **Free setup for the first 100 organizations**  
We'll help you install, configure, and launch your donation system.

---

= 🎯 Why Choose CharityGlow? =

Most donation plugins are:
- ❌ Complicated  
- ❌ Expensive (addons required)  
- ❌ Hard to customize  

**CharityGlow is different:**

✅ All-in-one solution  
✅ Beginner-friendly setup  
✅ Built for higher conversion rates  
✅ Works worldwide + Bangladesh  

---

= 💰 What You Can Do With CharityGlow =

✔ Accept donations via Stripe, PayPal, SSLCommerz  
✔ Accept bKash, Nagad, Rocket (Bangladesh)  
✔ Create unlimited fundraising campaigns  
✔ Accept one-time or recurring donations  
✔ Track donors with built-in CRM  
✔ Show progress bars, donor walls, and stats  

👉 Everything you need in ONE plugin.

---

= ⚡ Built to Increase Donations =

CharityGlow is not just a form plugin.

It helps you:
✔ Build donor trust  
✔ Improve conversion rate  
✔ Encourage recurring giving  
✔ Create professional fundraising pages  

---

= 💳 Payment Gateways =

* **Stripe** - Credit/Debit Cards (Worldwide)
* **PayPal** - PayPal
* **SSLCommerz 🇧🇩** - bKash, Nagad, Rocket, Upay, Bank Cards
* **Bank Transfer** - Offline/manual donations

---

= 🇧🇩 Perfect for Bangladesh =

CharityGlow is the **first free WordPress donation plugin** with built-in SSLCommerz.

Accept:
✔ bKash  
✔ Nagad  
✔ Rocket  
✔ Upay  
✔ All Bangladeshi bank cards  

👉 No extra plugins needed.

---

= 🧩 Powerful Features =

* 🎨 5 Beautiful Donation Form Templates
* 🔁 Recurring Donations (monthly/yearly)
* 🌍 Multi-Currency (25+ currencies)
* 📊 Real-time Reports & Analytics
* 👥 Donor CRM (profiles, history, lifetime value)
* 📧 Email Receipts & Notifications
* 📈 Campaign Goals & Progress Tracking
* 🔒 Secure & GDPR compliant
* 📱 Fully mobile responsive

---

= 🆓 Free vs Pro =

**Free version includes everything you need to start collecting donations:**

- **Donation Forms (5 Templates)**: ✅ Free, ✅ Pro
- **Stripe Payment Gateway**: ✅ Free, ✅ Pro
- **PayPal Payment Gateway**: ✅ Free, ✅ Pro
- **SSLCommerz (bKash, Nagad, Rocket)**: ✅ Free, ✅ Pro
- **Bank / Offline Transfer**: ✅ Free, ✅ Pro
- **Recurring Donations**: ✅ Free, ✅ Pro
- **Unlimited Campaigns**: ✅ Free, ✅ Pro
- **Campaign Goals & Progress Bar**: ✅ Free, ✅ Pro
- **Donor CRM (profiles & history)**: ✅ Free, ✅ Pro
- **Email Receipts & Notifications**: ✅ Free, ✅ Pro
- **Donor Wall & Recent Donations**: ✅ Free, ✅ Pro
- **25+ Currencies**: ✅ Free, ✅ Pro
- **Anonymous Donations**: ✅ Free, ✅ Pro
- **GDPR Compliance Tools**: ✅ Free, ✅ Pro
- **Mobile Responsive Forms**: ✅ Free, ✅ Pro
- **Advanced Form Builder**: ❌ Free, ✅ Pro
- **Multi-step Donation Forms**: ❌ Free, ✅ Pro
- **Conditional Form Fields**: ❌ Free, ✅ Pro
- **10 Premium Form Templates**: ❌ Free, ✅ Pro
- **PDF Receipt Generator**: ❌ Free, ✅ Pro
- **Custom Receipt Branding**: ❌ Free, ✅ Pro
- **Sequential Receipt Numbers**: ❌ Free, ✅ Pro
- **Campaign-Level Reports**: ❌ Free, ✅ Pro
- **Analytics Dashboard**: ❌ Free, ✅ Pro
- **Elementor Widgets**: ❌ Free, ✅ Pro
- **Failed Payment Email**: ❌ Free, ✅ Pro

🚀 **Upgrade to Pro:** https://charityglow.com/

---

= 🎥 Live Demo =

👉 Frontend Demo: https://demo.charityglow.com/

---

= ❤️ Who Is This For? =

* Nonprofits & NGOs  
* Mosques (Bangladesh)  
* Churches & religious organizations  
* Schools & universities  
* Fundraising campaigns  
* Community & social organizations  

---

= ⭐ Early Users Feedback =

"Simple, powerful, and perfect for our donation campaigns."

(👉 Add real testimonials soon)

---

= 🔧 Installation =

1. Upload plugin to `/wp-content/plugins/`
2. Activate via WordPress admin
3. Go to **CharityGlow → Settings**
4. Configure payment gateways
5. Create your first campaign
6. Add `[charityglow_form]` to any page

---

= ⚡ Quick Start =

1. Install & activate plugin  
2. Add Stripe or PayPal keys  
3. Create campaign  
4. Add form shortcode  
5. Start collecting donations  

---

= 🔧 Shortcodes =

* `[charityglow_form]` — Main donation form
* `[charityglow_form campaign_id="123"]` — Form linked to a specific campaign
* `[charityglow_form amounts="10,25,50,100,250"]` — Custom preset amounts
* `[charityglow_campaigns]` — Display all campaigns grid
* `[charityglow_progress_bar campaign_id="123"]` — Campaign progress bar
* `[charityglow_donor_wall]` — Public donor wall
* `[charityglow_recent_donations]` — Recent donations list
* `[charityglow_stats]` — Donation statistics

---

= 🔒 Security & Compliance =

* PCI compliant (via Stripe/PayPal/SSLCommerz)
* GDPR ready (data export/delete)
* Secure API & encrypted transactions

---

== External Services ==

This plugin connects to third-party services for payment processing. These connections are essential to process donations securely. No data is sent until a donor actively initiates a payment.

= Stripe =

This plugin uses Stripe to process credit and debit card payments. Stripe is a payment processing platform that securely handles card transactions.

**What it's used for:** Processing credit/debit card donations, managing recurring subscriptions, and handling refunds.

**What data is sent:**
* Payment amount and currency
* Card details (sent directly to Stripe via Stripe.js, never touches your server)
* Donor name and email address
* Billing address (if collected)
* Donation metadata (campaign ID, form ID, donation ID)

**When data is sent:** When a donor submits a donation form using the Stripe payment method.

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

This plugin includes the Stripe PHP library to communicate with Stripe's API (https://api.stripe.com).

= PayPal =

This plugin uses PayPal to process donations via PayPal accounts and PayPal guest checkout.

**What it's used for:** Processing donations through PayPal, allowing donors to pay using their PayPal balance, linked bank accounts, or cards via PayPal.

**What data is sent:**
* Payment amount and currency
* Donation/order description
* Return URLs (success and cancel pages on your site)
* Donor name and email (processed by PayPal)
* Invoice/donation ID for tracking

**When data is sent:** When a donor selects PayPal as their payment method and clicks to proceed. The donor is redirected to PayPal's website (https://paypal.com) to complete the payment.

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

This plugin connects to PayPal's API endpoints (https://api-m.paypal.com for live, https://api-m.sandbox.paypal.com for testing).

= SSLCommerz =

This plugin uses SSLCommerz to process donations via Bangladeshi payment methods including bKash, Nagad, Rocket, Upay, and Bangladeshi bank cards.

**What it's used for:** Processing donations from Bangladesh using local payment methods (mobile wallets, internet banking, and bank cards).

**What data is sent:**
* Payment amount and currency (BDT only)
* Donor name, email, and phone number
* Donation/transaction ID for tracking
* Return URLs (success, fail, and cancel pages on your site)
* Store ID and transaction reference

**When data is sent:** When a donor selects SSLCommerz as their payment method and clicks to donate. The donor is redirected to SSLCommerz's secure hosted payment page (https://securepay.sslcommerz.com) to complete the payment.

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

This plugin connects to SSLCommerz API endpoints:
* Sandbox: https://sandbox.sslcommerz.com
* Live: https://securepay.sslcommerz.com

**Note:** SSLCommerz is only available for BDT (Bangladeshi Taka) transactions. It is intended for use by organizations based in Bangladesh.

== Installation ==

1. Upload the `charityglow` folder to `/wp-content/plugins/`
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Go to **CharityGlow → Settings** to configure payment gateways
4. Add your Stripe and/or PayPal API keys, or SSLCommerz credentials for Bangladesh
5. Create your first campaign in **CharityGlow → Campaigns**
6. Add the donation form to any page using `[charityglow_form]`

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

= Quick Start =

1. After activation, go to **CharityGlow → Settings**
2. Enter your Stripe Test API keys (get from stripe.com/dashboard)
3. Enable "Test Mode" for testing
4. Create a test campaign with a goal amount
5. Add `[charityglow_form]` to any page
6. Make a test donation with card number: 4242 4242 4242 4242

= Quick Start for Bangladesh (SSLCommerz) =

1. After activation, go to **CharityGlow → Settings → Payment Gateways**
2. Enable SSLCommerz and enter your Store ID and Store Password
3. For sandbox testing, use Store ID: `testbox12345` and Password: `qwerty`
4. Set your currency to BDT in settings
5. Add `[charityglow_form]` to any page and test with sandbox credentials

== Frequently Asked Questions ==

= Which payment gateways are supported? =

CharityGlow supports Stripe (credit/debit cards), PayPal, SSLCommerz (Bangladesh — bKash, Nagad, Rocket, Upay, bank cards), and Offline/Bank Transfer payments out of the box.

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

Yes! Through the SSLCommerz integration, you can accept donations via bKash, Nagad, Rocket, Upay, and all major Bangladeshi bank cards and internet banking. SSLCommerz is included free of charge.

= Is SSLCommerz free to use? =

Yes! SSLCommerz integration is included in the free version of CharityGlow. You do need to register for an SSLCommerz merchant account at sslcommerz.com and get approved before accepting live payments.

= Can I accept recurring donations? =

Yes! Donors can choose to give monthly, quarterly, or yearly recurring donations. Stripe handles the automatic billing.

= What form templates are available? =

Five beautiful templates: Classic (full-featured), Inline (compact), Minimal (two-step), Card (modern), and Wizard (multi-step guided).

= Is it mobile-friendly? =

Yes, all donation forms are fully responsive and work great on mobile devices, tablets, and desktops.

= Can I customize the donation amounts? =

Yes, you can set custom preset amounts via shortcode attributes or in the plugin settings. Example: `[charityglow_form amounts="10,25,50,100,250"]`

= Does it send email receipts? =

Yes, donors automatically receive a beautiful HTML email receipt after donating. Admins also receive notification emails.

= Is it GDPR compliant? =

Yes, CharityGlow includes GDPR compliance features including donor data export and deletion capabilities.

= Can I track donations by campaign? =

Yes, you can create unlimited campaigns and track donations, donors, and progress for each one separately.

= Does it work with my theme? =

CharityGlow is designed to work with any properly coded WordPress theme. It's tested with popular themes like Astra, GeneratePress, and OceanWP.

= Can donors give anonymously? =

Yes, there's an option for donors to make their donation anonymous. Their name will be hidden from public donor walls.

= What currencies are supported? =

25+ currencies including USD, EUR, GBP, BDT (Bangladeshi Taka), CAD, AUD, JPY, INR, and more. The plugin properly handles zero-decimal currencies like JPY.

= 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]` shortcodes to display recent donors and donations.

= What data is shared with payment providers? =

Please see the "External Services" section in this readme for detailed information about what data is shared with Stripe, PayPal, and SSLCommerz, and when.

== Screenshots ==

1. Wizard (multi-step) donation form on frontend
2. All type donation form
3. Single campaign with donation form
4. Donation success page
5. Admin dashboard with real-time statistics
6. Campaign management
7. Payment gateway settings (Stripe, PayPal, SSLCommerz)
8. Donation list
9. Reports
10. Donor management (CRM) with lifetime value

== Changelog ==

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

= 1.1.0 - 2026-03-11 =
* New: SSLCommerz payment gateway integration (Bangladesh) — bKash, Nagad, Rocket, Upay, bank cards, and internet banking
* New: BDT (Bangladeshi Taka) currency support
* Improvement: Payment gateway settings page now shows Bangladesh-only warning for SSLCommerz
* Improvement: Donation form shows all three payment options (Stripe, PayPal, SSLCommerz) based on admin settings

= 1.0.0 - 2026-02-02 =
* Initial release
* **Payment Gateways:** Stripe, PayPal, Razorpay, Offline/Bank Transfer
* **Form Templates:** Classic, Inline, Minimal, Card, Wizard (5 templates)
* **Campaign Management:** Unlimited campaigns with goals, deadlines, and progress tracking
* **Donor Management:** Full CRM with donor profiles, history, and lifetime value
* **12 Shortcodes:** Forms, campaigns, stats, donor walls, progress bars, and more
* **Email System:** Beautiful HTML receipts and admin notifications
* **Analytics Dashboard:** Real-time stats, charts, and reports
* **Recurring Donations:** Monthly, quarterly, and yearly options
* **Multi-Currency:** 25+ currencies with proper formatting
* **Zero-Decimal Support:** Proper handling of JPY, KRW, and other currencies
* **Mobile Responsive:** All forms optimized for any device
* **GDPR Compliance:** Data export and deletion tools
* **Anonymous Donations:** Option to give anonymously
* **Theme Compatibility:** Works with Astra, GeneratePress, OceanWP, and more

== Upgrade Notice ==

= 1.2.0 =
This update brings a refreshed brand color system, an improved campaign details page, an updated setup wizard, and several admin CSS fixes. Recommended for all users.

= 1.1.0 =
Added SSLCommerz (bKash, Nagad, Rocket) for Bangladesh donations.

= 1.0.0 =
Initial release of CharityGlow donation plugin. Start accepting donations today with multiple payment gateways and beautiful forms!

== Additional Info ==

= Support =

support@charityglow.com

= Documentation =

https://charityglow.com/docs

= Credits =

* Stripe PHP Library - [stripe.com](https://stripe.com)
* SSLCommerz - [sslcommerz.com](https://sslcommerz.com)
* Chart.js - For beautiful charts in admin dashboard
* WordPress Community - For the amazing platform