Metadata-Version: 2.2
Name: openedx-cmi5-xblock
Version: 0.1.2
Summary: Openedx CMI5 XBlock
Home-page: https://github.com/edly-io/openedx-cmi5-xblock
Author: edly
Author-email: hello@edly.io
License: MIT
Keywords: Python edx cmi5 xblock
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.8
License-File: LICENSE
Requires-Dist: Mako
Requires-Dist: XBlock
Requires-Dist: django-statici18n
Requires-Dist: edx-i18n-tools
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: home-page
Dynamic: keywords
Dynamic: license
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

Openedx CMI5 XBlock
#############################

Xblock to integrate CMI5 content in Open edX. It provides following features

*   Ability to upload CMI5 package or cmi5.xml file
*   Parses xAPI statements generated by CMI5 content to set grade and track progress of learner
*   Ability to push xAPI statements to a configured LRS 

Setup
********************

Install CMI5 XBlock:

.. code-block:: bash

    pip install openedx-cmi5-xblock

Update course advanced settings by adding `openedx_cmi5_xblock` as shown in below image:

.. image:: https://github.com/edly-io/ai-coach-xblock/blob/master/docs/images/update_settings.png?raw=True
   :alt: Update Advanced Settings

Go back to your course content. In the "Add New Component" section, click "Advanced", and then "CMI5 module". Click "Edit" on the newly-created module: this is where you will upload your content package. It should be a .zip file or a .xml file containing the cmi5 content.

The cmi5 unit will display a link in the studio and the LMS. Clicking on the link will take users to a new tab where they can interact with the cmi5 content.

.. image:: https://github.com/edly-io/ai-coach-xblock/blob/master/docs/images/studio_view.png?raw=True
   :alt: Update Advanced Settings

.. image:: https://github.com/edly-io/ai-coach-xblock/blob/master/docs/images/lms_view.png?raw=True
   :alt: Update Advanced Settings

Advanced configuration for sending data to LRS
**********************************************

CMI5 Xblock can be configured to push xAPI statements to a Third-party Learning Record Store. To configure that, use these settings

.. code-block:: python

    XBLOCK_SETTINGS["CMI5XBlock"] = {
        "LRS_AUTH_KEY": "<LRS-activity-provider-key>",
        "LRS_AUTH_SECRET": "<LRS-secret-key>",
        "LRS_ENDPOINT": "<domain>/lrs/<LRS-app-id>/statements/"
    }

These settings may be added using Tutor by creating a `tutor plugin <https://docs.tutor.overhang.io/plugins/>`__:

.. code-block:: python

    from tutor import hooks

    hooks.Filters.ENV_PATCHES.add_item(
        (
            "openedx-common-settings",
            """
    XBLOCK_SETTINGS["CMI5XBlock"] = {
        "LRS_AUTH_KEY": "<LRS-activity-provider-key>",
        "LRS_AUTH_SECRET": "<LRS-secret-key>",
        "LRS_ENDPOINT": "<domain>/lrs/<LRS-app-id>/statements/"
    }"""
    )
    )

Change Log
##########

..
   All enhancements and patches to openedx_cmi5_xblock will be documented
   in this file.  It adheres to the structure of https://keepachangelog.com/ ,
   but in reStructuredText instead of Markdown (for ease of incorporation into
   Sphinx documentation and the PyPI description).

   This project adheres to Semantic Versioning (https://semver.org/).

.. There should always be an "Unreleased" section for changes pending release.

Unreleased
**********

*

0.1.0 – 2023-07-06
**********************************************

Added
=====

* First release on PyPI.
