Update Nuggets

Note


The method described here assumes that Nuggets has been installed using the process described in the "Installation" section.

Nuggets is very easy to update. However, we recommend that you never immediately remove the old version that you are about to update. By default, always install the new version on a new slide and test it first.

Now let's look in detail at how to update Nuggets.

Duplicate 1.1 nuggets 00.0.0a

First of all, in the Nuggets scene, let's duplicate the slide that implements the Nuggets library via a Web Object. This way, you keep all the triggers as they are, in particular the main initialisation trigger running the JavaScript that initialises and sets the Nuggets functions you're using.

Delete the Web Object that targets the Nuggets library, then via Storyline's Insert tab, click on Web Object and in the panel that opens, target the content of the new version that you have retrieved. As with the installation, we won't touch the other parameters.

Point of attention


If you have other Web Objects (fonts, downloadable PDFs, etc.) on this base layer, don't delete them!
At best, they will have been placed on the slide mask to avoid any manipulation errors.

Rename the slide with the version number of the release you have retrieved.

Main Slide Master

In the last trigger, target the new slide and publish. We're fairly confident that your project will launch successfully. In the Storyline View tab, then Slide Master, in the main Master, open the triggers panel:

Storyline Triggers
When the timeline starts on 'this slide'
- Pause timeline on 'this slide'
    If 'isOnline' = value 'True'
- Execute 'JavaScript'
    If 'isOnline' = value 'True'
When the timeline starts on 'this slide'
- Resume the timeline on 'this slide'
    If 'isOnline' = value 'True'
        and 'nuggetsLoaded' = value 'True'
- jump to slide '1.1 nuggets 00.0.0a'
    If 'isOnline' = value 'True'
        and 'nuggetsLoaded' = value 'False'

In the last trigger, target the new slide you just created and publish. We're confident that your project will get off to a good start.

If it doesn't, you can always go back to the version you were using before.

Point of attention


If you have other Web Objects (fonts, downloadable PDFs, etc.) on the base layer, don't forget to update the settings for the features concerned with the new folder names.
Refer to the relevant articles to change the settings.

Informations

After testing, if you leave the old versions of Nuggets in place, they won't cause any problems on a number of levels:

  • The weight of each version of Nuggets is nothing compared to the final size of an e-learning project.

    For example, the publication folder, published as is from the .story template available on Github, weighs just 3.8Mb. The library represents only 0.005% of the final weight of the file.

  • As long as the navigation does not allow access to the slides that incorporate older versions of Nuggets, these versions remain inactive.