## Blocks: Stash

block_stash
Maintained by Adrian Greeve, Frédéric Massart
Add an inventory of items to your course and let your students find items by exploring the activities. #game #gamification
265 sites
37 fans
Moodle 2.9, 3.0, 3.1, 3.2, 3.3, 3.4

The stash block is a good way to encourage more interaction with activities and is invaluable for teachers looking to gamify their course.

This plugin introduces a block that shows students items that they have picked up through the course.

The teacher can create items and then place them in activities and resources for students to find.

Items can be set to be collected once and encourages exploration of the course material. It is also possible to set an item to have an unlimited supply from a set location. This could encourage  students to return to specific areas to collect more items.

You can also check out this video:

#### Quick start

We've crafted a sample course for you to try, it is the best way to see what this plugin has to offer. Please accurately follow those steps:

1/ Get your hands on a Moodle installation (3.0 or newer preferred)
2/ Install the three following plugins (without exception)
3/ Enable the filter "Stash snippets" you just installed through "Site administration > Filters"
4/ Enable conditional access, named enableavailability under "Site administration > Advanced features"
5/ Restore this backup file as a new course

6/ Enrol a student in the new course
7/
Now, login as that student and try the course

### Important note

In order to make this plugin easier to use and fully featured, please also install:

They are highly recommended.

### Sets

This plugin is part of sets Stash, Gamification.

### Contributors

Frédéric Massart: (The real lead maintainer)

### Awards

• Wed, 8 Nov 2017, 10:21 AM
Hi Frederic:

Wanted to report that backup and restore worked perfectly on a Moodle 3.2 instance with 2 very large courses (over 250MB) with several hundred activities, many Stash objects, Trades, and conditional access to activities via the Stash availability plugin...AWESOME set of tools for gamification! Can't wait to see what kind of creative things people come up with the Stash set of tools!!
• Thu, 30 Nov 2017, 10:18 PM
Small bug report:

Stash currently prevents the non-editing teacher role from working (they will get an error message and can not access your course). There are also small conflicts with the amazing Snap theme from Moodlerooms, but it is not a big deal (I think it is how Snap deals with blocks--menu navigation doesn't work but the breadcrumb trail does--not a big deal once you train teacher).

Overall, Stash is the BEST plugin for gamification of your course because it is so brilliantly implemented to allow for teacher creativity with the Trade and Availability tools for conditional access! Thank you!
• Tue, 16 Jan 2018, 8:38 PM
Fantastic plugin for gamification. Absolutely recommended!!!. It works fantastic in Moodle 3.4 with Adaptable Theme. The only problem is that non-editing teachers can not see the stash and all the elements that include stash snipets does not work (it appears a message error). Any solution or patch?
• Tue, 16 Jan 2018, 8:54 PM
Problem solved. In order for a non-editing teacher to be able to view the inventory, you must access as Administrator and go to Site administration => Users => Permissions ==> Define roles. You must enable the 3 permissions related to the stash plugin (search for stash). Fantanstic plugin. Thanks
• Wed, 17 Jan 2018, 5:16 AM
Hi Carlos,

Thanks for sharing your enthousiasm! I believe that Adrian and I already discussed the complexity for non-editing teachers to use the plugin. I'm confident that we will simplify this in a future release.

• Wed, 17 Jan 2018, 10:09 PM
Hi Frederic:

Wanted to report and verify that Carlos solution worked for adding non-editing teachers to a course--fantastic!

Small bug report: I tried resetting a course to get ready for a new semester, and it looks like Stash does not have Course Reset implemented yet (not clearing out the Stash items and locations, but rather clearing out old students and items acquired). Not a big deal, but something to implement as Stash is used more and more by teachers around the world!

Thank you!
• Thu, 18 Jan 2018, 8:45 AM
Hi Joseph. The course reset is a good idea. I'll try to remember that.
Sorry about the inaction of late. I've been extremely busy trying to prepare for the GDPR compliance required later on this year.
• Wed, 31 Jan 2018, 12:24 AM
Is there a recommended pixel size for stash icons. I have added ones at 1000x1000 pixels and the same image reduced to 50x50 pixels and they are both the same size. Is there any way to reduce the size they display at?
• Wed, 31 Jan 2018, 2:45 AM
Hi Sue. We recommended between 200x200 and 100x100. The images weigh the same regardless of where they are displayed, on the display size changes. It is therefore not recommended to upload large images. Ideally, Moodle should offer a tool for resizing images but to my knowledge there isn't any yet. I hope this helps.
• Thu, 8 Feb 2018, 5:10 PM
Is there a facility to change the name of the Stash block. We work with disaffected kids who have been excluded from mainstream education, and the connotation with a stash of drugs is putting us off from using the facility. The the Level Up Block can be renamed but I can't see any way to do it for this.
• Fri, 9 Feb 2018, 9:09 AM
Hello Sue. The most recent version of this plugin has the ability to change the block title via the "actions" cog. This version however is only located on github https://github.com/abgreeve/moodle-block_stash. You can click the 'Clone or download' button to download a zip of this version. Alternatively you can change the string through the language customisation settings. This is located in 'Site administration > Language > Language customisation'. After loading all of the strings you can select block_stash and then look for the string 'plugin'. Changing this string will change the title of the stash block.
• Sat, 3 Mar 2018, 1:12 AM
Hi Frédéric,
Thanks for this plugin - it's really cool. I would like to let the learner pick up some items automatically when they view the page. Would you have a trick to achieve that?
Thanks.
• Sat, 3 Mar 2018, 12:41 PM
Hi Pascal,

That is something Adrian and I have considered since the early stage of development but never got around doing it. We had in mind that an item could be automatically found, perhaps after spending a certain amount of time on a page. Perhaps to give more incentive to students to actually read the content rather than clicking everywhere to find items.

There might be ways to achieve this, but you'd have to play around inserting JavaScript (similar to how the plugin used to work without the filter plugin), however, see this as an advanced and error-prone approach. Let me know if you're interested in getting your hands dirty and I'll guide you through it.
• Tue, 6 Mar 2018, 12:07 AM
Hi Frédéric,

Thanks. In fact, I think that your plugin can be a good alternative also to the "normal" access control in Moodle. I would like to set up a rule like "The learner has to access 80% of all content before proceeding to the exam". With the normal access control, one can define every activity to be mandatory, but not a percentage, If they would pic up an item on each page automatically, that can be easily done.

If you can direct me, I will try. I have a bit experience in JavaScript and have done a bit of editing of Moodle plugins, but I don't know how the event listeners work. I guess the picking up is done by the function "pickup_item($itemorid,$quantity = 1, \$userid = null)", but how can I trigger the event from the Moodle page if I know (only) the drop snippet?

Thanks!
Pascal
• Tue, 6 Mar 2018, 9:43 PM
Hi Pascal,

Here you can see the old-fashioned JavaScript snippet: https://github.com/FMCorz/moodle-block_stash/blob/master/amd/src/drop-snippet-maker.js#L206 In short, what you need to do is instantiate the Drop object with ID and the hash of the drop, and then call the d.pickup() method. You set the rules as to when the pickup method has to be called. You can find the ID and Hash when you go to the UI to get the snippet for your item. Note that the full hash should never be included (5 chars is enough IIRC).

Let me know how you go.

Cheers,
Fred

PS: Sorry, quick message but it's the end of the day and my brain isn't functioning any more.