# Admin Portal - Quick Start Guide

## 🚀 Getting Started

### Access the Admin Portal
1. Navigate to `https://yoursite.com/admin`
2. Log in with your credentials
3. You'll be redirected to the dashboard

## 📝 Creating Content

### Creating a News Article

1. **Navigate** to `News Articles` from the sidebar
2. **Click** the "New Article" button (top right)
3. **Fill in the form:**
   - **Title** - Catchy headline (required)
   - **Description** - Brief summary for previews (required)
   - **Content** - Full article text
   - **Image** - Upload or paste URL (required)
   - **Category** - Select appropriate category
   - **Tags** - Add comma-separated tags
4. **Options:**
   - ☑️ Featured Article - Shows in featured section
   - ☑️ Publish immediately - Makes it live instantly
5. **Save:**
   - Click "Save as Draft" to save without publishing
   - Click "Publish Now" to make it live

**💡 Tip:** Use descriptive titles and always include an image for better engagement.

### Creating an Event

1. **Navigate** to `Events` from the sidebar
2. **Click** "New Event"
3. **Fill in the details:**
   - **Title** - Event name (required)
   - **Description** - Brief overview (required)
   - **Start Date** - When it begins (required)
   - **End Date** - When it ends (optional)
   - **Location** - Venue or address
   - **Image** - Event poster/image
   - **Category** - Event type
4. **Options:**
   - ☑️ Featured Event
   - ☑️ Publish immediately
5. **Save** as draft or publish

**💡 Tip:** Add events at least a week in advance for better attendance.

### Creating a User Account

1. **Navigate** to `Users` from the sidebar
2. **Click** "New User"
3. **Personal Information:**
   - First Name & Last Name
4. **Contact Information:**
   - Email (must be unique)
   - Cellphone number
5. **Security:**
   - Password (min. 8 characters)
   - Confirm password
6. **Role & Permissions:**
   - Select appropriate role
   - ☑️ Active Account (enabled by default)
7. **Click** "Create User"

**💡 Tip:** Use strong passwords with uppercase, lowercase, numbers, and symbols.

## 📁 Managing Media

### Uploading Files

1. **Navigate** to `Media Library`
2. **Click** "Upload Files" button
3. **Select** one or more files
4. **Wait** for upload confirmation

**Supported formats:**
- Images: JPG, PNG, GIF, WebP
- Videos: MP4, AVI, MOV
- Documents: PDF

### Organizing Media

- **Switch Views:** Toggle between Grid and List view
- **Search:** Use the search bar to find files
- **Download:** Click the download icon on any file
- **Delete:** Click the trash icon (cannot be undone!)

**💡 Tip:** Use descriptive filenames before uploading for easier searching.

## 📊 Viewing Analytics

### Dashboard Overview

1. **Navigate** to `Analytics`
2. **Select Time Range:**
   - Last 24 Hours
   - Last 7 Days
   - Last 30 Days
   - Last 90 Days
3. **View Metrics:**
   - Total Visitors
   - Page Views
   - Unique Visitors
   - Average Session Duration

### Understanding the Data

**📈 Green arrows** = Positive trend (increase)
**📉 Red arrows** = Negative trend (decrease)

**Top Pages** - Most visited pages on your site
**Top Articles** - Most read news articles
**Geographic Distribution** - Where your visitors come from

**💡 Tip:** Export data regularly for reporting to management.

## 🔄 Using Bulk Operations

### Bulk Publishing/Unpublishing

1. **Navigate** to `News Articles`
2. **Click** "Bulk Operations" button
3. **Select Articles:**
   - Click on article cards to select them
   - Use "Select All" to select all filtered articles
4. **Choose Action:**
   - **Publish All** - Make selected articles live
   - **Unpublish All** - Hide selected articles
   - **Delete All** - Permanently remove (⚠️ cannot be undone!)
5. **Confirm** your action

**💡 Tip:** Use filters to narrow down articles before bulk operations.

### Best Practices

- ✅ **Double-check** selection before deleting
- ✅ **Use filters** to target specific categories
- ✅ **Unpublish instead of delete** for seasonal content
- ✅ **Test with one item** first if unsure

## ⚙️ Configuring Settings

### Email Configuration

1. **Navigate** to `Settings`
2. **Click** "Email" tab
3. **Configure:**
   - Email Provider (SMTP, SendGrid, etc.)
   - SMTP Host & Port
   - SMTP Username & Password
   - Sender Email Address
4. **Click** "Save Settings"

### SMS Configuration

1. **Navigate** to `Settings`
2. **Click** "SMS" tab
3. **Configure:**
   - SMS Provider (WinSMS, Twilio, etc.)
   - API Key
   - Sender Name
4. **Click** "Save Settings"

### Notification Preferences

1. **Navigate** to `Settings`
2. **Click** "Notifications" tab
3. **Toggle preferences:**
   - ☑️ Enable Email Notifications
   - ☑️ Enable SMS Notifications
   - ☑️ Notify on New User
   - ☑️ Notify on New Content
4. **Click** "Save Settings"

**💡 Tip:** Test notifications after configuration to ensure they work.

## 🔍 Viewing Audit Logs

### Accessing Logs

1. **Navigate** to `Audit Logs`
2. **Apply Filters:**
   - Search by user or entity
   - Filter by action (Create, Update, Delete, Login)
   - Filter by entity type (News, Events, Users, etc.)
   - Select date range
3. **View Details:**
   - Click "View" on any log entry
   - See full details including changes made

### Understanding Log Actions

- 🟢 **CREATE** - New item added
- 🔵 **UPDATE** - Existing item modified
- 🔴 **DELETE** - Item removed
- 🟣 **LOGIN** - User signed in

**💡 Tip:** Regularly review audit logs for security monitoring.

## 🔒 Security Best Practices

### Password Management
- ✅ Use unique passwords for each user
- ✅ Minimum 8 characters with mixed case, numbers, and symbols
- ✅ Change passwords regularly
- ✅ Never share login credentials

### Account Security
- ✅ Disable accounts for users who leave
- ✅ Review user permissions quarterly
- ✅ Use role-based access appropriately
- ✅ Enable two-factor authentication (when available)

### Content Security
- ✅ Review published content before making it live
- ✅ Use draft mode for work in progress
- ✅ Keep backups of important content
- ✅ Don't publish sensitive information

## 📋 Common Tasks

### Publishing a News Article
1. Create article → Fill form → Upload image → Save as draft
2. Review content → Make edits if needed
3. Click "Publish Now" or toggle publish status

### Scheduling an Event
1. Create event → Set start/end dates → Add location
2. Upload event image → Save as draft
3. Publish 1-2 weeks before event date

### Managing Users
1. Regular review of active users
2. Disable inactive accounts
3. Update roles as responsibilities change
4. Reset passwords when requested

### Content Moderation
1. Review new content submissions
2. Check for quality and accuracy
3. Ensure images are appropriate
4. Verify links work correctly
5. Publish or request revisions

## 🆘 Troubleshooting

### Can't Upload Files?
- Check file size (max 5MB for images)
- Ensure supported format
- Check internet connection
- Try different browser

### Content Not Showing?
- Verify it's published (not draft)
- Check if it's featured/active
- Clear browser cache
- Wait a few minutes for updates

### Can't Save Changes?
- Check internet connection
- Ensure all required fields are filled
- Try refreshing the page
- Log out and log back in

### Permission Denied?
- Verify your role has access to that feature
- Contact administrator for role upgrade
- Check if your account is active

## 📞 Getting Help

### Documentation
- Check the sidebar for "Help" section
- View detailed guides in the admin folder
- Read role-specific documentation

### Contact IT Support
- Email: support@madibeng.gov.za
- Phone: 014 590 4700
- Internal ticket system

### Training
- New user orientation sessions
- Monthly admin workshops
- One-on-one training available

## ✅ Daily Checklist for Content Managers

**Morning:**
- [ ] Check dashboard for overnight activity
- [ ] Review pending content submissions
- [ ] Respond to user requests

**Throughout Day:**
- [ ] Create/publish news articles as needed
- [ ] Update event calendar
- [ ] Monitor analytics

**End of Day:**
- [ ] Review published content
- [ ] Check for errors or issues
- [ ] Plan next day's content

**Weekly:**
- [ ] Review audit logs
- [ ] Check analytics trends
- [ ] Clean up media library
- [ ] Update user permissions if needed

**Monthly:**
- [ ] Full analytics report
- [ ] User account audit
- [ ] System settings review
- [ ] Content quality review

## 🎯 Tips for Success

1. **Be Consistent** - Post regularly to keep your audience engaged
2. **Use Images** - Visual content performs better
3. **Write Clear Headlines** - Make them descriptive and engaging
4. **Proofread** - Always check for typos before publishing
5. **Monitor Analytics** - Learn what content works best
6. **Stay Organized** - Use categories and tags effectively
7. **Backup Important Content** - Keep copies of critical information
8. **Collaborate** - Work with your team using draft mode

---

**Need more help?** Check the detailed documentation or contact your system administrator.

**Last Updated:** January 31, 2026