d1a775d3cd
* Use full LMS imports paths in LMS settings and urls modules * Use full LMS import paths in Studio settings and urls modules * Import from lms.djangoapps.badges instead of badges * Import from lms.djangoapps.branding instead of branding * Import from lms.djangoapps.bulk_email instead of bulk_email * Import from lms.djangoapps.bulk_enroll instead of bulk_enroll * Import from lms.djangoapps.ccx instead of ccx * Import from lms.djangoapps.course_api instead of course_api * Import from lms.djangoapps.course_blocks instead of course_blocks * Import from lms.djangoapps.course_wiki instead of course_wiki * Import from lms.djangoapps.courseware instead of courseware * Import from lms.djangoapps.dashboard instead of dashboard * Import from lms.djangoapps.discussion import discussion * Import from lms.djangoapps.email_marketing instead of email_marketing * Import from lms.djangoapps.experiments instead of experiments * Import from lms.djangoapps.gating instead of gating * Import from lms.djangoapps.grades instead of grades * Import from lms.djangoapps.instructor_analytics instead of instructor_analytics * Import form lms.djangoapps.lms_xblock instead of lms_xblock * Import from lms.djangoapps.lti_provider instead of lti_provider * Import from lms.djangoapps.mobile_api instead of mobile_api * Import from lms.djangoapps.rss_proxy instead of rss_proxy * Import from lms.djangoapps.static_template_view instead of static_template_view * Import from lms.djangoapps.survey instead of survey * Import from lms.djangoapps.verify_student instead of verify_student * Stop suppressing EdxPlatformDeprecatedImportWarnings
64 lines
2.2 KiB
Python
64 lines
2.2 KiB
Python
"""
|
|
Utilities for determining whether or not a survey needs to be completed.
|
|
"""
|
|
|
|
from django.utils.translation import ugettext as _
|
|
|
|
from lms.djangoapps.courseware.access import has_access
|
|
from lms.djangoapps.courseware.access_response import AccessError
|
|
from lms.djangoapps.courseware.access_utils import ACCESS_GRANTED
|
|
from lms.djangoapps.survey.models import SurveyAnswer, SurveyForm
|
|
|
|
|
|
class SurveyRequiredAccessError(AccessError):
|
|
"""
|
|
Access denied because the user has not completed a required survey
|
|
"""
|
|
def __init__(self):
|
|
error_code = "survey_required"
|
|
developer_message = u"User must complete a survey"
|
|
user_message = _(u"You must complete a survey")
|
|
super(SurveyRequiredAccessError, self).__init__(error_code, developer_message, user_message)
|
|
|
|
|
|
def is_survey_required_for_course(course_descriptor):
|
|
"""
|
|
Returns whether a Survey is required for this course
|
|
"""
|
|
|
|
# Check to see that the survey is required in the CourseDescriptor.
|
|
if not getattr(course_descriptor, 'course_survey_required', False):
|
|
return SurveyRequiredAccessError()
|
|
|
|
# Check that the specified Survey for the course exists.
|
|
return SurveyForm.get(course_descriptor.course_survey_name, throw_if_not_found=False)
|
|
|
|
|
|
def check_survey_required_and_unanswered(user, course_descriptor):
|
|
"""
|
|
Checks whether a user is required to answer the survey and has yet to do so.
|
|
|
|
Returns:
|
|
AccessResponse: Either ACCESS_GRANTED or SurveyRequiredAccessError.
|
|
"""
|
|
|
|
if not is_survey_required_for_course(course_descriptor):
|
|
return ACCESS_GRANTED
|
|
|
|
# anonymous users do not need to answer the survey
|
|
if user.is_anonymous:
|
|
return ACCESS_GRANTED
|
|
|
|
# course staff do not need to answer survey
|
|
has_staff_access = has_access(user, 'staff', course_descriptor)
|
|
if has_staff_access:
|
|
return ACCESS_GRANTED
|
|
|
|
# survey is required and it exists, let's see if user has answered the survey
|
|
survey = SurveyForm.get(course_descriptor.course_survey_name)
|
|
answered_survey = SurveyAnswer.do_survey_answers_exist(survey, user)
|
|
if answered_survey:
|
|
return ACCESS_GRANTED
|
|
|
|
return SurveyRequiredAccessError()
|