tutor-forum


Nametutor-forum JSON
Version 19.0.0 PyPI version JSON
download
home_pagehttps://github.com/overhangio/tutor-forum
Summaryforum plugin for Tutor
upload_time2024-12-16 19:41:17
maintainerabstract-technology.de
docs_urlNone
authorEdly
requires_python>=3.9
licenseAGPLv3
keywords
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            Forum plugin for `Tutor <https://docs.tutor.edly.io>`__
=======================================================

This plugin adds `discussion forums`_ to your `Open edX`_ platform, such that students
can have conversations about the courses they are following right in your LMS.

.. image:: https://overhang.io/static/catalog/screenshots/forum.png
  :alt: Forum screenshot


.. _discussion forums: https://github.com/openedx/cs_comments_service
.. _Open edX: https://openedx.org/

Installation
------------

.. code-block:: bash

    tutor plugins install forum

Upgrading from Redwood (v18)
****************************

In the Sumac release, this plugin was updated to run the new `openedx/forum <https://github.com/openedx/forum>`__ Python application ("v2") instead of the legacy `cs_comments_service <https://github.com/openedx/cs_comments_service>`__ Ruby application ("v1"). See this `deprecation announcement <https://github.com/openedx/cs_comments_service/issues/437>`__ for more information.

For data storage, forum v2 can use either MongoDB or MySQL as a data storage backend:

* New users running Open edX for the first time in Sumac (Tutor v19) will default to the MySQL backend.
* Existing platforms running Redwood or earlier (Tutor < v19) will keep using the MongoDB backend by default.

If you are running an existing platform, you are strongly encouraged to migrate to the new MySQL backend, as the MongoDB backend will disappear in Teak. To do so, you should start by migrating your data::

    tutor local run lms ./manage.py lms forum_migrate_course_from_mongodb_to_mysql --no-toggle all

This command is non-destructive for your data, and can be run multiple times with the same outcome. Once the data migration is successful, you should enable the ``forum_v2.enable_mysql_backend`` global course waffle flag::

    ./manage.py lms waffle_flag --create --everyone forum_v2.enable_mysql_backend

The forum will then make use of data stored in MySQL instead of MongoDB. Once you are sufficiently confident that the MongoDB data is no longer necessary, you may delete it with::

    ./manage.py lms forum_delete_course_from_mongodb all

For a more progressive transition, you may decide to migrate data for a single course::

    # removing the no-toggle option will automatically create the course waffle flag just for this course
    tutor local run lms ./manage.py lms forum_migrate_course_from_mongodb_to_mysql <course ID>
    # deleting data is optional and should be done only if you are confident that the migration was successful
    ./manage.py lms forum_delete_course_from_mongodb <course ID>

For more information, check out the `documentation <https://github.com/openedx/forum>`__ of the forum application.

Usage
-----

.. code-block:: bash

    tutor plugins enable forum
    tutor dev|local|k8s launch

Debugging
---------

To debug the forum application, you are encouraged to mount the ``forum`` repository from the host in the development container:

.. code-block:: bash

    tutor mounts add /path/to/forum
    tutor dev launch

Troubleshooting
---------------

This Tutor plugin is maintained by Ghassan Maslamani from `Abstract-Technology <https://abstract-technology.de>`__.
Community support is available from the official `Open edX forum <https://discuss.openedx.org>`__.
Do you need help with this plugin? See the `troubleshooting <https://docs.tutor.edly.io/troubleshooting.html>`__ section
from the Tutor documentation.

License
-------

This work is licensed under the terms of the `GNU Affero General Public License (AGPL)`_.

.. _GNU Affero General Public License (AGPL): https://github.com/overhangio/tutor-forum/blob/release/LICENSE.txt

            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/overhangio/tutor-forum",
    "name": "tutor-forum",
    "maintainer": "abstract-technology.de",
    "docs_url": null,
    "requires_python": ">=3.9",
    "maintainer_email": "g.maslamani@abstract-technology.de",
    "keywords": null,
    "author": "Edly",
    "author_email": null,
    "download_url": "https://files.pythonhosted.org/packages/d7/f5/da73b5bc7356bc3fe3a583098b245ddece509c2973cb66efd718f83c0d68/tutor_forum-19.0.0.tar.gz",
    "platform": null,
    "description": "Forum plugin for `Tutor <https://docs.tutor.edly.io>`__\n=======================================================\n\nThis plugin adds `discussion forums`_ to your `Open edX`_ platform, such that students\ncan have conversations about the courses they are following right in your LMS.\n\n.. image:: https://overhang.io/static/catalog/screenshots/forum.png\n  :alt: Forum screenshot\n\n\n.. _discussion forums: https://github.com/openedx/cs_comments_service\n.. _Open edX: https://openedx.org/\n\nInstallation\n------------\n\n.. code-block:: bash\n\n    tutor plugins install forum\n\nUpgrading from Redwood (v18)\n****************************\n\nIn the Sumac release, this plugin was updated to run the new `openedx/forum <https://github.com/openedx/forum>`__ Python application (\"v2\") instead of the legacy `cs_comments_service <https://github.com/openedx/cs_comments_service>`__ Ruby application (\"v1\"). See this `deprecation announcement <https://github.com/openedx/cs_comments_service/issues/437>`__ for more information.\n\nFor data storage, forum v2 can use either MongoDB or MySQL as a data storage backend:\n\n* New users running Open edX for the first time in Sumac (Tutor v19) will default to the MySQL backend.\n* Existing platforms running Redwood or earlier (Tutor < v19) will keep using the MongoDB backend by default.\n\nIf you are running an existing platform, you are strongly encouraged to migrate to the new MySQL backend, as the MongoDB backend will disappear in Teak. To do so, you should start by migrating your data::\n\n    tutor local run lms ./manage.py lms forum_migrate_course_from_mongodb_to_mysql --no-toggle all\n\nThis command is non-destructive for your data, and can be run multiple times with the same outcome. Once the data migration is successful, you should enable the ``forum_v2.enable_mysql_backend`` global course waffle flag::\n\n    ./manage.py lms waffle_flag --create --everyone forum_v2.enable_mysql_backend\n\nThe forum will then make use of data stored in MySQL instead of MongoDB. Once you are sufficiently confident that the MongoDB data is no longer necessary, you may delete it with::\n\n    ./manage.py lms forum_delete_course_from_mongodb all\n\nFor a more progressive transition, you may decide to migrate data for a single course::\n\n    # removing the no-toggle option will automatically create the course waffle flag just for this course\n    tutor local run lms ./manage.py lms forum_migrate_course_from_mongodb_to_mysql <course ID>\n    # deleting data is optional and should be done only if you are confident that the migration was successful\n    ./manage.py lms forum_delete_course_from_mongodb <course ID>\n\nFor more information, check out the `documentation <https://github.com/openedx/forum>`__ of the forum application.\n\nUsage\n-----\n\n.. code-block:: bash\n\n    tutor plugins enable forum\n    tutor dev|local|k8s launch\n\nDebugging\n---------\n\nTo debug the forum application, you are encouraged to mount the ``forum`` repository from the host in the development container:\n\n.. code-block:: bash\n\n    tutor mounts add /path/to/forum\n    tutor dev launch\n\nTroubleshooting\n---------------\n\nThis Tutor plugin is maintained by Ghassan Maslamani from `Abstract-Technology <https://abstract-technology.de>`__.\nCommunity support is available from the official `Open edX forum <https://discuss.openedx.org>`__.\nDo you need help with this plugin? See the `troubleshooting <https://docs.tutor.edly.io/troubleshooting.html>`__ section\nfrom the Tutor documentation.\n\nLicense\n-------\n\nThis work is licensed under the terms of the `GNU Affero General Public License (AGPL)`_.\n\n.. _GNU Affero General Public License (AGPL): https://github.com/overhangio/tutor-forum/blob/release/LICENSE.txt\n",
    "bugtrack_url": null,
    "license": "AGPLv3",
    "summary": "forum plugin for Tutor",
    "version": "19.0.0",
    "project_urls": {
        "Code": "https://github.com/overhangio/tutor-forum",
        "Community": "https://discuss.openedx.org",
        "Homepage": "https://github.com/overhangio/tutor-forum",
        "Issue tracker": "https://github.com/overhangio/tutor-forum/issues"
    },
    "split_keywords": [],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "d7f5da73b5bc7356bc3fe3a583098b245ddece509c2973cb66efd718f83c0d68",
                "md5": "798de34778504bb019aeb52e4fa5a13b",
                "sha256": "d8e90e8032a24ef35eced048e153d2b1c26d5d45d37f9e3e888d1633ef073008"
            },
            "downloads": -1,
            "filename": "tutor_forum-19.0.0.tar.gz",
            "has_sig": false,
            "md5_digest": "798de34778504bb019aeb52e4fa5a13b",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.9",
            "size": 16561,
            "upload_time": "2024-12-16T19:41:17",
            "upload_time_iso_8601": "2024-12-16T19:41:17.152840Z",
            "url": "https://files.pythonhosted.org/packages/d7/f5/da73b5bc7356bc3fe3a583098b245ddece509c2973cb66efd718f83c0d68/tutor_forum-19.0.0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-12-16 19:41:17",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "overhangio",
    "github_project": "tutor-forum",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "tutor-forum"
}
        
Elapsed time: 0.36807s