Skip to content

Commit

Permalink
docs: fix description and style
Browse files Browse the repository at this point in the history
  • Loading branch information
dcoa committed Jun 24, 2024
1 parent 6e026f9 commit 9014c10
Showing 1 changed file with 11 additions and 14 deletions.
25 changes: 11 additions & 14 deletions README.rst
Original file line number Diff line number Diff line change
Expand Up @@ -10,15 +10,11 @@ EOX Tenant
.. |PyPI Badge| image:: https://img.shields.io/pypi/v/eox-tenant?label=PyPI
:alt: PyPI - Version

Eox-tenant is a multi-tenancy Django app for `edx-platform`_. It is built as an `openedx plugin`_ so even as a Django app it will be auto-installed in the larger edx-platform core code once is installed in the same Python environment.

The code is written and maintained by `edunext`_ and we use it to support our multi-tenant services. It was initially created as an extension of the `microsites` and `site_configurations` features of the Open edX platform, however, it has grown to completely replace them to support a more robust multitenancy model.
Eox-tenant is a plugin for `Open edX`_, and part of the Edunext Open Extensions (aka EOX), that replaces the microsites and site_configurations features, offering a more robust multi-tenancy model.

If you are looking for professional development or support with multitenancy or multi-sites in the Open edX platform, you can reach out to [email protected]

.. _openedx plugin: https://github.com/openedx/edx-platform/tree/master/openedx/core/djangoapps/plugins
.. _edx-platform: https://github.com/openedx/edx-platform/
.. _eduNEXT: https://www.edunext.co
.. _Open edX: https://github.com/openedx/edx-platform/

Installation
============
Expand All @@ -31,8 +27,7 @@ Installation
- eox-tenant=={{version}}
#. Save the configuration with ``tutor config save``.
#. Build an open edx image with ``tutor images build openedx``.
#. Launch your platform with ``tutor local launch``.
#. Build the image and launch your platform with ``tutor local launch``.

Usage
=====
Expand All @@ -45,7 +40,7 @@ Once your instance is running, you can access the Django admin site and locate t
- **Tenant organizations:** Link each organization with one or multiple tenants.

Add ``EDNX_USE_SIGNAL = True`` in each microsite/tenant that wants to use the plugin.

Compatibility Notes
--------------------

Expand All @@ -71,7 +66,7 @@ Compatibility Notes
| Quince | >= v11.0.0 |
+------------------+----------------+

**NOTE**: Since the 6.2 version, eox-tenant does not support Django 2.2
⚠️ Since the 6.2 version, eox-tenant does not support Django 2.2

The plugin is configured for the latest release (Quince). The following changes in the plugin settings should be applied to be used for previous releases.

Expand All @@ -87,18 +82,20 @@ For version 11.X compatible
Those settings can be changed in ``eox_tenant/settings/common.py`` or, for example, in the instance settings.

**NOTE**
If you are installing a previous version, please refer to the tag to verify the configuration that should be applied.

ℹ️ For version > 10.0.0 you need to enable eox-tenant adding in the LMS configuration:

For version > 10.0.0 you need to enable eox-tenant adding in the LMS configuration:

.. code-block:: yaml
USE_EOX_TENANT = True
Commands
--------

Synchronize Organizations
^^^^^^^^^^^^^^^^^^^^^^^^^

This command will synchronize the course_org_filter values in lms_configs(TenantConfig model) or values(Microsite model) with the TenantOrganization registers if the organization does not exist, it will be created, otherwise, it will be added to the organizations model field.


Expand All @@ -110,6 +107,7 @@ This command will synchronize the course_org_filter values in lms_configs(Tenant
Create/Edit tenant configuration
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

`create_or_update_tenant_config` helps to add or edit ``TenantConfig`` and linked ``Routes`` via command line.

.. code-block:: bash
Expand Down Expand Up @@ -163,7 +161,6 @@ From version **1.0.0**, middlewares **RedirectionsMiddleware** and **PathRedirec
The table corresponding to the Redirection model will not be deleted but it will be discarded from the Django state


Caveats
-------

Expand Down

0 comments on commit 9014c10

Please sign in to comment.