=== Acadlix Importer ===
Contributors: acadlix
Donate link: https://acadlix.com/
Tags: quiz, import, migration, wp-pro-quiz, acadlix
Requires at least: 6.8
Tested up to: 6.9
Requires PHP: 8.2
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Seamlessly import WP-Pro-Quiz data to Acadlix LMS. Migrate quizzes, questions, categories, and statistics with ease.

== Description ==

**Acadlix Importer** is a powerful WordPress plugin designed to help you migrate your existing WP-Pro-Quiz content to the Acadlix learning management system. This plugin provides a complete data migration solution, preserving all your quizzes, questions, categories, user statistics, and leaderboard data.

= Key Features =

* **Complete Quiz Migration** - Import all your WP-Pro-Quiz quizzes with full configuration
* **Question Import** - Transfer all quiz questions with their settings and answer options
* **Category Support** - Import both quiz categories and question categories
* **Statistics Preservation** - Maintain all user quiz attempts and performance data
* **Leaderboard Migration** - Transfer toplist/leaderboard data
* **Prerequisites Import** - Import quiz prerequisites (requires Acadlix Pro)
* **Multisite Ready** - Full support for WordPress multisite installations
* **Modern Interface** - Clean, intuitive admin interface built with React
* **Data Integrity** - Sync tracking prevents duplicate imports
* **REST API** - Modern REST API for reliable data transfer

= Requirements =

* Acadlix or Acadlix Pro plugin must be installed and activated
* Existing WP-Pro-Quiz data to import
* PHP 8.2 or higher
* WordPress 6.8 or higher

= How It Works =

1. Install and activate the Acadlix plugin (or Acadlix Pro)
2. Install and activate Acadlix Importer
3. Navigate to the Acadlix Importer menu in your WordPress admin
4. Follow the on-screen instructions to import your data:
   - Categories (Quiz and Question categories)
   - Quizzes (Masters)
   - Questions
   - Prerequisites (Pro version only)
   - User Statistics
   - Leaderboards

The plugin automatically tracks imported items to prevent duplicates and maintains the relationship between your old WP-Pro-Quiz data and new Acadlix data.

= Perfect For =

* Sites upgrading from WP-Pro-Quiz to Acadlix
* LMS administrators migrating quiz content
* Educational institutions switching to Acadlix
* Training platforms looking for better quiz management

= Technical Highlights =

* Built with modern PHP 8.2+ features
* Eloquent ORM for reliable database operations
* React-based admin interface with Material-UI
* Secure REST API endpoints
* Complete multisite support
* Automated cleanup on uninstall

== Installation ==

= Automatic Installation =

1. Log in to your WordPress admin panel
2. Navigate to Plugins > Add New
3. Search for "Acadlix Importer"
4. Click "Install Now" and then "Activate"
5. Ensure Acadlix or Acadlix Pro is already installed and active

= Manual Installation =

1. Download the plugin zip file
2. Log in to your WordPress admin panel
3. Navigate to Plugins > Add New > Upload Plugin
4. Choose the downloaded zip file and click "Install Now"
5. Activate the plugin
6. Ensure Acadlix or Acadlix Pro is already installed and active

= After Installation =

1. You'll see an "Acadlix Importer" menu item in your WordPress admin
2. Click on it to access the import interface
3. Follow the step-by-step import process

**Important:** The Acadlix plugin must be installed and active before activating Acadlix Importer. If Acadlix is not active, the importer will automatically deactivate itself and display a notice.

== Frequently Asked Questions ==

= Does this plugin work without Acadlix? =

No, Acadlix Importer requires the Acadlix or Acadlix Pro plugin to be installed and active. It's designed specifically to import data into Acadlix.

= Will this plugin work with the latest version of WP-Pro-Quiz? =

Yes, the plugin is designed to work with WP-Pro-Quiz data structures. It reads directly from WP-Pro-Quiz database tables.

= Can I import data multiple times? =

The plugin includes a sync tracking system that prevents duplicate imports. However, it's recommended to import data once and verify the results.

= What happens to my WP-Pro-Quiz data after import? =

Your original WP-Pro-Quiz data remains untouched. The plugin only reads and copies data to Acadlix. You can deactivate WP-Pro-Quiz after verifying the import was successful.

= Does this work on multisite installations? =

Yes! The plugin fully supports WordPress multisite. It will create necessary tables for each site and handle activation/deactivation properly across the network.

= What data is imported? =

The plugin imports:
- Quiz categories
- Question categories  
- Quiz masters (quizzes with all settings)
- Questions (with all answer options and configurations)
- User statistics and quiz attempts
- Leaderboard/toplist data
- Prerequisites (requires Acadlix Pro)

= Will user quiz history be preserved? =

Yes, the plugin imports all user statistics and quiz attempt data, maintaining complete user history.

= What happens when I uninstall the plugin? =

When uninstalled, the plugin removes its sync tracking table and settings. Your imported Acadlix data remains intact - only the import tracking data is removed.

= Does this require Acadlix Pro? =

The basic import functionality works with the free Acadlix plugin. However, importing prerequisites requires Acadlix Pro.

= Is my data safe during import? =

Yes, the plugin uses secure database transactions and doesn't modify your original WP-Pro-Quiz data. It only creates new entries in Acadlix.

== Screenshots ==

1. Acadlix Importer admin interface
2. Import progress screen
3. Category import view
4. Quiz import overview
5. Statistics migration interface

== Changelog ==

= 1.0.0 - 2024-12-04 =
* Initial release
* Complete WP-Pro-Quiz to Acadlix migration
* Import categories (quiz and question)
* Import quiz masters with full configuration
* Import questions with all settings
* Import user statistics and attempts
* Import leaderboard data
* Import prerequisites (Pro version)
* React-based admin interface
* REST API implementation
* Multisite support
* Sync tracking system to prevent duplicates

== Upgrade Notice ==

= 1.0.0 =
Initial release of Acadlix Importer. Migrate your WP-Pro-Quiz data to Acadlix seamlessly.

== Developer Notes ==

= REST API Endpoints =

All endpoints are located at `/wp-json/acadlix-importer/v1/admin-wpproquiz/`

* `POST /post-import-category` - Import categories
* `POST /post-import-master` - Import quiz masters
* `POST /post-import-question` - Import questions
* `POST /post-import-prerequisite` - Import prerequisites (Pro)
* `POST /post-import-statistic` - Import statistics
* `POST /post-import-statistic-ref` - Import statistic references
* `POST /post-import-toplist` - Import leaderboard data

= Technology Stack =

**Backend:**
* PHP 8.2+
* Illuminate Database (Eloquent ORM)
* WordPress REST API
* Doctrine DBAL

**Frontend:**
* React
* Material-UI (MUI)
* TanStack React Query
* Axios


== Privacy Policy ==

Acadlix Importer does not collect, store, or transmit any personal data outside of your WordPress installation. All data migration happens locally within your WordPress database.

== Support ==

For support, feature requests, or bug reports, please visit:
* Plugin Support Forum
* [Acadlix Website](https://acadlix.com/)

== Credits ==

Developed by Team Acadlix for seamless migration from WP-Pro-Quiz to Acadlix LMS.