Craft Docs Web Block Reference Counter

WHAT IT DOES

Craft Docs Web Block Reference Counter automatically scans Craft Docs document pages to extract comprehensive block data including block types (text, heading, image, code, table, list, link, mention, other), block count, and reference usage across the document. The tool counts occurrences of each block type and identifies which blocks are referenced elsewhere in the document. A floating overlay panel displays a summary of block usage with color-coded indicators—each block type has a distinct color and icon. Summary statistics show total blocks, unique block types, and total references. A breakdown by block type shows counts and percentages. References are listed with their occurrence counts. A visual block density bar shows the distribution of block types at a glance. This provides a complete, organized view of your document's structure and block organization.

WHERE IT RUNS

This extension operates exclusively on craft.do domain pages that contain document content—specifically pages with "/doc", "/docs", or "/space" in the URL path, or pages that display Craft document blocks. It works alongside the free BotGentz companion extension, which provides the necessary DOM access and page interaction capabilities. The block reference counter runs entirely within your local browser instance and does not communicate with any external servers or APIs. All block data extraction, type analysis, and preference storage are processed and stored on your machine, ensuring your document data and tracking preferences remain private. It supports all modern Chromium-based browsers (Chrome, Edge, Brave, Opera) and Firefox when paired with the BotGentz bridge.

HOW TO USE

After installing both BotGentz and this block counter, navigate to any Craft Docs document page. Within 1-2 seconds, a panel appears in the bottom-right corner displaying a summary with total blocks, unique block types, and total references. The "Block Types" section shows each block type with its icon, count, and percentage. The "Top References" section lists blocks that are referenced most frequently. The "Block Density" section shows a visual bar chart of block type distribution. The panel provides a complete, organized view of your document's block structure and helps you understand document composition.

BLOCK DATA EXTRACTION AND REFERENCE ANALYSIS

The block reference counter uses a multi-strategy extraction system to locate and parse block data from Craft Docs pages. It first attempts to find structured block elements using selectors based on the site's typical class naming patterns, including block containers, paragraph elements, heading elements, and specialized block types. When these selectors fail due to site updates, the tool falls back to text-based parsing, scanning the page for block-like patterns using pattern matching for block indicators, heading markers, and content structure. Block types are classified using a comprehensive detection system: heading detection through class names or markdown-style # prefixes; image detection through img elements; code detection through pre elements or markdown-style code blocks; table detection through table elements; list detection through ul/ol elements or bullet markers; link detection through a elements; mention detection through @ patterns; and text detection for remaining blocks. References are extracted by scanning for mention patterns (@username) and link references (href attributes with # or block references). Block counts are aggregated by type, and percentages are calculated relative to total blocks. All data is presented in a clean, organized panel with color-coded indicators.

THE PANEL

The block reference counter panel is a compact, functional overlay that integrates into the Craft Docs document page. It can be dragged by clicking and holding the title bar, positioning the panel anywhere on the screen for optimal visibility while you review document structure. The panel includes a built-in snap feature that automatically aligns to the nearest screen edge when released within 48 pixels, keeping your workspace organized. Click the collapse arrow in the top-right corner to minimize the panel to a small icon bubble showing a gear emoji, preserving screen space while keeping the tool accessible. The panel is not resizable in this version, maintaining a consistent compact size that works on all screen resolutions. Press the Escape key to instantly hide the panel; press Escape again to restore it. All position, collapse state, and block tracking preferences are saved locally using GM_setValue and persist across browsing sessions.

PLEASE NOTE

This extension requires the free BotGentz extension to function—the block reference counter does not work standalone. Craft Docs occasionally updates its page layouts and block presentation formats, which may temporarily affect block data extraction accuracy. The tool extracts block data from the visible page content; if document content is loaded dynamically after page load, you may need to wait a moment or refresh the page for the panel to populate. Block type classification is based on DOM analysis and may not capture all block type variations with perfect accuracy. Reference detection is based on pattern matching and may miss some references. The tool does not store or transmit any data; all block data extraction, type analysis, and settings are processed and saved entirely within your browser. This tool is designed for personal document analysis and is not affiliated with or endorsed by Craft Docs or its parent company. Document structure data is subject to Craft Docs' terms; always review your official Craft Docs account for authoritative document information.