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:
- Install openedx-nodebb-discussion in app in your Open EdX instance using its README.
- 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:
- Navigate to NodeBB directory.
- 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:
- Run your NodeBB instance, in the admin panel go to
Extend->Plugins
, inPlugin Search
search fornodebb-plugin-openedx-discussion
then install and activate this plugin and restart NodeBB. - Again go to admin panel, in
Plugins
tab selectOpenedx Discussion
option. - Enter
JWT cookie name
andSecret
, 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
- [Muhammad Zeeshan] (https://github.com/zee-pk)
- [Osama Arshad] (https://github.com/asamolion)
- [Tehreem Sadat] (https://github.com/tehreem-sadat)
- [Danial Malik] (https://github.com/danialmalik)
- [Hamza Farooq] (https://github.com/HamzaIbnFarooq)
- [Hassan Tariq] (https://github.com/imhassantariq)
- [Muhammad Umar Khan] (https://github.com/mumarkhan999)