# Quick Start Guide - Theme Options Panel

## 🚀 Getting Started in 3 Steps

### Step 1: Access the Panel
1. Log in to WordPress admin
2. Go to **Appearance > Theme Options**
3. You'll see 5 tabs: General, Content, Performance, Related Posts, Advanced

### Step 2: Configure Your Settings
Start with the **General** tab:
- Upload your logo (recommended size: 200x60px)
- Upload favicon (recommended size: 32x32px)
- Enable breadcrumbs if desired
- Add your social media links

### Step 3: Save
Click **"Save All Settings"** at the bottom

That's it! Your theme is now configured.

---

## 📋 Most Common Settings

### Logo and Branding
```
Tab: General
• Site Logo: Upload your logo image
• Site Favicon: Upload your favicon
• Copyright Text: Edit footer copyright
```

### Content Display
```
Tab: Content
• Excerpt Length: 55 (default)
• Show Featured Image: ON
• Show Author Box: ON
• Enable Comments on Posts: ON
```

### Performance
```
Tab: Performance
• Enable Lazy Loading: ON (recommended)
• Remove Emoji Scripts: ON (recommended)
• Remove Dashicons: ON (recommended)
```

### Related Posts
```
Tab: Related Posts
• Enable Related Posts: ON
• Number of Posts: 3
• Relate By: Category
• Columns: 3
```

---

## 💡 Quick Tips

### 1. Export Your Settings
Before making changes, export your current settings:
- Click "Export Options" button
- A JSON file will download
- Keep this as backup

### 2. Test Before Going Live
- Make changes
- Save
- Check front-end
- If something breaks, import your backup

### 3. Use Reset with Caution
- "Reset to Defaults" will erase ALL settings
- Always export before resetting

---

## 🔧 Using Options in Your Templates

### Get Any Option
```php
$value = apus_get_option('option_name', 'default_value');
```

### Check if Enabled
```php
if (apus_is_option_enabled('enable_breadcrumbs')) {
    // Do something
}
```

### Common Examples
```php
// Logo
$logo_url = apus_get_logo_url();

// Breadcrumbs
if (apus_show_breadcrumbs()) {
    $separator = apus_get_breadcrumb_separator();
}

// Related Posts
if (apus_show_related_posts()) {
    $count = apus_get_related_posts_count();
}

// Social Links
$social_links = apus_get_social_links();
```

---

## 🎯 Recommended Initial Configuration

### For a Blog
```
General:
  ✅ Enable Breadcrumbs
  ✅ Add social media links

Content:
  ✅ Show Featured Image: ON
  ✅ Show Author Box: ON
  ✅ Comments on Posts: ON
  ✅ Excerpt Length: 55

Performance:
  ✅ Lazy Loading: ON
  ✅ Remove Emoji: ON
  ✅ Remove Dashicons: ON

Related Posts:
  ✅ Enable: ON
  ✅ Count: 3
  ✅ Taxonomy: Category
```

### For a Portfolio Site
```
General:
  ✅ Enable Breadcrumbs
  ✅ Add social media links

Content:
  ✅ Show Featured Image: ON
  ✅ Show Author Box: OFF
  ✅ Comments on Posts: OFF
  ✅ Comments on Pages: OFF

Performance:
  ✅ Lazy Loading: ON
  ✅ Remove Emoji: ON

Related Posts:
  ⬜ Enable: OFF
```

### For a Business Site
```
General:
  ✅ Upload Logo
  ✅ Update Copyright
  ✅ Add social links

Content:
  ✅ Comments on Posts: OFF
  ✅ Comments on Pages: OFF
  ✅ Layout: No Sidebar

Performance:
  ✅ All optimizations: ON

Related Posts:
  ⬜ Enable: OFF
```

---

## ⚠️ Troubleshooting

### Settings Not Saving
1. Check you're logged in as admin
2. Check browser console for errors (F12)
3. Refresh the page and try again

### Images Not Uploading
1. Check PHP upload_max_filesize (should be at least 8MB)
2. Try a smaller image
3. Check file permissions

### Changes Not Showing on Site
1. Clear browser cache (Ctrl+F5)
2. Clear WordPress cache if using cache plugin
3. Check if you saved the settings

---

## 📚 Need More Help?

See detailed documentation:
- **inc/admin/README.md** - Complete technical documentation
- **inc/admin/USAGE-EXAMPLES.php** - 20 code examples
- **inc/admin/TEST-CHECKLIST.md** - Testing guide
- **ISSUE-14-COMPLETION-REPORT.md** - Full feature list

---

## 🆘 Support

For issues or questions:
1. Check browser console for JavaScript errors (F12)
2. Check WordPress debug.log for PHP errors
3. Review the documentation files above
4. Check TEST-CHECKLIST.md for common issues

---

**Remember:** Always export your settings before making major changes!

**Quick Access:** Appearance > Theme Options

**Version:** 1.0.0
**Last Updated:** 2025-11-03