822 lines
31 KiB
Python
822 lines
31 KiB
Python
from collections import defaultdict
|
|
from datetime import datetime
|
|
import json
|
|
import logging
|
|
from django.conf import settings
|
|
|
|
import pytz
|
|
from django.contrib.auth.models import User
|
|
from django.core.urlresolvers import reverse
|
|
from django.db import connection
|
|
from django.http import HttpResponse
|
|
from django.utils.timezone import UTC
|
|
import pystache_custom as pystache
|
|
from opaque_keys.edx.locations import i4xEncoder
|
|
from opaque_keys.edx.keys import CourseKey
|
|
from xmodule.modulestore.django import modulestore
|
|
from lms.djangoapps.ccx.overrides import get_current_ccx
|
|
|
|
from django_comment_common.models import Role, FORUM_ROLE_STUDENT
|
|
from django_comment_client.permissions import check_permissions_by_view, has_permission, get_team
|
|
from django_comment_client.settings import MAX_COMMENT_DEPTH
|
|
from edxmako import lookup_template
|
|
|
|
from courseware import courses
|
|
from courseware.access import has_access
|
|
from openedx.core.djangoapps.content.course_structures.models import CourseStructure
|
|
from openedx.core.djangoapps.course_groups.cohorts import (
|
|
get_course_cohort_settings, get_cohort_by_id, get_cohort_id, is_course_cohorted
|
|
)
|
|
from openedx.core.djangoapps.course_groups.models import CourseUserGroup
|
|
|
|
|
|
log = logging.getLogger(__name__)
|
|
|
|
|
|
def extract(dic, keys):
|
|
"""
|
|
Returns a subset of keys from the provided dictionary
|
|
"""
|
|
return {k: dic.get(k) for k in keys}
|
|
|
|
|
|
def strip_none(dic):
|
|
"""
|
|
Returns a dictionary stripped of any keys having values of None
|
|
"""
|
|
return dict([(k, v) for k, v in dic.iteritems() if v is not None])
|
|
|
|
|
|
def strip_blank(dic):
|
|
"""
|
|
Returns a dictionary stripped of any 'blank' (empty) keys
|
|
"""
|
|
def _is_blank(v):
|
|
"""
|
|
Determines if the provided value contains no information
|
|
"""
|
|
return isinstance(v, str) and len(v.strip()) == 0
|
|
return dict([(k, v) for k, v in dic.iteritems() if not _is_blank(v)])
|
|
|
|
# TODO should we be checking if d1 and d2 have the same keys with different values?
|
|
|
|
|
|
def merge_dict(dic1, dic2):
|
|
"""
|
|
Combines the keys from the two provided dictionaries
|
|
"""
|
|
return dict(dic1.items() + dic2.items())
|
|
|
|
|
|
def get_role_ids(course_id):
|
|
"""
|
|
Returns a dictionary having role names as keys and a list of users as values
|
|
"""
|
|
roles = Role.objects.filter(course_id=course_id).exclude(name=FORUM_ROLE_STUDENT)
|
|
return dict([(role.name, list(role.users.values_list('id', flat=True))) for role in roles])
|
|
|
|
|
|
def has_discussion_privileges(user, course_id):
|
|
"""
|
|
Returns True if the user is privileged in teams discussions for
|
|
this course. The user must be one of Discussion Admin, Moderator,
|
|
or Community TA.
|
|
|
|
Args:
|
|
user (User): The user to check privileges for.
|
|
course_id (CourseKey): A key for the course to check privileges for.
|
|
|
|
Returns:
|
|
bool
|
|
"""
|
|
# get_role_ids returns a dictionary of only admin, moderator and community TAs.
|
|
roles = get_role_ids(course_id)
|
|
for role in roles:
|
|
if user.id in roles[role]:
|
|
return True
|
|
return False
|
|
|
|
|
|
def has_forum_access(uname, course_id, rolename):
|
|
"""
|
|
Boolean operation which tests a user's role-based permissions (not actually forums-specific)
|
|
"""
|
|
try:
|
|
role = Role.objects.get(name=rolename, course_id=course_id)
|
|
except Role.DoesNotExist:
|
|
return False
|
|
return role.users.filter(username=uname).exists()
|
|
|
|
|
|
def has_required_keys(module):
|
|
"""
|
|
Returns True iff module has the proper attributes for generating metadata
|
|
with get_discussion_id_map_entry()
|
|
"""
|
|
for key in ('discussion_id', 'discussion_category', 'discussion_target'):
|
|
if getattr(module, key, None) is None:
|
|
log.debug(
|
|
"Required key '%s' not in discussion %s, leaving out of category map",
|
|
key,
|
|
module.location
|
|
)
|
|
return False
|
|
return True
|
|
|
|
|
|
def get_accessible_discussion_modules(course, user, include_all=False): # pylint: disable=invalid-name
|
|
"""
|
|
Return a list of all valid discussion modules in this course that
|
|
are accessible to the given user.
|
|
"""
|
|
all_modules = modulestore().get_items(course.id, qualifiers={'category': 'discussion'}, include_orphans=False)
|
|
|
|
return [
|
|
module for module in all_modules
|
|
if has_required_keys(module) and (include_all or has_access(user, 'load', module, course.id))
|
|
]
|
|
|
|
|
|
def get_discussion_id_map_entry(module):
|
|
"""
|
|
Returns a tuple of (discussion_id, metadata) suitable for inclusion in the results of get_discussion_id_map().
|
|
"""
|
|
return (
|
|
module.discussion_id,
|
|
{
|
|
"location": module.location,
|
|
"title": module.discussion_category.split("/")[-1].strip() + " / " + module.discussion_target
|
|
}
|
|
)
|
|
|
|
|
|
class DiscussionIdMapIsNotCached(Exception):
|
|
"""Thrown when the discussion id map is not cached for this course, but an attempt was made to access it."""
|
|
pass
|
|
|
|
|
|
def get_cached_discussion_key(course, discussion_id):
|
|
"""
|
|
Returns the usage key of the discussion module associated with discussion_id if it is cached. If the discussion id
|
|
map is cached but does not contain discussion_id, returns None. If the discussion id map is not cached for course,
|
|
raises a DiscussionIdMapIsNotCached exception.
|
|
"""
|
|
try:
|
|
cached_mapping = CourseStructure.objects.get(course_id=course.id).discussion_id_map
|
|
if not cached_mapping:
|
|
raise DiscussionIdMapIsNotCached()
|
|
return cached_mapping.get(discussion_id)
|
|
except CourseStructure.DoesNotExist:
|
|
raise DiscussionIdMapIsNotCached()
|
|
|
|
|
|
def get_cached_discussion_id_map(course, discussion_ids, user):
|
|
"""
|
|
Returns a dict mapping discussion_ids to respective discussion module metadata if it is cached and visible to the
|
|
user. If not, returns the result of get_discussion_id_map
|
|
"""
|
|
try:
|
|
entries = []
|
|
for discussion_id in discussion_ids:
|
|
key = get_cached_discussion_key(course, discussion_id)
|
|
if not key:
|
|
continue
|
|
module = modulestore().get_item(key)
|
|
if not (has_required_keys(module) and has_access(user, 'load', module, course.id)):
|
|
continue
|
|
entries.append(get_discussion_id_map_entry(module))
|
|
return dict(entries)
|
|
except DiscussionIdMapIsNotCached:
|
|
return get_discussion_id_map(course, user)
|
|
|
|
|
|
def get_discussion_id_map(course, user):
|
|
"""
|
|
Transform the list of this course's discussion modules (visible to a given user) into a dictionary of metadata keyed
|
|
by discussion_id.
|
|
"""
|
|
return dict(map(get_discussion_id_map_entry, get_accessible_discussion_modules(course, user)))
|
|
|
|
|
|
def _filter_unstarted_categories(category_map, course):
|
|
"""
|
|
Returns a subset of categories from the provided map which have not yet met the start date
|
|
Includes information about category children, subcategories (different), and entries
|
|
"""
|
|
now = datetime.now(UTC())
|
|
|
|
result_map = {}
|
|
|
|
unfiltered_queue = [category_map]
|
|
filtered_queue = [result_map]
|
|
|
|
while unfiltered_queue:
|
|
|
|
unfiltered_map = unfiltered_queue.pop()
|
|
filtered_map = filtered_queue.pop()
|
|
|
|
filtered_map["children"] = []
|
|
filtered_map["entries"] = {}
|
|
filtered_map["subcategories"] = {}
|
|
|
|
for child in unfiltered_map["children"]:
|
|
if child in unfiltered_map["entries"]:
|
|
if course.self_paced or unfiltered_map["entries"][child]["start_date"] <= now:
|
|
filtered_map["children"].append(child)
|
|
filtered_map["entries"][child] = {}
|
|
for key in unfiltered_map["entries"][child]:
|
|
if key != "start_date":
|
|
filtered_map["entries"][child][key] = unfiltered_map["entries"][child][key]
|
|
else:
|
|
log.debug(u"Filtering out:%s with start_date: %s", child, unfiltered_map["entries"][child]["start_date"])
|
|
else:
|
|
if course.self_paced or unfiltered_map["subcategories"][child]["start_date"] < now:
|
|
filtered_map["children"].append(child)
|
|
filtered_map["subcategories"][child] = {}
|
|
unfiltered_queue.append(unfiltered_map["subcategories"][child])
|
|
filtered_queue.append(filtered_map["subcategories"][child])
|
|
|
|
return result_map
|
|
|
|
|
|
def _sort_map_entries(category_map, sort_alpha):
|
|
"""
|
|
Internal helper method to list category entries according to the provided sort order
|
|
"""
|
|
things = []
|
|
for title, entry in category_map["entries"].items():
|
|
if entry["sort_key"] is None and sort_alpha:
|
|
entry["sort_key"] = title
|
|
things.append((title, entry))
|
|
for title, category in category_map["subcategories"].items():
|
|
things.append((title, category))
|
|
_sort_map_entries(category_map["subcategories"][title], sort_alpha)
|
|
category_map["children"] = [x[0] for x in sorted(things, key=lambda x: x[1]["sort_key"])]
|
|
|
|
|
|
def get_discussion_category_map(course, user, cohorted_if_in_list=False, exclude_unstarted=True):
|
|
"""
|
|
Transform the list of this course's discussion modules into a recursive dictionary structure. This is used
|
|
to render the discussion category map in the discussion tab sidebar for a given user.
|
|
|
|
Args:
|
|
course: Course for which to get the ids.
|
|
user: User to check for access.
|
|
cohorted_if_in_list (bool): If True, inline topics are marked is_cohorted only if they are
|
|
in course_cohort_settings.discussion_topics.
|
|
|
|
Example:
|
|
>>> example = {
|
|
>>> "entries": {
|
|
>>> "General": {
|
|
>>> "sort_key": "General",
|
|
>>> "is_cohorted": True,
|
|
>>> "id": "i4x-edx-eiorguegnru-course-foobarbaz"
|
|
>>> }
|
|
>>> },
|
|
>>> "children": ["General", "Getting Started"],
|
|
>>> "subcategories": {
|
|
>>> "Getting Started": {
|
|
>>> "subcategories": {},
|
|
>>> "children": [
|
|
>>> "Working with Videos",
|
|
>>> "Videos on edX"
|
|
>>> ],
|
|
>>> "entries": {
|
|
>>> "Working with Videos": {
|
|
>>> "sort_key": None,
|
|
>>> "is_cohorted": False,
|
|
>>> "id": "d9f970a42067413cbb633f81cfb12604"
|
|
>>> },
|
|
>>> "Videos on edX": {
|
|
>>> "sort_key": None,
|
|
>>> "is_cohorted": False,
|
|
>>> "id": "98d8feb5971041a085512ae22b398613"
|
|
>>> }
|
|
>>> }
|
|
>>> }
|
|
>>> }
|
|
>>> }
|
|
|
|
"""
|
|
unexpanded_category_map = defaultdict(list)
|
|
|
|
modules = get_accessible_discussion_modules(course, user)
|
|
|
|
course_cohort_settings = get_course_cohort_settings(course.id)
|
|
|
|
for module in modules:
|
|
id = module.discussion_id
|
|
title = module.discussion_target
|
|
sort_key = module.sort_key
|
|
category = " / ".join([x.strip() for x in module.discussion_category.split("/")])
|
|
# Handle case where module.start is None
|
|
entry_start_date = module.start if module.start else datetime.max.replace(tzinfo=pytz.UTC)
|
|
unexpanded_category_map[category].append({"title": title, "id": id, "sort_key": sort_key, "start_date": entry_start_date})
|
|
|
|
category_map = {"entries": defaultdict(dict), "subcategories": defaultdict(dict)}
|
|
for category_path, entries in unexpanded_category_map.items():
|
|
node = category_map["subcategories"]
|
|
path = [x.strip() for x in category_path.split("/")]
|
|
|
|
# Find the earliest start date for the entries in this category
|
|
category_start_date = None
|
|
for entry in entries:
|
|
if category_start_date is None or entry["start_date"] < category_start_date:
|
|
category_start_date = entry["start_date"]
|
|
|
|
for level in path[:-1]:
|
|
if level not in node:
|
|
node[level] = {"subcategories": defaultdict(dict),
|
|
"entries": defaultdict(dict),
|
|
"sort_key": level,
|
|
"start_date": category_start_date}
|
|
else:
|
|
if node[level]["start_date"] > category_start_date:
|
|
node[level]["start_date"] = category_start_date
|
|
node = node[level]["subcategories"]
|
|
|
|
level = path[-1]
|
|
if level not in node:
|
|
node[level] = {"subcategories": defaultdict(dict),
|
|
"entries": defaultdict(dict),
|
|
"sort_key": level,
|
|
"start_date": category_start_date}
|
|
else:
|
|
if node[level]["start_date"] > category_start_date:
|
|
node[level]["start_date"] = category_start_date
|
|
|
|
always_cohort_inline_discussions = ( # pylint: disable=invalid-name
|
|
not cohorted_if_in_list and course_cohort_settings.always_cohort_inline_discussions
|
|
)
|
|
dupe_counters = defaultdict(lambda: 0) # counts the number of times we see each title
|
|
for entry in entries:
|
|
is_entry_cohorted = (
|
|
course_cohort_settings.is_cohorted and (
|
|
always_cohort_inline_discussions or entry["id"] in course_cohort_settings.cohorted_discussions
|
|
)
|
|
)
|
|
|
|
title = entry["title"]
|
|
if node[level]["entries"][title]:
|
|
# If we've already seen this title, append an incrementing number to disambiguate
|
|
# the category from other categores sharing the same title in the course discussion UI.
|
|
dupe_counters[title] += 1
|
|
title = u"{title} ({counter})".format(title=title, counter=dupe_counters[title])
|
|
node[level]["entries"][title] = {"id": entry["id"],
|
|
"sort_key": entry["sort_key"],
|
|
"start_date": entry["start_date"],
|
|
"is_cohorted": is_entry_cohorted}
|
|
|
|
# TODO. BUG! : course location is not unique across multiple course runs!
|
|
# (I think Kevin already noticed this) Need to send course_id with requests, store it
|
|
# in the backend.
|
|
for topic, entry in course.discussion_topics.items():
|
|
category_map['entries'][topic] = {
|
|
"id": entry["id"],
|
|
"sort_key": entry.get("sort_key", topic),
|
|
"start_date": datetime.now(UTC()),
|
|
"is_cohorted": (course_cohort_settings.is_cohorted and
|
|
entry["id"] in course_cohort_settings.cohorted_discussions)
|
|
}
|
|
|
|
_sort_map_entries(category_map, course.discussion_sort_alpha)
|
|
|
|
return _filter_unstarted_categories(category_map, course) if exclude_unstarted else category_map
|
|
|
|
|
|
def discussion_category_id_access(course, user, discussion_id, module=None):
|
|
"""
|
|
Returns True iff the given discussion_id is accessible for user in course.
|
|
Assumes that the commentable identified by discussion_id has a null or 'course' context.
|
|
Uses the discussion id cache if available, falling back to
|
|
get_discussion_categories_ids if there is no cache.
|
|
"""
|
|
if discussion_id in course.top_level_discussion_topic_ids:
|
|
return True
|
|
try:
|
|
if not module:
|
|
key = get_cached_discussion_key(course, discussion_id)
|
|
if not key:
|
|
return False
|
|
module = modulestore().get_item(key)
|
|
return has_required_keys(module) and has_access(user, 'load', module, course.id)
|
|
except DiscussionIdMapIsNotCached:
|
|
return discussion_id in get_discussion_categories_ids(course, user)
|
|
|
|
|
|
def get_discussion_categories_ids(course, user, include_all=False):
|
|
"""
|
|
Returns a list of available ids of categories for the course that
|
|
are accessible to the given user.
|
|
|
|
Args:
|
|
course: Course for which to get the ids.
|
|
user: User to check for access.
|
|
include_all (bool): If True, return all ids. Used by configuration views.
|
|
|
|
"""
|
|
accessible_discussion_ids = [
|
|
module.discussion_id for module in get_accessible_discussion_modules(course, user, include_all=include_all)
|
|
]
|
|
return course.top_level_discussion_topic_ids + accessible_discussion_ids
|
|
|
|
|
|
class JsonResponse(HttpResponse):
|
|
"""
|
|
Django response object delivering JSON representations
|
|
"""
|
|
def __init__(self, data=None):
|
|
"""
|
|
Object constructor, converts data (if provided) to JSON
|
|
"""
|
|
content = json.dumps(data, cls=i4xEncoder)
|
|
super(JsonResponse, self).__init__(content,
|
|
content_type='application/json; charset=utf-8')
|
|
|
|
|
|
class JsonError(HttpResponse):
|
|
"""
|
|
Django response object delivering JSON exceptions
|
|
"""
|
|
def __init__(self, error_messages=[], status=400):
|
|
"""
|
|
Object constructor, returns an error response containing the provided exception messages
|
|
"""
|
|
if isinstance(error_messages, basestring):
|
|
error_messages = [error_messages]
|
|
content = json.dumps({'errors': error_messages}, indent=2, ensure_ascii=False)
|
|
super(JsonError, self).__init__(content,
|
|
content_type='application/json; charset=utf-8', status=status)
|
|
|
|
|
|
class HtmlResponse(HttpResponse):
|
|
"""
|
|
Django response object delivering HTML representations
|
|
"""
|
|
def __init__(self, html=''):
|
|
"""
|
|
Object constructor, brokers provided HTML to caller
|
|
"""
|
|
super(HtmlResponse, self).__init__(html, content_type='text/plain')
|
|
|
|
|
|
class ViewNameMiddleware(object):
|
|
"""
|
|
Django middleware object to inject view name into request context
|
|
"""
|
|
def process_view(self, request, view_func, view_args, view_kwargs):
|
|
"""
|
|
Injects the view name value into the request context
|
|
"""
|
|
request.view_name = view_func.__name__
|
|
|
|
|
|
class QueryCountDebugMiddleware(object):
|
|
"""
|
|
This middleware will log the number of queries run
|
|
and the total time taken for each request (with a
|
|
status code of 200). It does not currently support
|
|
multi-db setups.
|
|
"""
|
|
def process_response(self, request, response):
|
|
"""
|
|
Log information for 200 OK responses as part of the outbound pipeline
|
|
"""
|
|
if response.status_code == 200:
|
|
total_time = 0
|
|
|
|
for query in connection.queries:
|
|
query_time = query.get('time')
|
|
if query_time is None:
|
|
# django-debug-toolbar monkeypatches the connection
|
|
# cursor wrapper and adds extra information in each
|
|
# item in connection.queries. The query time is stored
|
|
# under the key "duration" rather than "time" and is
|
|
# in milliseconds, not seconds.
|
|
query_time = query.get('duration', 0) / 1000
|
|
total_time += float(query_time)
|
|
|
|
log.info(u'%s queries run, total %s seconds', len(connection.queries), total_time)
|
|
return response
|
|
|
|
|
|
def get_ability(course_id, content, user):
|
|
"""
|
|
Return a dictionary of forums-oriented actions and the user's permission to perform them
|
|
"""
|
|
return {
|
|
'editable': check_permissions_by_view(user, course_id, content, "update_thread" if content['type'] == 'thread' else "update_comment"),
|
|
'can_reply': check_permissions_by_view(user, course_id, content, "create_comment" if content['type'] == 'thread' else "create_sub_comment"),
|
|
'can_delete': check_permissions_by_view(user, course_id, content, "delete_thread" if content['type'] == 'thread' else "delete_comment"),
|
|
'can_openclose': check_permissions_by_view(user, course_id, content, "openclose_thread") if content['type'] == 'thread' else False,
|
|
'can_vote': not is_content_authored_by(content, user) and check_permissions_by_view(
|
|
user,
|
|
course_id,
|
|
content,
|
|
"vote_for_thread" if content['type'] == 'thread' else "vote_for_comment"
|
|
),
|
|
'can_report': not is_content_authored_by(content, user) and check_permissions_by_view(
|
|
user,
|
|
course_id,
|
|
content,
|
|
"flag_abuse_for_thread" if content['type'] == 'thread' else "flag_abuse_for_comment"
|
|
)
|
|
}
|
|
|
|
# TODO: RENAME
|
|
|
|
|
|
def get_annotated_content_info(course_id, content, user, user_info):
|
|
"""
|
|
Get metadata for an individual content (thread or comment)
|
|
"""
|
|
voted = ''
|
|
if content['id'] in user_info['upvoted_ids']:
|
|
voted = 'up'
|
|
elif content['id'] in user_info['downvoted_ids']:
|
|
voted = 'down'
|
|
return {
|
|
'voted': voted,
|
|
'subscribed': content['id'] in user_info['subscribed_thread_ids'],
|
|
'ability': get_ability(course_id, content, user),
|
|
}
|
|
|
|
# TODO: RENAME
|
|
|
|
|
|
def get_annotated_content_infos(course_id, thread, user, user_info):
|
|
"""
|
|
Get metadata for a thread and its children
|
|
"""
|
|
infos = {}
|
|
|
|
def annotate(content):
|
|
infos[str(content['id'])] = get_annotated_content_info(course_id, content, user, user_info)
|
|
for child in (
|
|
content.get('children', []) +
|
|
content.get('endorsed_responses', []) +
|
|
content.get('non_endorsed_responses', [])
|
|
):
|
|
annotate(child)
|
|
annotate(thread)
|
|
return infos
|
|
|
|
|
|
def get_metadata_for_threads(course_id, threads, user, user_info):
|
|
"""
|
|
Returns annotated content information for the specified course, threads, and user information
|
|
"""
|
|
|
|
def infogetter(thread):
|
|
return get_annotated_content_infos(course_id, thread, user, user_info)
|
|
|
|
metadata = reduce(merge_dict, map(infogetter, threads), {})
|
|
return metadata
|
|
|
|
# put this method in utils.py to avoid circular import dependency between helpers and mustache_helpers
|
|
|
|
|
|
def render_mustache(template_name, dictionary, *args, **kwargs):
|
|
template = lookup_template('main', template_name).source
|
|
return pystache.render(template, dictionary)
|
|
|
|
|
|
def permalink(content):
|
|
if isinstance(content['course_id'], CourseKey):
|
|
course_id = content['course_id'].to_deprecated_string()
|
|
else:
|
|
course_id = content['course_id']
|
|
if content['type'] == 'thread':
|
|
return reverse('django_comment_client.forum.views.single_thread',
|
|
args=[course_id, content['commentable_id'], content['id']])
|
|
else:
|
|
return reverse('django_comment_client.forum.views.single_thread',
|
|
args=[course_id, content['commentable_id'], content['thread_id']]) + '#' + content['id']
|
|
|
|
|
|
def extend_content(content):
|
|
roles = {}
|
|
if content.get('user_id'):
|
|
try:
|
|
user = User.objects.get(pk=content['user_id'])
|
|
roles = dict(('name', role.name.lower()) for role in user.roles.filter(course_id=content['course_id']))
|
|
except User.DoesNotExist:
|
|
log.error(
|
|
'User ID %s in comment content %s but not in our DB.',
|
|
content.get('user_id'),
|
|
content.get('id')
|
|
)
|
|
|
|
content_info = {
|
|
'displayed_title': content.get('highlighted_title') or content.get('title', ''),
|
|
'displayed_body': content.get('highlighted_body') or content.get('body', ''),
|
|
'permalink': permalink(content),
|
|
'roles': roles,
|
|
'updated': content['created_at'] != content['updated_at'],
|
|
}
|
|
return merge_dict(content, content_info)
|
|
|
|
|
|
def add_courseware_context(content_list, course, user, id_map=None):
|
|
"""
|
|
Decorates `content_list` with courseware metadata using the discussion id map cache if available.
|
|
"""
|
|
if id_map is None:
|
|
id_map = get_cached_discussion_id_map(
|
|
course,
|
|
[content['commentable_id'] for content in content_list],
|
|
user
|
|
)
|
|
|
|
for content in content_list:
|
|
commentable_id = content['commentable_id']
|
|
if commentable_id in id_map:
|
|
location = id_map[commentable_id]["location"].to_deprecated_string()
|
|
title = id_map[commentable_id]["title"]
|
|
|
|
url = reverse('jump_to', kwargs={"course_id": course.id.to_deprecated_string(),
|
|
"location": location})
|
|
|
|
content.update({"courseware_url": url, "courseware_title": title})
|
|
|
|
|
|
def prepare_content(content, course_key, is_staff=False, course_is_cohorted=None):
|
|
"""
|
|
This function is used to pre-process thread and comment models in various
|
|
ways before adding them to the HTTP response. This includes fixing empty
|
|
attribute fields, enforcing author anonymity, and enriching metadata around
|
|
group ownership and response endorsement.
|
|
|
|
@TODO: not all response pre-processing steps are currently integrated into
|
|
this function.
|
|
|
|
Arguments:
|
|
content (dict): A thread or comment.
|
|
course_key (CourseKey): The course key of the course.
|
|
is_staff (bool): Whether the user is a staff member.
|
|
course_is_cohorted (bool): Whether the course is cohorted.
|
|
"""
|
|
fields = [
|
|
'id', 'title', 'body', 'course_id', 'anonymous', 'anonymous_to_peers',
|
|
'endorsed', 'parent_id', 'thread_id', 'votes', 'closed', 'created_at',
|
|
'updated_at', 'depth', 'type', 'commentable_id', 'comments_count',
|
|
'at_position_list', 'children', 'highlighted_title', 'highlighted_body',
|
|
'courseware_title', 'courseware_url', 'unread_comments_count',
|
|
'read', 'group_id', 'group_name', 'pinned', 'abuse_flaggers',
|
|
'stats', 'resp_skip', 'resp_limit', 'resp_total', 'thread_type',
|
|
'endorsed_responses', 'non_endorsed_responses', 'non_endorsed_resp_total',
|
|
'endorsement', 'context', 'last_activity_at'
|
|
]
|
|
|
|
if (content.get('anonymous') is False) and ((content.get('anonymous_to_peers') is False) or is_staff):
|
|
fields += ['username', 'user_id']
|
|
|
|
content = strip_none(extract(content, fields))
|
|
|
|
if content.get("endorsement"):
|
|
endorsement = content["endorsement"]
|
|
endorser = None
|
|
if endorsement["user_id"]:
|
|
try:
|
|
endorser = User.objects.get(pk=endorsement["user_id"])
|
|
except User.DoesNotExist:
|
|
log.error(
|
|
"User ID %s in endorsement for comment %s but not in our DB.",
|
|
content.get('user_id'),
|
|
content.get('id')
|
|
)
|
|
|
|
# Only reveal endorser if requester can see author or if endorser is staff
|
|
if (
|
|
endorser and
|
|
("username" in fields or has_permission(endorser, "endorse_comment", course_key))
|
|
):
|
|
endorsement["username"] = endorser.username
|
|
else:
|
|
del endorsement["user_id"]
|
|
|
|
if course_is_cohorted is None:
|
|
course_is_cohorted = is_course_cohorted(course_key)
|
|
|
|
for child_content_key in ["children", "endorsed_responses", "non_endorsed_responses"]:
|
|
if child_content_key in content:
|
|
children = [
|
|
prepare_content(child, course_key, is_staff, course_is_cohorted=course_is_cohorted)
|
|
for child in content[child_content_key]
|
|
]
|
|
content[child_content_key] = children
|
|
|
|
if course_is_cohorted:
|
|
# Augment the specified thread info to include the group name if a group id is present.
|
|
if content.get('group_id') is not None:
|
|
content['group_name'] = get_cohort_by_id(course_key, content.get('group_id')).name
|
|
else:
|
|
# Remove any cohort information that might remain if the course had previously been cohorted.
|
|
content.pop('group_id', None)
|
|
|
|
return content
|
|
|
|
|
|
def get_group_id_for_comments_service(request, course_key, commentable_id=None):
|
|
"""
|
|
Given a user requesting content within a `commentable_id`, determine the
|
|
group_id which should be passed to the comments service.
|
|
|
|
Returns:
|
|
int: the group_id to pass to the comments service or None if nothing
|
|
should be passed
|
|
|
|
Raises:
|
|
ValueError if the requested group_id is invalid
|
|
"""
|
|
if commentable_id is None or is_commentable_cohorted(course_key, commentable_id):
|
|
if request.method == "GET":
|
|
requested_group_id = request.GET.get('group_id')
|
|
elif request.method == "POST":
|
|
requested_group_id = request.POST.get('group_id')
|
|
if has_permission(request.user, "see_all_cohorts", course_key):
|
|
if not requested_group_id:
|
|
return None
|
|
try:
|
|
group_id = int(requested_group_id)
|
|
get_cohort_by_id(course_key, group_id)
|
|
except CourseUserGroup.DoesNotExist:
|
|
raise ValueError
|
|
else:
|
|
# regular users always query with their own id.
|
|
group_id = get_cohort_id(request.user, course_key)
|
|
return group_id
|
|
else:
|
|
# Never pass a group_id to the comments service for a non-cohorted
|
|
# commentable
|
|
return None
|
|
|
|
|
|
def is_comment_too_deep(parent):
|
|
"""
|
|
Determine whether a comment with the given parent violates MAX_COMMENT_DEPTH
|
|
|
|
parent can be None to determine whether root comments are allowed
|
|
"""
|
|
return (
|
|
MAX_COMMENT_DEPTH is not None and (
|
|
MAX_COMMENT_DEPTH < 0 or
|
|
(parent and parent["depth"] >= MAX_COMMENT_DEPTH)
|
|
)
|
|
)
|
|
|
|
|
|
def is_commentable_cohorted(course_key, commentable_id):
|
|
"""
|
|
Args:
|
|
course_key: CourseKey
|
|
commentable_id: string
|
|
|
|
Returns:
|
|
Bool: is this commentable cohorted?
|
|
|
|
Raises:
|
|
Http404 if the course doesn't exist.
|
|
"""
|
|
course = courses.get_course_by_id(course_key)
|
|
course_cohort_settings = get_course_cohort_settings(course_key)
|
|
|
|
if not course_cohort_settings.is_cohorted or get_team(commentable_id):
|
|
# this is the easy case :)
|
|
ans = False
|
|
elif (
|
|
commentable_id in course.top_level_discussion_topic_ids or
|
|
course_cohort_settings.always_cohort_inline_discussions is False
|
|
):
|
|
# top level discussions have to be manually configured as cohorted
|
|
# (default is not).
|
|
# Same thing for inline discussions if the default is explicitly set to False in settings
|
|
ans = commentable_id in course_cohort_settings.cohorted_discussions
|
|
else:
|
|
# inline discussions are cohorted by default
|
|
ans = True
|
|
|
|
log.debug(u"is_commentable_cohorted(%s, %s) = {%s}", course_key, commentable_id, ans)
|
|
return ans
|
|
|
|
|
|
def is_discussion_enabled(course_id):
|
|
"""
|
|
Return True if Discussion is enabled for a course; else False
|
|
"""
|
|
if settings.FEATURES.get('CUSTOM_COURSES_EDX', False):
|
|
if get_current_ccx(course_id):
|
|
return False
|
|
return settings.FEATURES.get('ENABLE_DISCUSSION_SERVICE')
|
|
|
|
|
|
def is_content_authored_by(content, user):
|
|
"""
|
|
Return True if the author is this content is the passed user, else False
|
|
"""
|
|
try:
|
|
return int(content.get('user_id')) == user.id
|
|
except (ValueError, TypeError):
|
|
return False
|