=== Andrew Harper Travel ===
Contributors: O2 Digital Creative Agency, Internova WP Team
Donate link: https://o2dca.com
Tags: membership, travel, payments, stripe, api, saml, authentication, subscription
Requires at least: 5.0
Tested up to: 6.4
Stable tag: 2.1.15
Alpha tag: 2.1.15-alpha.2
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

A comprehensive WordPress plugin for managing the Andrew Harper Travel website with membership management, payment processing, and API integration.

== Description ==

The Andrew Harper Travel plugin provides a complete solution for managing a premium travel membership website. It integrates with external APIs, handles member authentication via SAML, processes payments through Stripe, and manages content across multiple publication types.

= Key Features =

* **Member Account Management** - User registration, login, profile management, and member dashboard
* **Payment Processing** - Stripe integration for subscriptions, renewals, and one-time payments
* **API Integration** - Seamless connection to Andrew Harper Travel API for member data synchronization
* **SAML Authentication** - Single sign-on capability for enhanced security
* **Search Integration** - Algolia-powered search functionality for content discovery
* **Shopping Cart** - Custom cart implementation for memberships and products
* **Multiple Publication Types** - Support for Hideaway Report, Harper Collection, Directory, Traveler, and Cruises
* **Content Management** - Hotels, brands, exclusive experiences, editor's choice, and destination guides
* **Admin Settings Interface** - Centralized configuration management via WordPress admin

= Configurable Settings =

The plugin includes a comprehensive settings page accessible through WordPress admin:

* API Configuration (endpoint, service token, cache directory)
* Algolia Search Configuration (application ID, API key)
* SAML Authentication (SimpleSAML URL)
* Stripe Payment Processing (publishable and secret keys)
* Page ID Mappings (11 different content types)

All configuration values can be managed through the WordPress admin interface without modifying code.

== Installation ==

= Automatic Installation =

1. Log in to your WordPress admin panel
2. Navigate to Plugins > Add New
3. Search for "Andrew Harper Travel"
4. Click "Install Now" and then "Activate"
5. Navigate to AH Settings in the admin menu to configure

= Manual Installation =

1. Download the plugin zip file
2. Extract the zip file to your computer
3. Upload the `andrew-harper-plugin` folder to `/wp-content/plugins/` directory
4. Activate the plugin through the 'Plugins' menu in WordPress
5. Navigate to AH Settings in the admin menu

= Post-Installation Configuration =

After activation, you must configure the plugin settings:

1. Go to WordPress Admin > AH Settings
2. Configure API settings (endpoint, service token, site URL, cache directory)
3. Enter Algolia credentials (application ID, write API key)
4. Configure SAML authentication URL
5. Add Stripe keys (publishable and secret keys)
6. Map WordPress page IDs to plugin functionality (11 pages required)
7. Save settings and test functionality

For detailed configuration instructions, see the README.md file included with the plugin.

== Frequently Asked Questions ==

= Where do I configure the plugin settings? =

Navigate to WordPress Admin > AH Settings. This provides a centralized interface for all configuration options including API credentials, Stripe keys, SAML settings, and more.

= Do I need to edit any PHP files to configure the plugin? =

No. Version 2.1.0+ includes a complete settings interface. All configuration can be done through the WordPress admin without editing code.

= How do I switch between test and production Stripe keys? =

Go to AH Settings > Stripe Configuration. Replace the publishable key (pk_test_ or pk_live_) and secret key (sk_test_ or sk_live_) with the appropriate keys for your environment.

= What WordPress pages do I need to create? =

You need to create 11 pages for different content types (checkout, publications, hotels, etc.). After creating these pages, enter their IDs in AH Settings > Page IDs Configuration.

= How do I find a page ID in WordPress? =

Go to Pages > All Pages, hover over a page title, and look at the browser status bar. The ID appears as "post=###" in the URL.

= Is HTTPS required? =

Yes, HTTPS is required for production environments to ensure secure communication with payment processors and APIs.

= Where are the cache files stored? =

The cache directory path is configurable in AH Settings > API Configuration. Ensure the directory exists and is writable by the web server (permissions 755 or 775).

= Can I use this plugin with Azure hosting? =

Yes. Version 2.0.0+ is optimized for Azure hosting. Version 2.1.x includes additional path standardization for better cloud compatibility.

== Screenshots ==

1. AH Settings - Main configuration interface with API, Algolia, and SAML settings
2. Stripe Configuration - Payment processing setup with publishable and secret keys
3. Page IDs Configuration - WordPress page mapping for plugin functionality
4. Member Account Dashboard - User profile and membership management
5. Checkout Process - Stripe-powered payment flow

== Technical Requirements ==

* WordPress 5.0 or higher
* PHP 7.2 or higher
* MySQL 5.6 or higher
* HTTPS required for production environments
* Write permissions for cache directory

== External Services ==

This plugin integrates with the following third-party services:

* **Andrew Harper Travel API** - Member data and content management
* **Stripe** - Payment processing for subscriptions and purchases
* **Algolia** - Search functionality for content discovery
* **SAML Identity Provider** - Single sign-on authentication

== Support ==

For documentation and support:

* See README.md file included with the plugin for detailed documentation
* Visit [O2 Digital Creative Agency](https://o2dca.com)
* Review inline help in the AH Settings admin interface

== Privacy Policy ==

This plugin stores member data and processes payments through Stripe. Ensure your site has appropriate privacy policies in place regarding:

* Member data collection and storage
* Payment processing through Stripe
* Session management and cookies
* Third-party service integrations (Algolia, SAML)

== License ==

This plugin is licensed under GPLv2 or later.
License URI: http://www.gnu.org/licenses/gpl-2.0.html