## 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
361 sites
40 fans
Moodle 3.1, 3.2, 3.3, 3.4, 3.5

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
2/ Install the three following plugins (without exception)
3/ Enable conditional access, named enableavailability under "Site administration > Advanced features"
4/ Restore this backup file as a new course

5/ Enrol a student in the new course
6/
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)

• 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. • Tue, 20 Mar 2018, 4:55 AM I'm wondering what kind of logging this plugin does. I'm working with a professor who uses Level Up and wants to make some awards for things that happen outside of the LMS, but that can be tracked easily through student-submissions or some other mechanism. I'm curious to know if we use this plugin to stash some things at the end of submission forms or something if we could leverage the logging to add to their Level Up point values (because the Stash awards are in the logs). I know it sounds complicated, but is it do-able? • Tue, 20 Mar 2018, 8:59 AM Hello Carly, Yes block stash has an 'item_acquired' event. You can use this with Level Up to give XP to students that gain stash items. • Tue, 20 Mar 2018, 10:49 AM Hi Carly, to complement Adrian's answer, here is a screenshot of what the rule would look like in Level up!: [](screenshot) • Tue, 20 Mar 2018, 9:58 PM Yes, I see that now. My problem is that I need to award different points for different items acquired. • Thu, 22 Mar 2018, 7:34 PM My experience using this plugin is being fantastic. For me, it is a mandatory plugin if you want to use gamification in Moodle. After using it, I have realized that it would be very interesting to have a report containing all the operations (item achievement and trade) searchable for date and user. This woud help a lot when an user claim not to have received an object. Another interesting feature (related to previous one) is the possibility off adding/deleting items manually to/from the stash of a particular user. Thanks a lot for your work • Tue, 3 Apr 2018, 11:11 PM Hi Fred, Thanks a lot for your answer (some weeks ago). I am only getting back to it now. Together with the despription on https://docs.moodle.org/33/en/Stash_block, I manage to get the Generate the javascript snippet. Like this: image challenge Pick up!=item-action"> This works fine, as long as I use the full hash - not if I shorten it. Where I I stuck now, is calling d.pickup(). I tried calling it from a text link or with$( document ).ready(function(){
d.pickup();
});
without success.

Can you help?
Thanks again!
Pascal
• Wed, 4 Apr 2018, 7:11 PM
Hi Fred,
Just to drop a note that managed to get the item picked up automatically (with or with delay). So that's solved.
I just see now that the editor filtered out the code I added to my comment yesterday. Not really useful like that...
Thanks,
Pascal
• Thu, 5 Apr 2018, 10:40 AM
Hi Pascal. Sorry, I didn't have time to follow up prior to you finding the solution. I'm glad to hear that you made it work!
• Mon, 7 May 2018, 10:43 PM
Good evening, I would like to try this plugin. I am sure I followed instructions as best I can. My STASH block does not appear ... where can I find it? It looks as if it is installed under blocks. (Manage Blocks - It is there and visible) No idea what is wrong.

Any suggestions welcome pls!
Mignon
• Tue, 8 May 2018, 10:16 AM
Hi Mignon, at the moment the block can only be added to courses, is that where you were trying to place it? Fred