=== Relworx Donation  ===
Contributors: raymondsabiiti
Tags: donation, fundraising, mobile money, payments, Relworx
Requires at least: 5.0
Requires PHP: 7.2
Tested up to: 6.8
Stable Tag: 1.0.0
License: GPL v2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

A WordPress plugin for managing donation causes and collecting donations via mobile money payments.

== Description ==

Relworx Donation enables you to create and manage charitable causes, collect donations from supporters, and process payments securely through Relworx's mobile money payment gateway.

= Features =

* Create unlimited donation causes
* Collect one-time and recurring donations
* Secure mobile money payment processing
* Progress tracking for each cause
* Detailed donation analytics and reporting
* Customizable donation form appearance
* Multiple currency support (UGX, TZS, KES)
* Preset and custom donation amounts
* Webhook support for real-time payment status updates
* Admin dashboard with comprehensive statistics
* Full internationalization support

= Requirements =

* WordPress 5.0 or higher
* PHP 7.2 or higher
* Active Relworx Payment account with API credentials

== Installation ==

1. Download the plugin and extract it to your wp-content/plugins directory
2. Activate the plugin through the WordPress admin panel
3. Navigate to Relworx Donations > Settings
4. Enter your Relworx API key and account number
5. Configure webhook signing key for payment confirmations
6. Customize theme colors and currency settings

== Configuration ==

= API Setup =

1. Log into your Relworx Payment dashboard
2. Retrieve your API Key and Account Number
3. Copy these credentials to the plugin settings page

= Webhook Configuration =

1. Copy the webhook URL from the plugin settings
2. Add the webhook URL to your Relworx Payment dashboard under business account
3. Copy the webhook signing key to the plugin settings
4. Enable webhook signature verification for secure payments

= Theme Customization =

1. Choose your preferred currency (UGX, TZS, or KES)
2. Customize button colors and text colors
3. Save settings and reload your website

== Usage ==

= Creating a Cause =

1. Go to Relworx Donations > All Causes
2. Click "Add New"
3. Enter cause title and description
4. Set target amount
5. Configure preset donation amounts
6. Publish and copy the shortcode

= Displaying the Donation Form =

Use the shortcode in any page or post:
```
[relworx_donation cause="123"]
```

Replace "123" with your cause ID.

= Viewing Donations =

1. Navigate to Relworx Donations > All Donations
2. Filter by status, date range, or cause
3. Click "View Details" to see full donation information
4. Analytics dashboard shows real-time statistics

== Debug Mode ==

To enable detailed logging for troubleshooting, add this constant to your wp-config.php:

```php
define('RELWORX_DONATION_DEBUG', true);
```

This will log debugging information to wp-content/debug.log.

== External Services ==

This plugin relies on the Relworx payment gateway service to process donations. When donors submit payment requests, their mobile phone numbers and payment information are sent to Relworx servers for processing.

= Service Details =

* Service: Relworx Mobile Money Payment Gateway
* Service URL: https://payments.relworx.com/
* Privacy Policy: https://payments.relworx.com/terms_of_service
* Terms of Service: https://payments.relworx.com/terms_of_service

The plugin communicates with Relworx servers to process mobile money donations. Users' phone numbers and donation amounts are securely transmitted to complete transactions.


== Security ==
* User input is sanitized and validated
* Payment data is transmitted securely


== Support ==

For technical support, visit: https://relworx.com
For documentation: https://payments.relworx.com/docs

== Frequently Asked Questions ==

For comprehensive answers to frequently asked questions, visit our documentation: https://payments.relworx.com/docs/category/faqs/

== Screenshots ==

1. Donation form display - The customizable donation collection form
2. Settings - Set API credentials from your Relworx API
3. Admin dashboard - Comprehensive statistics and analytics

== Changelog ==

= 1.0.0 =
* Initial release
* Cause management
* One-time and recurring donations
* Payment processing via Relworx gateway
* Admin dashboard with analytics
* Webhook support for payment confirmations
* Full internationalization support

== Upgrade Notice ==

= 1.0.0 =
Initial release of Relworx Donation Plugin. Perfect for nonprofits and churches collecting donations.

== License ==

This plugin is licensed under GPL v2 or later. See LICENSE file for details.

== Author ==

Developed and maintained by Relworx Limited
Website: https://relworx.com
