You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

60 lines
1.9 KiB

<?php declare(strict_types = 0);
/*
** Zabbix
** Copyright (C) 2001-2023 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.
**/
namespace Zabbix\Widgets\Fields;
use Zabbix\Widgets\CWidgetField;
class CWidgetFieldReference extends CWidgetField {
public const DEFAULT_VALUE = '';
// This field name is reserved by Zabbix for this particular use case. See comments below.
public const FIELD_NAME = 'reference';
/**
* Reference widget field. If added to widget, will generate unique value across the dashboard
* and will be saved to database. This field should be used to save relations between widgets.
*/
public function __construct() {
/*
* All reference fields for all widgets on dashboard should share the same name.
* It is needed to make possible search if value is not taken by some other widget in same dashboard.
*/
parent::__construct(self::FIELD_NAME);
$this
->setDefault(self::DEFAULT_VALUE)
->setSaveType(ZBX_WIDGET_FIELD_TYPE_STR);
}
/**
* @param string $value Reference value. Only numeric characters allowed.
*/
public function setValue($value): self {
if ($value === '' || ctype_alnum((string) $value)) {
$this->value = $value;
}
return $this;
}
}