groupsInternal();
foreach ($groups as $group) {
foreach ($group->entries as $entry) {
if ($entry->id === $this->selectedId) {
$entry->selected = 'selected';
}
}
}
return $groups;
}
/**
* @return BootEntry|null the actual boot entry instance for given entry, null if invalid id
*/
public abstract function getBootEntryInternal(array $localData): ?BootEntry;
public final function getBootEntry(string $jsonString): ?BootEntry
{
$data = json_decode($jsonString, true);
return $this->getBootEntryInternal($data);
}
/**
* @param string $mixed either the plain ID if the entry to be marked as selected, or the JSON string representing
* the entire entry, which must have a key called 'id' that will be used as the ID then.
*/
public function setSelected(string $mixed): void
{
$json = @json_decode($mixed, true);
if (is_array($json)) {
$id = $json['id'];
$this->data = $json;
} else {
$id = $mixed;
}
$this->selectedId = $id;
}
/**
* @return string ID of entry that was marked as selected by setSelected()
*/
public function getSelected(): string
{
return $this->selectedId;
}
/**
* @return HookExtraField[]
*/
public function renderExtraFields(): array
{
$list = $this->extraFields();
foreach ($list as $entry) {
$entry->currentValue = $this->data[$entry->name] ?? $entry->default;
$entry->hook = $this;
}
return $list;
}
}
class HookEntryGroup
{
/**
* @var string
*/
public $groupName;
/**
* @var HookEntry[]
*/
public $entries;
public function __construct($groupName, $entries)
{
$this->groupName = $groupName;
$this->entries = $entries;
}
}
class HookEntry
{
/**
* @var string
*/
public $id;
/**
* @var string
*/
public $name;
/**
* @var bool
*/
public $valid;
/**
* @var string if !valid, this will be the string 'disabled', empty otherwise
*/
public $disabled;
/**
* @var string internal - to be set by ipxe module
*/
public $selected;
public function __construct(string $id, string $name, bool $valid)
{
$this->id = $id;
$this->name = $name;
$this->valid = $valid;
$this->disabled = $valid ? '' : 'disabled';
}
}
class HookExtraField
{
/**
* @var string ID of extra field, [a-z0-9\-] please. Must not be 'id'
*/
public $name;
/**
* @var string type of field, use string, bool, or an array of predefined options
*/
public $type;
/**
* @var mixed default value
*/
public $default;
public $currentValue;
/**
* @var BootEntryHook
*/
public $hook;
public function __construct(string $name, string $type, $default)
{
$this->name = $name;
$this->type = $type;
$this->default = $default;
}
public function fromPost($typePrefix)
{
if (is_array($this->type)) {
$val = Request::post('extra-' . $typePrefix . '-' . $this->name, '', 'array');
if (!in_array($val, $this->type)) {
$val = $this->default;
}
} else {
$val = Request::post('extra-' . $typePrefix . '-' . $this->name, '', $this->type);
settype($val, $this->type);
}
return $val;
}
public function html(): string
{
$fieldId = 'extra-' . $this->hook->moduleId . '-' . $this->name;
$fieldText = htmlspecialchars(Dictionary::translateFileModule($this->hook->moduleId, 'module', 'ipxe-' . $this->name));
if (is_array($this->type)) {
$out = '';
return $out;
}
if ($this->type === 'bool') {
$checked = $this->currentValue ? 'checked' : '';
return '';
}
// Default
return ''
. '';
}
}