Thomas
3f02da7b59
Related to #7020 and #7018. Restore DNS summary colors, fit compact cards, and match preview text scaling.
65 lines
2.4 KiB
Plaintext
65 lines
2.4 KiB
Plaintext
---
|
||
title: "DNS Hole Summary"
|
||
description: "Displays the summary of your DNS Hole."
|
||
hide_title: true
|
||
---
|
||
|
||
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 { dnsHoleSummaryWidget } from ".";
|
||
|
||
<WidgetHeader widget={dnsHoleSummaryWidget} categories={["DNS Hole"]} />
|
||
|
||
The DNS Hole Summary widget combines total queries, blocked queries, and blocklist size from selected DNS services.
|
||
Healthy sources remain visible when another integration fails.
|
||
|
||
On an uncached board load, Homarr starts summaries on the server for the initial layout, outside collapsed sections.
|
||
Each result appears when ready; integration permissions still apply.
|
||
|
||
### 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.src} alt="grid-layout pi-hole-colors" width={256 + 8} height={256 + 8} />
|
||
<div className="flex flex-col gap-2">
|
||
<img src={verticalLayout.src} alt="vertical-layout no-colors" width={128} height={128} />
|
||
<img src={horizontalLayout.src} alt="horizontal-layout pi-hole-colors" width={128 * 3} height={128} />
|
||
</div>
|
||
</div>
|
||
|
||
### Supported Integrations
|
||
|
||
<WidgetIntegrations
|
||
items={[
|
||
{
|
||
integration: adguardHomeIntegration,
|
||
},
|
||
{
|
||
integration: piHoleIntegration,
|
||
},
|
||
{
|
||
integration: technitiumDnsIntegration,
|
||
},
|
||
]}
|
||
/>
|
||
|
||
### Adding the widget
|
||
|
||
<AddingWidget />
|
||
|
||
### Configuration
|
||
|
||
Enable **Use Pi-Hole colors** to color the four statistics red, yellow, cyan, and green with any supported DNS integration. Disable it to use the board's primary color. Both modes respect the board opacity.
|
||
|
||
Compact cards, including 1×1 widgets on scaled boards, show abbreviated values without icons or labels. Hover or focus a value to see its metric label; larger cards keep their icons and labels.
|
||
|
||
<WidgetConfig configuration={dnsHoleSummaryWidget.configuration} />
|