feat(ratings): replace slider UI with new rater component [SCHOOL-17]

docs/customization/cbl/.pages

@@ -0,0 +1 @@
+title: CBL

docs/customization/cbl/ratings.md

@@ -0,0 +1,33 @@
+# Ratings
+
+## Options
+
+### `minRating`
+
+- Default: `5`
+- The lowest rating presented on the primary scale
+
+### `maxRating`
+
+- Default: `12`
+- The highest rating presented on the primary scale
+
+### `menuRatings`
+
+- Default: `[4, 3, 2, 1]`
+- The ratings available on the secondary scale available under the menu button
+
+### `enableMissing`
+
+- Default: `true`
+- Whether the `M` value is available on the primary scale
+
+### `enableDidNotMeet`
+
+- Default: `true`
+- Whether the `DNM` value is available on the primary scale
+
+### `enableCheckmark`
+
+- Default: `true`
+- Whether the checkmark value is available on the primary scale

php-classes/Slate/CBL/Demonstrations/DidNotMeetDemonstrationSkill.php

@@ -0,0 +1,9 @@
+<?php
+
+namespace Slate\CBL\Demonstrations;
+
+
+class DidNotMeetDemonstrationSkill extends DemonstrationSkill
+{
+
+}

php-classes/Slate/CBL/Demonstrations/MissingDemonstrationSkill.php

@@ -0,0 +1,9 @@
+<?php
+
+namespace Slate\CBL\Demonstrations;
+
+
+class MissingDemonstrationSkill extends DemonstrationSkill
+{
+
+}

php-migrations/Slate/CBL/Demonstrations/20210328_demoskill-subclass-dnm.php

@@ -0,0 +1,23 @@
+<?php
+
+namespace Slate\CBL\Demonstrations;
+
+
+$tableName = DemonstrationSkill::$tableName;
+$historyTableName = DemonstrationSkill::getHistoryTableName();
+
+// skip if table doesn't exist
+if (!static::tableExists($tableName)) {
+    printf("Skipping migration because table `%s` does not yet exist\n", $tableName);
+    return static::STATUS_SKIPPED;
+}
+
+// skip if Class column already contains DidNotMeet subclass
+if (static::hasColumnEnumValue($tableName, 'Class', DidNotMeetDemonstrationSkill::class)) {
+    printf("Skipping migration because column `%s`.`Class` already has value '%s'\n", $tableName, DidNotMeetDemonstrationSkill::class);
+    return static::STATUS_SKIPPED;
+}
+
+// add new Class value
+static::addColumnEnumValue($tableName, 'Class', DidNotMeetDemonstrationSkill::class);
+static::addColumnEnumValue($historyTableName, 'Class', DidNotMeetDemonstrationSkill::class);

php-migrations/Slate/CBL/Demonstrations/20210328_demoskill-subclass-missing.php

@@ -0,0 +1,39 @@
+<?php
+
+namespace Slate\CBL\Demonstrations;
+
+use DB;
+
+
+$tableName = DemonstrationSkill::$tableName;
+$historyTableName = DemonstrationSkill::getHistoryTableName();
+
+// skip if table doesn't exist
+if (!static::tableExists($tableName)) {
+    printf("Skipping migration because table `%s` does not yet exist\n", $tableName);
+    return static::STATUS_SKIPPED;
+}
+
+// skip if Class column already contains Missing subclass
+if (static::hasColumnEnumValue($tableName, 'Class', MissingDemonstrationSkill::class)) {
+    printf("Skipping migration because column `%s`.`Class` already has value '%s'\n", $tableName, MissingDemonstrationSkill::class);
+    return static::STATUS_SKIPPED;
+}
+
+// add new Class value
+static::addColumnEnumValue($tableName, 'Class', MissingDemonstrationSkill::class);
+static::addColumnEnumValue($historyTableName, 'Class', MissingDemonstrationSkill::class);
+
+// migrate legacy missing demonstrations
+DB::nonQuery(
+    'UPDATE `%s` SET Class = "%s", DemonstratedLevel = NULL WHERE Class = "%s" AND DemonstratedLevel = 0',
+    [
+        $tableName,
+        DB::escape(MissingDemonstrationSkill::class),
+        DB::escape(DemonstrationSkill::class)
+    ]
+);
+printf(
+    "Updated %u DemonstrationSkill records with Rating = 0 to MissingDemonstrationSkill class\n",
+    DB::affectedRows()
+);

sencha-workspace/SlateDemonstrationsTeacher/app/controller/Demonstrations.js

@@ -86,7 +86,7 @@ Ext.define('SlateDemonstrationsTeacher.controller.Demonstrations', {
             modal: true,
             layout: 'fit',
             minWidth: 300,
-            width: 600,
+            width: 960,
             minHeight: 600,
 
             mainView: {
@@ -316,7 +316,7 @@ Ext.define('SlateDemonstrationsTeacher.controller.Demonstrations', {
 
 
         // fetch demonstration and show window
-        if (!demonstration || (typeof demonstration == 'object' && !demonstration.isModel)) {
+        if (!demonstration || typeof demonstration == 'object' && !demonstration.isModel) {
             demonstration = DemonstrationModel.create(Ext.apply({
                 Class: 'Slate\\CBL\\Demonstrations\\ExperienceDemonstration',
                 Demonstrated: new Date()
@@ -350,4 +350,4 @@ Ext.define('SlateDemonstrationsTeacher.controller.Demonstrations', {
             Ext.Logger.error('Invalid demonstration option');
         }
     }
-});
+});

sencha-workspace/SlateTasksTeacher/app/controller/StudentTasks.js

@@ -71,7 +71,7 @@ Ext.define('SlateTasksTeacher.controller.StudentTasks', {
             modal: true,
             layout: 'fit',
             minWidth: 300,
-            width: 600,
+            width: 960,
             minHeight: 200,
 
             mainView: {
@@ -318,4 +318,4 @@ Ext.define('SlateTasksTeacher.controller.StudentTasks', {
             }
         });
     }
-});
+});

sencha-workspace/packages/slate-cbl/src/field/ratings/AbstractSkillsField.js

@@ -40,6 +40,7 @@ Ext.define('Slate.cbl.field.ratings.AbstractSkillsField', {
 
         return {
             ID: demonstrationSkill.ID || null,
+            Class: demonstrationSkill.Class || 'Slate\\CBL\\Demonstrations\\DemonstrationSkill',
             SkillID: demonstrationSkill.SkillID,
             TargetLevel: demonstrationSkill.TargetLevel || null,
             DemonstratedLevel: demonstrationSkill.DemonstratedLevel,