346 lines
15 KiB
Python
346 lines
15 KiB
Python
"""
|
|
Views for the course_mode module
|
|
"""
|
|
|
|
import decimal
|
|
import json
|
|
import urllib
|
|
|
|
import waffle
|
|
from babel.dates import format_datetime
|
|
from django.contrib.auth.decorators import login_required
|
|
from django.urls import reverse
|
|
from django.db import transaction
|
|
from django.http import HttpResponse, HttpResponseBadRequest
|
|
from django.shortcuts import redirect
|
|
from django.utils.decorators import method_decorator
|
|
from django.utils.translation import ugettext as _
|
|
from django.utils.translation import get_language, to_locale
|
|
from django.views.generic.base import View
|
|
from ipware.ip import get_ip
|
|
from opaque_keys.edx.keys import CourseKey
|
|
from six import text_type
|
|
|
|
from course_modes.models import CourseMode
|
|
from courseware.access import has_access
|
|
from edxmako.shortcuts import render_to_response
|
|
from lms.djangoapps.commerce.utils import EcommerceService
|
|
from lms.djangoapps.experiments.utils import get_experiment_user_metadata_context
|
|
from openedx.core.djangoapps.catalog.utils import get_currency_data
|
|
from openedx.core.djangoapps.embargo import api as embargo_api
|
|
from student.models import CourseEnrollment
|
|
from util.db import outer_atomic
|
|
from xmodule.modulestore.django import modulestore
|
|
|
|
|
|
class ChooseModeView(View):
|
|
"""View used when the user is asked to pick a mode.
|
|
|
|
When a get request is used, shows the selection page.
|
|
|
|
When a post request is used, assumes that it is a form submission
|
|
from the selection page, parses the response, and then sends user
|
|
to the next step in the flow.
|
|
|
|
"""
|
|
|
|
@method_decorator(transaction.non_atomic_requests)
|
|
def dispatch(self, *args, **kwargs):
|
|
"""Disable atomicity for the view.
|
|
|
|
Otherwise, we'd be unable to commit to the database until the
|
|
request had concluded; Django will refuse to commit when an
|
|
atomic() block is active, since that would break atomicity.
|
|
|
|
"""
|
|
return super(ChooseModeView, self).dispatch(*args, **kwargs)
|
|
|
|
@method_decorator(login_required)
|
|
@method_decorator(transaction.atomic)
|
|
def get(self, request, course_id, error=None):
|
|
"""Displays the course mode choice page.
|
|
|
|
Args:
|
|
request (`Request`): The Django Request object.
|
|
course_id (unicode): The slash-separated course key.
|
|
|
|
Keyword Args:
|
|
error (unicode): If provided, display this error message
|
|
on the page.
|
|
|
|
Returns:
|
|
Response
|
|
|
|
"""
|
|
course_key = CourseKey.from_string(course_id)
|
|
|
|
# Check whether the user has access to this course
|
|
# based on country access rules.
|
|
embargo_redirect = embargo_api.redirect_if_blocked(
|
|
course_key,
|
|
user=request.user,
|
|
ip_address=get_ip(request),
|
|
url=request.path
|
|
)
|
|
if embargo_redirect:
|
|
return redirect(embargo_redirect)
|
|
|
|
enrollment_mode, is_active = CourseEnrollment.enrollment_mode_for_user(request.user, course_key)
|
|
modes = CourseMode.modes_for_course_dict(course_key)
|
|
ecommerce_service = EcommerceService()
|
|
|
|
# We assume that, if 'professional' is one of the modes, it should be the *only* mode.
|
|
# If there are both modes, default to non-id-professional.
|
|
has_enrolled_professional = (CourseMode.is_professional_slug(enrollment_mode) and is_active)
|
|
if CourseMode.has_professional_mode(modes) and not has_enrolled_professional:
|
|
purchase_workflow = request.GET.get("purchase_workflow", "single")
|
|
verify_url = reverse('verify_student_start_flow', kwargs={'course_id': unicode(course_key)})
|
|
redirect_url = "{url}?purchase_workflow={workflow}".format(url=verify_url, workflow=purchase_workflow)
|
|
if ecommerce_service.is_enabled(request.user):
|
|
professional_mode = modes.get(CourseMode.NO_ID_PROFESSIONAL_MODE) or modes.get(CourseMode.PROFESSIONAL)
|
|
if purchase_workflow == "single" and professional_mode.sku:
|
|
redirect_url = ecommerce_service.get_checkout_page_url(professional_mode.sku)
|
|
if purchase_workflow == "bulk" and professional_mode.bulk_sku:
|
|
redirect_url = ecommerce_service.get_checkout_page_url(professional_mode.bulk_sku)
|
|
return redirect(redirect_url)
|
|
|
|
course = modulestore().get_course(course_key)
|
|
|
|
# If there isn't a verified mode available, then there's nothing
|
|
# to do on this page. Send the user to the dashboard.
|
|
if not CourseMode.has_verified_mode(modes):
|
|
return redirect(reverse('dashboard'))
|
|
|
|
# If a user has already paid, redirect them to the dashboard.
|
|
if is_active and (enrollment_mode in CourseMode.VERIFIED_MODES + [CourseMode.NO_ID_PROFESSIONAL_MODE]):
|
|
# If the course has started redirect to course home instead
|
|
if course.has_started():
|
|
return redirect(reverse('openedx.course_experience.course_home', kwargs={'course_id': course_key}))
|
|
return redirect(reverse('dashboard'))
|
|
|
|
donation_for_course = request.session.get("donation_for_course", {})
|
|
chosen_price = donation_for_course.get(unicode(course_key), None)
|
|
|
|
if CourseEnrollment.is_enrollment_closed(request.user, course):
|
|
locale = to_locale(get_language())
|
|
enrollment_end_date = format_datetime(course.enrollment_end, 'short', locale=locale)
|
|
params = urllib.urlencode({'course_closed': enrollment_end_date})
|
|
return redirect('{0}?{1}'.format(reverse('dashboard'), params))
|
|
|
|
# When a credit mode is available, students will be given the option
|
|
# to upgrade from a verified mode to a credit mode at the end of the course.
|
|
# This allows students who have completed photo verification to be eligible
|
|
# for univerity credit.
|
|
# Since credit isn't one of the selectable options on the track selection page,
|
|
# we need to check *all* available course modes in order to determine whether
|
|
# a credit mode is available. If so, then we show slightly different messaging
|
|
# for the verified track.
|
|
has_credit_upsell = any(
|
|
CourseMode.is_credit_mode(mode) for mode
|
|
in CourseMode.modes_for_course(course_key, only_selectable=False)
|
|
)
|
|
course_id = text_type(course_key)
|
|
context = {
|
|
"course_modes_choose_url": reverse(
|
|
"course_modes_choose",
|
|
kwargs={'course_id': course_id}
|
|
),
|
|
"modes": modes,
|
|
"has_credit_upsell": has_credit_upsell,
|
|
"course_name": course.display_name_with_default_escaped,
|
|
"course_org": course.display_org_with_default,
|
|
"course_num": course.display_number_with_default,
|
|
"chosen_price": chosen_price,
|
|
"error": error,
|
|
"responsive": True,
|
|
"nav_hidden": True,
|
|
}
|
|
context.update(
|
|
get_experiment_user_metadata_context(
|
|
course,
|
|
request.user,
|
|
)
|
|
)
|
|
|
|
title_content = _("Congratulations! You are now enrolled in {course_name}").format(
|
|
course_name=course.display_name_with_default_escaped
|
|
)
|
|
|
|
context["title_content"] = title_content
|
|
|
|
if "verified" in modes:
|
|
verified_mode = modes["verified"]
|
|
context["suggested_prices"] = [
|
|
decimal.Decimal(x.strip())
|
|
for x in verified_mode.suggested_prices.split(",")
|
|
if x.strip()
|
|
]
|
|
context["currency"] = verified_mode.currency.upper()
|
|
context["min_price"] = verified_mode.min_price
|
|
context["verified_name"] = verified_mode.name
|
|
context["verified_description"] = verified_mode.description
|
|
|
|
if verified_mode.sku:
|
|
context["use_ecommerce_payment_flow"] = ecommerce_service.is_enabled(request.user)
|
|
context["ecommerce_payment_page"] = ecommerce_service.payment_page_url()
|
|
context["sku"] = verified_mode.sku
|
|
context["bulk_sku"] = verified_mode.bulk_sku
|
|
|
|
context['currency_data'] = []
|
|
if waffle.switch_is_active('local_currency'):
|
|
if 'edx-price-l10n' not in request.COOKIES:
|
|
currency_data = get_currency_data()
|
|
try:
|
|
context['currency_data'] = json.dumps(currency_data)
|
|
except TypeError:
|
|
pass
|
|
return render_to_response("course_modes/choose.html", context)
|
|
|
|
@method_decorator(transaction.non_atomic_requests)
|
|
@method_decorator(login_required)
|
|
@method_decorator(outer_atomic(read_committed=True))
|
|
def post(self, request, course_id):
|
|
"""Takes the form submission from the page and parses it.
|
|
|
|
Args:
|
|
request (`Request`): The Django Request object.
|
|
course_id (unicode): The slash-separated course key.
|
|
|
|
Returns:
|
|
Status code 400 when the requested mode is unsupported. When the honor mode
|
|
is selected, redirects to the dashboard. When the verified mode is selected,
|
|
returns error messages if the indicated contribution amount is invalid or
|
|
below the minimum, otherwise redirects to the verification flow.
|
|
|
|
"""
|
|
course_key = CourseKey.from_string(course_id)
|
|
user = request.user
|
|
|
|
# This is a bit redundant with logic in student.views.change_enrollment,
|
|
# but I don't really have the time to refactor it more nicely and test.
|
|
course = modulestore().get_course(course_key)
|
|
if not has_access(user, 'enroll', course):
|
|
error_msg = _("Enrollment is closed")
|
|
return self.get(request, course_id, error=error_msg)
|
|
|
|
requested_mode = self._get_requested_mode(request.POST)
|
|
|
|
allowed_modes = CourseMode.modes_for_course_dict(course_key)
|
|
if requested_mode not in allowed_modes:
|
|
return HttpResponseBadRequest(_("Enrollment mode not supported"))
|
|
|
|
if requested_mode == 'audit':
|
|
# If the learner has arrived at this screen via the traditional enrollment workflow,
|
|
# then they should already be enrolled in an audit mode for the course, assuming one has
|
|
# been configured. However, alternative enrollment workflows have been introduced into the
|
|
# system, such as third-party discovery. These workflows result in learners arriving
|
|
# directly at this screen, and they will not necessarily be pre-enrolled in the audit mode.
|
|
CourseEnrollment.enroll(request.user, course_key, CourseMode.AUDIT)
|
|
# If the course has started redirect to course home instead
|
|
if course.has_started():
|
|
return redirect(reverse('openedx.course_experience.course_home', kwargs={'course_id': course_key}))
|
|
return redirect(reverse('dashboard'))
|
|
|
|
if requested_mode == 'honor':
|
|
CourseEnrollment.enroll(user, course_key, mode=requested_mode)
|
|
# If the course has started redirect to course home instead
|
|
if course.has_started():
|
|
return redirect(reverse('openedx.course_experience.course_home', kwargs={'course_id': course_key}))
|
|
return redirect(reverse('dashboard'))
|
|
|
|
mode_info = allowed_modes[requested_mode]
|
|
|
|
if requested_mode == 'verified':
|
|
amount = request.POST.get("contribution") or \
|
|
request.POST.get("contribution-other-amt") or 0
|
|
|
|
try:
|
|
# Validate the amount passed in and force it into two digits
|
|
amount_value = decimal.Decimal(amount).quantize(decimal.Decimal('.01'), rounding=decimal.ROUND_DOWN)
|
|
except decimal.InvalidOperation:
|
|
error_msg = _("Invalid amount selected.")
|
|
return self.get(request, course_id, error=error_msg)
|
|
|
|
# Check for minimum pricing
|
|
if amount_value < mode_info.min_price:
|
|
error_msg = _("No selected price or selected price is too low.")
|
|
return self.get(request, course_id, error=error_msg)
|
|
|
|
donation_for_course = request.session.get("donation_for_course", {})
|
|
donation_for_course[unicode(course_key)] = amount_value
|
|
request.session["donation_for_course"] = donation_for_course
|
|
|
|
return redirect(
|
|
reverse(
|
|
'verify_student_start_flow',
|
|
kwargs={'course_id': unicode(course_key)}
|
|
)
|
|
)
|
|
|
|
def _get_requested_mode(self, request_dict):
|
|
"""Get the user's requested mode
|
|
|
|
Args:
|
|
request_dict (`QueryDict`): A dictionary-like object containing all given HTTP POST parameters.
|
|
|
|
Returns:
|
|
The course mode slug corresponding to the choice in the POST parameters,
|
|
None if the choice in the POST parameters is missing or is an unsupported mode.
|
|
|
|
"""
|
|
if 'verified_mode' in request_dict:
|
|
return 'verified'
|
|
if 'honor_mode' in request_dict:
|
|
return 'honor'
|
|
if 'audit_mode' in request_dict:
|
|
return 'audit'
|
|
else:
|
|
return None
|
|
|
|
|
|
def create_mode(request, course_id):
|
|
"""Add a mode to the course corresponding to the given course ID.
|
|
|
|
Only available when settings.FEATURES['MODE_CREATION_FOR_TESTING'] is True.
|
|
|
|
Attempts to use the following querystring parameters from the request:
|
|
`mode_slug` (str): The mode to add, either 'honor', 'verified', or 'professional'
|
|
`mode_display_name` (str): Describes the new course mode
|
|
`min_price` (int): The minimum price a user must pay to enroll in the new course mode
|
|
`suggested_prices` (str): Comma-separated prices to suggest to the user.
|
|
`currency` (str): The currency in which to list prices.
|
|
`sku` (str): The product SKU value.
|
|
|
|
By default, this endpoint will create an 'honor' mode for the given course with display name
|
|
'Honor Code', a minimum price of 0, no suggested prices, and using USD as the currency.
|
|
|
|
Args:
|
|
request (`Request`): The Django Request object.
|
|
course_id (unicode): A course ID.
|
|
|
|
Returns:
|
|
Response
|
|
"""
|
|
PARAMETERS = {
|
|
'mode_slug': u'honor',
|
|
'mode_display_name': u'Honor Code Certificate',
|
|
'min_price': 0,
|
|
'suggested_prices': u'',
|
|
'currency': u'usd',
|
|
'sku': None,
|
|
}
|
|
|
|
# Try pulling querystring parameters out of the request
|
|
for parameter, default in PARAMETERS.iteritems():
|
|
PARAMETERS[parameter] = request.GET.get(parameter, default)
|
|
|
|
# Attempt to create the new mode for the given course
|
|
course_key = CourseKey.from_string(course_id)
|
|
CourseMode.objects.get_or_create(course_id=course_key, **PARAMETERS)
|
|
|
|
# Return a success message and a 200 response
|
|
return HttpResponse("Mode '{mode_slug}' created for '{course}'.".format(
|
|
mode_slug=PARAMETERS['mode_slug'],
|
|
course=course_id
|
|
))
|