=== AIML Trivia Matching ===
Contributors: aimlgames
Tags: games, education, ai, machine learning, trivia, matching
Requires at least: 5.0
Tested up to: 6.4
Stable tag: 1.0.0
Requires PHP: 7.4
License: GPL v2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Educational trivia matching game for AI and machine learning concepts - part of AIML Games Framework

== Description ==

AIML Trivia Matching is an educational game that challenges players to match AI/ML terminology with their correct definitions. This plugin is part of the AIML Games Framework hub & spoke architecture, providing seamless integration with shared services like leaderboards, analytics, and user management.

**Key Features:**
* Word-definition matching gameplay
* Multiple difficulty levels (Easy, Medium, Hard)
* Configurable timer and hint system
* Theme-based content organization
* Real-time score tracking
* Framework leaderboard integration
* Comprehensive analytics
* Responsive design for all devices

**Educational Value:**
Players learn AI and machine learning concepts by matching technical terms with their definitions, making it an excellent tool for:
* Students learning AI/ML concepts
* Professional training and onboarding
* Educational institutions
* Self-paced learning

== Installation ==

1. Install and activate the [AIML Games Framework](https://wordpress.org/plugins/aiml-games-framework/) plugin first
2. Upload the `aiml-games-trivia-matching` folder to the `/wp-content/plugins/` directory
3. Activate the plugin through the 'Plugins' menu in WordPress
4. Create new games using the 'aiml_game' custom post type
5. Select 'Trivia Matching' as the game type

== Frequently Asked Questions ==

= Does this plugin require the AIML Games Framework? =

Yes, this plugin is a "spoke" in the hub & spoke architecture and requires the AIML Games Framework to function properly.

= How do I create a Trivia Matching game? =

1. Go to 'Games' in your WordPress admin dashboard
2. Click 'Add New Game'
3. Select 'Trivia Matching' as the game type
4. Assign AI/ML words to the game using the 'Assign Words' meta box
5. Configure game settings (timer, hints, difficulty)
6. Publish the game

= Where do the word definitions come from? =

The plugin uses the `aiml_word` custom post type with the `_aiml_word_definition` meta field. You can add words and their definitions through the WordPress admin interface.

= Can I customize the scoring system? =

Yes, the scoring system is configurable through the plugin settings and game-specific options. The default system awards 50 points per correct match, subtracts 20 points for wrong guesses, and includes time bonuses.

= Is the game mobile-friendly? =

Yes, Trivia Matching is fully responsive and works on all device sizes.

== Screenshots ==

1. Game play interface with word cards and definition cards
2. Game creation interface in WordPress admin
3. Leaderboard integration
4. Settings configuration options

== Changelog ==

= 1.0.0 =
* Initial release
* Core matching gameplay functionality
* Framework integration with leaderboard and analytics
* Admin interface for game management
* Responsive design implementation
* Support for multiple difficulty levels
* Timer and hint system
* Theme-based content organization

== Upgrade Notice ==

= 1.0.0 =
This is the first release of AIML Trivia Matching. Ensure you have the latest version of AIML Games Framework installed before activating.

== Additional Information ==

**Framework Integration:**
This plugin seamlessly integrates with the AIML Games Framework, providing:
* Global leaderboard system
* User progress tracking
* Analytics and reporting
* Unified admin interface
* Consistent user experience across all games

**Content Structure:**
* Games are created as `aiml_game` custom post type
* Words and definitions use the `aiml_word` custom post type
* Themes are organized using the `aiml_word_category` taxonomy
* Difficulty levels use the `aiml_word_difficulty` taxonomy

**Technical Details:**
* Built with WordPress coding standards
* Extensible architecture for future enhancements
* Secure AJAX implementation with nonces
* Optimized database queries
* Caching support for better performance

**Future Enhancements:**
* Multiplayer support
* Advanced hint system
* Custom theme creation
* Import/export functionality
* Additional game modes
* Integration with learning management systems