Credentials plugin for `Tutor <https://docs.tutor.edly.io>`__
===================================================================================
This is a plugin for `Tutor <https://docs.tutor.edly.io>`_ that integrates the `Credentials <https://github.com/openedx/credentials/>`__ application in an Open edX platform.
Credentials application supports course and program certificates. This plugin offers an admin panel where user can do configurations for the certificates of his course and program.
Note that user will have to create the course/program using `Discovery plugin <https://github.com/overhangio/tutor-discovery>`__. Then Credentials plugin will be used for certificates configurations.
.. image:: https://github.com/overhangio/tutor-credentials/blob/main/doc/django-admin-screen-shot.png
:alt: Django Admin
Installation
------------
::
pip install https://github.com/overhangio/tutor-credentials.git
Note that this plugin is compatible with `Kubernetes integration <http://docs.tutor.edly.io/k8s.html>`__.
For further instructions on how to setup Credentials with Open edX, check the `Official Credentials documentation <https://readthedocs.org/projects/edx-credentials/>`__.
Usage
-----
::
pip install tutor-credentials
tutor plugins enable discovery mfe credentials
tutor local launch
For Copying programs that user make in `Discovery plugin <https://github.com/overhangio/tutor-discovery>`__ into Credentials. Run the below command:
::
tutor local run credentials ./manage.py copy_catalog
Using Django Admin
~~~~~~~~~~~~~~~~~~
The credentials user interface will be available at http://credentials.local.edly.io for a local instance, and at ``CREDENTIALS_HOST`` (by default: ``http(s)://credentials.<your lms host>``) in production. In order to run commands from the UI login with an admin user at: http://credentials.local.edly.io/admin/. User should be able to authenticate with the same username and password that he used for his lms.
User can also create superuser for credentials using the below command
::
tutor local run credentials ./manage.py createsuperuser
Learner Record UI
-----------------
.. image:: https://github.com/overhangio/tutor-credentials/blob/main/doc/learner-record.png
:alt: Learner Record MFE screenshot
This plugin installs and enables the `Learner Record MFE <https://github.com/openedx/frontend-app-learner-record>`__ by default. It contains views for a learners current status in a program, their current grade, and the ability to share any earned credentials either publically or with institutions.
The learner can access the Learner Record UI from their profile page by clicking the "View My Records" button.
Configuration
-------------
Application configuration
~~~~~~~~~~~~~~~~~~~~~~~~~
- ``CREDENTIALS_HOST`` (default: ``"credentials.{{ LMS_HOST }}"``)
- ``CREDENTIALS_MYSQL_DATABASE`` (default: ``"credentials"``)
- ``CREDENTIALS_MYSQL_USERNAME`` (default: ``"credentials"``)
- ``CREDENTIALS_MYSQL_PASSWORD`` (default: ``"{{ 8|random_string }}"``)
- ``CREDENTIALS_DOCKER_IMAGE`` (default: ``"{{ DOCKER_REGISTRY }}overhangio/openedx-credentials:{{ CREDENTIALS_VERSION }}"``)
- ``CREDENTIALS_EXTRA_PIP_REQUIREMENTS`` (default: ``[]``)
- ``CREDENTIALS_REPOSITORY`` (default: ``"https://github.com/openedx/credentials.git"``)
- ``CREDENTIALS_REPOSITORY_VERSION`` (default: ``"{{ OPENEDX_COMMON_VERSION }}"``)
Marketing & Theming
~~~~~~~~~~~~~~~~~~~
- ``CREDENTIALS_THEME_NAME`` (default: ``"edx-theme"``)
Backend authentication
~~~~~~~~~~~~~~~~~~~~~~~
- ``CREDENTIALS_BACKEND_SERVICE_EDX_OAUTH2_KEY`` (default: ``"credentials-backend-service-key"``)
- ``CREDENTIALS_BACKEND_SERVICE_EDX_OAUTH2_SECRET`` (default: ``"{{ CREDENTIALS_OAUTH2_SECRET }}"``)
- ``CREDENTIALS_OAUTH2_KEY`` (default: ``credentials-backend-service-key"``)
- ``CREDENTIALS_OAUTH2_SECRET`` (default: ``"CHANGE-ME"``)
Application Third party authentication
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
- ``CREDENTIALS_SOCIAL_AUTH_EDX_OAUTH2_KEY`` (default: ``"credentials-sso-key"``)
- ``CREDENTIALS_SOCIAL_AUTH_EDX_OAUTH2_SECRET`` (default: ``"credentials-sso-secret"``)
Learner Record UI configuration
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
The Learner Record is configurable dynamically via runtime configuration. To change any of the variables below, go to your LMS's Django admin Site Configuration page (for instance, http://local.edly.io/admin/site_configuration/siteconfiguration/) and add or modify corresponding JSON dict entries in the appropriate site:
- ``SUPPORT_URL_LEARNER_RECORDS`` (default: ``""``): the URL the learner is taken to when clicking the "read more in our records help area" link.
Funding
-------
.. image:: https://www.academiacentral.org/wp-content/uploads/2019/05/academia-nobeta.png
:alt: Academia Central
:target: https://www.academiacentral.org/
This plugin was initially developed and open sourced to the community thanks to the generous support of `Academia Central <https://www.academiacentral.org/>`_. Thank you!
Troubleshooting
---------------
This Tutor plugin is maintained by Muhammad Faraz Maqsood from `Edly <https://edly.io/>`__. 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 software is licensed under the terms of the AGPLv3.
Raw data
{
"_id": null,
"home_page": "https://github.com/overhangio/tutor-credentials.git",
"name": "tutor-credentials",
"maintainer": "Edly",
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "faraz.maqsood@arbisoft.com",
"keywords": "",
"author": "Lawrence McDaniel",
"author_email": "lpm0073@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/ab/b6/2e95d264360c0f9131dfca2bbfeff87bb6005dfd207bc0006c572b6a3d1a/tutor-credentials-17.0.1.tar.gz",
"platform": null,
"description": "Credentials plugin for `Tutor <https://docs.tutor.edly.io>`__\n===================================================================================\n\nThis is a plugin for `Tutor <https://docs.tutor.edly.io>`_ that integrates the `Credentials <https://github.com/openedx/credentials/>`__ application in an Open edX platform.\nCredentials application supports course and program certificates. This plugin offers an admin panel where user can do configurations for the certificates of his course and program.\n\nNote that user will have to create the course/program using `Discovery plugin <https://github.com/overhangio/tutor-discovery>`__. Then Credentials plugin will be used for certificates configurations.\n\n.. image:: https://github.com/overhangio/tutor-credentials/blob/main/doc/django-admin-screen-shot.png\n :alt: Django Admin\n\nInstallation\n------------\n\n::\n\n pip install https://github.com/overhangio/tutor-credentials.git\n\nNote that this plugin is compatible with `Kubernetes integration <http://docs.tutor.edly.io/k8s.html>`__.\n\n\nFor further instructions on how to setup Credentials with Open edX, check the `Official Credentials documentation <https://readthedocs.org/projects/edx-credentials/>`__.\n\nUsage\n-----\n\n::\n\n pip install tutor-credentials\n tutor plugins enable discovery mfe credentials\n tutor local launch\n\nFor Copying programs that user make in `Discovery plugin <https://github.com/overhangio/tutor-discovery>`__ into Credentials. Run the below command:\n::\n\n tutor local run credentials ./manage.py copy_catalog\n\nUsing Django Admin\n~~~~~~~~~~~~~~~~~~\n\nThe credentials user interface will be available at http://credentials.local.edly.io for a local instance, and at ``CREDENTIALS_HOST`` (by default: ``http(s)://credentials.<your lms host>``) in production. In order to run commands from the UI login with an admin user at: http://credentials.local.edly.io/admin/. User should be able to authenticate with the same username and password that he used for his lms.\nUser can also create superuser for credentials using the below command\n::\n\n tutor local run credentials ./manage.py createsuperuser\n\nLearner Record UI\n-----------------\n\n.. image:: https://github.com/overhangio/tutor-credentials/blob/main/doc/learner-record.png\n :alt: Learner Record MFE screenshot\n\nThis plugin installs and enables the `Learner Record MFE <https://github.com/openedx/frontend-app-learner-record>`__ by default. It contains views for a learners current status in a program, their current grade, and the ability to share any earned credentials either publically or with institutions.\n\nThe learner can access the Learner Record UI from their profile page by clicking the \"View My Records\" button.\n\nConfiguration\n-------------\n\nApplication configuration\n~~~~~~~~~~~~~~~~~~~~~~~~~\n\n- ``CREDENTIALS_HOST`` (default: ``\"credentials.{{ LMS_HOST }}\"``)\n- ``CREDENTIALS_MYSQL_DATABASE`` (default: ``\"credentials\"``)\n- ``CREDENTIALS_MYSQL_USERNAME`` (default: ``\"credentials\"``)\n- ``CREDENTIALS_MYSQL_PASSWORD`` (default: ``\"{{ 8|random_string }}\"``)\n- ``CREDENTIALS_DOCKER_IMAGE`` (default: ``\"{{ DOCKER_REGISTRY }}overhangio/openedx-credentials:{{ CREDENTIALS_VERSION }}\"``)\n- ``CREDENTIALS_EXTRA_PIP_REQUIREMENTS`` (default: ``[]``)\n- ``CREDENTIALS_REPOSITORY`` (default: ``\"https://github.com/openedx/credentials.git\"``)\n- ``CREDENTIALS_REPOSITORY_VERSION`` (default: ``\"{{ OPENEDX_COMMON_VERSION }}\"``)\n\nMarketing & Theming\n~~~~~~~~~~~~~~~~~~~\n\n- ``CREDENTIALS_THEME_NAME`` (default: ``\"edx-theme\"``)\n\nBackend authentication\n~~~~~~~~~~~~~~~~~~~~~~~\n\n- ``CREDENTIALS_BACKEND_SERVICE_EDX_OAUTH2_KEY`` (default: ``\"credentials-backend-service-key\"``)\n- ``CREDENTIALS_BACKEND_SERVICE_EDX_OAUTH2_SECRET`` (default: ``\"{{ CREDENTIALS_OAUTH2_SECRET }}\"``)\n- ``CREDENTIALS_OAUTH2_KEY`` (default: ``credentials-backend-service-key\"``)\n- ``CREDENTIALS_OAUTH2_SECRET`` (default: ``\"CHANGE-ME\"``)\n\nApplication Third party authentication\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\n- ``CREDENTIALS_SOCIAL_AUTH_EDX_OAUTH2_KEY`` (default: ``\"credentials-sso-key\"``)\n- ``CREDENTIALS_SOCIAL_AUTH_EDX_OAUTH2_SECRET`` (default: ``\"credentials-sso-secret\"``)\n\nLearner Record UI configuration\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\nThe Learner Record is configurable dynamically via runtime configuration. To change any of the variables below, go to your LMS's Django admin Site Configuration page (for instance, http://local.edly.io/admin/site_configuration/siteconfiguration/) and add or modify corresponding JSON dict entries in the appropriate site:\n\n- ``SUPPORT_URL_LEARNER_RECORDS`` (default: ``\"\"``): the URL the learner is taken to when clicking the \"read more in our records help area\" link.\n\nFunding\n-------\n\n.. image:: https://www.academiacentral.org/wp-content/uploads/2019/05/academia-nobeta.png\n :alt: Academia Central\n :target: https://www.academiacentral.org/\n\nThis plugin was initially developed and open sourced to the community thanks to the generous support of `Academia Central <https://www.academiacentral.org/>`_. Thank you!\n\nTroubleshooting\n---------------\n\nThis Tutor plugin is maintained by Muhammad Faraz Maqsood from `Edly <https://edly.io/>`__. 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.\n\nLicense\n-------\n\nThis software is licensed under the terms of the AGPLv3.\n",
"bugtrack_url": null,
"license": "AGPLv3",
"summary": "A Tutor plugin for Open edX Credentials service",
"version": "17.0.1",
"project_urls": {
"Code": "https://github.com/overhangio/tutor-credentials.git",
"Community": "https://discuss.overhang.io",
"Homepage": "https://github.com/overhangio/tutor-credentials.git",
"Issue tracker": "https://github.com/overhangio/tutor-credentials.git/issues"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "abb62e95d264360c0f9131dfca2bbfeff87bb6005dfd207bc0006c572b6a3d1a",
"md5": "fe2ec076e5101def6a4546cb670ed084",
"sha256": "25ae1defd58463b245455fd77812faf28c25cf482a6bfc08e13759fd350f6fff"
},
"downloads": -1,
"filename": "tutor-credentials-17.0.1.tar.gz",
"has_sig": false,
"md5_digest": "fe2ec076e5101def6a4546cb670ed084",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 13508,
"upload_time": "2024-01-23T10:01:00",
"upload_time_iso_8601": "2024-01-23T10:01:00.943620Z",
"url": "https://files.pythonhosted.org/packages/ab/b6/2e95d264360c0f9131dfca2bbfeff87bb6005dfd207bc0006c572b6a3d1a/tutor-credentials-17.0.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-01-23 10:01:00",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "overhangio",
"github_project": "tutor-credentials",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "tutor-credentials"
}
JSON
