Web
Configuring the Home Module for all users
Last updated
MangoApps Administrators Guide
Configuring the Home Module for all users
Last updated
By default, the landing page is set to the Home Module for all users after they log in to your MangoApps domain. Network admins can set up both the default layout and the content that appears on your users’ Home on the User Portal.
Network admins can setup dashboard using fixed height widgets vs variable height widgets. Fixed height widgets help admins to align up the heights of all the widgets in a row. When toggled ON the widget height setting cannot be overridden by end users, to ensure they get a consistent UX.
Click the Widget Gallery button to scroll through the list of widgets and then click the + Add button to add them to the home page. Each widget dynamically loads the content based on the logged in user's role.
For a full list of the widgets offered by MangoApps, check out the pdf below!
To see more information on specific widgets, visit their sub-articles under the full module explanation in the User Guide.
Click the Publish Changes Only button to apply the edits made to Home and append the changes to the existing Home configurations of users. This does not overwrite the existing Home configurations of the users.
Home module changes by the network admin are logged in the Audit Log as Dashboard published with changes only for the Dashboard item type.
Impact of Publish Changes Only:
A newly added widget by the network admin gets added to the end of the user home module (if the widget is not present).
Edited widgets (for example, settings changed via the Set Properties option found in a widget's 3-Dot action menu) by the network admin get updated on the user's dashboard (if the widget is present).
Deleted widgets by the network admin get deleted from the user dashboard (if the widget is present).
No layout changes will be made to the user's dashboard.
Other widgets on the user dashboard will not be changed or removed.
Publish Full Home
Click the Publish Full Home button to apply the edits made to Home and overwrite the existing Home module settings of users.
Home changes by the network admin are logged in the Audit Log.
Click the Publish Full Home button to open the Confirmation pop-up window.
Publish Setting
Publish for new users: Select the option to publish the Home module configurations to all new users signing up on your domain and the invited users on your domain in the future.
Publish for all users: Select the option to publish the Home module configurations to all existing and new users. This option overwrites the existing Home configurations of all existing users.
Home Setting
Fully-Customizable: Select the Fully-Customizable option when publishing your Home module layout to ensure that users can add, remove, resize, and rearrange widgets.
Semi-Customizable: Select the Semi-Customizable option when publishing the Home module layout to ensure that all users have the same widgets with the ability to resize, reorder widgets, and change the layout. The semi-customizable option does NOT let users add or remove widgets.
Locked: Selecting the Locked option when publishing the Home module layout to ensure that all users have the same widgets without the ability to customize them. The locked option does NOT let users add, remove, resize, reorder widgets, or change the layout.
Notification Setting
Click the toggle bar to send a notification to all network users about the Home module update. The system displays "[Username] has updated your dashboard." Username refers to the network admin who updated the Home module layout.
Click the Publish button to save all Home configurations.
All widgets display the user-specific content in Home for each user on the User Portal.
Publishing Home module changes sends a notification to all network users and NOT guest users.
Preview
Click to view the Home module settings. When designing the web Home module, real content in the widgets is also shown to help get a better picture of with both design & data. You can preview the new Home module layout before publishing for both web & mobile devices are available.
Configure the Home module from the Admin Portal for all users by adding widgets.
To add widgets:
Click the Widget Gallery button to open the Add Web Widgets pop-up.
Click the preferred widget to add it. You can search for specific widgets by utilizing the Quick Search bar along the top left of the gallery.
Once you have selected all the desired widgets, click Done. The selected widgets will begin to populate at the bottom of the Home module editor.
Once the widgets have been added from the gallery, additional layout options becaome available.
Resize the widgets by dragging the small icon on the bottom right edge of the widget. The widgets can also be drag-and-dropped at the preferred position.
Clicking this option will open the Set Properties pop-up window. Depending on the widget type selected, additional settings will appear. However, most widgets will possess the following:
In a scenario where the page width is fixed at 1200px, such as on Home, Team, or Company pages, using the default font family and size, the following character limits apply to widgets:
Widgets with a single column display approximately 30 characters before ellipsis appear.
Widgets with two columns display around 70 characters before ellipsis.
Widgets with three columns display all 100 characters.
However, in a full-width scenario (exclusive to the Home module), the character limits for widgets are as follows:
Single-column widgets show approximately 50 characters before ellipsis.
Two-column and three-column widgets display all 100 characters without ellipsis.
From the admin portal, widgets can be assigned header images. Toggle Title to the OFF position to use the just the image as the header of the widget.
| Width of Widget | Minimum px | Recommended px |
|---|---|---|
1 Column Widget | 400 x 96 px | 600 x 144 px |
2 Column Widget | 800 x 96 px | 1200 x 144 px |
3 Column Widget | 1200 x 96 px | 1800 x 144 px |
The image uploaded as the 1 column widget header will also serve as the header image for the widget in mobile.
This feature enables you to determine the visibility of the widget, either to all network users or exclusively to specific user segments.
To ensure uniformity in the dashboard layout, we advise adding a widget with an identical column width (1, 2, or 3) below any widget with restricted visibility.
Click the Lock () icon to create a sticky widget. A sticky widget ensures that a widget remains on all users home modules permanently — they cannot delete this widget nor change the title. This option still lets users add and remove other widgets.
Hover over the More Options () icon to duplicate, add more, or remove widgets. This menu also allows you to Set Properties for individual widgets.
