require_once(APPROOT.'application/dashboardlayout.class.inc.php'); require_once(APPROOT.'application/dashlet.class.inc.php'); /** * A user editable dashboard page * * @copyright Copyright (C) 2010-2012 Combodo SARL * @license http://opensource.org/licenses/AGPL-3.0 */ abstract class Dashboard { protected $sTitle; protected $sLayoutClass; protected $aWidgetsData; protected $oDOMNode; protected $sId; protected $aCells; public function __construct($sId) { $this->sLayoutClass = null; $this->aCells = array(); $this->oDOMNode = null; $this->sId = $sId; } public function FromXml($sXml) { $this->aCells = array(); // reset the content of the dashboard set_error_handler(array('Dashboard', 'ErrorHandler')); $oDoc = new DOMDocument(); $oDoc->loadXML($sXml); restore_error_handler(); $this->oDOMNode = $oDoc->getElementsByTagName('dashboard')->item(0); $oLayoutNode = $this->oDOMNode->getElementsByTagName('layout')->item(0); $this->sLayoutClass = $oLayoutNode->textContent; $oTitleNode = $this->oDOMNode->getElementsByTagName('title')->item(0); $this->sTitle = $oTitleNode->textContent; $oCellsNode = $this->oDOMNode->getElementsByTagName('cells')->item(0); $oCellsList = $oCellsNode->getElementsByTagName('cell'); foreach($oCellsList as $oCellNode) { $aDashletList = array(); $oDashletList = $oCellNode->getElementsByTagName('dashlet'); foreach($oDashletList as $oDomNode) { $sDashletClass = $oDomNode->getAttribute('xsi:type'); $sId = $oDomNode->getAttribute('id'); $oNewDashlet = new $sDashletClass($sId); $oNewDashlet->FromDOMNode($oDomNode); $aDashletList[] = $oNewDashlet; } $this->aCells[] = $aDashletList; } } /** * Error handler to turn XML loading warnings into exceptions */ public static function ErrorHandler($errno, $errstr, $errfile, $errline) { if ($errno == E_WARNING && (substr_count($errstr,"DOMDocument::loadXML()")>0)) { throw new DOMException($errstr); } else { return false; } } public function ToXml() { $oDoc = new DOMDocument(); $oDoc->formatOutput = true; // indent (must be loaded with option LIBXML_NOBLANKS) $oDoc->preserveWhiteSpace = true; // otherwise the formatOutput option would have no effect $oMainNode = $oDoc->createElement('dashboard'); $oMainNode->setAttribute('xmlns:xsi', "http://www.w3.org/2001/XMLSchema-instance"); $oDoc->appendChild($oMainNode); $oNode = $oDoc->createElement('layout', $this->sLayoutClass); $oMainNode->appendChild($oNode); $oNode = $oDoc->createElement('title', $this->sTitle); $oMainNode->appendChild($oNode); $oCellsNode = $oDoc->createElement('cells'); $oMainNode->appendChild($oCellsNode); foreach ($this->aCells as $aCell) { $oCellNode = $oDoc->createElement('cell'); $oCellsNode->appendChild($oCellNode); foreach ($aCell as $oDashlet) { $oNode = $oDoc->createElement('dashlet'); $oCellNode->appendChild($oNode); $oNode->setAttribute('id', $oDashlet->GetID()); $oNode->setAttribute('xsi:type', get_class($oDashlet)); $oDashlet->ToDOMNode($oNode); } } $sXml = $oDoc->saveXML(); return $sXml; } public function FromParams($aParams) { $this->sLayoutClass = $aParams['layout_class']; $this->sTitle = $aParams['title']; foreach($aParams['cells'] as $aCell) { $aCellDashlets = array(); foreach($aCell as $aDashletParams) { $sDashletClass = $aDashletParams['dashlet_class']; $sId = $aDashletParams['dashlet_id']; $oNewDashlet = new $sDashletClass($sId); $oForm = $oNewDashlet->GetForm(); $oForm->SetParamsContainer($sId); $oForm->SetPrefix(''); $aValues = $oForm->ReadParams(); $oNewDashlet->FromParams($aValues); $aCellDashlets[] = $oNewDashlet; } $this->aCells[] = $aCellDashlets; } } public function Save() { } public function GetLayout() { return $this->sLayoutClass; } public function SetLayout($sLayoutClass) { $this->sLayoutClass = $sLayoutClass; } public function GetTitle() { return $this->sTitle; } public function SetTitle($sTitle) { $this->sTitle = $sTitle; } public function AddDashlet($oDashlet) { $sId = $this->GetNewDashletId(); $oDashlet->SetId($sId); $this->aCells[] = array($oDashlet); } public function Render($oPage, $bEditMode = false, $aExtraParams = array()) { $oPage->add('

'.Dict::S($this->sTitle).'

'); $oLayout = new $this->sLayoutClass; $oLayout->Render($oPage, $this->aCells, $bEditMode, $aExtraParams); if (!$bEditMode) { $oPage->add_linked_script('../js/dashlet.js'); $oPage->add_linked_script('../js/dashboard.js'); } } public function RenderProperties($oPage) { // menu to pick a layout and edit other properties of the dashboard $oPage->add('
'.Dict::S('UI:DashboardEdit:Properties').'
'); $sUrl = utils::GetAbsoluteUrlAppRoot(); $oPage->add('
'.Dict::S('UI:DashboardEdit:Layout').'
'); $oPage->add('
'); foreach( get_declared_classes() as $sLayoutClass) { if (is_subclass_of($sLayoutClass, 'DashboardLayout')) { $oReflection = new ReflectionClass($sLayoutClass); if (!$oReflection->isAbstract()) { $aCallSpec = array($sLayoutClass, 'GetInfo'); $aInfo = call_user_func($aCallSpec); $sChecked = ($this->sLayoutClass == $sLayoutClass) ? 'checked' : ''; $oPage->add(''); // title="" on either the img or the label does nothing ! } } } $oPage->add('
'); $oForm = new DesignerForm(); $oField = new DesignerLongTextField('dashboard_title', Dict::S('UI:DashboardEdit:DashboardTitle'), $this->sTitle); $oForm->AddField($oField); $this->SetFormParams($oForm); $oForm->RenderAsPropertySheet($oPage, false, ':itop-dashboard'); $oPage->add('
'); $oPage->add_ready_script( <<add('
'.Dict::S('UI:DashboardEdit:Dashlets').'
'); $sUrl = utils::GetAbsoluteUrlAppRoot(); $oPage->add('
'); foreach( get_declared_classes() as $sDashletClass) { if (is_subclass_of($sDashletClass, 'Dashlet')) { $oReflection = new ReflectionClass($sDashletClass); if (!$oReflection->isAbstract()) { $aCallSpec = array($sDashletClass, 'IsVisible'); $bVisible = call_user_func($aCallSpec); if ($bVisible) { $aCallSpec = array($sDashletClass, 'GetInfo'); $aInfo = call_user_func($aCallSpec); $oPage->add(''); } } } } $oPage->add('
'); $oPage->add('
'); $oPage->add_ready_script("$('.dashlet_icon').draggable({helper: 'clone', appendTo: 'body', zIndex: 10000, revert:'invalid'});"); $oPage->add_ready_script("$('.layout_cell').droppable({accept:'.dashlet_icon', hoverClass:'dragHover'});"); } public function RenderDashletsProperties($oPage) { // Toolbox/palette to edit the properties of each dashlet $oPage->add('
'.Dict::S('UI:DashboardEdit:DashletProperties').'
'); $oPage->add('
'); foreach($this->aCells as $aCell) { foreach($aCell as $oDashlet) { $sId = $oDashlet->GetID(); $sClass = get_class($oDashlet); if ($oDashlet->IsVisible()) { $oPage->add(''); } } } $oPage->add('
'); $oPage->add('
'); } protected function GetNewDashletId() { $iNewId = 0; foreach($this->aCells as $aDashlets) { foreach($aDashlets as $oDashlet) { $iNewId = max($iNewId, (int)$oDashlet->GetID()); } } return $iNewId + 1; } abstract protected function SetFormParams($oForm); } class RuntimeDashboard extends Dashboard { protected $bCustomized; public function __construct($sId) { parent::__construct($sId); $this->bCustomized = false; } public function SetCustomFlag($bCustomized) { $this->bCustomized = $bCustomized; } protected function SetFormParams($oForm) { $oForm->SetSubmitParams(utils::GetAbsoluteUrlAppRoot().'pages/ajax.render.php', array('operation' => 'update_dashlet_property')); } public function Save() { $sXml = $this->ToXml(); $oUDSearch = new DBObjectSearch('UserDashboard'); $oUDSearch->AddCondition('user_id', UserRights::GetUserId(), '='); $oUDSearch->AddCondition('menu_code', $this->sId, '='); $oUDSet = new DBObjectSet($oUDSearch); if ($oUDSet->Count() > 0) { // Assuming there is at most one couple {user, menu}! $oUserDashboard = $oUDSet->Fetch(); $oUserDashboard->Set('contents', $sXml); $oUserDashboard->DBUpdate(); } else { // No such customized dasboard for the current user, let's create a new record $oUserDashboard = new UserDashboard(); $oUserDashboard->Set('user_id', UserRights::GetUserId()); $oUserDashboard->Set('menu_code', $this->sId); $oUserDashboard->Set('contents', $sXml); $oUserDashboard->DBInsert(); } } public function Revert() { $oUDSearch = new DBObjectSearch('UserDashboard'); $oUDSearch->AddCondition('user_id', UserRights::GetUserId(), '='); $oUDSearch->AddCondition('menu_code', $this->sId, '='); $oUDSet = new DBObjectSet($oUDSearch); if ($oUDSet->Count() > 0) { // Assuming there is at most one couple {user, menu}! $oUserDashboard = $oUDSet->Fetch(); $oUserDashboard->DBDelete(); } } public function Render($oPage, $bEditMode = false, $aExtraParams = array()) { parent::Render($oPage, $bEditMode, $aExtraParams); if (!$bEditMode) { $sEditMenu = "