Welcome to Open edX Events’ documentation!

Open edX Events is type of hook in the Hooks Extension Framework that allows extending the Open edX platform in a more stable and maintainable way. If you’re new to this approach for extending Open edX, start by reading the Hooks Extension Framework documentation. This documentation provides an overview of the framework’s concepts and structure useful to support your adoption of Open edX Events.

Contents:

• Concepts
  • Open edX Events
  • Open edX Event Bus
• Architectural Decision Records (ADRs)
  • 1. Purpose of this Repo
  • 2. Open edX events naming and versioning
  • 3. Open edX events payload conventions
  • 4. External event bus and Django Signal events
  • 5. External Event Schema Format
  • 6. Event schema serialization and evolution
  • 7. Optional fields in events
  • 8. Event signals with PII
  • 9. Event design of the COURSE_CATALOG_INFO_CHANGED signal
  • 10. Multiple event types per topic
  • 11. Depending on multiple event bus implementations
  • 12. Enable producing to event bus via settings
  • 13. Event definitions for special exam post-submission and review
  • 14. Change event producer config settings
  • 15. Outbox pattern and production modes
  • 16. Event Design Best Practices
• How-tos
  • Create a New Open edX Event with Long-Term Support
  • Consume an Open edX Event
  • Add Event Bus Support to an Open edX Event
  • Use the Open edX Event Bus to Broadcast and Consume Events
  • Use the Open edX Event Bus
  • Add a New Concrete Implementation of the Event Bus
• Quickstarts
  • Using Open edX Events in the LMS service
• References
  • Open edX Events Tooling
  • Open edX Events Data Attributes
  • Events
  • In-line Code Annotations for An Open edX Event
  • Open edX Events Glossary
  • Event Bus Configuration
  • Open edX Proposals
  • Architecture Subdomains
  • Real-Life Use Cases for Open edX Events