Troubleshooting

​

Solution Steps

1. Check if extension is installed:
   • Chrome: Go to chrome://extensions/ and look for Botnadzor
   • Firefox: Go to about:addons and check Extensions list
2. Ensure extension is enabled:
   • Toggle the extension on if it’s disabled
   • Reload the browser if needed
3. Pin the extension icon:
   • Click the extensions icon (puzzle piece) in the toolbar
   • Find Botnadzor in the list
   • Click the pin icon to make it visible in the toolbar

​

Possible Causes and Solutions

1. Extension not active on current page:
   • Botnadzor only works on VK domains: vk.com, vk.ru, vkvideo.ru, and their mobile versions (m.vk.com, etc.)
   • Also supports VK pages archived on web.archive.org
   • Verify you’re on a supported domain
2. Tags are hidden in settings:
   • Open the Botnadzor popup
   • Go to the Settings tab
   • Check that account category tags are not hidden
   • Enable checkboxes for the tags you want to see
3. No accounts in database for current page:
   • The page may not contain any accounts that are in the Botnadzor database
   • Try visiting pages with more user interactions (comments, profiles, etc.)
4. Page needs to be refreshed:
   • Reload the VK page after installing or updating the extension
   • Clear browser cache if the issue persists

# Force refresh (most browsers)
Ctrl+Shift+R  # Windows/Linux
Cmd+Shift+R   # macOS

​

Troubleshooting Steps

1. Check browser console:
   • Right-click the extension icon
   • Select “Inspect popup” (Chrome) or “Debug” (Firefox)
   • Look for error messages in the console
2. Verify extension permissions:
   • Ensure the extension has required permissions
   • Chrome: Check chrome://extensions/ → Botnadzor → Details → Permissions
   • Firefox: Check about:addons → Botnadzor → Permissions
3. Clear extension storage:
   • Open browser developer tools on the popup
   • Go to Application/Storage tab
   • Clear extension storage
   • Reload the extension
4. Reinstall the extension:
   • Remove the extension completely
   • Restart the browser
   • Reinstall from the browser store

​

Check These Items

1. Browser sync storage enabled:
   • Verify browser sync is working correctly
   • Check browser settings for sync/storage permissions
2. Storage quota not exceeded:
   • The extension uses browser sync storage
   • Ensure you haven’t exceeded browser storage limits
3. Extension has storage permissions:
   • Verify storage permission is granted
   • Chrome: chrome://extensions/ → Details → Permissions
   • Firefox: about:addons → Permissions tab
4. Try manual configuration reset:
   • Open Settings tab in popup
   • Use the Reset button at the bottom
   • Reconfigure your preferences

​

Performance Optimization

1. Reduce visible tags:
   • Hide tag categories you don’t need
   • This reduces DOM modification operations
2. Disable comment collection (if enabled):
   • Go to Settings tab
   • Uncheck “Сбор и отправка комментаторов”
   • This reduces background data processing
3. Clear browser cache:
   • Old cached data can slow down page loads
   • Clear VK site data in browser settings
4. Check other extensions:
   • Disable other VK-related extensions temporarily
   • Test if the slowdown persists
   • Conflicts with other extensions can cause performance issues

​

Requirements and Solutions

1. Authentication required:
   • Comment collection only works for authenticated users
   • Open the Access tab in the popup
   • Verify your authentication status shows as “valid”
2. Feature must be enabled:
   • Go to Settings tab
   • Find “Сбор и отправка комментаторов”
   • Check the checkbox to enable
3. Check access permissions:
   • Not all users may have access to this feature
   • Contact Botnadzor administrators if you need access

​

Fixing Color Override Issues

1. Verify hex color format:
   • Colors must be in hex format: #rrggbb
   • Examples: #ff0000 (red), #00ff00 (green), #0000ff (blue)
   • Invalid formats will be ignored
2. Check color picker value:
   • Use the color picker for reliable color selection
   • The text field updates automatically with valid hex codes
3. Ensure changes are applied:
   • Press Enter after typing hex code
   • Or click outside the text field
   • The color should update immediately
4. Reload VK pages:
   • Color changes apply to new page loads
   • Refresh any open VK tabs to see the new colors

// Valid hex color examples
#ff0000  // Pure red
#00ff00  // Pure green
#0000ff  // Pure blue
#ffa500  // Orange
#800080  // Purple

• The extension periodically fetches updated account lists
• During processing, statistics may show as updating
• Wait a few moments for the update to complete
• New account data will appear automatically

​

Force Data Refresh

1. Close and reopen the popup
2. Wait for background sync (happens automatically)
3. Check for extension updates in your browser’s extension manager
4. Restart the browser if data still appears stale

• Background service worker manages data updates
• Updates are throttled to prevent excessive API calls
• Local database is synchronized periodically