Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/botnadzor/extension/llms.txt

Use this file to discover all available pages before exploring further.

Accessing Extension Settings

The Botnadzor Extension popup provides access to all configuration options and statistics.
1

Open the Popup Menu

Click the Botnadzor icon in your browser’s extension toolbar. The popup window will open with multiple tabs.
2

Navigate to Settings

The popup contains four main tabs:
  • Настройки (Settings): Configure extension preferences
  • Доступ (Access): Manage authentication and access rights
  • Уведомления (Announcements): View extension updates and news
  • Статистика (Statistics): View detected account statistics
3

Adjust Your Preferences

Modify settings according to your needs. Changes are saved automatically.

Configuration Options

Tag Visibility and Colors

Customize how different account categories are displayed on VK pages.

Tag Color Customization

Each account category has a default highlight color that you can customize:
  • Click the color picker next to any tag name
  • Select a new color from the color palette
  • Enter a custom hex color code (e.g., #ff0000) in the text field
  • Press Enter or click outside to apply the change
To reset a color to its default value, simply set it back to the original color shown in the placeholder.

Tag Visibility Toggle

Control which account categories are highlighted:
  • Check the checkbox next to a tag name to enable highlighting for that category
  • Uncheck the checkbox to hide highlights for that category
  • Some tags have locked visibility and cannot be toggled
The number displayed next to each tag shows how many accounts of that type have been detected in the current database.

Display Preferences

Fans Display Mode

This feature is currently under development and disabled in the extension.
Controls how likes and reactions are displayed:
  • Default: Standard VK display format
  • Table: Tabular view of likes in popup windows
This setting affects the display of:
  • Post reactions and likes
  • Comment likes
  • Subscriber lists

Comment Collection

Collecting and Submitting Commenters

When authenticated with Botnadzor:
  • Enable: Check “Сбор и отправка комментаторов” to collect commenter data
  • Disable: Uncheck to stop collecting commenter information
This feature helps identify bot networks by analyzing commenting patterns across VK.
Comment collection is only available to authenticated users with valid access credentials.

Data Storage

Configuration data is stored using your browser’s sync storage:
  • Sync Across Devices: Settings sync automatically across browsers where you’re signed in (when using the same browser account)
  • Automatic Saving: All configuration changes are saved automatically
  • Write Throttling: Updates are batched and written every 1000ms to optimize performance

Configuration Data Model

The extension stores user preferences in the following structure:
{
  // Tag visibility and color overrides
  tagOverrideLookup: {
    [tagId: string]: {
      colorForHighlight?: string,  // Hex color (e.g., "#ff0000")
      hidden?: true                 // If true, tag is hidden
    }
  },
  
  // Display mode for likes/reactions
  fansDisplay: "default" | "table",
  
  // Whether to collect commenter data
  collectingComments?: true
}

Resetting Configuration

If you need to restore default settings:
  1. Open the Settings tab in the popup
  2. Scroll to the bottom of the settings panel
  3. Click the Reset button
  4. Confirm the reset action
Resetting configuration will remove all custom tag colors, visibility preferences, and display settings. This action cannot be undone.

Statistics View

The Statistics tab provides insights into detected accounts:

Regional Statistics

View the number of detected accounts by region:
  • Each region shows the total count of identified accounts
  • Click region links to view detailed information on the Botnadzor website
  • Colored indicators match the region tags used in highlighting

Subcategory Statistics

View detected accounts broken down by subcategories:
  • Account type classifications
  • Behavioral pattern categories
  • Activity-based groupings
Statistics are updated automatically as the extension’s database receives updates. When new data is being processed, you’ll see a tooltip indicating “Данные обрабатываются” (Data is being processed).

Advanced Configuration

The extension uses a service-based architecture for configuration management:
  • UserConfigService: Manages configuration state and storage synchronization
  • Pollable Pattern: Enables efficient state polling across extension components
  • Background Service Worker: Coordinates configuration updates between content scripts and popup
For developers: Configuration is managed through the userConfigService proxy service, accessible from any extension context (background, content script, or popup).

Build docs developers (and LLMs) love