tutor-contrib-sample

A Tutor plugin that installs and wires up the three other sub-packages in this repo (backend-plugin-sample, frontend-plugin-sample, and brand-sample) into a Tutor-based Open edX deployment. Enabling this plugin is the simplest way to see all three working together.

How to use it

See the root README for the full setup. The minimum:

pip install -e ./tutor-contrib-sample
tutor plugins enable sample
tutor dev launch

tutor-mfe is required for the frontend slot configuration to apply; the plugin degrades gracefully (backend + brand only) if it isn't installed.

How it works

The plugin is a single file: tutorsample/plugin.py. Each section below is independent of the others.

Backend. Installs the published openedx-plugin-sample package from PyPI into the LMS and CMS images via the openedx-dockerfile-post-python-requirements patch. Also registers backend-plugin-sample as a MOUNTED_DIRECTORIES entry, so that running tutor mounts add "$PWD/backend-plugin-sample" bind-mounts your local checkout and pip-installs that instead.

Migrations. Adds manage.py lms migrate openedx_plugin_sample (and the CMS equivalent) to the tutor … do init task list.

Frontend. (Only when tutor-mfe is installed.) Installs the published @openedx/plugin-sample npm package into every MFE image, injects an import { CourseList } from '@openedx/plugin-sample' into the generated env.config.jsx, and wires CourseList into the org.openedx.frontend.learner_dashboard.course_list.v1 slot (hiding the default contents).

Brand. Sets MFE_CONFIG["PARAGON_THEME_URLS"] to load Paragon's default light theme overlaid with the compiled brand-sample/dist/light.min.css served from jsDelivr.

TODO: the brand override currently assumes brand-sample has been pushed to jsDelivr from main. For a source-hacking workflow, this should be swapped for the tutor-contrib-paragon flow described in brand-sample/README.md.

Development Status
- 3 - Alpha
Intended Audience
- Developers
Natural Language
- English
Programming Language

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

tutor_contrib_sample-3.8.0.tar.gz (8.0 kB view details)

Uploaded Sep 1, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

tutor_contrib_sample-3.8.0-py3-none-any.whl (8.8 kB view details)

Uploaded Sep 1, 2026 Python 3

File details

Details for the file tutor_contrib_sample-3.8.0.tar.gz.

File metadata

Download URL: tutor_contrib_sample-3.8.0.tar.gz
Upload date: Sep 1, 2026
Size: 8.0 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for tutor_contrib_sample-3.8.0.tar.gz
Algorithm	Hash digest
SHA256	`ede06d4526b7f6943817ac234e04fd80f2259f1569fe2fb2066b3b7bf68b7349`
MD5	`7a3455b671131e135e85b3901731e2ef`
BLAKE2b-256	`370b182c431ebb557e064671dfb24a26b8d72a1d80ee6d097611136d802c5e1d`

See more details on using hashes here.

Provenance

The following attestation bundles were made for tutor_contrib_sample-3.8.0.tar.gz:

Publisher: release.yml on openedx/sample-plugin

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: tutor_contrib_sample-3.8.0.tar.gz
- Subject digest: ede06d4526b7f6943817ac234e04fd80f2259f1569fe2fb2066b3b7bf68b7349
- Sigstore transparency entry: 2676720862
- Sigstore integration time: Sep 1, 2026
Source repository:
- Permalink: openedx/sample-plugin@1f6766e215ba4615155664ee763c2ea6520121c5
- Branch / Tag: refs/heads/main
- Owner: https://github.com/openedx
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@1f6766e215ba4615155664ee763c2ea6520121c5
- Trigger Event: push