Skip to content

Commit b0d9e83

Browse files
authored
docs: update readme to include mongodb params customization section (#66)
1 parent 9da0c46 commit b0d9e83

File tree

1 file changed

+27
-0
lines changed

1 file changed

+27
-0
lines changed

README.rst

Lines changed: 27 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -49,6 +49,33 @@ For a more progressive transition, you may decide to migrate data for a single c
4949

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

52+
Breaking Changes
53+
^^^^^^^^^^^^^^^^
54+
As part of the Sumac major release, the following MongoDB-related configuration were removed from this plugin:
55+
56+
* FORUM_MONGODB_DATABASE (default: ``cs_comments_service``)
57+
* FORUM_MONGODB_USE_SSL (default: ``False``)
58+
* FORUM_MONGODB_AUTH_SOURCE (default: ``""``)
59+
* FORUM_MONGODB_AUTH_MECH (default: ``""``)
60+
* FORUM_PORT (default: ``"4567"``)
61+
* FORUM_API_KEY (default: ``"forumapikey"``)
62+
* FORUM_REPOSITORY (default: ``https://github.com/openedx/cs_comments_service.git``)
63+
* FORUM_REPOSITORY_VERSION (default: ``{{ OPENEDX_COMMON_VERSION }}``)
64+
65+
These configurable parameters were deprecated in sumac upgrade when `openedx forum <https://github.com/openedx/forum>`_ was made default in tutor-forum.
66+
Prior to v19 sumac release, if an operator using this plugin had customized the above listed configurations, they will not be able to customize these values with ``tutor config save --set`` after v19 sumac release. To customize the deprecated mongo params, **openedx-common-settings** patch should be used. See below for an example using this patch in a custom plugin:
67+
68+
.. code-block:: python
69+
70+
tutor_hooks.Filters.ENV_PATCHES.add_item(
71+
(
72+
"openedx-common-settings", """
73+
FORUM_MONGODB_DATABASE = 'your_custom_name',
74+
"""
75+
)
76+
)
77+
78+
5279
Usage
5380
-----
5481

0 commit comments

Comments
 (0)