=== SlideMind Bridge ===
Contributors: zaprene
Tags: scorm, xapi, elearning, lms, scorm player
Requires at least: 6.0
Tested up to: 7.0
Stable tag: 1.0.0
Requires PHP: 8.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Upload and play SCORM & xAPI packages in WordPress. Auto-bridges completion data to LearnDash, TutorLMS, LearnPress, LifterLMS, Sensei.

== Description ==

SlideMind Bridge lets you **upload SCORM and xAPI packages** (ZIP files exported from your authoring tool) and **play them directly inside WordPress**. When a learner completes a module or earns a score, the plugin automatically sends that data back to your LMS plugin — no manual grade entry, no iframe hacks, and no separate SCORM cloud service required.

= Supported LMS Plugins =

* **LearnDash** — marks lessons/topics complete, passes back scores
* **TutorLMS** — marks lessons complete, passes back scores
* **LearnPress** — updates lesson completion and scores
* **LifterLMS** — marks lessons complete, passes back scores
* **Sensei LMS** — starts/completes lessons, passes back scores

The plugin **auto-detects** which LMS is active. No configuration needed.

= Supported Standards =

* **SCORM 1.2** — the most widely used standard
* **SCORM 2004** (3rd/4th Edition) — full CMI data model support
* **xAPI / Tin Can** — modern experience tracking with built-in LRS emulator

= Works With Your Authoring Tool =

Packages exported from any SCORM or xAPI compliant authoring tool work out of the box:

* **Articulate Storyline** (360, 3, 2)
* **Articulate Rise** (360)
* **Adobe Captivate**
* **iSpring Suite**
* **Lectora**
* **DominKnow**
* **Elucidat**
* **Evolve Authoring**
* Any tool that exports a valid SCORM 1.2, SCORM 2004, or xAPI (Tin Can) ZIP package

= How It Works =

1. Upload a SCORM or xAPI ZIP from your admin dashboard
2. The plugin extracts it, parses the manifest (imsmanifest.xml or tincan.xml), and detects the format
3. Embed the package in any page or lesson using a shortcode or Gutenberg block
4. SCORM content communicates via an injected runtime; xAPI content talks to the built-in LRS emulator
5. On completion, scores and status are automatically passed to your LMS

= Pro Features (via SlideMind) =

With an active [SlideMind](https://slidemind.app) Pro license, unlock:

* **Detailed Reports** — KPI dashboards, learner tables, xAPI statement viewer, CSV export
* **Forward to External LRS** — Send xAPI statements to an external LRS (Learning Locker, Watershed, etc.)

= Third-Party Services =

**Freemius:** SlideMind Bridge uses Freemius for optional account connection, Pro license activation, checkout, billing, software updates, and license management. Free playback features do not require a Freemius account. When an administrator chooses to connect the plugin, activate a license, purchase Pro, or manage account/license details, the Freemius SDK may send site, plugin, account, license, and diagnostic information to Freemius. Freemius service terms and privacy policy are available at https://freemius.com/terms/ and https://freemius.com/privacy/.

**External LRS Forwarding (Pro feature only):** When enabled and configured by the site administrator, this plugin can forward xAPI statements to an external Learning Record Store (LRS). This feature is entirely opt-in and requires the administrator to provide the LRS endpoint URL and credentials. The external LRS service is provided by a third-party chosen by the administrator; please refer to your LRS provider's terms of service and privacy policy.

= Companion Plugin =

SlideMind Bridge is a companion to [SlideMind WP](https://slidemind.app), which adds AI-powered features to your e-learning modules: persistent memory across courses, personalized feedback, integrated pedagogical conversations, and dynamic branching.

== Installation ==

1. Upload the `slidemind-bridge` folder to `/wp-content/plugins/`, or install directly from the WordPress plugin directory.
2. Activate the plugin through the **Plugins** menu in WordPress.
3. Go to **SlideMind Bridge > Upload** to upload your first SCORM or xAPI package.

== Frequently Asked Questions ==

= What standards are supported? =

**SCORM 1.2**, **SCORM 2004** (3rd and 4th Edition), and **xAPI / Tin Can**. The plugin auto-detects the format from the package manifest.

= Which LMS plugins does it work with? =

LearnDash, TutorLMS, LearnPress, LifterLMS, and Sensei LMS. The plugin detects which LMS is active and bridges data automatically.

= Does it work with Articulate Storyline and Adobe Captivate? =

Yes. Any SCORM or xAPI compliant authoring tool works — Storyline, Rise, Captivate, iSpring, Lectora, DominKnow, and more. Export as SCORM 1.2, SCORM 2004, or xAPI (Tin Can) and upload the ZIP.

= How does xAPI tracking work? =

The plugin includes a built-in LRS emulator. xAPI content sends statements to the emulator endpoint, which extracts completion status and scores and stores them in the same tracking table as SCORM. The content uses its own xAPI library (TinCanJS, xAPIWrapper) — no additional configuration needed.

= Do I need SlideMind WP to use this plugin? =

No. SlideMind Bridge works fully on its own. SlideMind WP is an optional companion that adds AI-powered features (persistent memory, personalized feedback, conversations).

= Where is learner data stored? =

All tracking data (scores, completion status, suspend data, xAPI states) is stored in a dedicated database table on your WordPress server. External connections are limited to optional Freemius account/license/checkout actions and optional LRS forwarding when explicitly enabled by the administrator.

= What happens if no LMS plugin is detected? =

The player still works — learners can launch and interact with packages. Completion and score data is stored in the tracking table, but no LMS passback occurs. You can install a supported LMS plugin at any time.

== Screenshots ==

1. Package list — view all uploaded learning packages
2. Upload form — drag and drop or select a SCORM/xAPI ZIP file
3. Player — embedded player running inside WordPress

== Changelog ==

= 1.0.0 =
* Initial release
* SCORM 1.2 and 2004 runtime support
* xAPI / Tin Can support with built-in LRS emulator
* REST API for SCORM runtime and xAPI statement/state endpoints
* Auto-detection and bridging for LearnDash, TutorLMS, LearnPress, LifterLMS, and Sensei
* Admin interface for package upload and management
* Gutenberg block and shortcodes for embedding packages
* Pro: detailed reports with KPI dashboards, learner tables, and CSV export
* Pro: forward xAPI statements to external LRS

== Upgrade Notice ==

= 1.0.0 =
Initial release.
