Instructors can edit default response feedback text

Previously, instructors were unable to edit the feedback prompt text ("I noticed that
this response...") displayed in the response box asking a student to provide feedback
on the peer responses they received.

To allow instructors to edit this, I've added an editable xml element (feedback_default_text).
The text within the element defaults to "I noticed that this response...," but an instructor
can change this text to whatever he or she wants by editing the text within the xml element.

Editing of this new element has also been added to the authoring gui.

openassessment/templates/openassessmentblock/edit/oa_edit_rubric.html

@@ -41,8 +41,17 @@ <h6>
                     {% trans "Encourage your students to provide feedback on the response they've graded. You can replace the sample text with your own." %}
                 </p>
             </li>
+            <li class="field comp-setting-entry">
+                <div class="wrapper-comp-setting" id="openassessment_rubric_feedback_default_text_input_wrapper">
+                    <label for="openassessment_rubric_feedback_default_text" class="setting-label"> {% trans "Default Feedback Text" %}</label>
+                        <textarea id="openassessment_rubric_feedback_default_text" class="input setting-input">{{ feedback_default_text }}</textarea>
+                </div>
+                <p class="setting-help">
+                    {% trans "Enter feedback text that students will see before they enter their own feedback. Use this text to show students a good example peer assessment." %}
+                </p>
+            </li>
 
         </ul>
     </div>
 </div>
-{% endspaceless %}
+{% endspaceless %}

openassessment/templates/openassessmentblock/oa_rubric.html

@@ -63,12 +63,12 @@ <h4 class="question__title ui-toggle-visibility__control">
             <div class="wrapper--input">
                 <textarea
                     id="assessment__rubric__question--feedback__value"
-                    placeholder="{% trans "I noticed that this response..." %}"
+                    placeholder="{{ rubric_feedback_default_text }}"
                     maxlength="500"
                 >
                 </textarea>
             </div>
         </li>
     </ol>
 </fieldset>
-{% endspaceless %}
+{% endspaceless %}

openassessment/templates/openassessmentblock/peer/oa_peer_turbo_mode.html

@@ -127,7 +127,7 @@ <h4 class="question__title ui-toggle-visibility__control">
                                         <div class="wrapper--input">
                                                 <textarea
                                                     id="assessment__rubric__question--feedback__value"
-                                                    placeholder="{% trans "I noticed that this response..." %}"
+                                                    placeholder="{{ rubric_feedback_default_text }}"
                                                     maxlength="500"
                                                 >
                                                 </textarea>

openassessment/xblock/defaults.py

@@ -66,6 +66,12 @@
 (Optional) What aspects of this response stood out to you? What did it do well? How could it improve?
 """
 
+# The rubric's feedback text is the default text displayed and used as
+# the student's response to the feedback prompt
+DEFAULT_RUBRIC_FEEDBACK_TEXT = """
+I noticed that this response...
+"""
+
 DEFAULT_EXAMPLE_ANSWER = (
     "Replace this text with your own sample response for this assignment. "
     "Then, under Response Score to the right, select an option for each criterion. "

openassessment/xblock/openassessmentblock.py

@@ -152,6 +152,12 @@ class OpenAssessmentBlock(
         help="The rubric feedback prompt displayed to the student"
     )
 
+    rubric_feedback_default_text = String(
+        default=DEFAULT_RUBRIC_FEEDBACK_TEXT,
+        scope=Scope.content,
+        help="The default rubric feedback text displayed to the student"
+    )
+
     rubric_assessments = List(
         default=DEFAULT_ASSESSMENT_MODULES,
         scope=Scope.content,
@@ -386,6 +392,7 @@ def parse_xml(cls, node, runtime, keys, id_generator):
 
         block.rubric_criteria = config['rubric_criteria']
         block.rubric_feedback_prompt = config['rubric_feedback_prompt']
+        block.rubric_feedback_default_text = config['rubric_feedback_default_text']
         block.rubric_assessments = config['rubric_assessments']
         block.submission_start = config['submission_start']
         block.submission_due = config['submission_due']

openassessment/xblock/peer_assessment_mixin.py

@@ -8,6 +8,7 @@
     PeerAssessmentRequestError, PeerAssessmentInternalError, PeerAssessmentWorkflowError
 )
 from openassessment.workflow.errors import AssessmentWorkflowError
+from openassessment.xblock.defaults import DEFAULT_RUBRIC_FEEDBACK_TEXT
 from .data_conversion import create_rubric_dict
 from .resolve_dates import DISTANT_FUTURE
 from .data_conversion import clean_criterion_feedback
@@ -130,6 +131,12 @@ def render_peer_assessment(self, data, suffix=''):
             return Response(u"")
         continue_grading = data.params.get('continue_grading', False)
         path, context_dict = self.peer_path_and_context(continue_grading)
+
+        # For backwards compatibility, if no feedback default text has been
+        # set, use the default text
+        if 'rubric_feedback_default_text' not in context_dict:
+            context_dict['rubric_feedback_default_text'] = DEFAULT_RUBRIC_FEEDBACK_TEXT
+
         return self.render_assessment(path, context_dict)
 
     def peer_path_and_context(self, continue_grading):
@@ -155,6 +162,9 @@ def peer_path_and_context(self, continue_grading):
         if self.rubric_feedback_prompt is not None:
             context_dict["rubric_feedback_prompt"] = self.rubric_feedback_prompt
 
+        if self.rubric_feedback_default_text is not None:
+            context_dict['rubric_feedback_default_text'] = self.rubric_feedback_default_text
+
         # We display the due date whether the problem is open or closed.
         # If no date is set, it defaults to the distant future, in which
         # case we don't display the date.

openassessment/xblock/schema.py

@@ -69,6 +69,7 @@ def datetime_validator(value):
     Required('prompt'): utf8_validator,
     Required('title'): utf8_validator,
     Required('feedback_prompt'): utf8_validator,
+    Required('feedback_default_text'): utf8_validator,
     Required('submission_start'): Any(datetime_validator, None),
     Required('submission_due'): Any(datetime_validator, None),
     Required('allow_file_upload'): bool,
@@ -123,4 +124,4 @@ def datetime_validator(value):
             ]
         })
     ]
-})
+})

openassessment/xblock/static/js/spec/oa_server.js

@@ -32,6 +32,7 @@ describe("OpenAssessment.Server", function() {
 
     var PROMPT = "Hello this is the prompt yes.";
     var FEEDBACK_PROMPT = "Prompt for feedback";
+    var FEEDBACK_DEFAULT_TEXT = "Default feedback response text";
 
     var RUBRIC = '<rubric>'+
         '<criterion>'+
@@ -234,6 +235,7 @@ describe("OpenAssessment.Server", function() {
         server.updateEditorContext({
             prompt: PROMPT,
             feedbackPrompt: FEEDBACK_PROMPT,
+            feedback_default_text: FEEDBACK_DEFAULT_TEXT,
             title: TITLE,
             submissionStart: SUBMISSION_START,
             submissionDue: SUBMISSION_DUE,
@@ -248,6 +250,7 @@ describe("OpenAssessment.Server", function() {
             data: JSON.stringify({
                 prompt: PROMPT,
                 feedback_prompt: FEEDBACK_PROMPT,
+                feedback_default_text: FEEDBACK_DEFAULT_TEXT,
                 title: TITLE,
                 submission_start: SUBMISSION_START,
                 submission_due: SUBMISSION_DUE,

openassessment/xblock/static/js/src/oa_server.js

@@ -413,6 +413,7 @@ if (typeof OpenAssessment.Server == "undefined" || !OpenAssessment.Server) {
             title (string): The title of the problem.
             prompt (string): The question prompt.
             feedbackPrompt (string): The directions to the student for giving overall feedback on a submission.
+            feedback_default_text (string): The default feedback text used as the student's feedback response
             submissionStart (ISO-formatted datetime string or null): The start date of the submission.
             submissionDue (ISO-formatted datetime string or null): The date the submission is due.
             criteria (list of object literals): The rubric criteria.
@@ -430,6 +431,7 @@ if (typeof OpenAssessment.Server == "undefined" || !OpenAssessment.Server) {
             var payload = JSON.stringify({
                 prompt: kwargs.prompt,
                 feedback_prompt: kwargs.feedbackPrompt,
+                feedback_default_text: kwargs.feedback_default_text,
                 title: kwargs.title,
                 submission_start: kwargs.submissionStart,
                 submission_due: kwargs.submissionDue,

openassessment/xblock/static/js/src/studio/oa_edit.js

@@ -187,6 +187,7 @@ OpenAssessment.StudioView.prototype = {
         this.server.updateEditorContext({
             prompt: view.promptView.promptText(),
             feedbackPrompt: view.rubricView.feedbackPrompt(),
+            feedback_default_text: view.rubricView.feedback_default_text(),
             criteria: view.rubricView.criteriaDefinition(),
             title: view.settingsView.displayName(),
             submissionStart: view.settingsView.submissionStart(),

openassessment/xblock/static/js/src/studio/oa_edit_rubric.js

@@ -92,6 +92,23 @@ OpenAssessment.EditRubricView.prototype = {
         return OpenAssessment.Fields.stringField(sel, text);
     },
 
+    /**
+    Get or set the default feedback response text in the editor.
+    The text is used as a student's default response to the feedback
+    prompt. 
+
+    Args:
+        text (string, option): If provided, sets the default text to this value.
+
+    Returns:
+        string
+
+    **/
+    feedback_default_text: function(text) {
+        var sel = $("#openassessment_rubric_feedback_default_text", this.element);
+        return OpenAssessment.Fields.stringField(sel, text);
+    },
+
     /**
     Add a new criterion to the rubric.
     Uses a client-side template to create the new criterion.

openassessment/xblock/static/xml/example_based_example.xml

@@ -65,5 +65,8 @@
         <feedbackprompt>
             (Optional) What aspects of this response stood out to you? What did it do well? How could it improve?
         </feedbackprompt>
+        <feedback_default_text>
+            I noticed that this response...
+        </feedback_default_text>
     </rubric>
-</openassessment>
+</openassessment>

openassessment/xblock/studio_mixin.py

@@ -10,7 +10,7 @@
 from xblock.core import XBlock
 from xblock.fields import List, Scope
 from xblock.fragment import Fragment
-from openassessment.xblock.defaults import DEFAULT_EDITOR_ASSESSMENTS_ORDER
+from openassessment.xblock.defaults import DEFAULT_EDITOR_ASSESSMENTS_ORDER, DEFAULT_RUBRIC_FEEDBACK_TEXT
 from openassessment.xblock.validation import validator
 from openassessment.xblock.data_conversion import create_rubric_dict, make_django_template_key
 from openassessment.xblock.schema import EDITOR_UPDATE_SCHEMA
@@ -105,6 +105,12 @@ def editor_context(self):
         if not criteria:
             criteria = self.DEFAULT_CRITERIA
 
+        # To maintain backwards compatibility, if there is no 
+        # feedback_default_text configured for the xblock, use the default text
+        feedback_default_text = copy.deepcopy(self.rubric_feedback_default_text)
+        if not feedback_default_text:
+            feedback_default_text = DEFAULT_RUBRIC_FEEDBACK_TEXT
+
         return {
             'prompt': self.prompt,
             'title': self.title,
@@ -113,6 +119,7 @@ def editor_context(self):
             'assessments': assessments,
             'criteria': criteria,
             'feedbackprompt': self.rubric_feedback_prompt,
+            'feedback_default_text': feedback_default_text,
             'allow_file_upload': self.allow_file_upload,
             'leaderboard_show': self.leaderboard_show,
             'editor_assessments_order': [
@@ -202,6 +209,7 @@ def update_editor_context(self, data, suffix=''):
         self.rubric_assessments = data['assessments']
         self.editor_assessments_order = data['editor_assessments_order']
         self.rubric_feedback_prompt = data['feedback_prompt']
+        self.rubric_feedback_default_text = data['feedback_default_text']
         self.submission_start = data['submission_start']
         self.submission_due = data['submission_due']
         self.allow_file_upload = bool(data['allow_file_upload'])