=== Octopus Learning Games ===
Contributors: bdaloukas
Tags: game, quiz, learning, education, multiplayer
Requires at least: 6.2
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.3
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Educational quiz games with solo, local multiplayer, split-screen play, avatars, rankings, and shortcode support.

== Description ==

Octopus Learning Games adds interactive educational quiz games to WordPress.

The plugin supports:
- solo gameplay
- shared-device multiplayer gameplay
- split-screen educational gameplay
- avatars and rankings
- timers and score tracking
- shortcode integration
- anonymous or logged-in gameplay

Octopus Learning Games is designed for:
- schools
- educational websites
- classroom activities
- self-paced learning
- collaborative learning

The gameplay interface supports both keyboard and touch interaction.

By default, uninstalling the plugin does not remove gameplay data. Administrators can enable permanent data deletion from the plugin settings before uninstalling.

Octopus Learning Games is released under the GPLv2 or later license.

== Features ==

* Educational quiz gameplay
* Solo and local multiplayer modes
* Split-screen gameplay support
* Real-time score updates
* Avatar support
* Rankings and leaderboards
* Responsive HTML5 interface
* WordPress REST API integration
* Translation-ready
* Keyboard and touch support
* Shortcode integration
* Anonymous or logged-in play

== Installation ==

1. Upload the plugin folder to `/wp-content/plugins/`
2. Activate the plugin through the WordPress admin panel
3. Create or import game content
4. Insert a game using shortcode:

`[octopus_learning_games id="1"]`

== Frequently Asked Questions ==

= Can anonymous users play? =

Yes. The plugin supports guest gameplay sessions.

= Does the plugin require JavaScript? =

Yes. Modern JavaScript support is required for gameplay.

= Is multiplayer online? =

No. The current version supports solo play, local multiplayer, and shared-screen/split-screen gameplay.

= Are translations supported? =

Yes. The plugin includes translation infrastructure for both PHP and JavaScript.

= Does the plugin send data to external services? =

No. Gameplay and session data remain on the local WordPress site.

= How do I display a game? =

Use the shortcode:

`[octopus_learning_games id="1"]`

== Requirements ==

- WordPress 6.2 or newer
- PHP 7.4 or newer
- Modern browser with JavaScript enabled

== Screenshots ==
1. Starting game with one player in the device.
2. Quiz gameplay screen with answers, timer, and score (QuizAlone).
3. Quiz gameplay screen with answers, timer, and score (QuizAduel).
4. Starting game with two players in one computer using gamepads (gamepads are optional).
5. Quiz gameplay screen with answers, timer, and score (QuizSplit).
6. Quiz gameplay screen with answers, timer, and score (Mobile phone).
7. Administrative page.

== Changelog ==

= 1.0.3 =
* Renamed plugin for WordPress.org slug reservation.

= 1.0.2 =
* Fixes and improvements.
= 1.0.0 =
* Initial public release.

== Upgrade Notice ==
= 1.0.3 =
Renamed plugin for WordPress.org slug reservation.

= 1.0.2 =
Fixes and improvements.
= 1.0.0 =
Initial release.

== Privacy ==

The plugin may temporarily process gameplay-related session data such as:
- scores
- gameplay progress
- anonymous session identifiers
- optional user IDs for logged-in users

Gameplay data is stored locally in the WordPress database and is not transmitted to third-party services.

The plugin does not send gameplay or personal data to external services.

The plugin stores gameplay progress, scores, rankings,
avatars, and temporary gameplay session data in the local
WordPress database.

== External Services ==

This plugin does not connect to external services.

== Credits ==

This plugin includes third-party assets and libraries.

See `licenses/assets.txt` and bundled license files for details.

Third-party assets are distributed under their respective licenses.

== Game Modes ==

= Alone =
Single-player adaptive quiz mode. Each player receives one open question attempt at a time. Answers immediately update the player profile, rankings and question statistics.

= ADuel =
Asynchronous two-player duel mode. One player answers a question set first, while a second player later receives the same questions and competes against the recorded answers.

= Split =
Multi-session multiplayer mode. The server creates and manages grouped quiz attempts for multiple active sessions simultaneously.

== Security ==

Gameplay requests for anonymous users use temporary server-side
session tokens instead of authenticated WordPress sessions.
Administrative actions require standard WordPress capabilities
and nonce validation.


Gameplay communication uses WordPress REST API endpoints.

Logged-in users are protected with WordPress nonces.

Guest gameplay uses plugin-generated session identifiers validated server-side.
