家教的richie插件
项目描述
这是一个将学习门户 CMS Richie与Open edX集成的插件。集成采用Tutor插件的形式。
安装
pip install tutor-richie tutor plugins enable richie
运行 Richie 插件需要你重建“openedx”Docker 镜像:
tutor config save tutor images build openedx
此步骤是在 edx-platform 中安装 Richie 连接器应用程序所必需的。
然后,平台可以像往常一样启动:
tutor local quickstart
您将能够在 http(s)://courses.LMS_HOST 访问您的课程目录。在开发中,这个 url 将是http://courses.local.overhang.io。
开始
一旦您的 Richie 平台启动并运行,您将很快意识到您的学习门户是空的。这是因为您应该首先从 Richie 内部创建相应的课程和组织。为此,首先创建一个超级用户:
tutor local run richie ./sandbox/manage.py createsuperuser
然后,您可以使用刚刚在 http(s)://yourrichiehost/admin 创建的凭据。在开发中,这是http://courses.local.overhang.io/admin。
然后,参考Richie 官方文档,了解如何创建课程和组织。
您可能还想用演示站点填充您的学习门户 - 但请注意不要在生产中运行此命令,因为之后很难摆脱演示站点:
# WARNING: do not attempt this in production! tutor local run richie ./sandbox/manage.py create_demo_site --force
配置
这个 Tutor 插件带有一些配置设置:
RCHIE_RELEASE_VERSION (默认: "v2.8.2" )
RICHIE_HOST(默认:“课程。{{ LMS_HOST }}”)
RCHIE_MYSQL_DATABASE(默认值:“richie”)
RCHIE_MYSQL_USERNAME(默认值:“richie”)
RCHIE_ELASTICSEARCH_INDICES_PREFIX(默认值:“richie”)
对于大多数用户来说,这些默认值应该足够了。要修改其中任何一个,请运行:
tutor config save --set RICHIE_SETTING_NAME=myvalue
例如,要自定义 Richie 运行的域名:
tutor config save --set "RICHIE_HOST=mysubdomain.{{ LMS_HOST }}"
发展
绑定安装卷:
tutor dev bindmount richie /app/richie
然后,运行开发服务器:
tutor dev runserver --volume=/app/richie richie
Richie 开发服务器可在http://courses.local.overhang.io:8003 获得。
故障排除
你需要这个插件的帮助吗?通过打开 GitHub 问题与 Richie 的维护者取得联系:https ://github.com/openfun/richie/issues/
执照
该软件根据AGPLv3条款获得许可。由于France Université Numérique的赞助,它得以开发并得到积极维护。