1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
|
<?php
/*
** Zabbix
** Copyright (C) 2001-2022 Zabbix SIA
**
** 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 2 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, write to the Free Software
** Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
**/
/**
* Class containing methods for operations with widget iterators.
*/
abstract class CControllerWidgetIterator extends CControllerWidget {
/**
* @var array $iterator_validation_rules Validation rules for input parameters of the iterator.
*/
private static $iterator_validation_rules = [
'page' => 'required|ge 1'
];
public function __construct() {
parent::__construct();
$this->setValidationRules(self::$iterator_validation_rules);
}
/**
* Set validation rules for input parameters.
*
* @param array $validation_rules Validation rules for input parameters.
*
* @return object
*/
protected function setValidationRules(array $validation_rules) {
return parent::setValidationRules(array_merge(self::$iterator_validation_rules, $validation_rules));
}
/**
* Get realistic page number for given number of child widgets.
*
* @param int $num_widgets Number of child widgets.
*
* @return int Page number.
*/
protected function getIteratorPage($num_widgets) {
return max(1, min((int) $this->getInput('page'), $this->getIteratorPageCount($num_widgets)));
}
/**
* Get number of child widgets to show on a single page.
*
* @return int Number of child widgets.
*/
protected function getIteratorPageSize() {
$fields_data = $this->getForm()->getFieldsData();
return min($fields_data['rows'] * $fields_data['columns'],
floor(DASHBOARD_MAX_COLUMNS * DASHBOARD_WIDGET_MAX_ROWS / DASHBOARD_WIDGET_MIN_ROWS)
);
}
/**
* Get number of pages for given number of child widgets.
*
* @param int $num_widgets Number of child widgets.
*
* @return int Number of pages.
*/
protected function getIteratorPageCount($num_widgets) {
return (floor(max(0, $num_widgets - 1) / $this->getIteratorPageSize()) + 1);
}
}
|