{"id":2614,"date":"2015-10-26T15:16:51","date_gmt":"2015-10-26T15:16:51","guid":{"rendered":"https:\/\/twproject.com\/support\/twproject-advanced-usage\/customizations\/dashboard-customization\/"},"modified":"2021-08-26T14:20:16","modified_gmt":"2021-08-26T14:20:16","slug":"dashboard-customization","status":"publish","type":"page","link":"https:\/\/twproject.com\/support\/twproject-advanced-usage\/customizations\/dashboard-customization\/","title":{"rendered":"Dashboards"},"content":{"rendered":"<p><img loading=\"lazy\" decoding=\"async\" class=\"alignnone wp-image-4947 size-full\" src=\"https:\/\/twproject.com\/support\/wp-content\/uploads\/customiza-pagina.png\" alt=\"\" width=\"1590\" height=\"897\" \/><\/p>\n<p>Dashboards are\u00a0used to keep every work aspect under control at a glance.<br \/>\nEvery company and every user may require to keep different information under control; every Twproject\u2019 user by default can customize her\/his home page\/dashboard.<\/p>\n<p>A dashboard (also called &#8220;page&#8221;) is composed by a &#8220;template&#8221; (the grid) and several widget (also called &#8220;portlet&#8221;) placed on each grid&#8217; &#8220;box&#8221;.<\/p>\n<h2>Pages<\/h2>\n<p>Twproject comes with several pre-defined pages that you can customize.<br \/>\nYou can anytime create new pages<\/p>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"alignnone wp-image-5052 size-full\" src=\"https:\/\/twproject.com\/support\/wp-content\/uploads\/pages.png\" alt=\"\" width=\"1582\" height=\"551\" \/><\/p>\n<p>Editing a page<\/p>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"alignnone wp-image-5053 size-full\" src=\"https:\/\/twproject.com\/support\/wp-content\/uploads\/page-editor.png\" alt=\"\" width=\"1593\" height=\"694\" \/><\/p>\n<p>Define a title, a name, the template (see below for more on templates).<\/p>\n<p>The name is used for composing the URL, the title is what will be shown in user interface.<\/p>\n<p>You can allow users to customize its copy of this page or not by checking the flag customizable. You can hide the page by set it not active.<\/p>\n<p>You can set permissions on the page, so that the page will be available for some user only.<\/p>\n<p>Then you have to set the page contents simply dragging and dropping the &#8220;widget&#8221; in the grid.<\/p>\n<p><strong>For the administrators: <\/strong><span style=\"line-height: 1.5;\"><span style=\"line-height: 1.5;\">administrators will have a double option: they can change their own page or the \u201cdefault view\u201d for other operators, so pay attention on what you are editing.<\/span><\/span><\/p>\n<p>&nbsp;<\/p>\n<h2>Templates (the grid)<\/h2>\n<p>A template represents the page grid. It should contain the \u201careas\u201d where you can drop your widget:<\/p>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-full wp-image-2655\" src=\"https:\/\/twproject.com\/support\/wp-content\/uploads\/screen1100.jpg\" alt=\"screen1100\" width=\"434\" height=\"171\" \/><\/p>\n<p>Here you have two columns with some boxes identified by the \u201careaname&#8221; property. You can specify that some areas are not customizable writing custom=\u201dno\u201d; in this case the administrator only can drop there widgets.<\/p>\n<h2>Widgets (aka portlet)<\/h2>\n<p>Widgets are the small parts that compose a page.<\/p>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"alignnone wp-image-5054 size-full\" src=\"https:\/\/twproject.com\/support\/wp-content\/uploads\/portlets.png\" alt=\"\" width=\"1599\" height=\"896\" \/><\/p>\n<p>Drag and drop them on a grid&#8217;s box to compose you page.<\/p>\n<p>We provide a quite wide range of built-in widgets, but users (Java programmers) can create their own.<\/p>\n<h2>Editing widgets<\/h2>\n<p>&nbsp;<\/p>\n<p>Here you will see the status of installed widgets.<br \/>\nA widget is an object that refers to a\u00a0self standing <strong>.jsp page<\/strong>\u00a0contained on\u00a0a specific folder (default ones are on [root]\/applications\/teamwork\/portal\/portlets folder).<\/p>\n<p>Having a file on that folder is not sufficient to use a widget, you need to\u00a0create a &#8220;portlet&#8221; object point to it.<\/p>\n<p>In the widget editor you can change name and description, remove the widget from where it is used and modify it.<\/p>\n<p>You can select a widget file from the combo that lists the .jsp files in the folder.<\/p>\n<pre>By selecting \u201cstoring modality\u201d to \u201cwrite\u201d you will be able to change the widget source code. This requires Java skills, do not do it at home :-)<\/pre>\n<p>The \u201csecurity\u201d tab will allow restricting widget usage to users that have particular permissions.<\/p>\n<h2><\/h2>\n<h2>Create your own widgets<\/h2>\n<pre>You should be fluent in Java in order to create your own widgets.<\/pre>\n<p>If you are still reading this section probably you didn\u2019t see the previous disclaimer, anyway\u2026<\/p>\n<p>Let\u2019s start with something really easy: we want to create a widget that shows a satellite photo of weather on NE USA.<\/p>\n<p>First create a new file on [root]\/applications\/teamwork\/customers\/[YOUR_COMPANY_NAME]\/portlets folder: we\u2019ll call it \u201cwp_forecast.jsp\u201d.<\/p>\n<p>Here is the content:<\/p>\n<pre>&lt;div class=\"portletBox\"&gt;\r\n&lt;img src=\"http:\/\/media.zenfs.com\/en_us\/weather\/weather.com\/us_nw_9regradar_medium_usen.jpg?1340207025\" alt=\"satellite forecast\"&gt;\r\n&lt;\/div&gt;<\/pre>\n<p>Then from the widget editor create a new widget: call it \u201cWeather on NE USA\u201d, select \u201cwp_forecast.jsp\u201d as file, save it.<\/p>\n<pre>Probably you will get a warning about the absence of a parameter configuration widget. This is a more sophisticated feature that allows you to customize widget with parameters through the web interface. Study the supplied example wp_iframe.jsp and wp_iframe_param.jsp<\/pre>\n<p>You can change the code by editing it \u201con-line\u201d; just select the \u201cwrite\u201d radio.<\/p>\n<p>&nbsp;<\/p>\n<p>Your new widget is now ready to use: from \u201ccustomize page\u201d, drag and drop the widgets in your page, save.<\/p>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-full wp-image-2662\" src=\"https:\/\/twproject.com\/support\/wp-content\/uploads\/screen1106.jpg\" alt=\"screen1106\" width=\"371\" height=\"321\" \/><\/p>\n<pre>There are many widget distributed with Twproject that not are used by default. You can have a look to them if you are interested on developing a new one.<\/pre>\n<p>&nbsp;<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Dashboards are\u00a0used to keep every work aspect under control at a glance. Every company and every user may require to keep different information under control; every Twproject\u2019 user by default can customize her\/his home page\/dashboard. A dashboard (also called &#8220;page&#8221;) is composed by a &#8220;template&#8221; (the grid) and several widget (also called &#8220;portlet&#8221;) placed on [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"parent":2309,"menu_order":44,"comment_status":"closed","ping_status":"open","template":"","meta":{"footnotes":""},"class_list":["post-2614","page","type-page","status-publish","hentry"],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v25.4 - https:\/\/yoast.com\/wordpress\/plugins\/seo\/ -->\n<title>Dashboards | Twproject support<\/title>\n<meta name=\"description\" content=\"Dashboards are\u00a0used to keep every work aspect under control at a glance. Every company and every user may require to keep different information under\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/twproject.com\/support\/twproject-advanced-usage\/customizations\/dashboard-customization\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Dashboards | Twproject support\" \/>\n<meta property=\"og:description\" content=\"Dashboards are\u00a0used to keep every work aspect under control at a glance. Every company and every user may require to keep different information under\" \/>\n<meta property=\"og:url\" content=\"https:\/\/twproject.com\/support\/twproject-advanced-usage\/customizations\/dashboard-customization\/\" \/>\n<meta property=\"og:site_name\" content=\"Twproject support\" \/>\n<meta property=\"article:publisher\" content=\"https:\/\/www.facebook.com\/twproject\" \/>\n<meta property=\"article:modified_time\" content=\"2021-08-26T14:20:16+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/twproject.com\/support\/wp-content\/uploads\/customiza-pagina.png\" \/>\n\t<meta property=\"og:image:width\" content=\"1590\" \/>\n\t<meta property=\"og:image:height\" content=\"897\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/png\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"3 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/twproject.com\/support\/twproject-advanced-usage\/customizations\/dashboard-customization\/\",\"url\":\"https:\/\/twproject.com\/support\/twproject-advanced-usage\/customizations\/dashboard-customization\/\",\"name\":\"Dashboards | Twproject support\",\"isPartOf\":{\"@id\":\"https:\/\/twproject.com\/support\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\/\/twproject.com\/support\/twproject-advanced-usage\/customizations\/dashboard-customization\/#primaryimage\"},\"image\":{\"@id\":\"https:\/\/twproject.com\/support\/twproject-advanced-usage\/customizations\/dashboard-customization\/#primaryimage\"},\"thumbnailUrl\":\"https:\/\/twproject.com\/support\/wp-content\/uploads\/customiza-pagina.png\",\"datePublished\":\"2015-10-26T15:16:51+00:00\",\"dateModified\":\"2021-08-26T14:20:16+00:00\",\"description\":\"Dashboards are\u00a0used to keep every work aspect under control at a glance. Every company and every user may require to keep different information under\",\"breadcrumb\":{\"@id\":\"https:\/\/twproject.com\/support\/twproject-advanced-usage\/customizations\/dashboard-customization\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/twproject.com\/support\/twproject-advanced-usage\/customizations\/dashboard-customization\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/twproject.com\/support\/twproject-advanced-usage\/customizations\/dashboard-customization\/#primaryimage\",\"url\":\"https:\/\/twproject.com\/support\/wp-content\/uploads\/customiza-pagina.png\",\"contentUrl\":\"https:\/\/twproject.com\/support\/wp-content\/uploads\/customiza-pagina.png\",\"width\":1590,\"height\":897},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/twproject.com\/support\/twproject-advanced-usage\/customizations\/dashboard-customization\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/twproject.com\/support\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Advanced usage\",\"item\":\"https:\/\/twproject.com\/support\/twproject-advanced-usage\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Customization\",\"item\":\"https:\/\/twproject.com\/support\/twproject-advanced-usage\/customizations\/\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"Dashboards\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/twproject.com\/support\/#website\",\"url\":\"https:\/\/twproject.com\/support\/\",\"name\":\"Twproject support\",\"description\":\"Twproject documentation online\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/twproject.com\/support\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Dashboards | Twproject support","description":"Dashboards are\u00a0used to keep every work aspect under control at a glance. Every company and every user may require to keep different information under","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/twproject.com\/support\/twproject-advanced-usage\/customizations\/dashboard-customization\/","og_locale":"en_US","og_type":"article","og_title":"Dashboards | Twproject support","og_description":"Dashboards are\u00a0used to keep every work aspect under control at a glance. Every company and every user may require to keep different information under","og_url":"https:\/\/twproject.com\/support\/twproject-advanced-usage\/customizations\/dashboard-customization\/","og_site_name":"Twproject support","article_publisher":"https:\/\/www.facebook.com\/twproject","article_modified_time":"2021-08-26T14:20:16+00:00","og_image":[{"width":1590,"height":897,"url":"https:\/\/twproject.com\/support\/wp-content\/uploads\/customiza-pagina.png","type":"image\/png"}],"twitter_misc":{"Est. reading time":"3 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/twproject.com\/support\/twproject-advanced-usage\/customizations\/dashboard-customization\/","url":"https:\/\/twproject.com\/support\/twproject-advanced-usage\/customizations\/dashboard-customization\/","name":"Dashboards | Twproject support","isPartOf":{"@id":"https:\/\/twproject.com\/support\/#website"},"primaryImageOfPage":{"@id":"https:\/\/twproject.com\/support\/twproject-advanced-usage\/customizations\/dashboard-customization\/#primaryimage"},"image":{"@id":"https:\/\/twproject.com\/support\/twproject-advanced-usage\/customizations\/dashboard-customization\/#primaryimage"},"thumbnailUrl":"https:\/\/twproject.com\/support\/wp-content\/uploads\/customiza-pagina.png","datePublished":"2015-10-26T15:16:51+00:00","dateModified":"2021-08-26T14:20:16+00:00","description":"Dashboards are\u00a0used to keep every work aspect under control at a glance. Every company and every user may require to keep different information under","breadcrumb":{"@id":"https:\/\/twproject.com\/support\/twproject-advanced-usage\/customizations\/dashboard-customization\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/twproject.com\/support\/twproject-advanced-usage\/customizations\/dashboard-customization\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/twproject.com\/support\/twproject-advanced-usage\/customizations\/dashboard-customization\/#primaryimage","url":"https:\/\/twproject.com\/support\/wp-content\/uploads\/customiza-pagina.png","contentUrl":"https:\/\/twproject.com\/support\/wp-content\/uploads\/customiza-pagina.png","width":1590,"height":897},{"@type":"BreadcrumbList","@id":"https:\/\/twproject.com\/support\/twproject-advanced-usage\/customizations\/dashboard-customization\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/twproject.com\/support\/"},{"@type":"ListItem","position":2,"name":"Advanced usage","item":"https:\/\/twproject.com\/support\/twproject-advanced-usage\/"},{"@type":"ListItem","position":3,"name":"Customization","item":"https:\/\/twproject.com\/support\/twproject-advanced-usage\/customizations\/"},{"@type":"ListItem","position":4,"name":"Dashboards"}]},{"@type":"WebSite","@id":"https:\/\/twproject.com\/support\/#website","url":"https:\/\/twproject.com\/support\/","name":"Twproject support","description":"Twproject documentation online","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/twproject.com\/support\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"}]}},"_links":{"self":[{"href":"https:\/\/twproject.com\/support\/wp-json\/wp\/v2\/pages\/2614","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/twproject.com\/support\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/twproject.com\/support\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/twproject.com\/support\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/twproject.com\/support\/wp-json\/wp\/v2\/comments?post=2614"}],"version-history":[{"count":0,"href":"https:\/\/twproject.com\/support\/wp-json\/wp\/v2\/pages\/2614\/revisions"}],"up":[{"embeddable":true,"href":"https:\/\/twproject.com\/support\/wp-json\/wp\/v2\/pages\/2309"}],"wp:attachment":[{"href":"https:\/\/twproject.com\/support\/wp-json\/wp\/v2\/media?parent=2614"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}