Page 1 of 1

Opening multiple home pages when launching Atrium

Posted: Mon Aug 09, 2021 9:04 am
by Larelyn
We are using Atrium in an Single Sign-on environment, and we have a strong but small contingent of users that love the product!

In trying to convert more users over, a common request is to have more than one tab open (home page) when they navigate to Atrium. We have several ProfoundUI programs that this group values. Their normal mode is to have several separate Genie sessions open to these programs. They maintain if Atrium can have multiple home pages, they would be more likely to embrace the product.

Obviously, Atrium Control Panel only allows us one home page as default. Is there a way to utilize macro or javascript technologies to have multiple tabs open upon Atrium launch within the same Atrium session?

Re: Opening multiple home pages when launching Atrium

Posted: Mon Aug 09, 2021 3:24 pm
by Emily
Hi Lisa,

Glad to hear that your users are enjoying Atrium!

You're correct that Atrium will only allow you to setup one single Home Page that appears when you first launch Atrium. However, we do offer some JavaScript API that can help with what you're wanting to accomplish:

Atrium.onload(): https://docs.profoundlogic.com/x/ZAClAQ
Atrium.launchItem(): https://docs.profoundlogic.com/x/lAF4

The Atrium.onload() function will run your custom JavaScript code whenever the Atrium page is first rendered. You can use this function, along with the Atrium.launchItem() API, to launch specific menu items once you launch Atrium. For example, you could do something like this:

Code: Select all

Atrium.onload = function() {
   Atrium.api.launchItem(100);
   Atrium.api.launchItem(101);
   Atrium.api.launchItem(102);
}
This example will launch three menu items when Atrium loads: one with the menu ID of 100, one with the menu ID of 101, and one with the menu ID of 102. *Note that you can find the ID of a menu item in the item's settings from the Atrium Control Panel.

So, you would want to setup the different home pages that you're wanting to launch in the Atrium Control Panel, and then place this JavaScript in a file in the /profoundui/userdata/extension/atrium/ directory of your instance. If the /extension/atrium directory does not already exist for your instance, you can simply create it and this should work properly for you.

Does this help? If there's anything else that we can assist with, please let us know!