Introduction

Welcome to the official documentation for the NGO Management System. This software is designed to automate donation tracking, volunteer management, project handling, and 80G receipt generation for non-profit organizations.

Server Requirements

Before installing, ensure your server meets the following requirements:

• PHP Version: 7.4 or 8.0+ (Recommended)
• Database: MySQL 5.7+ or MariaDB
• Web Server: Apache (with mod_rewrite enabled) or Nginx
• PHP Extensions: PDO, cURL, mbstring, GD, ZIP

Database Setup

1. Log in to your hosting Control Panel (cPanel, DirectAdmin, etc.).
2. Create a new Database and a Database User.
3. Assign the user to the database with ALL PRIVILEGES.
4. Open phpMyAdmin and select your new database.
5. Click on the Import tab and upload the provided database.sql file.

File Upload

Upload the source code to your server's root directory (e.g., public_html) or a subdomain.

• Upload the .zip file provided in the package.
• Extract the files.
• Ensure the admin, includes, uploads, and libs folders are in the root directory.

Configuration

You need to connect the PHP files to your database.

Open config/db.php and update the following lines:

$host = 'localhost';
$db   = 'your_database_name';
$user = 'your_database_user';
$pass = 'your_database_password';
            

Donation Management

Admin Features:

• View Donations: See all incoming donations with status (Pending/Success).
• Verify: Click verify to check payment screenshots uploaded by donors.
• Approve/Reject: Update payment status. Approving automatically updates the project fund.
• 80G Receipt: System auto-generates PDF receipts with/without PAN based on settings.

Frontend Features:

• Users can donate via QR Code or Bank Transfer.
• Users upload payment screenshots for verification.
• Donation History: Users can view their history and download receipts using OTP login.

Volunteer System

A complete system to recruit and manage volunteers.

• Registration: Volunteers sign up from the frontend with a photo.
• Approval: Admin approves requests.
• ID Card: System generates a printable PDF ID Card with QR Code and Validity.
• Verification: Public verification page to check volunteer authenticity using Email OTP.

Frontend Management

You can manage almost all frontend content from the Admin Panel.

White Labeling (Rebranding)

You can easily rebrand this software for your clients.

1. Change Logo & Favicon

Go to Settings > Receipt & Branding in the Admin Panel to upload the new Logo and Favicon.

2. Update Footer Credits

To change "Designed by Your Name", edit the following files:

• includes/footer.php
• admin/includes/footer.php

Security & SMTP

SMTP Setup (For Emails)

Go to Settings > Email (SMTP). For Hosting Mail:

• Host: smtp.hosting.com
• Port: 465
• Encryption: SSL
• Username: Use Hosting mail
• Password: Use Hosting mail password.

Troubleshooting

Images not showing?

Ensure the uploads/ folder has write permissions. Also, check if BASE_URL is correctly set in your environment if you used absolute paths.

Email not sending?

Check if your server allows outgoing SMTP connections. Verify your SMTP credentials in Settings. Turn on Debug mode in the code if necessary.

404 Errors?

If you are using Apache, ensure the .htaccess file is configured correctly (if applicable). For this pure PHP version, ensure all file names match the URL case-sensitivity.