=== WooCommerce Payment Migration Tool ===
Contributors: Automattic
Tags: paypal, woocommerce, migration, payment-gateway
Requires at least: 5.0
Tested up to: 6.7
Requires PHP: 7.4
Requires Plugins: woocommerce
Stable tag: 1.0.0
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Safely migrate your WooCommerce PayPal settings from the legacy "PayPal for WooCommerce" plugin to the official "WooCommerce PayPal Payments" plugin.

== Description ==

The **WooCommerce Payment Migration Tool** is a comprehensive WordPress plugin designed to safely migrate merchant PayPal payment gateway configurations from the legacy "PayPal for WooCommerce" plugin (pymntpl-paypal-woocommerce) to the official "WooCommerce PayPal Payments" plugin (woocommerce-paypal-payments).

### Key Features:

* **Safe Migration**: Automatic backup of plugin settings before migration with SHA256 verification (gateway option values only — not orders or other site data)
* **Smart Settings Transformation**: Intelligently maps API credentials and payment settings between plugins
* **Validation & Conflict Detection**: Comprehensive validation ensures data integrity before migration
* **Rollback Capability**: 30-day rollback window to recover from migration if needed
* **Audit Trail**: Complete logging of all migration operations for compliance and troubleshooting
* **User-Friendly Wizard**: Multi-step guided migration interface with progress tracking
* **Backup Management**: View, restore, and manage plugin settings backups
* **Error Handling**: Graceful error handling with detailed error messages and recovery suggestions

### What Gets Migrated:

* API credentials (username, password, signature → OAuth client ID/secret)
* Gateway settings (enabled, title, description, sandbox mode, etc.)
* Payment methods (PayPal, credit card preferences)
* Advanced options (debugging, address requirements, etc.)
* Payment action settings (sale vs authorization)

### Safety Measures:

1. **Pre-Migration Checks**: Validates system compatibility and data integrity
2. **Automatic Backup**: Creates a verified snapshot of both plugins' gateway settings (WordPress option values) before any changes. Does not include orders, transactions, customer data, or other site data.
3. **Atomic Operations**: All-or-nothing migration approach (rollback on failure)
4. **Database Transactions**: Safe database operations with error recovery
5. **Audit Logging**: Complete audit trail of all operations

== Installation ==

1. Download and activate the "WooCommerce Payment Migration Tool" plugin from WordPress.org
2. Ensure both the old "PayPal for WooCommerce" and "WooCommerce PayPal Payments" plugins are installed
3. Navigate to **WooCommerce > PayPal Migration** in the WordPress admin
4. Click "Start Migration" to begin the guided migration process

== Usage ==

### Starting a Migration:

1. Go to **WooCommerce > PayPal Migration** in your WordPress admin
2. Click the "Start Migration" button
3. Follow the 6-step wizard:
   - **Step 1**: Detect plugins and verify compatibility
   - **Step 2**: Review settings that will be migrated
   - **Step 3**: Validate settings for any issues
   - **Step 4**: Final confirmation
   - **Step 5**: Migration execution
   - **Step 6**: Completion summary

### Managing Backups:

Backups contain a snapshot of both plugins' gateway settings (WordPress option values only). They do **not** include orders, transactions, customer data, or other site data.

1. Go to **WooCommerce > PayPal Migration > Backups**
2. View all available settings backups with verification status
3. Restore a backup by clicking the "Restore" button (restores plugin option values only)
4. Delete old backups to manage storage

### Viewing Logs:

1. Go to **WooCommerce > PayPal Migration > Logs**
2. Review the complete audit trail of all migration operations
3. Export logs if needed for support or compliance

## Frequently Asked Questions

= Is my data safe during migration? =

Yes. The plugin creates an automatic SHA256-verified backup of both plugins' gateway settings (WordPress option values) before any changes. If anything goes wrong during migration, all changes are rolled back automatically. You also have a 30-day window to manually rollback if needed. Note: this backup covers plugin settings only — orders, transactions, and customer data are not included, but they are also not modified by this plugin.

= Can I migrate multiple stores? =

This plugin is designed for single-store migrations. For multi-site or multistore scenarios, contact support for guidance.

= What if my migration fails? =

If migration fails, the plugin automatically rolls back all changes and restores from the backup. Check the logs for detailed error information, and contact support if needed.

= Can I use this plugin on production sites? =

Yes, but we recommend testing on a staging environment first. The plugin is designed for production use with comprehensive safety measures.

= How long does migration take? =

Migration typically takes 1-2 minutes depending on your server performance and number of settings. Large configurations may take slightly longer.

= What if I need to rollback after migration? =

You have a 30-day rollback window. Go to **WooCommerce > PayPal Migration > Backups** and click "Restore" on the pre-migration backup.

= Does this plugin delete the old PayPal plugin? =

No. The plugin leaves the old plugin in place. You can manually disable or delete it after verifying the new plugin is working correctly.

= Will my customers be affected during migration? =

No. Migration is a settings transfer operation that doesn't affect existing orders or customer data. PayPal payments will continue to work throughout the process.

== Screenshots ==

1. Dashboard showing plugin status and recent migrations
2. Multi-step migration wizard with progress tracking
3. Settings review and validation interface
4. Backup management and restoration interface
5. Complete audit log of all operations

== Changelog ==

= 1.0.0 =
* Initial release
* Core migration engine implementation
* Multi-step wizard interface
* Backup and rollback functionality
* Comprehensive audit logging
* Settings validation and conflict detection

== Upgrade Notice ==

= 1.0.0 =
Initial release of the WooCommerce Payment Migration Tool