Magento 2 Donation Extension

The Documentation

After downloading the package, please proceed with the following steps:

Step 1:

Please unzip the archive.

Step 2:

Disable cache at System -> Cache Management.

Step 3:

Unload the contents of the module package to the Magento root folder. This will not over write the existing Magento files, only the new contents will be added.

Step 4:

Using SSH, go to Magento root folder and run command below:

1. Run command to update database : php bin/magento setup:upgrade

2. Run command to deploy : php bin/magento setup:static-content:deploy

Step 5:

Refresh your admin user access rights: log out from your store admin and then login back. Next, please Enable Cache.

Extension Configuration

Backend Setup

The main extension’s settings can be found under STORES Configuration CMSIDEAS EXTENSION Donations.

Accept Cart Donations - set to Yes to add the donations box on the shopping cart page.

Enable donations in Admin Orders : set to Yes to add donations from the backend.

Minimum Donation  - Enter the minimal value of the donation.

Default Description - Allow to change the default text of the donation box.

Donation Amount Placeholder - Provide the sample text shown inside the donation box.

Show Predefined Amounts - Allow to add the desired donation amounts as separate values in the dropdowns.


This is the way how these settings can be combined to show the donations on the frontend. The predefined amounts are shown in the dropdown menu. If Custom Amount is selected, the client can specify the desired value. The donation placeholder text (Enter your donation in this case) is shown on this box.

Manage Donation Charities

To add or edit the charities section, go to SALES Donations Charity Charity

To add the new Charity, click the Add New Charity button.

Name – Set the Name for the charity

Description – Enter the description for the charity

Image – Upload a logo for the charity

Active – Switch to Yes to make the charity

Sort Order - Provide the position of this charity.

Donations Box On the Orders Page

Frontend Experience

On frontend, the donations box is shown on the shopping cart.

On the screenshot, Your Donation is the Default Description specified in the configuration

Below is the box to input the value for the donation. Next, in the dropdown, customers can select a charity they’d like to donate to. Orphanage is the charity name.

Its priority is based on the Sort Order setting in the Charity configuration

Below is the charities name, description and image from the Charity configuration as well.

The minimum donation from the extensions configuration is depicted below the image and the description.

If you face problems with the installation or customization of our product please do not hesitate to contact us via our support ticket system: