N°3123 - Refactor Directories

sources/application/UI/Base/Layout/TabContainer/Tab/AjaxTab.php

@@ -0,0 +1,127 @@
+<?php
+/**
+ * Copyright (C) 2013-2020 Combodo SARL
+ *
+ * This file is part of iTop.
+ *
+ * iTop is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * iTop 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ */
+
+namespace Combodo\iTop\Application\UI\Base\Layout\TabContainer\Tab;
+
+
+use Combodo\iTop\Application\UI\Base\iUIBlock;
+use Combodo\iTop\Application\UI\Base\UIException;
+use Dict;
+use TabManager;
+
+/**
+ * Class AjaxTab
+ *
+ * @package Combodo\iTop\Application\UI\Base\Layout\TabContainer\Tab
+ * @internal
+ * @since   3.0.0
+ */
+class AjaxTab extends Tab {
+	// Overloaded constants
+	public const BLOCK_CODE = 'ibo-ajax-tab';
+	public const TAB_TYPE = TabManager::ENUM_TAB_TYPE_AJAX;
+
+	/** @var string The target URL to be loaded asynchronously */
+	private $sUrl;
+	/** @var bool Whether the tab should should be cached by the browser or always refreshed */
+	private $bCache;
+
+	/**
+	 * @param string $sUrl
+	 *
+	 * @return $this
+	 */
+	public function SetUrl(string $sUrl) {
+		$this->sUrl = $sUrl;
+
+		return $this;
+	}
+
+	/**
+	 * @return string
+	 */
+	public function GetUrl(): string {
+		return $this->sUrl;
+	}
+
+	/**
+	 * Set whether the tab should should be cached by the browser or always refreshed
+	 *
+	 * @param bool $bCache
+	 *
+	 * @return $this
+	 */
+	public function SetCache(bool $bCache) {
+		$this->bCache = $bCache;
+
+		return $this;
+	}
+
+	/**
+	 * Return whether the tab should should be cached by the browser or always refreshed
+	 *
+	 * @return string
+	 */
+	public function GetCache(): string {
+		return $this->bCache ? 'true' : 'false';
+	}
+
+	//-------------------------------
+	// iUIBlock implementation
+	//-------------------------------
+
+	/**
+	 * @inheritDoc
+	 */
+	public function GetParameters(): array {
+		$aParams = parent::GetParameters();
+
+		$aParams['sURL'] = $this->GetUrl();
+		$aParams['sCache'] = $this->GetCache() ? 'true' : 'false';
+
+		return $aParams;
+	}
+
+	//-------------------------------
+	// iUIContentBlock implementation
+	//-------------------------------
+
+	/**
+	 * @inheritDoc
+	 * @throws \Combodo\iTop\Application\UI\Base\UIException
+	 */
+	public function AddHtml(string $sHtml) {
+		throw new UIException($this, Dict::Format('UIBlock:Error:AddBlockForbidden', $this->GetId()));
+	}
+
+	/**
+	 * @inheritDoc
+	 * @throws \Combodo\iTop\Application\UI\Base\UIException
+	 */
+	public function AddSubBlock(iUIBlock $oSubBlock) {
+		throw new UIException($this, Dict::Format('UIBlock:Error:AddBlockForbidden', $this->GetId()));
+	}
+
+	/**
+	 * @inheritDoc
+	 */
+	public function GetSubBlocks(): array {
+		return [];
+	}
+}

sources/application/UI/Base/Layout/TabContainer/Tab/Tab.php

@@ -0,0 +1,89 @@
+<?php
+/**
+ * Copyright (C) 2013-2020 Combodo SARL
+ *
+ * This file is part of iTop.
+ *
+ * iTop is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * iTop 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ */
+
+namespace Combodo\iTop\Application\UI\Base\Layout\TabContainer\Tab;
+
+
+use Combodo\iTop\Application\UI\Base\Layout\UIContentBlock;
+use TabManager;
+
+/**
+ * Class Tab
+ *
+ * @package Combodo\iTop\Application\UI\Base\Layout\TabContainer\Tab
+ * @internal
+ * @since 3.0.0
+ */
+class Tab extends UIContentBlock
+{
+	// Overloaded constants
+	public const BLOCK_CODE = 'ibo-tab';
+	public const HTML_TEMPLATE_REL_PATH = 'base/layouts/tab-container/tab/layout';
+
+	/** @var string */
+	public const TAB_TYPE = TabManager::ENUM_TAB_TYPE_HTML;
+
+	/** @var string */
+	protected $sTitle;
+
+	/**
+	 * Tab constructor.
+	 *
+	 * @param string $sTabCode
+	 * @param string $sTitle
+	 */
+	public function __construct(string $sTabCode, string $sTitle)
+	{
+		parent::__construct($sTabCode);
+		$this->sTitle = $sTitle;
+	}
+
+	/**
+	 * @return string
+	 */
+	public function GetType(): string
+	{
+		return static::TAB_TYPE;
+	}
+
+	/**
+	 * @return string
+	 */
+	public function GetTitle(): string
+	{
+		return $this->sTitle;
+	}
+
+	//-------------------------------
+	// iUIBlock implementation
+	//-------------------------------
+
+	/**
+	 * @inheritDoc
+	 */
+	public function GetParameters(): array
+	{
+		return [
+			'sBlockId' => $this->GetId(),
+			'sTitle' => $this->GetTitle(),
+			'sType' => $this->GetType(),
+			'oBlock' => $this,
+		];
+	}
+}