Ramadhan Giving Widget Documentation

Quick Start

Complete documentation for integrating the Ramadhan donation flow into your application

Add the Ramadhan script to your page

initialise
<script src="https://s3.givebrite.com/ramadhan.min.js?charityId=YOUR_CHARITY_ID"></script>

Replace YOUR_CHARITY_ID with your charity ID from Givebrite.

Add a container element where you want the button to appear

<div class="ramadhan" style="width: 300px"></div>

The SDK looks for an element with the class ramadhan by default.

Render the donation button

// If you used ?charityId=... in the script src, the instance is window.ramadhan
ramadhan.renderButton({ text: "Automate Your Giving" });

Or create the instance yourself (e.g. to set dev/production):

const ramadhan = Ramadhan.init("YOUR_CHARITY_ID", { env: "production" });
ramadhan.renderButton({ text: "Automate Your Giving", icon: true });

Choose your integration method: