MyClub/DOCS/ADMIN_QUICK_REFERENCE.md

Admin Panel - Quick Reference Guide

Version: 1.0
Last Updated: 2025-01-15

---

🚀 Quick Access

Admin Panel URL

http://your-site.com/admin

Login Credentials

• Role Required: Admin
• URL: /login
• Auto-redirect: Yes (to dashboard after login)

---

📋 All Admin Pages Quick Links

Core Management

Page	URL	Purpose
📊 Dashboard	/admin	Overview & quick stats
📈 Analytics	/admin/analytika	Visitor statistics (Umami)
📝 Articles	/admin/clanky	Blog posts & news
📖 About	/admin/o-klubu	Club information page
🎥 Videos	/admin/videa	YouTube video management
🖼️ Gallery	/admin/galerie	Zonerama photo albums
👕 Clothing	/admin/obleceni	Merchandise products

Sports Management

Page	URL	Purpose
👥 Teams	/admin/tymy	Team management
⚽ Matches	/admin/zapasy	Match schedule & results
🏃 Players	/admin/hraci	Player roster & stats
📅 Activities	/admin/aktivity	Events & calendar
📊 Scoreboard	/admin/scoreboard	Live match scoreboard
📱 Scoreboard Remote	/admin/scoreboard/remote	Mobile control

Content & Media

Page	URL	Purpose
🏷️ Categories	/admin/kategorie	Article categories
🤝 Sponsors	/admin/sponzori	Sponsor logos & links
📢 Banners	/admin/bannery	Advertisement banners
💬 Messages	/admin/zpravy	Contact form inbox
📁 Files	/admin/soubory	File manager

Communication

Page	URL	Purpose
📧 Newsletter	/admin/newsletter	Email campaigns & subscribers
📝 Contacts	/admin/kontakty	Contact categories
📊 Polls	/admin/ankety	Voting polls

Configuration

Page	URL	Purpose
⚙️ Settings	/admin/nastaveni	Site configuration
🧭 Navigation	/admin/navigace	Menu management
🏆 Competition Aliases	/admin/aliasy-soutezi	FACR competition mapping
🔄 Prefetch	/admin/prefetch	Cache management
👤 Users	/admin/uzivatele	User accounts
📚 Documentation	/admin/docs	Built-in help guide

---

🎯 Common Tasks

1. Create New Article

1. Go to /admin/clanky
2. Click "+ Nový článek"
3. Fill in title, content, category
4. Upload featured image
5. Click "Uložit"

2. Add New Match

1. Go to /admin/zapasy
2. Click "+ Přidat zápas"
3. Search for teams (FACR integration)
4. Set date, time, venue
5. Save

3. Manage Players

1. Go to /admin/hraci
2. Click "+ Přidat hráče"
3. Upload photo (auto-compressed)
4. Enter name, position, number
5. Save

4. Update Site Settings

1. Go to /admin/nastaveni
2. Modify club info, colors, logos
3. Configure integrations
4. Click "Uložit nastavení"

5. Control Live Scoreboard

1. Go to /admin/scoreboard
2. Link to a match
3. Update scores in real-time
4. Changes reflect on homepage

6. Send Newsletter

1. Go to /admin/newsletter
2. Choose campaign type
3. Write content or use template
4. Click "Odeslat"

---

🔑 Keyboard Shortcuts

Global

• Ctrl + S - Save form (where applicable)
• Esc - Close modal/dialog
• Ctrl + K - Search (if enabled)

Navigation

• Click sidebar items to navigate
• Use browser back/forward

---

💡 Tips & Best Practices

Content Management

• ✅ Always add featured images to articles
• ✅ Use categories for better organization
• ✅ Preview before publishing
• ✅ Use SEO-friendly slugs

Match Management

• ✅ Link matches to scoreboard for live updates
• ✅ Use FACR search for official team data
• ✅ Set accurate date/time for automatic countdown

Media

• ✅ Images are auto-compressed (no manual resize needed)
• ✅ Use YouTube URLs for videos (not uploads)
• ✅ Keep sponsor logos high-quality PNG

Performance

• ✅ Use prefetch to warm cache
• ✅ Check analytics regularly
• ✅ Clear old newsletters periodically

Security

• ✅ Use strong passwords
• ✅ Logout after admin session
• ✅ Don't share admin credentials

---

🆘 Troubleshooting

Can't Login?

• Check username/password
• Verify you have admin role
• Try password reset link
• Contact system administrator

Changes Not Visible?

• Check if item is marked as "visible"
• Verify publication status
• Clear browser cache
• Wait for prefetch cycle (30 min)

Upload Failed?

• Check file size (max varies per type)
• Verify file format (jpg, png for images)
• Check internet connection
• Try smaller file

Integration Not Working?

• Check API keys in Settings
• Verify external service status
• Check CORS configuration
• Review browser console errors

Page Loading Slowly?

• Check analytics data size
• Clear cache via Prefetch page
• Optimize images before upload
• Contact developer for optimization

---

📊 Feature Matrix

Feature	Articles	Matches	Players	Activities
Create	✅	✅	✅	✅
Edit	✅	✅	✅	✅
Delete	✅	✅	✅	✅
Bulk Actions	✅	❌	❌	❌
Search	✅	✅	✅	✅
Filter	✅	✅	✅	✅
Image Upload	✅	✅	✅	✅
Rich Editor	✅	❌	❌	✅
Categories	✅	❌	❌	❌
Visibility Toggle	✅	❌	❌	✅
AI Generation	❌	❌	❌	✅

---

🔌 External Integrations

FACR (Czech FA)

• Pages: Matches, Competition Aliases, Standings
• Purpose: Official match data, league tables
• Setup: Automatic (no config needed)

YouTube

• Pages: Videos, Activities
• Purpose: Video embedding
• Setup: Just paste YouTube URL

Umami Analytics

• Pages: Analytics, Settings
• Purpose: Visitor tracking
• Setup: Set UMAMI_WEBSITE_ID in Settings

OpenAI

• Pages: Activities
• Purpose: AI content generation
• Setup: Set OPENAI_API_KEY in backend .env

Zonerama

• Pages: Gallery
• Purpose: Photo albums
• Setup: Enter API key in Settings

Google Maps

• Pages: Settings, Activities
• Purpose: Location maps
• Setup: Configure in Settings

---

📱 Mobile Access

The admin panel is fully responsive and works on:

• ✅ Desktop (recommended)
• ✅ Tablet (iPad, Android tablets)
• ✅ Mobile (smartphones)

Note: Some complex pages (Analytics, Scoreboard) are optimized for desktop.

---

🎨 Customization

Site Appearance

1. Go to /admin/nastaveni
2. Configure:
   • Club name & logo
   • Primary/accent colors
   • Font pairings
   • Hero style
   • Sponsor layout

Navigation Menu

1. Go to /admin/navigace
2. Add/edit/reorder menu items
3. Configure social media links
4. Set visibility

Layout

1. Use MyUIbrix Editor (link in sidebar)
2. Visual drag-and-drop customization
3. Choose element variants
4. Save and publish

---

📈 Analytics Dashboard

Metrics Available:

• Visitors: Total unique visitors
• Page Views: Total page views
• Events: Custom event tracking
• Countries: Geographic distribution
• Top Pages: Most visited pages
• Referrers: Traffic sources

Refresh Interval:

• Data updates every 30 minutes
• Real-time for events
• Historical data available

---

🔒 Security

Best Practices:

1. Strong Passwords: Use 12+ characters
2. Regular Logout: Don't stay logged in
3. Limited Access: Only admins should have access
4. Audit Trail: Check user activity logs
5. Updates: Keep system updated

Permissions:

• Admin: Full access to all features
• Editor: Limited to content (if implemented)
• Viewer: Read-only (if implemented)

---

📞 Support

Built-in Help

• Visit /admin/docs for detailed documentation
• Search functionality available
• Step-by-step guides

Common Issues

• Check /admin/docs → "Řešení problémů"
• Review error messages carefully
• Check browser console (F12)

Contact

• System Administrator
• Developer Team
• [Your Support Email]

---

📚 Related Documentation

• Full Admin Audit: ADMIN_SECTION_INTEGRITY_AUDIT.md
• MyUIbrix Guide: MYUIBRIX_QUICK_START.md
• API Documentation: /admin/docs
• Setup Guide: SETUP.md

---

🚦 Status Indicators

Page Status:

• 🟢 Fully Functional - Working perfectly
• 🟡 Partially Functional - Minor issues
• 🔴 Not Working - Critical issues
• ⚠️ Placeholder - Not yet implemented

Current Status:

• 🟢 30/32 pages fully functional
• ⚠️ 1/32 placeholder (Media)
• 🟡 1/32 legacy version kept

---

✅ Quick Checklist for New Admins

• Login with admin credentials
• Review Dashboard
• Check all sidebar links work
• Upload club logo in Settings
• Configure primary colors
• Add first article
• Upload player photos
• Create a match
• Test newsletter
• Review analytics
• Customize navigation
• Check mobile view
• Read full documentation

---

Quick Start: Go to /admin → Navigate via sidebar → Click any item to manage content
Need Help: Check /admin/docs for comprehensive guides
Report Issues: Contact system administrator

---

Last Updated: January 15, 2025
Version: 1.0
Maintained By: Development Team