Splash screen

Splash is a tool in BaseExtensions that enables to point to a specific HTML page. Splash is triggered by the command and prompts the page concerned. As an example, this can be used to open an information site related to a feature. This works in both Word, PowerPoint and Excel.

If you want to see an example of usage, take a look at the demo of our Bundles package, which is located here:

...\GIT\SD.Demo\Bundles

Pull and run the SDUP. Here, Splash is supported in CorporateInfographics with the purpose of introducing the feature and explaining the different options.

CMD

<Cmd case="BaseExtensions:splash" path="x"/>

Parameter

path

Define the path to the HTML page. This can be either a website, e.g. https://omnidocs.com, or relative to the Content folder of BaseExtensions.

In the example above, the path is defined as the following:

<Cmd case="BaseExtensions:splash" path="IGSplash/splash.html"/>

Thus, the HTML page is located in this path:

...\OfficeExtensions\Content\BaseExtensions\IGSplash

PopupWidth

Set width of the pop up, e.g. 870.

PopupHeight

Set height of the pop up, e.g. 620.

Support for "Never show this again"

We can create our own HTML pages. However, this article will not elaborate how to create such page, but instead describe how we are able to support a "never show this again" feature on the HTML page. In this way, we allow the user to never see the Splash screen again when starting Word.

In a Splash screen HTML file we can create a link to sd://close/donotshowagain. When navigating to this link, it will close the dialog and not show it again. Here is an example:

<a type=“button” class=“btn btn-outline-sd” href=“sd://close/donotshowagain”>Never show again</a>

This is how it looks in the Splash screen:

If you need to reset and then allow the Splash screen to appear again, go to %appdata% in a folder and search for SplashState.json and remove this file.