Current File : /var/www/projetos/suporte.iigd.com.br/src/Dashboard/Item.php
<?php
/**
* ---------------------------------------------------------------------
*
* GLPI - Gestionnaire Libre de Parc Informatique
*
* http://glpi-project.org
*
* @copyright 2015-2024 Teclib' and contributors.
* @copyright 2003-2014 by the INDEPNET Development Team.
* @licence https://www.gnu.org/licenses/gpl-3.0.html
*
* ---------------------------------------------------------------------
*
* LICENSE
*
* This file is part of GLPI.
*
* This program is free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program. If not, see <https://www.gnu.org/licenses/>.
*
* ---------------------------------------------------------------------
*/
namespace Glpi\Dashboard;
class Item extends \CommonDBChild
{
public static $itemtype = "Glpi\\Dashboard\\Dashboard";
public static $items_id = 'dashboards_dashboards_id';
// prevent bad getFromDB when bootstraping tests suite
// FIXME Should be true
public static $mustBeAttached = false;
/**
* Return items for the provided dashboard
*
* @param int $dashboards_id
*
* @return array the items
*/
public static function getForDashboard(int $dashboards_id = 0): array
{
/** @var \DBmysql $DB */
global $DB;
$di_iterator = $DB->request([
'FROM' => self::getTable(),
'WHERE' => [
'dashboards_dashboards_id' => $dashboards_id
]
]);
$items = [];
foreach ($di_iterator as $item) {
unset($item['id']);
$item['card_options'] = importArrayFromDB($item['card_options']);
$items[] = $item;
}
return $items;
}
/**
* Save items in DB for the provided dashboard
*
* @param int $dashboards_id id (not key) of the dashboard
* @param array $items cards of the dashboard, contains:
* - gridstack_id: unique id of the card in the grid, usually build like card_id.uuidv4
* - card_id: key of array return by getAllDasboardCards
* - x: position in grid
* - y: position in grid
* - width: size in grid
* - height: size in grid
* - card_options, sub array, depends on the card, contains at least a key color
*
* @return void
*/
public static function addForDashboard(int $dashboards_id = 0, array $items = [])
{
/**
* @var \DBmysql $DB
* @var array $_UREQUEST
*/
global $DB, $_UREQUEST;
$query_items = $DB->buildInsert(
self::getTable(),
[
'dashboards_dashboards_id' => new \QueryParam(),
'gridstack_id' => new \QueryParam(),
'card_id' => new \QueryParam(),
'x' => new \QueryParam(),
'y' => new \QueryParam(),
'width' => new \QueryParam(),
'height' => new \QueryParam(),
'card_options' => new \QueryParam(),
]
);
$stmt = $DB->prepare($query_items);
foreach ($items as $item_key => $item) {
// card_options should be unescaped as they will be json_encoded after
$card_options = $_UREQUEST['items'][$item_key]['card_options'] ?? $item['card_options'] ?? [];
// clean
unset(
$card_options['force'],
$card_options['card_id'],
$card_options['gridstack_id']
);
// encode for DB
$card_options = exportArrayToDB($card_options);
$gridstack_id = $item['gridstack_id'] ?? $item['gs_id'];
$stmt->bind_param(
'issiiiis',
$dashboards_id,
$gridstack_id,
$item['card_id'],
$item['x'],
$item['y'],
$item['width'],
$item['height'],
$card_options
);
$DB->executeStatement($stmt);
}
}
}
Mini Shell