=== Send Your Prayers ===
Contributors: digitalmeactivecampaign
Donate link: https://www.digitalme.cc
Tags: prayer, donations, payments, stripe, paypal
Requires at least: 5.0
Tested up to: 6.9
Stable tag: 1.6.2
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

A prayer submission system with one-time payments.

== Description ==

Send Your Prayers allows users to submit prayer requests with optional one-time donations via Stripe or PayPal.

== External Services ==

This plugin connects to third-party payment services to process donations. The following external services are used:

### Stripe Payment Processing
- **What it is**: Stripe is a payment processing service used to securely handle credit/debit card transactions.
- **What data is sent**: When a user submits a prayer with a donation, the plugin sends:
  - Payment amount and currency
  - Credit/debit card details (processed directly by Stripe's secure payment elements)
  - User's email address (for payment confirmation)
  - Prayer request text (as metadata for the transaction)
- **When data is sent**: Data is sent only when a user submits the prayer form with payment information.
- **Service provider**: Stripe, Inc.
- **Terms of Service**: https://stripe.com/legal
- **Privacy Policy**: https://stripe.com/privacy

### PayPal Payment Processing
- **What it is**: PayPal is a payment processing service used to handle PayPal payments.
- **What data is sent**: When a user chooses PayPal as payment method, the plugin sends:
  - Payment amount and currency
  - User's email address (for payment confirmation)
  - Prayer request text (as transaction description)
  - Order information to redirect to PayPal for payment authorization
- **When data is sent**: Data is sent only when a user submits the prayer form and selects PayPal as the payment method.
- **Service provider**: PayPal, Inc.
- **Terms of Service**: https://www.paypal.com/us/legalhub/ua
- **Privacy Policy**: https://www.paypal.com/us/legalhub/privacy-full

### Data Handling Notes:
- All payment information is processed directly by the respective payment services (Stripe or PayPal).
- This plugin does not store credit/debit card numbers or PayPal login credentials.
- Email addresses and prayer requests are stored in your WordPress database for administrative purposes.
- Payment services may store transaction data according to their own policies and legal requirements.

== Installation ==

1. Upload the entire `send-your-prayers` folder to `/wp-content/plugins/`
2. Activate the plugin through 'Plugins' menu in WordPress
3. Go to Prayers → Settings to configure payment gateways
4. Create two pages: one for the form (add shortcode `[send_your_prayers]`) and one for thank you (add shortcode `[syprayer_thank_you]`)
5. Map these pages in Prayers → Settings → Page Mapping

== Configuration ==

= Payment Gateways =

You need to configure at least one payment gateway:

* **Stripe**: Get API keys from dashboard.stripe.com
* **PayPal**: Get Client ID and Secret from developer.paypal.com

= Page Mapping =

Map your form page and thank you page in the settings for proper redirects.

== Usage ==

= Shortcodes =

* `[send_your_prayers]` - Display the prayer submission form
* `[syprayer_thank_you]` - Display thank you page after submission

= Template Override =

You can override the form template by copying `prayer-form.php` to your theme folder.

== Security Features ==

* All database queries use prepared statements
* Input sanitization on all user data
* Nonce verification on all form submissions
* Secure payment processing with Stripe and PayPal
* CSRF protection

== Performance ==

* Object caching for database queries
* Efficient database schema with proper indexes
* Minimal plugin footprint

== Privacy ==

This plugin collects:
* Email addresses (for prayer submissions)
* Prayer request text
* Payment information (processed by payment gateways)

All data is stored securely and can be exported/deleted via WordPress tools.

**Important**: This plugin uses third-party payment services (Stripe and PayPal) to process donations. Please review their privacy policies and terms of service:
- Stripe: https://stripe.com/privacy
- PayPal: https://www.paypal.com/us/legalhub/privacy-full

== Compatibility ==

* Tested with WordPress 6.9
* Compatible with PHP 7.4+
* Works with any theme
* No jQuery conflicts

== Support ==

For support, please use the WordPress.org support forums or visit https://www.digitalme.cc


== Frequently Asked Questions ==

= What payment gateways are supported? =

Stripe and PayPal are both supported. Both are external services that process payments securely.

= Is there a free version? =

This is the free version with one-time payment support.

= What data is sent to external services? =

When processing payments, necessary transaction data (amount, currency, email) is sent to the chosen payment gateway (Stripe or PayPal). No credit card numbers are stored on your website - they are processed directly by the payment services.

= Can I use this plugin without external payment services? =

No, this plugin requires at least one payment gateway (Stripe or PayPal) to be configured for processing donations.


== Changelog ==

= 1.6.2 =
* Fixed naming conventions to meet WordPress.org requirements
* Changed prefix from "syp" to "syprayer" to avoid conflicts
* Updated all classes, functions, and options with unique prefix
* Fixed AJAX action names to avoid common word conflicts

= 1.6.1 =
* Added comprehensive documentation for external services
* Clarified data handling with third-party payment processors
* Updated privacy information

= 1.6.0 =
* Initial public release
* Features:
  * Prayer submission system with one-time payments
  * Stripe and PayPal payment gateways
  * Admin dashboard with statistics
  * Submission limiting per email
  * Customizable form colors and text
  * Secure database implementation
  * Caching for performance
  * Responsive design
  * Translation ready
* Security:
  * All inputs sanitized and validated
  * Prepared SQL statements
  * Nonce verification on all endpoints
  * Secure payment processing
* Performance:
  * Database query optimization
  * Object caching implementation
  * Efficient frontend JavaScript