Skip to content

An edx-platform plugin for managing user notices and user interactions with them.

License

Notifications You must be signed in to change notification settings

edx/platform-plugin-notices

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

platform-plugin-notices

PyPI CI Codecov Documentation Supported Python versions License

This repo is not currently accepting open source contributions

Overview

This plugin for edx-platform manages notices that a user must acknowledge. It only stores the content of the notices and whether a user has acknowledged them. Presentation and other client side decisions will be left to the frontends that utilize these APIs.

This Django app contains notices that a user must acknowledge before continuing to use the site. This app will have two API endpoints to facilitate that: 1. An endpoint to return links to all notices that the user hasn't acknowledged. 2. An endpoint to acknowledge that a user has seen the notice. This endpoint's URL will be passed to the client via the first endpoint.

Documentation

(TODO: Set up documentation)

Developing in Devstack

Make sure the LMS container is running in Devstack, then

git clone git@github.com:edx/platform-plugin-notices.git <devstack_folder>/src
cd <devstack_folder>/devstack
make dev.shell.lms
pip install -e /edx/src/platform-plugin-notices
cd /edx/app/edxapp/edx-platform
./manage.py lms migrate

Once that is done, LMS will pickup the plugin and saves to existing files should cause a devserver restart with your changes. Occasionally when adding a new file, you may need to restart the LMS container in order for it to pickup the changes.

Enabling the Notices Plugin in the LMS

The Notices plugin functionality is enabled via use of a waffle flag. After installation of the plugin you need to do the following in devstack:

  1. Log into the LMS Django Admin (http://localhost:18000/admin/)
  2. Add a new waffle flag (http://localhost:18000/admin/waffle/flag/add/)
  3. Name the waffle flag notices.enable_notices
  4. Set Everyone to Yes
  5. Save the waffle flag.

License

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

Please see LICENSE.txt for details.

How To Contribute

This repo is not currently accepting open source contributions

Reporting Security Issues

Please do not report security issues in public. Please email security@edx.org.

Support

If you're having trouble, we have discussion forums at https://discuss.openedx.org where you can connect with others in the community.

Our real-time conversations are on Slack. You can request a Slack invitation, then join our community Slack workspace.

For more information about these options, see the Getting Help page.