{"id":527,"date":"2016-06-20T11:39:06","date_gmt":"2016-06-20T11:39:06","guid":{"rendered":"http:\/\/www.piglets.org\/blog\/?p=527"},"modified":"2016-06-20T11:39:06","modified_gmt":"2016-06-20T11:39:06","slug":"opus-and-assessment-2-adding-custom-assessments","status":"publish","type":"post","link":"https:\/\/www.piglets.org\/blog\/2016\/06\/20\/opus-and-assessment-2-adding-custom-assessments\/","title":{"rendered":"OPUS and Assessment 2 - Adding Custom Assessments"},"content":{"rendered":"<p>This is a follow on to the <a href=\"http:\/\/www.piglets.org\/blog\/2016\/06\/20\/opus-and-assessment-1\/\">previous article<\/a> on setting up assessment in OPUS, an on-line system for placement learning. You probably want to read that first. This is much more advanced and requires some technical knowledge (or someone that has that).<\/p>\n<h2>Making New Assessments<\/h2>\n<p>Suppose that OPUS doesn't have the assessment you want, then you will have to build your own, from scratch, or by modifying an existing one. <strong>This takes some minor HTML skill and access to your OPUS code to add a new file.<\/strong> So if you can't do this yourself, ensure you get appropriate support.<\/p>\n<p>Look at an existing assessment closely first. Go back to <em>Advanced<\/em> on the OPUS admin menu, and then <em>Assessments<\/em>.<\/p>\n<p>For each assessment, clicking on <em>Structure<\/em> allows access to underlying variables that are captured. These can be numeric, text, or checkboxes, and some validation is possible too.<\/p>\n<p><a href=\"http:\/\/www.piglets.org\/blog\/wp-content\/uploads\/2016\/06\/Screen-Shot-2016-06-20-at-11.28.38.png\"><img loading=\"lazy\" decoding=\"async\" class=\"alignleft size-large wp-image-523\" src=\"http:\/\/www.piglets.org\/blog\/wp-content\/uploads\/2016\/06\/Screen-Shot-2016-06-20-at-11.28.38-1024x304.png\" alt=\"The Structure of an Assessment\" width=\"474\" height=\"141\" srcset=\"https:\/\/www.piglets.org\/blog\/wp-content\/uploads\/2016\/06\/Screen-Shot-2016-06-20-at-11.28.38-1024x304.png 1024w, https:\/\/www.piglets.org\/blog\/wp-content\/uploads\/2016\/06\/Screen-Shot-2016-06-20-at-11.28.38-300x89.png 300w, https:\/\/www.piglets.org\/blog\/wp-content\/uploads\/2016\/06\/Screen-Shot-2016-06-20-at-11.28.38-768x228.png 768w, https:\/\/www.piglets.org\/blog\/wp-content\/uploads\/2016\/06\/Screen-Shot-2016-06-20-at-11.28.38.png 1205w\" sizes=\"auto, (max-width: 474px) 100vw, 474px\" \/><\/a><\/p>\n<p>you need to work out what things you will capture, and create a skin for the assessment, most usually from modifying one from another. This following snippet from a related Smarty template shows this is just HTML, but OPUS, through Smarty drops in an <img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/www.piglets.org\/blog\/wp-content\/ql-cache\/quicklatex.com-c93eb1316ba52c7d37a567ac420b237f_l3.png\" class=\"ql-img-inline-formula quicklatex-auto-format\" alt=\"&#97;&#115;&#115;&#101;&#115;&#115;&#109;&#101;&#110;&#116;&#32;&#118;&#97;&#114;&#105;&#97;&#98;&#108;&#101;&#32;&#116;&#104;&#97;&#116;&#32;&#103;&#105;&#118;&#101;&#115;&#32;&#97;&#99;&#99;&#101;&#115;&#115;&#32;&#116;&#111;&#32;&#97;&#110;&#121;&#32;&#101;&#120;&#105;&#115;&#116;&#105;&#110;&#103;&#32;&#118;&#97;&#108;&#117;&#101;&#115;&#44;&#32;&#97;&#110;&#100;&#32;&#97;&#110;&#121;&#32;&#118;&#97;&#108;&#105;&#100;&#97;&#116;&#105;&#111;&#110;&#32;&#101;&#114;&#114;&#111;&#114;&#115;&#46; &#60;&#112;&#114;&#101;&#32;&#99;&#108;&#97;&#115;&#115;&#61;&#34;&#108;&#97;&#110;&#103;&#58;&#120;&#104;&#116;&#109;&#108;&#32;&#100;&#101;&#99;&#111;&#100;&#101;&#58;&#116;&#114;&#117;&#101;&#34;&#32;&#116;&#105;&#116;&#108;&#101;&#61;&#34;&#65;&#110;&#32;&#101;&#120;&#116;&#114;&#97;&#99;&#116;&#32;&#102;&#114;&#111;&#109;&#32;&#97;&#32;&#116;&#101;&#109;&#112;&#108;&#97;&#116;&#101;&#46;&#34;&#62;&#123;&#42;&#32;&#83;&#109;&#97;&#114;&#116;&#121;&#32;&#42;&#125; &#123;&#42;&#32;&#84;&#101;&#109;&#112;&#108;&#97;&#116;&#101;&#32;&#102;&#111;&#114;&#32;&#83;&#69;&#77;&#69;&#32;&#70;&#105;&#110;&#97;&#108;&#32;&#86;&#105;&#115;&#105;&#116;&#32;&#42;&#125; &#123;&#42;&#32;&#65;&#115;&#115;&#101;&#115;&#115;&#109;&#101;&#110;&#116;&#32;&#115;&#112;&#101;&#99;&#105;&#102;&#105;&#99;&#32;&#108;&#97;&#121;&#111;&#117;&#116;&#32;&#42;&#125; &#123;&#42;&#32;&#82;&#101;&#97;&#108;&#108;&#121;&#44;&#32;&#111;&#110;&#108;&#121;&#32;&#116;&#104;&#101;&#32;&#102;&#111;&#114;&#109;&#32;&#99;&#111;&#110;&#116;&#101;&#110;&#116;&#115;&#32;&#110;&#101;&#101;&#100;&#32;&#116;&#111;&#32;&#98;&#101;&#32;&#97;&#100;&#100;&#101;&#100;&#32;&#42;&#125; &#123;&#42;&#32;&#78;&#111;&#116;&#101;&#32;&#116;&#104;&#101;&#32;&#117;&#115;&#101;&#32;&#111;&#102;&#32;&#103;&#101;&#116;&#95;&#118;&#97;&#108;&#117;&#101;&#32;&#97;&#110;&#100;&#32;&#102;&#108;&#97;&#103;&#95;&#101;&#114;&#114;&#111;&#114;&#32;&#116;&#111;&#32;&#42;&#125;&Acirc;&#32;&Acirc;&#32;&#32;&Acirc;&#32; &#123;&#42;&#32;&#98;&#114;&#105;&#110;&#103;&#32;&#105;&#110;&#32;&#97;&#115;&#115;&#101;&#115;&#115;&#109;&#101;&#110;&#116;&#32;&#115;&#112;&#101;&#99;&#105;&#102;&#105;&#99;&#32;&#109;&#97;&#116;&#101;&#114;&#105;&#97;&#108;&#32;&#42;&#125;  &#46;&#46;&#46; &#46;&#46;&#46;  &#60;&#116;&#114;&#62; &#60;&#116;&#100;&#32;&#99;&#108;&#97;&#115;&#115;&#61;&#34;&#112;&#114;&#111;&#112;&#101;&#114;&#116;&#121;&#34;&#32;&#114;&#111;&#119;&#115;&#112;&#97;&#110;&#61;&#34;&#53;&#34;&#62;&#85;&#115;&#101;&#32;&#111;&#102;&#32;&#69;&#110;&#103;&#108;&#105;&#115;&#104;&#60;&#47;&#116;&#100;&#62; &#60;&#116;&#100;&#32;&#99;&#111;&#108;&#115;&#112;&#97;&#110;&#61;&#34;&#49;&#34;&#62;&#60;&#115;&#116;&#114;&#111;&#110;&#103;&#62;&#77;&#97;&#114;&#107;&#60;&#47;&#115;&#116;&#114;&#111;&#110;&#103;&#62;&#60;&#47;&#116;&#100;&#62;&#60;&#116;&#100;&#32;&#99;&#111;&#108;&#115;&#112;&#97;&#110;&#61;&#34;&#52;&#34;&#62;&#60;&#115;&#116;&#114;&#111;&#110;&#103;&#62;&#67;&#111;&#109;&#109;&#101;&#110;&#116;&#115;&#60;&#47;&#115;&#116;&#114;&#111;&#110;&#103;&#62;&#60;&#47;&#116;&#100;&#62;&#60;&#47;&#116;&#114;&#62;  &#60;&#116;&#114;&#62;&#60;&#116;&#100;&#32;&#99;&#111;&#108;&#115;&#112;&#97;&#110;&#61;&#34;&#49;&#34;&#62; &#32;&#32;&#123;\" title=\"Rendered by QuickLaTeX.com\" height=\"192\" width=\"1542\" style=\"vertical-align: -3px;\"\/>assessment-&gt;flag_error(\"mark5\")}<br \/>\n&lt;input type=\"text\" class=\"data_entry_required\" size=\"2\" value=\"{<img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/www.piglets.org\/blog\/wp-content\/ql-cache\/quicklatex.com-96a6143212edd5cb0654fd33489f5434_l3.png\" class=\"ql-img-inline-formula quicklatex-auto-format\" alt=\"&#97;&#115;&#115;&#101;&#115;&#115;&#109;&#101;&#110;&#116;&#45;&#62;&#103;&#101;&#116;&#95;&#118;&#97;&#108;&#117;&#101;&#40;&#34;&#109;&#97;&#114;&#107;&#53;&#34;&#41;&#125;&#34;&#32;&#110;&#97;&#109;&#101;&#61;&#34;&#109;&#97;&#114;&#107;&#53;&#34;&#62; &#60;&#47;&#116;&#100;&#62; &#60;&#116;&#100;&#32;&#99;&#111;&#108;&#115;&#112;&#97;&#110;&#61;&#34;&#52;&#34;&#62; &#32;&#32;&#123;\" title=\"Rendered by QuickLaTeX.com\" height=\"40\" width=\"582\" style=\"vertical-align: -4px;\"\/>assessment-&gt;flag_error(\"comment5\")}<br \/>\n  {include file=\"general\/assessment\/textarea.tpl\" name=\"comment5\" rows=\"7\" cols=\"60\"}<br \/>\n&lt;\/td&gt;<br \/>\n&lt;\/tr&gt;<\/p>\n<p>&lt;tr&gt;&lt;td colspan=\"5\"&gt;Marking Scheme&lt;\/td&gt;&lt;\/tr&gt;<br \/>\n&lt;tr&gt;<br \/>\n&lt;td&gt; Uses language to clearly express views concisely &lt;\/td&gt;<br \/>\n&lt;td&gt; Expresses clearly but with some minor errors &lt;\/td&gt;<br \/>\n&lt;td&gt; Good expression, logical flow, reasonably concise &lt;\/td&gt;<br \/>\n&lt;td&gt; Reasonable flow, some contorted expressions, a little verbose &lt;\/td&gt;<br \/>\n&lt;td&gt; Poor expression, verbose, some colloquialisms &lt;\/td&gt;<br \/>\n&lt;\/tr&gt;<\/p>\n<p>...<br \/>\n...<\/pre>\n<p>This is a representative snippet. You can see this full template <a href=\"http:\/\/foss.ulster.ac.uk\/redmine\/projects\/opus\/repository\/revisions\/master\/entry\/templates\/assessment\/uu\/final_visit.tpl\">here<\/a>. Note the \"special\" code in between braces { }. The variables in the template pertain to the names in the structure.<\/p>\n<h2>Create and Save Your Template<\/h2>\n<p>Create your template, probably using one of the existing ones to help you understand the format. This provides the layout and skin for your pro-forma and allows you to do anything you can wish with HTML\/CSS. Be mindful of security considerations, but you aren't writing main code, just an included bit. OPUS will top and tail the file for you when it runs.<\/p>\n<p>Save it under the <em>templates\/assessments <\/em> directory in your OPUS install. I recommend you make a subdirectory for your institution.<\/p>\n<p><strong>Avoid using the \"uu\" directory. This is used for pre-shipped assessments and those used at Ulster University. There is a chance your changes will get clobbered by a new OPUS version if you put your template in there.<\/strong><\/p>\n<h2>Adding the Assessment variables into OPUS<\/h2>\n<p>Then you need to create your new Assessment item itself as at the top of the article. Once you have created it, click on <em>structure<\/em> and add each variable you will capture in turn, whether it is text, a number, or a checkbox, and any simple validation rules - such as minimum or maximum values.<\/p>\n<div id=\"attachment_534\" style=\"width: 693px\" class=\"wp-caption alignleft\"><a href=\"http:\/\/www.piglets.org\/blog\/wp-content\/uploads\/2016\/06\/Screen-Shot-2016-06-20-at-12.33.32.png\"><img loading=\"lazy\" decoding=\"async\" aria-describedby=\"caption-attachment-534\" class=\"size-full wp-image-534\" src=\"http:\/\/www.piglets.org\/blog\/wp-content\/uploads\/2016\/06\/Screen-Shot-2016-06-20-at-12.33.32.png\" alt=\"The final detail of one variable\" width=\"683\" height=\"212\" srcset=\"https:\/\/www.piglets.org\/blog\/wp-content\/uploads\/2016\/06\/Screen-Shot-2016-06-20-at-12.33.32.png 683w, https:\/\/www.piglets.org\/blog\/wp-content\/uploads\/2016\/06\/Screen-Shot-2016-06-20-at-12.33.32-300x93.png 300w\" sizes=\"auto, (max-width: 683px) 100vw, 683px\" \/><\/a><p id=\"caption-attachment-534\" class=\"wp-caption-text\">The final detail of one variable<\/p><\/div>\n<p>The <em>description<\/em> appears in feedback and validation, so make sure it is meaningful to the end user. The <em>name<\/em> is the variable name as it appears in your template. The <em>weighting<\/em> field is used to determine if numeric values contribute to the score. Usually use 1 if you want the score to be counted, and 0 if you want the score to be ignored. Finally you can choose whether each field is compulsory or not. Optional fields will be ignored in a total when OPUS creates a percentage.<\/p>\n<p>Once complete, add your new assessment into a test regime as detailed in the first article and do some careful testing before adding the regime to live students.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>This is a follow on to the previous article on setting up assessment in OPUS, an on-line system for placement learning. You probably want to read that first. This is much more advanced and requires some technical knowledge (or someone that has that). Making New Assessments Suppose that OPUS doesn't have the assessment you want, [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"jetpack_post_was_ever_published":false,"_jetpack_newsletter_access":"","_jetpack_dont_email_post_to_subs":false,"_jetpack_newsletter_tier_id":0,"_jetpack_memberships_contains_paywalled_content":false,"_jetpack_memberships_contains_paid_content":false,"vkexunit_cta_each_option":"","footnotes":"","jetpack_publicize_message":"","jetpack_publicize_feature_enabled":true,"jetpack_social_post_already_shared":true,"jetpack_social_options":{"image_generator_settings":{"template":"highway","default_image_id":0,"enabled":false},"version":2}},"categories":[7,125],"tags":[168,16,126,121,167,166],"class_list":["post-527","post","type-post","status-publish","format-standard","hentry","category-11-free-software","category-higher-education","tag-assessment","tag-free-software","tag-higher-education","tag-opus","tag-placement","tag-work-based-learning"],"jetpack_publicize_connections":[],"jetpack_featured_media_url":"","jetpack_sharing_enabled":true,"jetpack-related-posts":[],"jetpack_shortlink":"https:\/\/wp.me\/p52I4w-8v","_links":{"self":[{"href":"https:\/\/www.piglets.org\/blog\/wp-json\/wp\/v2\/posts\/527","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.piglets.org\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.piglets.org\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.piglets.org\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.piglets.org\/blog\/wp-json\/wp\/v2\/comments?post=527"}],"version-history":[{"count":1,"href":"https:\/\/www.piglets.org\/blog\/wp-json\/wp\/v2\/posts\/527\/revisions"}],"predecessor-version":[{"id":535,"href":"https:\/\/www.piglets.org\/blog\/wp-json\/wp\/v2\/posts\/527\/revisions\/535"}],"wp:attachment":[{"href":"https:\/\/www.piglets.org\/blog\/wp-json\/wp\/v2\/media?parent=527"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.piglets.org\/blog\/wp-json\/wp\/v2\/categories?post=527"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.piglets.org\/blog\/wp-json\/wp\/v2\/tags?post=527"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}