Files
homarr/apps/docs/docs/widgets/dns-hole-summary/index.mdx
T

64 lines
2.2 KiB
Plaintext

---
title: "DNS Hole Summary"
description: "Displays the summary of your DNS Hole."
hide_title: true
---
import { WidgetInteractionGuide } from "@site/src/components/widgets/interactions";
import { WidgetHeader } from "@site/src/components/widgets/header";
import { AddingWidget } from "@site/src/components/widgets/adding";
import { WidgetConfig } from "@site/src/components/widgets/configuration";
import { WidgetIntegrations } from "@site/src/components/widgets/integrations";
import { IconAd } from "@tabler/icons-react";
import Tabs from "@theme/Tabs";
import TabItem from "@theme/TabItem";
import { dnsHoleSummaryWidget } from ".";
<WidgetHeader widget={dnsHoleSummaryWidget} categories={["DNS Hole"]} />
This widget combines statistics from every selected DNS service, including total queries, blocked queries, and blocklist size. Its data is cached under the same DNS query family as DNS Hole Controls, so placing both widgets on a board does not create a second integration request. When the widget has enough room, it adds a scrollable status row naming each selected source.
### Screenshots
import gridLayout from "./img/grid.png";
import verticalLayout from "./img/vertical.png";
import horizontalLayout from "./img/horizontal.png";
import { adguardHomeIntegration } from "@site/docs/integrations/adguard-home";
import { piHoleIntegration } from "@site/docs/integrations/pi-hole";
import { technitiumDnsIntegration } from "@site/docs/integrations/technitium-dns";
<div className="flex gap-2">
<img src={gridLayout} alt="grid-layout pi-hole-colors" width={256 + 8} height={256 + 8} />
<div className="flex flex-col gap-2">
<img src={verticalLayout} alt="vertical-layout no-colors" width={128} height={128} />
<img src={horizontalLayout} alt="horizontal-layout pi-hole-colors" width={128 * 3} height={128} />
</div>
</div>
### Supported Integrations
<WidgetIntegrations
items={[
{
integration: adguardHomeIntegration,
},
{
integration: piHoleIntegration,
},
{
integration: technitiumDnsIntegration,
},
]}
/>
<WidgetInteractionGuide advancedView={false} />
### Adding the widget
<AddingWidget />
### Configuration
<WidgetConfig configuration={dnsHoleSummaryWidget.configuration} />