1 files changed, 28 insertions, 0 deletions
diff --git a/library/Icingadb/Hook/HostsDetailExtensionHook.php b/library/Icingadb/Hook/HostsDetailExtensionHook.php
new file mode 100644
index 0000000..79c091e
--- /dev/null
+++ b/library/Icingadb/Hook/HostsDetailExtensionHook.php
@@ -0,0 +1,28 @@
+<?php
+
+/* Icinga DB Web | (c) 2021 Icinga GmbH | GPLv2 */
+
+namespace Icinga\Module\Icingadb\Hook;
+
+use Icinga\Module\Icingadb\Hook\ExtensionHook\ObjectsDetailExtensionHook;
+use Icinga\Module\Icingadb\Model\Host;
+use ipl\Html\ValidHtml;
+use ipl\Orm\Query;
+
+abstract class HostsDetailExtensionHook extends ObjectsDetailExtensionHook
+{
+    /**
+     * Assemble and return an HTML representation of the given hosts
+     *
+     * The given query is already pre-filtered with the user's custom filter and restrictions. The base filter does
+     * only contain the user's custom filter, use this for e.g. subsidiary links.
+     *
+     * The query is also limited by default, use `$hosts->limit(null)` to clear that. But beware that this may yield
+     * a huge result set in case of a bulk selection.
+     *
+     * @param Query<Host> $hosts
+     *
+     * @return ValidHtml
+     */
+    abstract public function getHtmlForObjects(Query $hosts): ValidHtml;
+}