N°2847 - Rework iTopWebPage layout (WIP Part VI)

- iTopWebPage: Restore "open search" feature - iTopWebPage: Change all resources URL to absolute in order to benefit from the "duplicate removal" benefits - iTopWebPage: Remove obsolete method IsMenuPaneVisible() - Config: Add new parameters quick_create.enabled / global_search.enabled / breadcrumb.enabled - utils: Add new GetAppRevisionNumber() method - Introduce iUIBlock interface for UI layouts, components, ... - Introduce BlockRenderer to properly render blocks - Add "render_block" function to TwigHelper to render blocks directly from TWIG - Refactor layouts and components into proper block classes to fit the new architecture
2026-04-24 02:58:43 +02:00 · 2020-07-29 18:43:31 +02:00
parent b207ae1bb3
commit 1f0211b45a
43 changed files with 2537 additions and 335 deletions
--- a/sources/application/UI/Component/GlobalSearch/GlobalSearchHelper.php
+++ b/sources/application/UI/Component/GlobalSearch/GlobalSearchHelper.php
@@ -0,0 +1,121 @@
+<?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\Component\GlobalSearch;
+
+
+use appUserPreferences;
+use utils;
+
+/**
+ * Class GlobalSearchHelper
+ *
+ * @author Guillaume Lajarige <guillaume.lajarige@combodo.com>
+ * @package Combodo\iTop\Application\UI\Component\GlobalSearch
+ * @internal
+ * @since 2.8.0
+ */
+class GlobalSearchHelper
+{
+	const MAX_HISTORY_SIZE = 10;
+	const USER_PREF_CODE = 'global_search_history';
+
+	/**
+	 * Add $sQuery to the history. History is limited to the static::MAX_HISTORY_SIZE last queries.
+	 *
+	 * @param string $sQuery Raw search query
+	 * @param string|null $sIconRelUrl Relative URL of the icon
+	 * @param string|null $sLabelAsHtml Alternate label for the query (eg. more human readable or with highlights), MUST be html entities
+	 *     otherwise there can be XSS flaws
+	 *
+	 * @return void
+	 * @throws \CoreException
+	 * @throws \CoreUnexpectedValue
+	 * @throws \MySQLException
+	 * @throws \Exception
+	 * @noinspection PhpUnused Called by /pages/UI.php and extensions overloading the global search
+	 */
+	public static function AddQueryToHistory($sQuery, $sIconRelUrl = null, $sLabelAsHtml = null)
+	{
+		$aNewEntry = [
+			'query' => $sQuery,
+		];
+
+		// Set icon only when necessary
+		if(!empty($sIconRelUrl))
+		{
+			//Ensure URL is relative to limit space in the preferences and avoid broken links in case app_root_url changes
+			$aNewEntry['icon_url'] = str_replace(utils::GetAbsoluteUrlAppRoot(), '', $sIconRelUrl);
+		}
+
+		// Set label only when necessary to avoid unnecessary space filling of the preferences in the DB
+		if(!empty($sLabelAsHtml))
+		{
+			$aNewEntry['label_html'] = $sLabelAsHtml;
+		}
+
+		/** @var array $aHistoryEntries */
+		$aHistoryEntries = appUserPreferences::GetPref(static::USER_PREF_CODE, []);
+
+		// Remove same query from history to avoid duplicates
+		for($iIdx = 0; $iIdx < count($aHistoryEntries); $iIdx++)
+		{
+			if($aHistoryEntries[$iIdx]['query'] === $sQuery)
+			{
+				unset($aHistoryEntries[$iIdx]);
+			}
+		}
+
+		// Add new entry
+		array_unshift($aHistoryEntries, $aNewEntry);
+
+		// Truncate history
+		if(count($aHistoryEntries) > static::MAX_HISTORY_SIZE)
+		{
+			$aHistoryEntries = array_slice($aHistoryEntries, 0, static::MAX_HISTORY_SIZE);
+		}
+
+		appUserPreferences::SetPref(static::USER_PREF_CODE, $aHistoryEntries);
+	}
+
+	/**
+	 * Return an array of past queries, including the query itself and its HTML label
+	 *
+	 * @return array
+	 * @throws \CoreException
+	 * @throws \CoreUnexpectedValue
+	 * @throws \MySQLException
+	 */
+	public static function GetLastQueries()
+	{
+		/** @var array $aHistoryEntries */
+		$aHistoryEntries = appUserPreferences::GetPref(static::USER_PREF_CODE, []);
+
+		// Add HTML label if missing
+		for($iIdx = 0; $iIdx < count($aHistoryEntries); $iIdx++)
+		{
+			if(!isset($aHistoryEntries[$iIdx]['label_html']))
+			{
+				$aHistoryEntries[$iIdx]['label_html'] = utils::HtmlEntities($aHistoryEntries[$iIdx]['query']);
+			}
+		}
+
+		return $aHistoryEntries;
+	}
+}