General overview

AlgebraKiT exposes its core functionality and the front end widgets as a RESTful web service. The look and feel of these widgets can be configured to match the visual style of your LMS.

These documentation pages describe the general setup of the AlgebraKiT services, including a description of the web service API and the front end API. Refer to the menu on the left to navigate through these documentation pages. For code examples, refer to code examples on Github. For more detailed questions, please use the contact form a reach out to us.

Main components

AlgebraKiT is a system with the following main components:

  1. The knowledge rules, which form the mathematical configuration of AlgebraKiT and control how AlgebraKiT solves mathematical problems.
  2. The web service, which exposes AlgebraKiT’s evaluation engine, handles exercise sessions and allows access to exercises stored in AlgebraKiT’s CMS.
  3. The front end API, which handles configuration, widget creation, event handlers and the like.
  4. The front end widgets, which are injected into your web page and take care of interacting between AlgebraKiT and the student.
  5. The AlgebraKiT CMS, an online environment where authors are allowed to create new exercises or arrange existing randomized exercises. Refer to the AlgebraKiT CMS web page.

Exercise life-cycle

The life-cycle of an exercise is as follows:

  1. Create session: New sessions are initialized from your LMS’ backend. AlgebraKiT replies with a session id.
  2. Insert widget: The LMS inserts the widget in its web page through a dedicated tag and supplies the session id as an attribute.
  3. Session events: The widget takes care of initializing itself and communicating with AlgebraKiT for evaluation, hints and feedback.
  4. Collect results: The LMS uses the session id to get the session results from AlgebraKiT. This can be done directly after the session or any time later on.

This approach guarantees that no ‘confidential’ information, such as the exercise’s answer, is sent to the front end. In addition, the amount of data that is sent back and forth between front and back end is minimal.

Front end - your web page

To be able to use AlgebraKiT in your solution, you need to load the front end API first. Questions are included through dedicated tags that each refer to the applicable sessions. The front end API will automatically detect the tags, figure out the question type and launch the corresponding widget.

Note that the sessions are created server side, through a call to the AlgebraKiT web service.

Also note that this is a minimal setup; see the front end API documentation to read more about configuration, listening to events and sending commands.

<html>
   <head></head>
   <body>
      ...  <!-- Whatever your page contains... -->

      <!--Insert an AlgebraKiT question here -->
      <akit-exercise session-id="{id}"></akit-exercise>

      ...  <!-- Whatever your page contains... -->

      <!--Load front end API -->
      <script href="https://algebrakit.eu/akit-widgets.min.js"></script>
      <script> <!--Detect tags and launch widgets -->
        AlgebraKIT.injectWidgets();
      </script>
   </body>
</html>
about algebrakit contact us
Contact info@algebrakit.nl
Try our demos +31 624827648
Disclaimer Eindhoven, the Netherlands
Copyright AlgebraKiT 2017