TWiki Dashboard Add-On

Introduction

A dashboard comes into play when users need to get an overview of their work and want to navigate quickly to relevant places. This TWiki application is designed to give administrators a tool to quickly create dashboards for intranet home, team homepages, project homepages and knowledge bases.

Usage

The add-on defines several sections that are used to create dashboards. This can be done either via DASHBOARD or INCLUDE variables. A dashboard is constructed using the following sections:

Dashboard screenshot (click to enlarge)

• section "dashboard_start"
  • section "banner"
  • section "box_start"
    • Box 1 content
  • section "box_end"
  • section "box_start"
    • Box 2 content
  • section "box_end"
  • ...etc...
• section "dashboard_end"

Banner(s) and boxes fill the dashboard width, and are arranged left to right, top to bottom.

%DASHBOARD{ section="dashboard_start" }%
%DASHBOARD{ section="banner" ... }%
%DASHBOARD{ section="box_start" ... }%
Box 1 content
%DASHBOARD{ section="box_end" }%
%DASHBOARD{ section="box_start" ... }%
Box 2 content
%DASHBOARD{ section="box_end" }%
...etc...
%DASHBOARD{ section="dashboard_end" }%

%INCLUDE{ "TWikiDashboardAddOn" section="dashboard_start" }%
%INCLUDE{ "TWikiDashboardAddOn" section="banner" ... }%
%INCLUDE{ "TWikiDashboardAddOn" section="box_start" ... }%
Box 1 content
%INCLUDE{ "TWikiDashboardAddOn" section="box_end" }%
%INCLUDE{ "TWikiDashboardAddOn" section="box_start" ... }%
Box 2 content
%INCLUDE{ "TWikiDashboardAddOn" section="box_end" }%
...etc...
%INCLUDE{ "TWikiDashboardAddOn" section="dashboard_end" }%

Section "dashboard_start"

The "dashboard_start" section starts a dashboard. It is the container of banners and boxes. A dashboard needs to be closed with a "dashboard_end" section. Parameter:

Section "banner"

The "banner" section defines a banner with an image. All content is specified by parameters, e.g. there is no start and end banner section. Parameters:

Note: The popup (modal dialog box) depends on the TWiki:Plugins.ModalBoxAddOn.

Section "box_start"

The "box_start" section starts a box. A box needs to be closed with a "box_end" section. Parameters:

Section "box_end"

The "box_end" section ends a box. It has no additional parameters.

Section "dashboard_end"

The "dashboard_end" section ends a dashboard. It has no additional parameters.

Dashboard Dimensions

The default dashboard is 1024 pixels wide, which is just about the right size for laptop screens. The TWikiDashboardImages are designed for this width. By default, boxes are 300 pixels wide and 200 pixels high for a 3 column layout. The following screenshot shows the dimensions.

When designing custom dimensions keep in mind that banner(s) and boxes are arranged left to right, top to bottom.

Example

This example defines a simple dashboard. Write this:

%DASHBOARD{ section="dashboard_start" }%
%DASHBOARD{ section="banner"
 image="%PUBURL%/%SYSTEMWEB%/TWikiDashboardImages/marin-headlands.jpg"
 title="Dashboard for %WIKIUSERNAME%"
 titlestyle="color:#800000;"
 button1="TWiki Help|%SYSTEMWEB%.WebHome"
 button2="TWiki Variables|%SYSTEMWEB%.TWikiVariables"
 button3="Popup Demo|Modal Popup Demo|This requires the TWiki:Plugins.ModalBoxAddOn|400"
}%
%DASHBOARD{ section="box_start" title="Box 1 title" }%
Box 1 content
%DASHBOARD{ section="box_end" }%
%DASHBOARD{ section="box_start" title="Box 2 title" }%
Box 2 content
%DASHBOARD{ section="box_end" }%
%DASHBOARD{ section="box_start" title="Box 3 title" }%
Box 3 content
%DASHBOARD{ section="box_end" }%
%DASHBOARD{ section="box_start" title="Box 4 title" width="992" height="100" }%
Box 4 content
%DASHBOARD{ section="box_end" }%
%DASHBOARD{ section="dashboard_end" }%

As documented earlier, an alternate syntax for %DASHBOARD{ section="..." ... }% is %INCLUDE{ "TWikiDashboardAddOn" section="..." ... }%.

This example generates the following dashboard:

Dashboard Logic

This section defines the actual dashboard. View the raw text of this topic to look under the hood.

Installation Instructions

Note: You do not need to install anything on the browser to use this add-on. The following instructions are for the administrator who installs the add-on on the TWiki server.

Show details Hide details

   * %SYSTEMWEB%.TWikiDashboardAddOn variable, documented in %SYSTEMWEB%.VarDASHBOARD:
      * Set DASHBOARD = %INCLUDE{ "%SYSTEMWEB%.TWikiDashboardAddOn" section="%section%" %IF{ "'%height{ default="" }%'!=''" then="height=\"%height%\"" }% %IF{ "'%width{ default="" }%'!=''" then="width=\"%width%\"" }% %IF{ "'%ENCODE{ "%image{ default="" }%" type="entity" }%'!=''" then="image=\"%ENCODE{ "%image%" type="quote" }%\"" }% %IF{ "'%ENCODE{ "%title{ default="" }%" type="entity" }%'!=''" then="title=\"%ENCODE{ "%title%" type="quote" }%\"" }% %IF{ "'%ENCODE{ "%button1{ default="" }%" type="entity" }%'!=''" then="button1=\"%ENCODE{ "%button1%" type="quote" }%\"" }% %IF{ "'%ENCODE{ "%button2{ default="" }%" type="entity" }%'!=''" then="button2=\"%ENCODE{ "%button2%" type="quote" }%\"" }% %IF{ "'%ENCODE{ "%button3{ default="" }%" type="entity" }%'!=''" then="button3=\"%ENCODE{ "%button3%" type="quote" }%\"" }% %IF{ "'%ENCODE{ "%button4{ default="" }%" type="entity" }%'!=''" then="button4=\"%ENCODE{ "%button4%" type="quote" }%\"" }% %IF{ "'%ENCODE{ "%button5{ default="" }%" type="entity" }%'!=''" then="button5=\"%ENCODE{ "%button5%" type="quote" }%\"" }% %IF{ "'%ENCODE{ "%button6{ default="" }%" type="entity" }%'!=''" then="button6=\"%ENCODE{ "%button6%" type="quote" }%\"" }% %IF{ "'%ENCODE{ "%button7{ default="" }%" type="entity" }%'!=''" then="button7=\"%ENCODE{ "%button7%" type="quote" }%\"" }% %IF{ "'%ENCODE{ "%button8{ default="" }%" type="entity" }%'!=''" then="button8=\"%ENCODE{ "%button8%" type="quote" }%\"" }% %IF{ "'%ENCODE{ "%style{ default="" }%" type="entity" }%'!=''" then="style=\"%style%\"" }% %IF{ "'%ENCODE{ "%titlestyle{ default="" }%" type="entity" }%'!=''" then="titlestyle=\"%titlestyle%\"" }% %IF{ "'%ENCODE{ "%contentstyle{ default="" }%" type="entity" }%'!=''" then="contentstyle=\"%contentstyle%\"" }% }%

Add-On Info

• Set SHORTDESCRIPTION = Create professional dashboards for intranet home, teams, knowledge bases and more

Add-on Author: TWiki:Main.PeterThoeny Copyright: © 2012-2013, TWiki:Main.PeterThoeny, TWiki.org © 2012-2013 TWiki:TWiki.TWikiContributor License: GPL (GNU General Public License) Add-on Version: 2013-08-15

Show Change History Hide Change History

2013-08-15: TWikibug:Item7154: Updated nasa-airfield.jpg 2013-07-15: TWikibug:Item7154: Add a new banner image by Blackstation 2013-04-06: TWikibug:Item7154: Add 13 new banner images by Peter Thoeny, 1 by Google 2013-04-22: TWikibug:Item7151: Change CALC to CALCULATE in image library 2013-04-06: TWikibug:Item7154: Add 9 new banner images by Jeffrey Pang, Peter Thoeny, Romain Guy, Steve Dunleavy 2013-02-13: TWikibug:Item7041: Add 5 new banner images by Joi Ito, Jon Brack 2013-02-04: TWikibug:Item7041: Add 3 new banner images by Cindy Cornett Seigle, Danny Hope, Zsolt Andrasi 2013-02-01: TWikibug:Item7041: Add 9 new banner images by Dan Tentler, Jake Rome, Jim Crossley, Juhan Sonin, Matteo Leoni, Paul Downey, Steve Bowbrick, Tom Woodward 2013-01-31: TWikibug:Item7091: Use TWISTY in installation instructions and change history 2013-01-31: TWikibug:Item7041: Add 8 new banner images by Peter Thoeny 2013-01-06: TWikibug:Item7041: Add 4 new banner images by David Yu, Joi Ito 2012-12-28: TWikibug:Item7041: Add 7 new banner images by David Yu, ETH Zurich, Peter Thoeny 2012-12-04: TWikibug:Item7041: Add 10 new banner images by CERN 2012-11-28: TWikibug:Item7041: Add 12 new banner images by Andreas Schaefer, Angela Ju, David Yu, Jeff Keller, Martin Eckert, NASA, Paulo Ordoveza, Peter Thoeny, Sean Fitzgibbon 2012-11-11: TWikibug:Item7020: Categorize TWiki Variable DASHBOARD 2012-11-05: TWikibug:Item7021: Add 6 more banner images by David Yu, Diliff, Goro Kosaka, Jens Hausherr, Koppi2, Sbittante 2012-10-13: TWikibug:Item6972: Add TWikiDashboardAddOn to core distribution; multiple banner buttons with button1="" button2="" ... 2012-10-12: TWikibug:Item6981: Add 12 more dashboard banner images 2012-10-06: TWikibug:Item6954: Initial version

TWiki Dependency: $TWiki::Plugins::VERSION 1.3 (TWiki-5.0) TWiki:Plugins.ScrollBoxAddOn TWiki:Plugins.SpreadSheetPlugin version 2012-04-04 TWiki:Plugins.ModalBoxAddOn required if popup buttons are used CPAN Dependencies: none Other Dependencies: none Perl Version: 5.005 Add-on Home: http://TWiki.org/cgi-bin/view/Plugins/TWikiDashboardAddOn Feedback: http://TWiki.org/cgi-bin/view/Plugins/TWikiDashboardAddOnDev Appraisal: http://TWiki.org/cgi-bin/view/Plugins/TWikiDashboardAddOnAppraisal

Related Topics: VarDASHBOARD, TWikiDashboardImages, ScrollBoxAddOn, TWikiAddOns