"""Poll block is ungraded xmodule used by students to to do set of polls. On the client side we show: If student does not yet anwered - Question with set of choices. If student have answered - Question with statistics for each answers. """ import html import json import logging from copy import deepcopy from collections import OrderedDict from django.conf import settings from lxml import etree from web_fragments.fragment import Fragment from xblock.core import XBlock from xblock.fields import Boolean, Dict, List, Scope, String # lint-amnesty, pylint: disable=wrong-import-order from xblocks_contrib.poll import PollBlock as _ExtractedPollBlock from openedx.core.djangolib.markup import Text, HTML from xmodule.mako_block import MakoTemplateBlockBase from xmodule.stringify import stringify_children from xmodule.util.builtin_assets import add_webpack_js_to_fragment, add_css_to_fragment from xmodule.x_module import ( ResourceTemplates, shim_xmodule_js, XModuleMixin, XModuleToXBlockMixin, ) from xmodule.xml_block import XmlMixin log = logging.getLogger(__name__) _ = lambda text: text @XBlock.needs('mako') class _BuiltInPollBlock( MakoTemplateBlockBase, XmlMixin, XModuleToXBlockMixin, ResourceTemplates, XModuleMixin, ): # pylint: disable=abstract-method """Poll Block""" is_extracted = False # Name of poll to use in links to this poll display_name = String( help=_("The display name for this component."), scope=Scope.settings ) voted = Boolean( help=_("Whether this student has voted on the poll"), scope=Scope.user_state, default=False ) poll_answer = String( help=_("Student answer"), scope=Scope.user_state, default='' ) poll_answers = Dict( help=_("Poll answers from all students"), scope=Scope.user_state_summary ) # List of answers, in the form {'id': 'some id', 'text': 'the answer text'} answers = List( help=_("Poll answers from xml"), scope=Scope.content, default=[] ) question = String( help=_("Poll question"), scope=Scope.content, default='' ) resources_dir = None uses_xmodule_styles_setup = True def handle_ajax(self, dispatch, data): # lint-amnesty, pylint: disable=unused-argument """Ajax handler. Args: dispatch: string request slug data: dict request data parameters Returns: json string """ if dispatch in self.poll_answers and not self.voted: # FIXME: fix this, when xblock will support mutable types. # Now we use this hack. temp_poll_answers = self.poll_answers temp_poll_answers[dispatch] += 1 self.poll_answers = temp_poll_answers self.voted = True self.poll_answer = dispatch return json.dumps({'poll_answers': self.poll_answers, 'total': sum(self.poll_answers.values()), 'callback': {'objectName': 'Conditional'} }) elif dispatch == 'get_state': return json.dumps({'poll_answer': self.poll_answer, 'poll_answers': self.poll_answers, 'total': sum(self.poll_answers.values()) }) elif dispatch == 'reset_poll' and self.voted and \ self.xml_attributes.get('reset', 'True').lower() != 'false': self.voted = False # FIXME: fix this, when xblock will support mutable types. # Now we use this hack. temp_poll_answers = self.poll_answers temp_poll_answers[self.poll_answer] -= 1 self.poll_answers = temp_poll_answers self.poll_answer = '' return json.dumps({'status': 'success'}) else: # return error message return json.dumps({'error': 'Unknown Command!'}) def student_view(self, _context): """ Renders the student view. """ fragment = Fragment() params = { 'element_id': self.location.html_id(), 'element_class': self.location.block_type, 'ajax_url': self.ajax_url, 'configuration_json': self.dump_poll(), } fragment.add_content(self.runtime.service(self, 'mako').render_lms_template('poll.html', params)) add_css_to_fragment(fragment, 'PollBlockDisplay.css') add_webpack_js_to_fragment(fragment, 'PollBlockDisplay') shim_xmodule_js(fragment, 'Poll') return fragment def dump_poll(self): """Dump poll information. Returns: string - Serialize json. """ # FIXME: hack for resolving caching `default={}` during definition # poll_answers field if self.poll_answers is None: self.poll_answers = {} answers_to_json = OrderedDict() # FIXME: fix this, when xblock support mutable types. # Now we use this hack. temp_poll_answers = self.poll_answers # Fill self.poll_answers, prepare data for template context. for answer in self.answers: # Set default count for answer = 0. if answer['id'] not in temp_poll_answers: temp_poll_answers[answer['id']] = 0 answers_to_json[answer['id']] = html.escape(answer['text'], quote=False) self.poll_answers = temp_poll_answers return json.dumps({ 'answers': answers_to_json, 'question': html.escape(self.question, quote=False), # to show answered poll after reload: 'poll_answer': self.poll_answer, 'poll_answers': self.poll_answers if self.voted else {}, 'total': sum(self.poll_answers.values()) if self.voted else 0, 'reset': str(self.xml_attributes.get('reset', 'true')).lower() }) _tag_name = 'poll_question' _child_tag_name = 'answer' @classmethod def definition_from_xml(cls, xml_object, system): """Pull out the data into dictionary. Args: xml_object: xml from file. system: `system` object. Returns: (definition, children) - tuple definition - dict: { 'answers': , 'question': } """ # Check for presense of required tags in xml. if len(xml_object.xpath(cls._child_tag_name)) == 0: raise ValueError("Poll_question definition must include \ at least one 'answer' tag") xml_object_copy = deepcopy(xml_object) answers = [] for element_answer in xml_object_copy.findall(cls._child_tag_name): answer_id = element_answer.get('id', None) if answer_id: answers.append({ 'id': answer_id, 'text': stringify_children(element_answer) }) xml_object_copy.remove(element_answer) definition = { 'answers': answers, 'question': stringify_children(xml_object_copy) } children = [] return (definition, children) def definition_to_xml(self, resource_fs): """Return an xml element representing to this definition.""" poll_str = HTML('<{tag_name}>{text}').format( tag_name=self._tag_name, text=self.question) xml_object = etree.fromstring(poll_str) xml_object.set('display_name', self.display_name) def add_child(xml_obj, answer): # lint-amnesty, pylint: disable=unused-argument # Escape answer text before adding to xml tree. answer_text = str(answer['text']) child_str = Text('{tag_begin}{text}{tag_end}').format( tag_begin=HTML('<{tag_name} id="{id}">').format( tag_name=self._child_tag_name, id=answer['id'] ), text=answer_text, tag_end=HTML('').format(tag_name=self._child_tag_name) ) child_node = etree.fromstring(child_str) xml_object.append(child_node) for answer in self.answers: add_child(xml_object, answer) return xml_object PollBlock = None def reset_class(): """Reset class as per django settings flag""" global PollBlock PollBlock = ( _ExtractedPollBlock if settings.USE_EXTRACTED_POLL_QUESTION_BLOCK else _BuiltInPollBlock ) return PollBlock reset_class() PollBlock.__name__ = "PollBlock"