Enhanced Admin Search Implementation

Overview

The admin search has been comprehensively enhanced to include all admin pages, settings sections, and documentation with intelligent search capabilities.

Features Added

1. Comprehensive Coverage

32+ Admin Pages: All admin pages now indexed with proper Czech keywords
6 Settings Sections: Deep links to specific settings tabs (Obecné, Sociální sítě, Videa, SMTP, Analytika, SEO)
25+ Documentation Sections: Complete documentation coverage with hash anchors
Smart Categorization: Pages grouped into logical sections (Základní, Obsah, Sport, Média, Marketing, Komunikace, SEO, Nastavení, Nástroje, Dokumentace)

2. Enhanced Search Capabilities

Czech Keywords: Full Czech language support with local terms
Intelligent Scoring:
- Exact matches: 200 points
- Startswith matches: 120 points
- Contains matches: 80 points (minus position offset)
- Keyword matches: 40 points
- Context boosts: +30 points for relevant sections
Deep Link Support: Settings pages support hash navigation (e.g., /admin/nastaveni#socialni-site)

3. Search Examples

Search Query	Best Result	Why
"sociální sítě"	Nastavení - Sociální sítě	Direct match with deep link
"články"	Články	Exact match
"facebook"	Nastavení - Sociální sítě	Keyword match
"scoreboard"	Tabule (Scoreboard)	Keyword match
"help"	Dokumentace - Řešení problémů	Context boost for docs
"nastavení"	Nastavení + all settings tabs	Section boost

4. Settings Deep Links

The settings page now supports hash navigation to specific tabs:

/admin/nastaveni#obecne → Obecné tab
/admin/nastaveni#socialni-site → Sociální sítě tab
/admin/nastaveni#videa → Videa tab
/admin/nastaveni#smtp → SMTP tab
/admin/nastaveni#analytika → Analytika tab
/admin/nastaveni#seo → SEO tab

5. Section Organization

Základní: Dashboard, core functionality
Obsah: Articles, activities, about club
Sport: Teams, players, matches, competitions
Média: Gallery, videos, files
Marketing: Sponsors, ads, clothing, polls, rewards
Komunikace: Newsletter, messages, contacts, notifications
SEO: Analytics, SEO tools
Nastavení: System configuration, users, navigation
Nástroje: Cache, error logs, translations, imports
Dokumentace: Complete help documentation

Technical Implementation

Frontend Changes

AdminSearchModal.tsx: Enhanced with comprehensive index and improved scoring
SettingsAdminPage.tsx: Added hash navigation support for deep links
Icon Library: Added missing icons (FaTshirt, FaGlobe, etc.)

Search Index Structure

interface AdminSearchItem {
  label: string;        // Display name
  path: string;         // URL path
  section: string;      // Category for grouping
  keywords?: string[];  // Search terms (Czech + English)
  icon?: any;          // React icon component
}

Settings page uses controlled Tabs component with hash-based navigation:

const [tabIndex, setTabIndex] = useState(0);

useEffect(() => {
  const hash = window.location.hash.replace('#', '');
  const tabMap = {
    'obecne': 0,
    'socialni-site': 1,
    'videa': 2,
    'smtp': 3,
    'analytika': 4,
    'seo': 5,
  };
  if (tabMap[hash] !== undefined) {
    setTabIndex(tabMap[hash]);
  }
}, []);

Usage

Press Ctrl+K in admin to open search
Type any term in Czech or English
Use arrow keys to navigate results
Press Enter to go to selected page
Click outside or press Escape to close

Benefits

Faster Navigation: No need to click through menus
Discoverability: Users can find pages they didn't know existed
Context-Aware: Search understands what you're looking for
Deep Access: Jump directly to specific settings sections
Language Support: Works seamlessly in Czech and English

Future Enhancements

Recent searches history
Keyboard shortcuts for frequent pages
Search analytics to improve indexing
Fuzzy search for typos
Command palette style interface

4.2 KiB Raw Blame History