Donations & Campaigns (@vicacha-devs/strapi-plugin-donations)
Generic Crowdfunding Campaigns, Donor Pledges, Utility Invoice Sponsorship, Commodity Assessment Calculator & Tax Certificate Bridge for Strapi v5, powered by @vicacha-devs/strapi-plugin-calendar and @vicacha-devs/strapi-plugin-certificates.
Key Features
Section titled “Key Features”- Fundraising Campaigns & Utility Invoice Transparency (
plugin::donations.campaign):- Track campaign goals (
goalAmount), raised totals (raisedAmount), donor counts, urgency badges, and recurring monthly utility bills (category: 'utility_invoice', e.g., Electricity, Water, Gas, Internet).
- Track campaign goals (
- Donor Pledges & Payment Proof Verification (
plugin::donations.pledge):- Public pledge submission (
POST /api/donations/pledges) and HMAC-verified payment gateway webhook receiver (POST /api/donations/webhook). - Automatic campaign progress recalculation and tax-deductible receipt issuance via
@vicacha-devs/strapi-plugin-certificates.
- Public pledge submission (
- Rule-Based Assessment & Commodity Threshold Calculator:
- Configurable precious-metal/commodity thresholds (
GET /api/donations/calculator,POST /api/donations/calculate) supporting multi-currency (COP,USD,EUR,TRY) assessments.
- Configurable precious-metal/commodity thresholds (
- 13-Locale Admin UI:
- Ships with full translations for
en,es,ar,tr,fr,de,pt,it,nl,pl,id,ur, andzh.
- Ships with full translations for
Quick Installation & Configuration
Section titled “Quick Installation & Configuration”pnpm add @vicacha-devs/strapi-plugin-donationsEnable the plugin in config/plugins.ts:
export default () => ({ "donations": { enabled: true, },});Content-Type Entities & Where to Find Them
Section titled “Content-Type Entities & Where to Find Them”Registers two Collection Types (plugin::donations.campaign with draftAndPublish: true and i18n.localized: true, and plugin::donations.pledge) plus two Custom Fields (plugin::donations.currency and plugin::donations.country). Supports runtime schemaExtensions in config/plugins.ts.
- Content Manager:
/admin/content-manager/collection-types/plugin::donations.campaign&/admin/content-manager/collection-types/plugin::donations.pledge(visible: true) - Content-Type Builder:
/admin/plugins/content-type-builderunder Collection Types + Custom Fieldsplugin::donations.currency&plugin::donations.country - Plugin Workspace & Settings:
/admin/plugins/donations(Campaigns, Utility Bills, Pledges, Nisab Calculator) and/admin/settings/donations - Database Tables:
vicacha_donation_campaignsandvicacha_donation_pledges
Strapi v5 Content Manager Integration (/admin/content-manager)
Section titled “Strapi v5 Content Manager Integration (/admin/content-manager)”Content Manager Sidebar Group:
Donations & Certificates
Content Manager Entities & Components
Section titled “Content Manager Entities & Components”plugin::donations.campaign(Donation Campaign & Invoice —/admin/content-manager/collection-types/plugin::donations.campaign)plugin::donations.pledge(Donation Pledge & Contribution —/admin/content-manager/collection-types/plugin::donations.pledge)- Custom Fields
plugin::donations.currency&plugin::donations.country

Why This Plugin Creates & Integrates Content Manager Entities
Section titled “Why This Plugin Creates & Integrates Content Manager Entities”@vicacha-devs/strapi-plugin-donations registers Donation Campaign & Invoice (plugin::donations.campaign, with i18n.localized: true and draftAndPublish: true) and Donation Pledge & Contribution (plugin::donations.pledge) in the Strapi v5 Content Manager so fundraising and accounting teams get full multilingual publishing and ledger auditing:
- Multilingual (
i18n) Campaign & Utility Invoice Authoring: Translate campaign titles, descriptions, and impact stories acrossen,es,ar, andtrusing Content Manager’s locale switcher (?plugins[i18n][locale]=en) while sharing unified financial progress. - Draft & Publish Staging for Fundraising Appeals: Prepare Ramadan, Zakat, or emergency relief campaigns in
Draftmode, attach Media Library invoice PDFs or cover images, and publish when ready. - Accounting & Pledge Reconciliation: Filter
Donation Pledge & Contribution(plugin::donations.pledge) in Content Manager bystatus(pending,verified,refunded),paymentMethod,currency,isZakatEligible, or linkedcertificateSerial.
How to Use in Strapi Content Manager (Step-by-Step)
Section titled “How to Use in Strapi Content Manager (Step-by-Step)”- Open in Content Manager: Navigate to Content Manager -> Collection Types -> Donations & Certificates and select Donation Campaign & Invoice (
/admin/content-manager/collection-types/plugin::donations.campaign?plugins[i18n][locale]=en) or Donation Pledge & Contribution (/admin/content-manager/collection-types/plugin::donations.pledge). - Create Major Campaigns or Utility Invoices: Click + Create new entry in Donation Campaign & Invoice, choose
campaignKind(major_campaignorutility_invoice), setgoalAmount,currency(plugin::donations.currency), and for utility bills populateutilityProvider,invoiceReference, anddueDate. - Translate Across Locales: Use the top-right locale dropdown (
English (en),Spanish (es),Arabic (ar),Turkish (tr)) in Content Manager to localize campaign copy. - Workspace vs. Content Manager: Use Content Manager for multilingual campaign authoring, media uploads, and accounting filters; use the Donations Workspace (
/admin/plugins/donations) for real-time KPI dashboards, 1-click pledge verification, and Nisab threshold testing.
Content Manager & Plugin Workspace Synchronization
Section titled “Content Manager & Plugin Workspace Synchronization”Content Manager Use Cases & Editorial Workflows
Section titled “Content Manager Use Cases & Editorial Workflows”Content Manager Use Case 1 — Publishing Localized Crowdfunding Campaigns & Monthly Utility Bills
Section titled “Content Manager Use Case 1 — Publishing Localized Crowdfunding Campaigns & Monthly Utility Bills”- Why & What it is for: Manage both major Waqf/social campaigns (
major_campaign) and monthly electricity/water/fiber invoices (utility_invoice) with localized descriptions in Content Manager. - How to use in Content Manager: Open
/admin/content-manager/collection-types/plugin::donations.campaign?plugins[i18n][locale]=en, editEducational Endowment & Scholarship FundorMonthly Natural Gas Utility Bill, switch locales to translate, and click Publish.
Content Manager Use Case 2 — Reconciling Verified Pledges & Linked Tax Certificate Serials
Section titled “Content Manager Use Case 2 — Reconciling Verified Pledges & Linked Tax Certificate Serials”- Why & What it is for: Filter verified Zakat and Sadaqah contributions in Content Manager and verify their issued Ed25519 tax certificate serial numbers.
- How to use in Content Manager: Open
/admin/content-manager/collection-types/plugin::donations.pledgeand filter bystatus = verifiedandcertificateSerial is not null.
End-to-End Use Cases & Workflows
Section titled “End-to-End Use Cases & Workflows”Use Case 1 — Multi-Currency Crowdfunding Campaigns (major_campaign)
Section titled “Use Case 1 — Multi-Currency Crowdfunding Campaigns (major_campaign)”- What it is for: Run localized (
en,es,ar,tr) fundraising campaigns with real-time progress bars (goalAmount,raisedAmount,donorCount). - How it works: Publish a
plugin::donations.campaignentity (campaignKind: 'major_campaign'), list viaGET /api/donations/campaigns, and submit pledges viaPOST /api/donations/pledges.

Use Case 2 — Operational Utility Invoice Sponsorship (utility_invoice)
Section titled “Use Case 2 — Operational Utility Invoice Sponsorship (utility_invoice)”- What it is for: Allow community members to pay off specific monthly utility bills (electricity, water, internet) partially or in full (
coversRemainingBalance). - How it works: Create a
plugin::donations.campaignwithcampaignKind: 'utility_invoice',invoiceReference,dueDate, andinvoiceDocumentUrl; query viaGET /api/donations/utility-bills.

Use Case 3 — HMAC-SHA256 Payment Gateway Webhooks & Auto-Certificate Bridge
Section titled “Use Case 3 — HMAC-SHA256 Payment Gateway Webhooks & Auto-Certificate Bridge”- What it is for: Automatically verify pledges from Wompi/Stripe webhooks, increment campaign totals, and issue an Ed25519 tax certificate.
- How it works:
POST /api/donations/webhookverifies the signature, marksplugin::donations.pledgeasverified, updatesraisedAmount, and callsstrapi.plugin('certificates').service('issuance').

Use Case 4 — Precious-Metal Threshold (Zakat / Nisab) Calculation
Section titled “Use Case 4 — Precious-Metal Threshold (Zakat / Nisab) Calculation”- What it is for: Provide donors with an interactive calculator based on live gold/silver gram thresholds in their local currency.
- How it works: Call
POST /api/donations/calculate-thresholdwith asset balances and liabilities to compute net zakatable wealth and recommended contribution.
Admin Workspace, Content Manager & Settings Panel Preview
Section titled “Admin Workspace, Content Manager & Settings Panel Preview”
Strapi v5 Content Manager Entities (/admin/content-manager)
Section titled “Strapi v5 Content Manager Entities (/admin/content-manager)”
Settings Panel (Settings -> Configuration)
Section titled “Settings Panel (Settings -> Configuration)”
Explore Content Types & Use Cases, the Developer Guide & Admin UI Tour, and the Interactive OpenAPI Reference for complete schema, workflow diagram, and endpoint documentation.