=== FreedomReader ===
Contributors: kiranrs
Tags: paypal, subscription, monetization, content-lock, premium-content
Requires at least: 5.0
Tested up to: 6.8
Requires PHP: 7.4
Stable tag: 1.0.2
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

A comprehensive content monetization plugin with subscription and à la carte purchase options via PayPal.

== Description ==

FreedomReader is a powerful WordPress plugin that allows you to monetize your content through PayPal payments and subscriptions. Perfect for bloggers, news sites, course creators, and content publishers who want to generate revenue from premium content.

= Key Features =

* **Content Locking System** - Lock full content, show teasers, or require subscriptions
* **PayPal Integration** - Secure payments via PayPal REST API
* **Subscription Management** - Monthly/yearly recurring billing with free trials
* **À la carte Purchases** - One-time payments for individual content
* **User Dashboard** - Purchase history, subscription management, downloadable invoices
* **Admin Analytics** - Revenue tracking, subscription analytics, export functionality
* **Shortcodes** - Flexible content control with multiple shortcodes
* **Responsive Design** - Mobile-optimized interface

= Payment Options =

* One-time purchases for individual posts/pages
* Monthly and yearly subscription plans
* Free trial periods (configurable)
* Multiple pricing tiers
* Secure PayPal checkout

= Content Control =

* Full content locks
* Partial content with teasers
* Subscription-only content
* Category and tag-based restrictions
* Individual post/page controls

= Requirements =

* PayPal Business Account
* SSL Certificate (recommended for live payments)
* WordPress 5.0 or higher
* PHP 7.4 or higher

= External Services =

This plugin connects to external services to provide its functionality. By using this plugin, you acknowledge and agree to the data transmission to these services:

== PayPal Payment Processing ==

This plugin integrates with PayPal's REST API for payment processing and subscription management.

* **Service**: PayPal REST API (api.paypal.com for live mode, api.sandbox.paypal.com for testing)
* **Purpose**: Process payments, manage subscriptions, handle refunds, and capture payment data
* **Data Sent**: Customer payment information, purchase amounts, product descriptions, subscription details, user billing information
* **When Data is Sent**: When users make purchases, create subscriptions, cancel subscriptions, or when refunds are processed
* **PayPal Terms of Service**: https://www.paypal.com/us/legalhub/useragreement-full
* **PayPal Privacy Policy**: https://www.paypal.com/us/legalhub/privacy-full

== IP Geolocation Service ==

This plugin uses IP-API.com for geolocation-based content restrictions.

* **Service**: IP-API.com (ip-api.com)
* **Purpose**: Determine user's country based on IP address for geographic content restrictions
* **Data Sent**: User's IP address
* **When Data is Sent**: When geographic lock rules are enabled and content is accessed
* **IP-API Terms of Service**: https://ip-api.com/docs/legal
* **IP-API Privacy Policy**: https://ip-api.com/docs/legal

**Important**: These external services are essential for the plugin's core functionality. Payment processing cannot function without PayPal integration, and geographic restrictions require IP geolocation services.

== Installation ==

1. Upload the plugin files to `/wp-content/plugins/freedomreader/` directory
2. Activate the plugin through the 'Plugins' screen in WordPress
3. Go to FreedomReader > Settings to configure PayPal credentials
4. Set up your subscription plans
5. Start locking content using the post metaboxes

= PayPal Setup =

1. Create a PayPal Business Account
2. Go to PayPal Developer Dashboard
3. Create a new application
4. Copy Client ID and Client Secret
5. Enter credentials in plugin settings
6. Choose Sandbox for testing or Live for production

== Frequently Asked Questions ==

= Do I need a PayPal Business Account? =

Yes, you need a PayPal Business Account to accept payments and create subscription plans.

= Can I test payments before going live? =

Yes, the plugin includes sandbox mode for testing with PayPal's testing environment.

= What happens if a user cancels their subscription? =

Users can cancel subscriptions from their dashboard. The plugin handles cancellation through PayPal's API and updates access accordingly.

= Can I customize the appearance? =

Yes, the plugin includes CSS classes for styling and supports theme customization.

= Is the plugin GDPR compliant? =

The plugin stores minimal user data locally. Payment data is handled by PayPal. You should review your privacy policy and data handling practices.

= Can I export payment data? =

Yes, the admin dashboard includes export functionality for purchases and subscriptions.

== Screenshots ==

1. Admin dashboard with revenue analytics
2. Content lock metabox in post editor
3. User dashboard showing purchases and subscriptions
4. PayPal checkout integration
5. Subscription plans display
6. Mobile-responsive design

== Changelog ==

= 1.0.0 =
* Initial release
* PayPal integration for payments and subscriptions
* Content locking system with multiple options
* User dashboard for purchase/subscription management
* Admin analytics and reporting
* Shortcodes for flexible content control
* Responsive design with mobile support

== Upgrade Notice ==

= 1.0.0 =
Initial release of FreedomReader plugin.

== Privacy Policy ==

FreedomReader stores the following data locally:
* Purchase records (user ID, amount, date, status)
* Subscription information (user ID, plan, status, dates)
* Content lock settings (post ID, lock type, pricing)

Payment processing is handled entirely by PayPal. No sensitive payment information is stored locally.

Users can request data deletion by contacting the site administrator.

== Support ==

For support and documentation:
* GitHub repository: https://github.com/kiranrs/freedomreader
* WordPress.org support forum (when published)
* Issues and feature requests: GitHub Issues

== Contributing ==

We welcome contributions! Please see our GitHub repository for contribution guidelines.

== Credits ==

* PayPal REST API integration
* WordPress Plugin Boilerplate structure
* Icons from various open-source collections
