MyClub/DOCS/POLL_QUICK_START.md

# Poll System - Quick Start Guide

## 🚀 Getting Started with Polls

The poll/voting system is now fully integrated into your article and activity admin pages!

### ✅ What's Integrated

1. **Article Admin Page** (`/admin/clanky`)
   - Poll linker in the "Media" tab when editing an article
   - Link existing polls or create new ones
   - Polls auto-display at the end of published articles

2. **Activity Admin Page** (`/admin/aktivity`)
   - Poll linker at the bottom of the activity edit modal
   - Perfect for event feedback and engagement
   - Polls auto-display at the end of event details

3. **Dedicated Poll Management** (`/admin/ankety`)
   - Full poll creation and management
   - Statistics and analytics
   - Advanced settings and options

## 📝 How to Add a Poll to an Article

### Method 1: While Editing an Article

1. Go to `/admin/clanky`
2. Click on an existing article to edit (or create a new one and save it first)
3. Navigate to the **"Média"** tab
4. Scroll to the bottom - you'll see **"Ankety"** section
5. Click to expand it
6. Select a poll from the dropdown or create a new one in `/admin/ankety`
7. Click **"Připojit"** to link the poll

### Method 2: Create Poll First, Then Link

1. Go to `/admin/ankety`
2. Click **"Nová anketa"**
3. Fill in:
   - **Název**: e.g., "Hráč zápasu"
   - **Možnosti**: Add at least 2 options
   - **Propojení s obsahem**: Enter the article ID
4. Set status to **"Aktivní"**
5. Save

## 📅 How to Add a Poll to an Activity/Event

### While Editing an Activity

1. Go to `/admin/aktivity`
2. Click to edit an existing activity (or create and save a new one first)
3. Scroll to the bottom of the modal
4. Find the **"Ankety"** section
5. Click to expand
6. Select a poll or create one first in `/admin/ankety`
7. Click **"Připojit"**

## 🎯 Common Use Cases

### 1. Man of the Match Poll (After Match Article)

**Step 1:** Publish match report article
**Step 2:** Go to `/admin/ankety` and create:
```
Title: "Hráč zápasu - Sparta vs Slavia"
Type: Single choice
Options:
  - Jan Novák (link to player if available)
  - Petr Svoboda
  - Martin Dvořák
Status: Active
End Date: +24 hours from now
```
**Step 3:** In article admin → Media tab → Link the poll
**Result:** Poll appears at end of article automatically!

### 2. Event Feedback Poll (After Club Event)

**Step 1:** Create the event activity
**Step 2:** Create poll:
```
Title: "Jak se vám akce líbila?"
Options:
  - Výborné! 😍
  - Dobré 👍
  - Průměrné 😐
  - Mohlo být lepší 👎
Show Results: After end
```
**Step 3:** In activity edit modal → Link the poll
**Result:** Poll appears when users view event details!

### 3. Pre-Match Prediction Poll

**Step 1:** Create match preview article
**Step 2:** Create poll:
```
Title: "Předpověď: Kdo vyhraje?"
Start Date: Now
End Date: 30 minutes before match
Options:
  - Domácí tým
  - Remíza
  - Hosté
Show Results: After end
```
**Step 3:** Link to article
**Result:** Fans can vote before match starts!

## 🔧 The PollLinker Component

The `PollLinker` component is embedded in both admin pages and provides:

- ✅ **View linked polls** - See which polls are connected
- ✅ **Link existing polls** - Choose from dropdown of available polls
- ✅ **Unlink polls** - Remove poll connections
- ✅ **Quick stats** - See vote counts at a glance
- ✅ **Collapsible** - Keeps UI clean when not in use

### Features:
- Shows poll title, status, and vote count
- Click expand to manage polls
- Only shows polls not already linked elsewhere
- One-click link/unlink functionality

## 📊 Where Polls Appear

### For Website Visitors:

1. **Article Pages** (`/news/:slug`)
   - Polls appear after article content
   - Before newsletter CTA
   - Fully interactive with real-time voting

2. **Activity Pages** (`/aktivita/:id`)
   - Polls appear after event details
   - Great for gathering feedback

3. **Dedicated Polls Page** (`/ankety`)
   - All active polls in one place
   - Tabbed interface (All, Active, Featured)

## 🎨 Poll Display Features

- **Real-time results** with progress bars
- **Mobile responsive** - works on all devices
- **Dark mode support** - adapts to theme
- **Anonymous voting** - no login required (configurable)
- **Duplicate prevention** - IP + session tracking
- **Visual feedback** - shows when you've voted

## 💡 Tips & Best Practices

1. **Create polls before publishing** - Ensures they appear immediately
2. **Set end dates** - Auto-close polls after reasonable time
3. **Use featured flag** - Shows polls on homepage widget
4. **Link to players** - For MOTM polls, creates rich display
5. **Multiple polls** - You can link multiple polls to same content (max 3 shown)
6. **Monitor stats** - Check `/admin/ankety` for analytics

## 🔍 Finding Content IDs

### Article IDs
1. Go to `/admin/clanky`
2. Click article to edit
3. Look at the ID in the interface or URL

### Event IDs
1. Go to `/admin/aktivity`
2. Click event to edit
3. ID is shown in the interface

## ⚙️ Poll Settings Explained

- **Type**: Single (radio), Multiple (checkbox), Rating
- **Status**: Draft, Active, Closed, Archived
- **Allow Multiple**: Enable multi-select for multiple choice
- **Max Choices**: Limit selections (if multiple allowed)
- **Show Results**: 
  - Always: Everyone sees results
  - After Vote: Only after user votes
  - After End: Only when poll closes
  - Never: Admin only
- **Require Auth**: Force login to vote
- **Allow Guest Vote**: Anonymous voting enabled
- **Featured**: Show on homepage

## 🆘 Troubleshooting

**Poll not showing in article?**
- Save the article first (poll linker only appears for saved articles)
- Check poll status is "active"
- Verify poll dates include current time
- Refresh the page

**Can't find poll to link?**
- Create the poll first in `/admin/ankety`
- Make sure poll isn't already linked elsewhere
- Check poll status is "active"

**Poll not appearing on public page?**
- Poll must be status "active"
- Check start/end dates
- Clear browser cache
- Verify article/event is published

## 📚 Related Documentation

- `POLL_SYSTEM_IMPLEMENTATION.md` - Complete technical documentation
- `POLL_INTEGRATION_GUIDE.md` - Content linking details
- `/admin/docs` - Admin panel help

## 🎉 You're Ready!

The poll system is now seamlessly integrated into your workflow. Just edit an article or activity, scroll to the poll section, and start engaging your fans!

---

**Need Help?** Check the admin documentation at `/admin/docs` or refer to the detailed guides in the project root.