Skip to main content

Getting started

info

Disclaimer

This documentation is in its early stages and may contain incomplete or unclear sections. Your feedback, suggestions, or corrections are highly appreciated to help us improve its clarity and usefulness.

If you have any questions or concerns, please don’t hesitate to reach out to us at: developer@photon.education

Classwise Cross-platform Integration​

The Classwise Cross-platform Integration enables seamless incorporation of Classwise's interactive quiz functionality into third-party educational platforms. This integration allows partners to enhance their existing educational software with Classwise's real-time classroom engagement features without requiring users to manually switch between different applications.

Why We created this integration​

Educational technology platforms often need to provide interactive assessment capabilities while maintaining a consistent user experience. Rather than building these features from scratch, partners can leverage Classwise's proven quiz system through this integration. This approach offers several benefits:

  • Seamless user experience within the partner's platform
  • Access to Classwise's specialized classroom interaction features
  • Real-time student engagement and feedback
  • Comprehensive analytics and result tracking

Integration approach​

The integration is built on modern web technologies and follows these key principles:

  • Browser-based communication using the window.postMessage API
  • Secure authentication through JWT tokens
  • Flexible deployment options (iframe or new tab)
  • Real-time data exchange for quiz content and results

This documentation provides comprehensive technical guidance for implementing the Classwise Cross-platform Integration, including authentication, content delivery, and result handling. Whether you're building a new integration or maintaining an existing one, you'll find detailed information about all aspects of the integration process.

Integration Modes​

Classwise supports two integration modes:

1. Standard Mode​

This mode provides full access to platform features and a persistent user profile. Users can access their Classwise account through two authentication methods:

a. Manual Login​

Users log in manually to their Classwise account. This method is suitable for platforms that don't require authentication.

Features:

  • Traditional login experience
  • Full access to Classwise features
  • Persistent user profile
  • Manual authentication process

Users are automatically logged in to Classwise through account linking between the partner platform and Classwise. This provides a seamless experience as login happens automatically after the initial account linking.

Recommended: This option is suggested for most integrations, as it provides the best user experience while maintaining all functionality.

Features:

  • Automatic authentication after initial setup
  • Seamless integration between platforms
  • All Classwise features accessible
  • No manual login required after initial linking

Common Advantages for Both Methods:

  • Complete activity history and performance tracking
  • Access to advanced analytics and insights
  • Persistent user profiles
  • Full Classwise feature availability

2. Anonymous Mode​

The user does not need to log in to Classwise. This mode allows quick access to quizzes and activities without creating an account. It is ideal for guests and temporary sessions, with no persistent user profile.

Key Benefits:

  • No account creation required
  • Quick setup and deployment
  • Privacy-focused approach
  • Ideal for temporary assessments

Important: In Anonymous Mode, Classwise does not store any data about completed activities or participating students. As a result, teachers lose access to their activity history and cannot analyze results within Classwise.

note

Anonymous vs. Standard Modes

  • Anonymous Mode: Temporary access, no persistent user data, simplified onboarding
  • Standard Mode: Persistent user profiles, full feature access, cross-session continuity

Choose the method that best fits your use case and user preferences.