section-to-course 0.4.3

Purpose

Allows course authors to factor sections from Open edX courses into their own new course.

Installation

This application is not yet available on PyPI, so you will need to install it from source. You can install it from source on the current main branch by adding:

git+https://github.com/open-craft/section-to-course.git

…to the requirements/private.txt file of your Open edX installation, and then run pip install -r requirements/private.txt. If you’re developing locally without the platform, create a virtualenv using the latest Python 3.8 release, and then run pip install -e . from the root of this repository.

git remote add open-craft git@github.com:open-craft/edx-platform.git
git fetch open-craft
git checkout open-craft/opencraft-release/nutmeg.2

git clone git@github.com:open-craft/section-to-course.git

make dev.shell.studio
cd /edx/src/section-to-course
pip install -e .

Configuration (optional)

New courses are self-paced. If you want to set relative deadlines in them, follow the next steps:

1. Add the following Waffle Flags (with Everyone: Yes) in Django admin:

   1. studio.custom_relative_dates

   2. course_experience.relative_dates

   3. course_experience.relative_dates_disable_reset

2. Go to Django admin -> Course_Date_Signals -> Self paced relative dates configs and add a config with Enabled: Yes.

Usage

Once installed, the plugin should automatically register itself within Django. Be sure to run database migrations.

The admin views are in the Django admin, under the “Section to Course” section. From there, you can create a new section to course link, which will create a new course with the same content as the section you selected. You can also view the list of existing section to course links, refresh them, and delete them.

Note: The start date of a newly created course is in the future, so you will likely want to modify it in the “Schedule & Details” section in Studio.

Refreshing a Course

There are two ways to refresh a course:

1. Use the admin action from the changelist view. This will allow you to refresh several courses at once.

2. Use the refresh button on the detail view for a single course, shown here:

License

The code in this repository is licensed under the AGPL 3.0.

Please see LICENSE.txt for details.

Contributing

Contributions are very welcome.

This project is currently accepting all types of contributions, bug fixes, security fixes, maintenance work, or new features. However, please make sure to have a discussion about your new feature idea with the maintainers prior to beginning development to maximize the chances of your change being accepted. You can start a conversation by creating a new issue on this repo summarizing your idea.

Reporting Security Issues

Please do not report security issues in public. Please email help@opencraft.com.

Unreleased

[0.4.3] - 2024-02-21

Fixed

• Compatibility of compat imports with post Quince releases.

[0.4.2] - 2023-11-15

[0.4.1] - 2023-11-07

Fixed

• Compatibility of compat imports with Palm.

[0.4.0] - 2023-05-18

[0.3.0] - 2023-05-12

Changed

• New section-based courses are self-paced.

[0.2.0] - 2023-05-10

Added

• Admin views for creating new section-based courses.

• First release on PyPI.

[0.1.0] - 2023-04-03

Added

• Initial section-derived course creation code.