nodebb-plugin-openedx-discussion

NodeBB plugin for integrating NodeBB discussion into Open EdX.

Usage no npm install needed!

<script type="module">
  import nodebbPluginOpenedxDiscussion from 'https://cdn.skypack.dev/nodebb-plugin-openedx-discussion';
</script>

README

nodebb-plugin-openedx-discussion (A NodeBB plugin for Openedx)

By integrating this plugin we can use all the functionalities of NodeBB Discussion Forum in Open EdX in following ways: 1- Session will be shared among Open EdX and NodeBB. 2- An embed view of NodeBB discussion will be displayed in course discussion.

Prerequisites

  • Open EdX (hawthorn or later) instance
  • NodeBB (v1.10.x or above) instance.

Enabling the plugin

To enable this plugin we need to configure both of our Open EdX and NodeBB instances according to following steps:

  1. Install openedx-nodebb-discussion in app in your Open EdX instance using its README.
  2. Integrate nodebb-plugin-openedx-discussion plugin in your NodeBB instance, using the Installation Guide given bellow.

Installation Guide

Automated way

To install nodebb-plugin-openedx-discussion using the curl follow the following steps:

  1. Navigate to NodeBB directory.
  2. Run the following command to install and activate the plugin:
$ curl https://raw.githubusercontent.com/edly-io/nodebb-plugin-openedx-discussion/master/install.sh | bash

Manual way

To install nodebb-plugin-openedx-discussion manually follow the following steps:

  1. Run your NodeBB instance, in the admin panel go to Extend->Plugins, in Plugin Search search for nodebb-plugin-openedx-discussion then install and activate this plugin and restart NodeBB.
  2. Again go to admin panel, in Plugins tab select Openedx Discussion option.
  3. Enter JWT cookie name and Secret, make sure that these settings match with the settings of your openedx-nodebb-discussion app.

The Plugin is working now, you can check it by creating a course in you Open EdX instance with nodebb enabled and selecting the NodeBB Discussion tab where a NodeBB iframe will be shown to you.

License

The code in this repository is licensed under the GPL v3.0 unless otherwise noted. Please see LICENSE.md for details

How To Contribute

To contribute, please make a pull request in this repositry on Github: nodebb-plugin-openedx-discussion. If you have any question or issue, please feel free to open an issue on Github: nodebb-plugin-openedx-discussion.

Contributors