README

A Magento 2 module that adds donation functionality to the checkout process, allowing customers to add charitable donations to their orders.

Features

• Checkout Integration: Donation checkbox on checkout page with configurable amount
• Multi-Currency Support: Handles different store currencies with proper conversion
• Order Management: Donation amounts integrated into orders, invoices, and credit memos
• Admin Configuration: Enable/disable donation, set amount and label
• Admin Reports: Donation report with filtering, export, and totals
• Frontend Display: Donation amounts shown on order view and print pages

Installation

Via Composer (Recommended)

composer require cloudcommerce/donation
php bin/magento module:enable CloudCommerce_Donation
php bin/magento setup:upgrade
php bin/magento cache:flush

Manual Installation

1. Copy the module files to app/code/CloudCommerce/Donation/
2. Run setup commands:

   php bin/magento module:enable CloudCommerce_Donation
   php bin/magento setup:upgrade
   php bin/magento setup:di:compile
   php bin/magento cache:flush

Configuration

Navigate to Stores > Configuration > CloudCommerce > Donation

General Settings

• Enable Donation: Enable/disable the donation feature
• Donation Amount: Default donation amount (base currency)
• Donation Label: Text displayed on checkout
• Donation Subtitle: Optional subtitle text
• Sort Order: Display position in totals

API Endpoints

• POST /rest/V1/carts/mine/donation - Set donation amount on quote

Admin Features

Donation Reports

• Location: Sales > Reports > Donation Report
• Features: Grid view, date filtering, export to CSV/Excel
• Permissions: Controlled by ACL resources

Order Management

• View donation amounts in order, invoice, and credit memo views
• Donation amounts included in totals calculations

Version

1.0.0

Requirements

• Magento 2.4+
• PHP 8.0+

Keywords

magento 2 donation, magento donation extension, charity donation magento, checkout donation, ecommerce donation, magento 2 charity module, donation checkout integration, magento nonprofit, donation management system, magento 2 extension, ecommerce charity integration, magento donation plugin, magento charity integration, donation processing magento, charity fundraising extension

Support

For issues and feature requests, please contact CloudCommerce support.