fuascailtdev/niapays-plugin

A simple OctoberCMS plugin for accepting donations via Stripe.

v1.2.0 2025-08-19 05:55 UTC

Requires

• php: >=8.2
• composer/installers: ~1.0
• stripe/stripe-php: ^10.0

MIT

• Kirsten

• plugin
• stripe
• donation
• october
• octobercms

README

This plugin allows you to quickly set up a donation form and integrate Stripe payments on your OctoberCMS website. 👍

Features

• Clean, Bootstrap-styled donation form
• Stripe payments integration (just add your key)
• Drag-and-drop component for easy use

Requirements

• OctoberCMS version 3.x or higher
• Stripe API keys (added in backend settings)

Installation

1. Download or clone this repository into your plugins directory.
2. Run database migrations:

   php artisan october:migrate

Usage

1. After installation, go to NiaPays Settings in the backend and add your Stripe keys.
2. Choose a redirect page for successful donations.

Configuration

Make sure to include the following in your CMS page or layout to ensure the form works properly:

{% framework extras %}

If you experience issues, this is often the cause.

You will also need JQuery to load BEFORE the component, or else the PaymentIntent will fail.

The component you will need to add is below.

<script src="https://code.jquery.com/jquery-3.6.0.min.js"></script>
{% framework extras %}
{% component 'donationForm' %}

Backend

The backend provides a simple table to view successful donations.

Contributing

I’m still learning how to build plugins, so if you have any contributions, improvements, or just want to roast me ❤️, please create a pull request!

License

MIT – free to use.

Credits

ofthewildire / Kirsten