Moodle 3.1 beta has been released and I am happy to start another round of the popular Moodle plugins Triathlon!
The basic rules are same as the last time - see the original post. To receive the Early bird award
- your plugin must be tested for 3.1 compatibility,
- all eventual regressions (including PHP notices) must be fixed,
- the compatible version must be released in time of actual Moodle 3.1 release (expected to happen on May 23rd).
As a new rule (to make it even more funny and challenging!), your plugin must come with a valid PHPUnit and/or Behat test. The test coverage does not need to be 100% but dummy tests will not qualify.
Ready, steady, go!
Please see the useful 3.1 plugin upgrade checklist published by Marina at General developer forum post.
David, does the new rule (a valid PHPUnit and/or Behat test) applies to themes too?
Hmm, that's a good question! Can you think of some theme functionality that could be covered by automated testing?
I don't know any theme including the tests. And thinking in Adaptable, it is really difficult to find some automatic testing having 300 different settings that can be combined.
I'm not a behat expert, all the opposite, but maybe a simple test that could be common for all the themes is the only we could test: Profile, Preferences, Dashboard, .. mainly the items that should be in the custom menu. (Just random thoughts)
The latest OU theme has a lot of behat tests to test things like:
- What appears and disappears, or blocks change to hamburger menus, as the width of the page changes (responsiveness)
- We have used the theme (with a related course format) to make a lot of changes to navigation, and verifying that that works
- ...
There must be more than that. All the behat tests take about 20 minutes to run.
Tim, would be great if you could share these tests.
The most used themes do not have any test and only Essential has some. Maybe we could create some common tests and then, depending the theme complexity add others.
OK, here is one simple one
@ou @ou_vle @theme @theme_osep
Feature: Back to top
In order to go back to the top of the page
As somebody using a mobile device
I should have 'back to top' icons that appear and work
Background:
Given the following "courses" exist:
| fullname | shortname | format | startdate |
| Course 1 | C1 | oustudyplan | 1420243200 |
And I log in as "admin"
And I am using the OSEP theme
And the OU study planner thinks the date is "2015-01-03"
And I am on site homepage
And I follow "Course 1"
And I turn editing mode on in the OSEP theme
# Put 4 weeks into the course.
And I add a section to the end of the OU study planner
And I add a section to the end of the OU study planner
And I add a section to the end of the OU study planner
# Switch to mobile size.
And I change window size to "320x480"
@javascript
Scenario: Check display and usage on main screen
# The icon appears when scrolling down.
When I scroll to the bottom of the OU study planner
And I wait "1" seconds
Then "#osep-backtotop" "css_element" should be visible
# Click on it. It then scrolls to top and disappears.
When I click on "#osep-backtotop a" "css_element"
And I wait "1" seconds
Then "#osep-backtotop" "css_element" should not be visible
# At desktop size they don't appear
When I change window size to "1024x768"
And I scroll to the bottom of the OU study planner
And I wait "1" seconds
Then "#osep-backtotop" "css_element" should not be visible
Obviously all the tests are rather specific to the particular functionality of our theme, but I hope that example helps.
We have total of 113 final candidate plugins that were marked as compatible with Moodle 3.1 by the release date. Great success!
The award will be granted to plugins soon. Well done and thanks everybody for your hard work.
OK, so we have results here! After considering all the received feedback, we have finally decided it will be best to keep the early bird award criteria clean from any additional rules.
All plugins that had a compatible version available by the 3.1 release day 23:59 UTC, receive the "Early 3.1 bird" award. At the end there are 110 such plugins now. Some of them are still waiting for the initial approval checks even if they were submitted in time. Those will appear at the list once they are published in the Plugins directory.
To award those who answered the call for unit tests and Behat tests and have added them to their plugins, we are introducing a fresh new award called "Automated testing support". This award is given to recent plugins that support automated testing via PHPUnit and/or Behat. Recent means that the plugin has to be compatible with currently supported Moodle versions. Initially the award was granted to 177 such plugins.
I am very happy to see numbers of actively maintained plugins that are up-to-date with latest Moodle development. Big thanks and respect to all the maintainers!
"Big thanks and respect to all the maintainers!"
Hear hear