<?php
/*
* OIDplus 2.0
* Copyright 2019 Daniel Marschall, ViaThinkSoft
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
class OIDplusObjectTypePluginGuid extends OIDplusObjectTypePlugin {
public static function getPluginInformation() {
$out['name'] = 'Globally Unique Identifier (GUID)';
$out['author'] = 'ViaThinkSoft';
$out['version'] = null;
$out['descriptionHTML'] = null;
return $out;
}
public static function getObjectTypeClassName() {
return 'OIDplusGuid';
}
}
class OIDplusGuid extends OIDplusObject {
private $guid;
public function __construct($guid) {
if (uuid_valid($guid)) {
$this->guid = uuid_canonize($guid); // It is a real GUID (leaf node)
} else {
$this->guid = $guid; // It is a category name
}
}
public static function parse($node_id) {
if ($namespace !== 'guid') return false;
return new self($guid);
}
public static function objectTypeTitle() {
return "Globally Unique Identifier (GUID)";
}
public static function objectTypeTitleShort() {
return "GUID";
}
public static function ns() {
return 'guid';
}
public static function root() {
return 'guid:';
}
public function isRoot() {
return $this->guid == '';
}
public function nodeId($with_ns=true) {
return $with_ns ? 'guid:'.$this->guid : $this->guid;
}
public function addString($str) {
if (uuid_valid($str)) {
// real GUID
return 'guid:'.uuid_canonize($str);
} else {
// just a category
return 'guid:'.$this->guid.'/'.$str;
}
}
public function crudShowId(OIDplusObject $parent) {
}
public function crudInsertPrefix() {
return '';
}
public function jsTreeNodeName(OIDplusObject $parent = null) {
if ($parent == null) return $this->objectTypeTitle();
return $this->crudShowId($parent);
}
public function defaultTitle() {
return $this->guid;
}
public function isLeafNode() {
return uuid_valid($this->guid);
}
public function getContentPage(&$title, &$content, &$icon) {
$icon = file_exists(__DIR__
.'/icon_big.png') ?
'plugins/objectTypes/'.basename(__DIR__
).'/icon_big.png' : '';
if ($this->isRoot()) {
$title = OIDplusGuid::objectTypeTitle();
$res = OIDplus
::db()->query("select * from ###objects where parent = ?", array(self::root())); if ($res->num_rows() > 0) {
$content = 'Please select a GUID in the tree view at the left to show its contents.';
} else {
$content = 'Currently, no GUID is registered in the system.';
}
if (!$this->isLeafNode()) {
if (OIDplus::authUtils()::isAdminLoggedIn()) {
$content .= '<h2>Manage root objects / categories</h2>';
} else {
$content .= '<h2>Available objects / categories</h2>';
}
$content .= '%%CRUD%%';
}
} else {
$title = $this->getTitle();
if ($this->isLeafNode()) {
uuid_info($this->guid);
$info = preg_replace('@:\s*(.+)\n@ismU', ": <code>\\1</code><br>", $info);
$content = "<h2>Technical information</h2><p>UUID: <code>" . uuid_canonize($this->guid) . "</code><br>" .
"C++ notation: <code>" . uuid_c_syntax($this->guid) . "</code><br>" .
"$info";
// "<a href=\"https://misc.daniel-marschall.de/tools/uuid_mac_decoder/interprete_uuid.php?uuid=".urlencode($this->guid)."\">More technical information</a></p>";
} else {
$content = '';
}
$content .= '<h2>Description</h2>%%DESC%%';
if (!$this->isLeafNode()) {
if ($this->userHasWriteRights()) {
$content .= '<h2>Create or change subsequent objects / categories</h2>';
} else {
$content .= '<h2>Subsequent objects / categories</h2>';
}
$content .= '%%CRUD%%';
}
}
}
// TODO: It would be nice if category and leaf items could have different pictures.
// But the problem is, that the RA link should have a orange "GUID" icon, not a folder icon
/*
public function getIcon($row) {
if (!$this->isLeafNode()) return null; // foldericon
return parent::getIcon($row);
}
*/
public function one_up() {
// A GUID is a GUID, there is no hierarchy
return false;
}
public function distance($to) {
// Distance between GUIDs is not possible
return null;
}
public function getAltIds() {
if ($this->isRoot()) return array(); if (!$this->isLeafNode()) return array(); $ids = parent::getAltIds();
$ids[] = new OIDplusAltId('oid', uuid_to_oid($this->guid), 'OID representation of UUID');
return $ids;
}
}