feat: Add installable tutor plugin for the sample plugin

Replaces the non-functional sample_plugin.py placeholder with a proper
installable Python package under tutor/tutorsampleplugin/.

The plugin:
- Installs openedx-sample-plugin (PyPI) into LMS and CMS images via the
  openedx-dockerfile-post-python-requirements patch
- Installs @openedx/sample-plugin (npm) into all MFE images via the
  mfe-dockerfile-post-npm-install patch (global rather than per-MFE because
  env.config.jsx is a shared template rendered for all MFEs)
- Imports CourseList via mfe-env-config-buildtime-imports
- Configures the org.openedx.frontend.learner_dashboard.course_list.v1 slot
  to hide the default content and insert the sample plugin's CourseList

Gracefully degrades when tutor-mfe is not installed (frontend hooks are
skipped via ImportError guard).

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: feanil

tutor/pyproject.toml

@@ -0,0 +1,42 @@
+[build-system]
+requires = ["setuptools", "setuptools-scm>8.1"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "tutor-sample-plugin"
+description = "Tutor plugin for the Open edX Sample Plugin"
+requires-python = ">=3.11"
+license = "Apache-2.0"
+authors = [
+    {name = "Open edX Project", email = "oscm@openedx.org"},
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Natural Language :: English",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.12",
+]
+keywords = ["tutor", "openedx", "plugin"]
+dependencies = ["tutor>=17.0.0"]
+dynamic = ["readme", "version"]
+
+[project.entry-points."tutor.plugin.v1"]
+sample_plugin = "tutorsampleplugin.plugin"
+
+[project.urls]
+Homepage = "https://github.com/openedx/sample-plugin"
+Repository = "https://github.com/openedx/sample-plugin"
+
+[tool.setuptools.dynamic]
+readme = {file = ["README.md"], content-type = "text/markdown"}
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["tutorsampleplugin*"]
+
+[tool.setuptools_scm]
+# The root for the git repo is one directory up.
+root = ".."
+version_scheme = "only-version"
+local_scheme = "no-local-version"

tutor/sample_plugin.py

@@ -0,0 +1,86 @@
+"""
+Tutor plugin for the Open edX Sample Plugin.
+
+Installs the backend Django app (openedx-sample-plugin from PyPI) into LMS/CMS
+and configures the frontend MFE slot (from @openedx/sample-plugin on npm) in the
+learner-dashboard.
+
+Requirements:
+    tutor>=17.0.0
+    tutor-mfe (for frontend slot configuration)
+"""
+
+from tutor import hooks
+
+try:
+    from tutormfe.hooks import PLUGIN_SLOTS
+    _tutormfe_available = True
+except ImportError:
+    _tutormfe_available = False
+
+# ---------------------------------------------------------------------------
+# Backend: Install the Django app plugin into LMS and CMS images
+# ---------------------------------------------------------------------------
+# The openedx-dockerfile-post-python-requirements patch runs after pip
+# installs the base Open edX requirements. Plugins installed here are
+# available in both LMS and CMS containers.
+# ---------------------------------------------------------------------------
+
+hooks.Filters.ENV_PATCHES.add_item((
+    "openedx-dockerfile-post-python-requirements",
+    "RUN pip install openedx-sample-plugin",
+))
+
+# ---------------------------------------------------------------------------
+# Frontend: Install npm package and configure the learner-dashboard slot
+# ---------------------------------------------------------------------------
+# Only runs when tutor-mfe is installed, so the plugin degrades gracefully
+# if someone uses this plugin without the MFE plugin.
+# ---------------------------------------------------------------------------
+
+if _tutormfe_available:
+    # Step 1: Install the npm package into all MFE images.
+    # Ideally this would use mfe-dockerfile-post-npm-install-learner-dashboard
+    # to scope installation to only the MFE that needs it, but env.config.jsx
+    # is a single shared file rendered for all MFEs. The buildtime import below
+    # must resolve in every MFE's node_modules, so we install it globally.
+    # The plugin slot config is still scoped to learner-dashboard at runtime.
+    hooks.Filters.ENV_PATCHES.add_item((
+        "mfe-dockerfile-post-npm-install",
+        "RUN npm install @openedx/sample-plugin",
+    ))
+
+    # Step 2: Import the CourseList component in the MFE env config so it is
+    # in scope when the plugin slot configuration is evaluated at runtime.
+    # The mfe-env-config-buildtime-imports patch injects import statements
+    # into the generated env.config.jsx file.
+    hooks.Filters.ENV_PATCHES.add_item((
+        "mfe-env-config-buildtime-imports",
+        "import { CourseList } from '@openedx/sample-plugin';",
+    ))
+
+    # Step 3: Configure the course list plugin slot.
+    # - Hide the default CourseList that ships with the learner-dashboard.
+    # - Insert our custom CourseList that adds archive/unarchive functionality.
+    #
+    # Slot ID: org.openedx.frontend.learner_dashboard.course_list.v1
+    # Props passed by the slot: courseListData (visibleList, numPages,
+    #   setPageNumber, filterOptions, showFilters)
+    PLUGIN_SLOTS.add_item((
+        "learner-dashboard",
+        "org.openedx.frontend.learner_dashboard.course_list.v1",
+        """
+        {
+          op: PLUGIN_OPERATIONS.Hide,
+          widgetId: 'default_contents',
+        },
+        {
+          op: PLUGIN_OPERATIONS.Insert,
+          widget: {
+            id: 'sample_plugin_course_list',
+            type: DIRECT_PLUGIN,
+            priority: 50,
+            RenderWidget: CourseList,
+          },
+        }""",
+    ))