1 files changed, 191 insertions, 0 deletions
diff --git a/lib/private/FullTextSearch/Model/SearchTemplate.php b/lib/private/FullTextSearch/Model/SearchTemplate.php
new file mode 100644
index 00000000000..6f9a04a911e
--- /dev/null
+++ b/lib/private/FullTextSearch/Model/SearchTemplate.php
@@ -0,0 +1,191 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * SPDX-FileCopyrightText: 2019 Nextcloud GmbH and Nextcloud contributors
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+namespace OC\FullTextSearch\Model;
+
+use JsonSerializable;
+use OCP\FullTextSearch\IFullTextSearchProvider;
+use OCP\FullTextSearch\Model\ISearchOption;
+use OCP\FullTextSearch\Model\ISearchTemplate;
+
+/**
+ * Class ISearchTemplate
+ *
+ * This is a data transfer object that should be created by Content Provider
+ * when the getSearchTemplate() method is called.
+ *
+ * The object will contain templates to be displayed, and the list of the different
+ * options to be available to the user when they start a new search.
+ *
+ * The display of the Options is generated by the FullTextSearch app and Options
+ * can be displayed in 2 places:
+ *
+ * - the navigation page of the app that generate the indexed content.
+ *   (files, bookmarks, deck, mails, ...)
+ * - the navigation page of the FullTextSearch app.
+ *
+ * Both pages will have different Options, and only the first one can integrate
+ * a specific template.
+ *
+ * @see IFullTextSearchProvider::getSearchTemplate
+ *
+ * @since 15.0.0
+ *
+ * @package OC\FullTextSearch\Model
+ */
+final class SearchTemplate implements ISearchTemplate, JsonSerializable {
+	private string $template = '';
+
+	/** @var SearchOption[] */
+	private array $panelOptions = [];
+
+	/** @var SearchOption[] */
+	private array $navigationOptions = [];
+
+	/**
+	 * ISearchTemplate constructor.
+	 *
+	 * the class of the icon and the css file to be loaded can be set during the
+	 * creation of the object.
+	 *
+	 * @since 15.0.0
+	 */
+	public function __construct(
+		private string $icon = '',
+		private string $css = '',
+	) {
+	}
+
+
+	/**
+	 * Set the class of the icon to be displayed in the left panel of the
+	 * FullTextSearch navigation page, in front of the related Content Provider.
+	 *
+	 * @since 15.0.0
+	 */
+	public function setIcon(string $class): ISearchTemplate {
+		$this->icon = $class;
+
+		return $this;
+	}
+
+	/**
+	 * Get the class of the icon.
+	 */
+	public function getIcon(): string {
+		return $this->icon;
+	}
+
+
+	/**
+	 * Set the path of a CSS file that will be loaded when needed.
+	 *
+	 * @since 15.0.0
+	 */
+	public function setCss(string $css): ISearchTemplate {
+		$this->css = $css;
+
+		return $this;
+	}
+
+	/**
+	 * Get the path of the CSS file.
+	 *
+	 * @since 15.0.0
+	 */
+	public function getCss(): string {
+		return $this->css;
+	}
+
+
+	/**
+	 * Set the path of the file of a template that the HTML will be displayed
+	 * below the Options.
+	 * This should only be used if your Content Provider needs to set options in
+	 * a way not generated by FullTextSearch
+	 *
+	 * @since 15.0.0
+	 */
+	public function setTemplate(string $template): ISearchTemplate {
+		$this->template = $template;
+
+		return $this;
+	}
+
+	/**
+	 * Get the path of the template file.
+	 *
+	 * @since 15.0.0
+	 */
+	public function getTemplate(): string {
+		return $this->template;
+	}
+
+
+	/**
+	 * Add an option in the Panel that is displayed when the user start a search
+	 * within the app that generate the content.
+	 *
+	 * @see ISearchOption
+	 *
+	 * @since 15.0.0
+	 */
+	public function addPanelOption(ISearchOption $option): ISearchTemplate {
+		$this->panelOptions[] = $option;
+
+		return $this;
+	}
+
+	/**
+	 * Get all options to be displayed in the Panel.
+	 *
+	 * @since 15.0.0
+	 *
+	 * @return SearchOption[]
+	 */
+	public function getPanelOptions(): array {
+		return $this->panelOptions;
+	}
+
+
+	/**
+	 * Add an option in the left panel of the FullTextSearch navigation page.
+	 *
+	 * @see ISearchOption
+	 *
+	 * @since 15.0.0
+	 */
+	public function addNavigationOption(ISearchOption $option): ISearchTemplate {
+		$this->navigationOptions[] = $option;
+
+		return $this;
+	}
+
+	/**
+	 * Get all options to be displayed in the FullTextSearch navigation page.
+	 *
+	 * @since 15.0.0
+	 */
+	public function getNavigationOptions(): array {
+		return $this->navigationOptions;
+	}
+
+
+	/**
+	 * @since 15.0.0
+	 */
+	public function jsonSerialize(): array {
+		return [
+			'icon' => $this->getIcon(),
+			'css' => $this->getCss(),
+			'template' => $this->getTemplate(),
+			'panel' => $this->getPanelOptions(),
+			'navigation' => $this->getNavigationOptions()
+		];
+	}
+}