Dashboard Link
*********************

This widget provides a convenient way to link to other dashboards.
It can be configured to open the dashboard in either the same tab or a new tab.
The widget also supports custom styling to fit seamlessly into any dashboard design.

The widget uses the dashboard name to create a direct link. If the dashboard is renamed, the widget will try to link to it by its ID.

Widget setting
==============

The following image shows an example of a widget setting.

\ |IMG1|\

It is possible to customize the widget settings from the inspector panel (in edit mode), as shown below:

+-------------------------+-----------------------------------------------------------------------------------------------------+
|Input value              |Description                                                                                          |
+=========================+=====================================================================================================+
|Dashboard Default Option |Select the default dashboard to link to                                                              |
+-------------------------+-----------------------------------------------------------------------------------------------------+
|Hide Dropdown Selection  |Boolean to decide if dropdown is visible or not                                                      |
+-------------------------+-----------------------------------------------------------------------------------------------------+
|Open on a New Tab        |Boolean to decide if the link opens in a new tab                                                     |
+-------------------------+-----------------------------------------------------------------------------------------------------+
|Text for Button          |Text to display on the button                                                                        |
+-------------------------+-----------------------------------------------------------------------------------------------------+
|Custom Dropdown CSS      |Write custom CSS for the dropdown. The syntax is the same as standard CSS used in HTML files         |
+-------------------------+-----------------------------------------------------------------------------------------------------+
|Custom Button CSS        |Write custom CSS for the button. The syntax is the same as standard CSS used in HTML files           |
+-------------------------+-----------------------------------------------------------------------------------------------------+
|Custom Widget CSS        |Write custom CSS for the widget container. The syntax is the same as standard CSS used in HTML files |
+-------------------------+-----------------------------------------------------------------------------------------------------+

Once the widget is added, you can select the default dashboard the link should point to.

\ |IMG2|\

The widget also provides advanced styling options to customize the appearance of the dropdown and button.

\ |IMG3|\


Applying CSS to widget
======================

The look and feel of widgets can be customised using the ``Custom CSS`` section. The CSS syntax is the same used in HTML files.

\ |IMG4|\

.. bottom of content

.. |IMG1| image:: _static/img/dashboard_link_widget.png
   :width: 289 px

.. |IMG2| image:: _static/img/dashboard_link_select.png
   :width: 339 px

.. |IMG3| image:: _static/img/dashboard_link_custom_css.png
   :width: 598 px

.. |IMG4| image:: _static/img/dashboard_link_widget_css.png
   :width: 574 px

A note on Shared dashboards
===========================

While the widget will show up on the dashboard for all users,
there are a few things to consider:

* The dropdown will only show dashboards that are owned by the logged in user,
  it is therefore recommended to hide the dropdown for shared dashboards.
* If the dashboard set as default also happens to be shared with a user,
  they can use the link to access it directly.
* If the dashboard is not shared with the user,
  the user will see a message indicating that they do not have access to the dashboard.