Skip navigation
All Places > Blackboard Open LMS Community > Blog > Author: ab37750

Blackboard Open LMS Community

6 Posts authored by: ab37750

With the Open LMS 3.6 release a quiet change was made to the gradebook; I thought it might be nice to go over the change and visit the Natural grading method and talk about how it is useful. 


Grade calculations get ifs

Buried in the footnotes that I am sure you read on a regular basis was a mention of an update to the gradebook's calculated grades feature. It is a request that goes way back to Moodle 1.9 (aka 2009) that has finally added for your enjoyment. 

Calculated grades background

If you weren't aware, in the gradebook you can create a grade item that is based on a calculation of other grade items. With it you could make a category total that is not just the weighted mean of the grades, but a custom weighted total of selected grade items. I know it sounds pretty advanced, and really it kind of is, but it really comes in handy for the specific times that I need it. How about if you need to go beyond the built in min and max functions? For example, you could make a grade item that is the average of the highest score value of 6 pairs of graded items, I'll take the highest score from each week's homework with two assignments per week in a six week course. Well the calculated grade can handle that for me; the grade total would be =average(max([[Item1]],[[Item2]]), max([[Item3]],[[Item4]]), max([[Item5]],[[Item6]]), max([[Item7]],[[Item8]]), max([[Item9]],[[Item10]]), max([[Item11]],[[Item12]]))

Put an if in there

Well now as of the 3.6 release, you can add an IF statement to the calculation. So if I state in my syllabus that I will add 10 bonus points to the exams total if all the assignments have been turned in(for me this means they've got scores above 0, I'm only dishing out 0's for not trying), I can do that automatically in the gradebook.

=if(min(Assignment1, Assignment2, Assignment3, Assignment4, Assignment5) >0, sum(Midterm1, Midterm2, Final, 10), sum(Midterm1, Midterm2, Final))

Now I could add in logic to make sure the bonus score does not exceed the maximum total score for the exams, or weight the exams, or take the average of the scores whatever logic needs to be in the calculation can be nested in there. Overall the idea is that the if function works like an if in coding or logic.

if(condition, then this, else the other)

if(condition, calculation1, calculation2) 

The if starts with the condition to check. If the condition matches, the middle clause happens for the calculation, if the condition does not match then the third clause is the calculation.

Seems pretty straightforward and lots of potential for fun!


Natural grading method

Introduced a few years back, the Natural grading aggregation feels like the new kid on the block still. I get questions about it pretty regularly so I thought we could discuss it here. What is natural about it and why would I use it? 

Screenshot of the grade settings showing the control of the aggregation and other settings.

The simple version of what is the natural aggregation is that it is the sum of the grade values scaled by their weight. It is a sum with an implied weighting based on the size of the grade item. Five assignments with the same maximum score will all have the same weight, an exam worth double the points will have an effective weight that is double the others. The "natural" bit is that it tries to follow what we naturally mean when we have 5 items in a gradebook with the same total points; they get the same weight. They have the same impact on the final grade because they are worth the same amount. 

How does it work?

Natural aggregation functions as a sum of grades when the weight boxes are left alone. In this situation, the numbers in the weight boxes are just informational and show the effective weights in the sum. Natural aggregation assumes that all of the points will total up to 100% and automatically weights everything based on their contribution to that amount. Here it automatically suggests or shows weights for the assignments based their relative maximum scores. This first one is out of 100 points, that other assignment is out of 40 points so it is 40% of the weight of the first and so on. 

Screenshot of the gradebook setup page showing grade categories, grade items, and grade weights automatically assigned by the Natural aggregation method.

In my course set up, I weight my assignments, participation, and tests grades to be specific amounts of the final grade. Now pen and paper me used to put in the effort before the term to make sure that my number of assignments and their point totals got me to the right total number for the assignments grades part of the course grade. Here in my online course I can do the same thing, but what if I didn't? What if my assignments totalled up to 400 points and the course was 900 points but I wanted the assignments to be worth 25% of the total score, not 44.4? The natural method can support this easily. When I look at the category grade settings, I can just click on the checkbox to override the grade weight for the category. The value there is created by a calculation based on the total points (not including extra credit) in the category compared to the total number of points available in the course. If I override the weight, I can set the assignments to be worth 25% and the participation to be worth 50%. The aggregation will automatically assign the remaining third category of grades to be worth the remaining 25% of the weighting in order to keep the total to 100.  

Where credit is due

If you are looking at that Assignment category layout in the screenshot above, you might have picked out that the total in the weights seems off; the weighting adds up to 110. What happened there? Has the natural method let me down? Don't worry, one of the assignments that is worth 10 in the weighting is also marked as extra credit. 

Screenshot showing the extra credit indicator in the gradebook setup view. The indicator is keyboard accessible.

This item does not actually add to the total available points, but just adds it's value to the student's score in this section. It's weight indicator shows how much potential it has to lift grades in the Assignment category that I have set up. Students who complete this with a perfect score have a potential to move their grade in the assignments by 10%, more generous than I normally am. 

So why use the natural aggregation?

It is not a radical departure from the other methods, and that is a good thing. However in my mind it offers one clear advantage. If I add a collection of activities to my course worth the points that I have given each one and do nothing else, the natural method will gather them up and create a total that acts more or less exactly how I would expect it to handle the scores without me doing anything else.I can see the implied weighting and make changes as needed, but if I took my pen and paper course layout for grades and translated it directly to an online gradebook, natural would give me exactly the same grade I got by hand. 

Natural merges some of the functionality of several of the older grade aggregation methods into one method and adds extra credit support without having to choose a special version of a method. Rather than use sum of grades and then switch to weighted means to get custom weights and then make sure that the weights add up to the right total, I can use natural and have the single aggregation method handle all of that without me needing to keep switching and correcting. 



What's up with Glossary?

Posted by ab37750 Aug 19, 2019

The Glossary activity is there in your add activity list. You've probably looked at it and wondered what to do with it, or how to use it well, or if you are like me even where to start. Well this blog post is for you my friend. Let's talk about what the Glossary tool is all about, how you can use it, and some neat features that can really enhance your course.

Glossary is a normal Moodle activity, but typically is not graded. The most common way to think of using one is as a dictionary or encyclopedia list of entries that explain terms and concepts from the course material. The list can be the authoritative source for terms and definitions for the course provided by the instructor or even from an associated textbook. The list can be shown in different layouts and styles, dictionary, continuous listings (not broken up by first letter), encyclopedia (dictionary with pictures inline with the terms), and FAQ (where the concepts and definitions are called questions and answers.) This screenshot shows a simple, dictionary style listing. 

Screenshot of the list of entries in a glossary. It is searchable and can be filtered by the entry's first letter.

Glossary can be treated as a student contribution and collaboration space where learners can create entries for terms or concepts that they do not understand and have other students provide attempts at answers. Comments and even grading can be used in this approach. 

For my exploration, I will use the authoritative source approach which assumes that the entries are "official". For this purpose I prefer to use the appearance mode called "simple, dictionary style". It provides a clean standard view with terms organized by first letter and dispenses with the notion of who authored each individual entry. Entry authorship is more useful for collaborative glossaries. 


Screenshot of the form for making a new glossary entry.

Each new entry is a combination of a Concept or a Term and it's definition. It is best to keep the Concepts as simple and short as possible. In part because they tend to be easier to search for, and in part because it is easier to use the filter system on single terms and fixed short phrases. Keywords can be thought of as aliases for the concept; any terms that should be considered synonymous to the main concept in the entry. Filters will show this definition for the keywords as well as the concept. 

What's this about filters? 

Screenshot of the course admin tools showing the Filters settings for the course. Screenshot of the enable filter interface.

Maybe you've used them before, maybe not, or maybe you've used them and not known. Filters screen the HTML text on the page and do something when they find a match. Like the MathJax filter that takes LaTeX embedded between the right tags and turns it into a nice math font based mathematical expression on the page. Glossary comes with the glossary auto-linking filter. Auto-linking takes the glossary out of it's isolation in the activity and injects it into the course content.

When enabled in a course or an individual course content item (a Forum or a Page resource as examples) the glossary auto-linking filter finds words in the HTML that match concepts and their keywords and creates a link to the glossary entry that matches. 

Screenshot of a section of text with the glossary auto-link enabled and modals with definitions open.

It even works on itself! Concepts and keywords in glossary definitions can be auto-linked to their definitions. A veritable journey through concepts awaits your learners as they follow a key term in text presented in the course to a definition that opens further definitions for the key concepts it contains. 


The filter matching can be set to match on all or part of the concept term in the text, for example if the concept is for the word trust, whole word matching will only match to the word trust, partial will match to trust in the word trusting. Keywords can be useful here to have more precise control over the matching behavior. Set the match to whole word only and list intended matches in the keywords list to avoid partial matching to terms that are not intended. There is also an option to force case sensitivity, to create constraints on the matching behavior. Auto-linking can be enabled and disabled for each individual term, giving you complete control.


Glossary auto-linking can be enabled everywhere in the course or just in specific activities and content items. If enabled everywhere, it can be disabled in specific activities or content items, like in a summative quiz to avoid showing answers in question text. The glossary auto-linking filter needs to be enabled by a site administrator before it shows up in your course as an option. 


Experiment with the glossary. Add terms and concepts over time; enlist learners to start a glossary and then refine and finalize it. Use the filter in a few areas and then expand them over time. Glossary can be a useful and rewarding tool for teaching and learning when employed in your courses.

I've been playing around with the TinyMCE editor and the Atto Editor for a while and thought it might be useful to share some of my thoughts and findings. 

A little background

You may or may not have been using Open LMS/Moodle for a while so why not give a little history and context. For a number of years, Moodle was using the TinyMCE editor as the HTML editor in the platform. Eventually a custom HTML editor was developed in part to maintain more control over the development and bug fixing needed in the platform. Overall, there are some performance enhancements with Atto over TinyMCE, particularly in pages with multiple instances of the HTML editor. After a while,the TinyMCE editor stopped being formally supported but has still been included due to the large number of users of this older HTML editor. This means that sometimes weird behavior or issues that come up are actually related to the use of the TinyMCE editor. Atto has become the editor of choice and is the default in new installations; but many folks have some issues or confusion about it or are just plain unaware that it is around. 


Managing the tool bar

Atto starts in a more streamlined mode, with fewer options available in both collapsed and expanded mode. In part this is a design decision and in part it is part of a plan to encourage more web friendly and accessible content. The styles are little different overall and Atto does manage styles a bit differently than TinyMCE. We will check out some of the ways they are different, why, and what can be done about it. Both have admin control over what options show up in the tool bars, but most of us have just never used this power. 

Screenshot of the Admin Settings menu in the Text Editors in the Plugins list Screenshot of the Atto Text Editor settings in the Admin tools

When I am adding new buttons to the tool bar, I just copy the "shortname" from the list and paste it into the grouping that I want the button to show up in. For Example, I might add or move the underline button to the style1 grouping by adding a ", underline" immediately after the "italic" on that list. The groupings just help manage and collect buttons with a similar theme together. 



One of the most often singled out items is the lack of color choice in the text editor. Color is not an effective way to communicate importance because we do not all see colors and it is noise that a screen reader user will have turned off, so they will not be notified of this "importance" or information meant to convey in color. Importance should be communicated with headings and tags, not color. That said, if your life is incomplete without it, you can add color to the Atto editor choices. There are two buttons that an admin can add to the tool bar; fontcolor and morefontcolors. Screenshot of the morefontcolors custom color creation interface.

The fontcolor button adds a fixed set of color options while the morefontcolors adds a configurable menu of color choices with an option to allow the user to create a custom color using a color picker.


Adding Images

I have found that while the Atto editor is generally very accessible and responsive friendly, it has a few odd corners. One is in image handling. By default, the editor always requires a fixed size for images that are added. There is no option to leave the size to be unspecified. The result is that often times for a large image, the responsive behavior is limited by the fixed size scale. I usually add the image and then enter HTML mode and just remove the height and width tags. This is probably bad form, but I like the results much better, especially when using Snap and it's responsive classes. 

Where Atto does better than TinyMCE is in a very critical issue; the finding and linking to files. I have seen several issues come up with copying HTML content objects with embedded images and files breaking when the link was made in TinyMCE. If the content is re-created with Atto, the issue goes away. The TinyMCE editor just does not use the correct linking to images in the file repository.


Collapse behavior and HTML+

Some of us like to work in HTML in the editor, and if you are one you might like the HTML+ tool. It is included in the system as an option, and is designed to replace the HTML button. Just change the html entry in the buttons list to be htmlplus. It adds color coding to HTML tags to help identify open or malformed tags. 

You and your faculty might also prefer to always have the editor open fully rather than have a collapse/expand behavior. An admin can remove the collapse option by removing the line "collapse = collapse" from the button line up in Atto. This will force the tool to just load open and not hide options under the collapsed space. 



What have you found with the Atto editor? What is your favorite feature in one that you can't seem to find in the other?


More on H5P

Posted by ab37750 May 14, 2019

Hi folks, I am back and on the H5P train again.

Just an update to kick things off, but I thought I'd start with a note about the more recent updates to H5P in Moodle/Open LMS. One of my favorite bits is the reporting views. They really feel so much more polished and clear, I am loving them. 

From the Grader view in the gradebook, you can click on the H5P activity link to get to this grade report page. 

Screenshot of the H5P Grade Report showing grade information for each student's attempt.

It has a few more details than the gradebook view, but gets more exciting when we dive into the View Answers Report.

For each student we can see the detailed report on their responses without having to navigate out or find additional reports.

Screenshot of the H5P View Answers Report showing detailed information about the answers selected or provided by the student.

Pretty good details on what the actual responses were from the attempt.


Another item for today's post is the idea of creating a template page for the Course presentation activity.

It is easy to really think about the Course presentation as a slide show, the parallels are pretty strong. So as I was knocking out some examples, it occurred to me that the clone page tool is perfect for the job. 

Screenshot of the H5P Course presentation authoring page, highlighting the clone page tool.I can make several different styles of page template, and use the clone page button to make copies of them for each page I want to build. When I am all done, I can toss out the template pages, or use them as the last of that style of page. It can really cut down on the styling time, and make it feel a little more like using Power point or Keynote to author a slide presentation. 

I'll be back with more updates and information. I think next up I will take a tour through the Open Badges 2.0 implementation and some cool new features in there.


H5P Updates

Posted by ab37750 May 9, 2017

Hi folks!

Back from a little traveling hiatus and I wanted to share some quick notes about the MP2 updates to the H5P plugin in Moodlerooms.


1) Grades Support Enhanced.

Originally the H5P activity had a somewhat mysterious internal setting for the grade it would publish to the grade book in Moodle. Now it has more normal support for grades in the settings with the addition of a field for the Maximum grade for the activity.

H5P Grade Setting Screenshot

Still missing in my opinion is the ability to assign scales, single or multiple attempts, the aggregation methods for those multiple attempts, and the grade category the item belongs in. These are standard Moodle activity behaviors and I expect they will show up someday, but for now I have a much more normal workflow to setting up the max grade for the activity.


2) Backup and Restore.

That's right, back up and restore now work correctly with this activity so when you create one in a template course, you can count on it rolling out to the copies made of that course. I've tested it and it does work for the scenarios I ran through, including import, duplicate, and the recycle bin.

H5P in the Import ScreenH5P Content in the   Recycle Bin

Please let me know if you find one where it doesn't seem to be working right.


There were also some fixes and updates and tweaks to various content types in the H5P plugin. Go explore and share some of what you have done, especially since you can back it up now!

I'll be back within the week to show off some steps in creation of content and some backups of sample files.


H5P, a new tool...

Posted by ab37750 Mar 1, 2017

An Introduction to H5P

Thanks to those who could make it to one of the Territory Moots to hear me babble about H5P and the interactive content you can create with it.

I will launch a few posts about this tool but I thought it would be good to start with capturing some highlights of the presentation here and share my slides for that part which include my notes.

To start, especially for those who might have missed out on the talk, H5P is an Open Source tool and a Free Project. The folks at are providing a really dynamic and exciting tool which lets you author, share/borrow, and reuse content for learning. The content, of which there are about 30 different types, is in HTML5 format, so it is web friendly by design and will work on all those cool mobile devices like tablets and smartphones.

What kind of content?

Truly interactive content like Games (like Memory or Flashcards), Quizzes, Interactive Videos, Presentations, Timelines, and more. Content that really expands the possibilities for reaching learners in varied and engaging ways.

While you can embed the content straight from the site into your course page, the Moodle integration really shines by including an Activity for H5P that provides an authoring tool right in the Settings page. You don't have to launch extra tools or purchase and install software suites in order to create content that is powerful and interactive. You'll need to request the Activity (H5P) to be installed on your Moodlerooms site. There is no charge and it is a simple process. A great suggestion that came up a few times was to install it on the sandbox first to test and then enable it on the production environment.

h5p-create-flashcards.pngOnce the activity is there, you can start authoring content in the activity tool. The interface is dynamic, meaning that it changes based on the content type you choose. It is also pretty straightforward and simple to use but supports a great depth of settings and features. The Activity also includes links to tutorials on the site to help you understand what the content types do and how they are created. Lastly but not least, H5P includes essential support for accessibility, such as captioning for videos and alternative text.


We explored some of the content types and discussed some ideas on how to leverage these in teaching and learning. One key element I want to hit on again is that the embedded content works out of the box, but the authored or imported content in the activity format will automatically add a grade item to the grade book and record student performance. Very Exciting!


One last note I want to make in this post. As HTML5 content, your H5P activities and embedded content will also work on student's mobile devices, no fuss. Learners can engage in the content on their web browser on their device, and embedded content displays in the Moodle Mobile App automatically. While the App does not support the activity natively, it will just launch the browser for the student and let them interact with the content through that interface.


So check out the H5P content and activity, and watch for my next post on the topic where we will explore some of the specific content types that I am currently infatuated with and I'll share some example files as well.