# Templates Directory

This directory contains all PHP template files for rendering HTML output in the Nuclear Engagement plugin.

## Structure

### Admin Templates (`admin/`)

#### Dashboard (`dashboard/`)
- `analytics.php` - Analytics and statistics display
- `credits.php` - API credits information
- `inventory.php` - Content inventory listing

#### Generate (`generate/`)
- `confirm.php` - Generation confirmation step
- `filters.php` - Post filtering interface
- `progress.php` - Generation progress display

#### Settings (`settings/`)
- Main setting sections: `display.php`, `generation.php`, `optin.php`, `placement.php`, `theme.php`, `uninstall.php`
- Display subsections in `display/` - attribution, counts, labels, titles, TOC, custom quiz
- Placement subsections in `placement/` - positions, sticky TOC
- Theme subsections in `theme/` - progress bar, quiz buttons/container, summary/TOC containers

#### Setup (`setup/`)
- `header.php` - Setup wizard header
- `step1.php` - Initial setup step
- `step2.php` - Configuration step
- `credits.php` - Credits allocation
- `support.php` - Support information

#### Other Admin Templates
- `nuclen-admin-generate.php` - Main generation page
- `nuclen-admin-settings.php` - Main settings page
- `nuclen-dashboard-page.php` - Main dashboard page
- `quiz-metabox.php` - Quiz post metabox
- `summary-metabox.php` - Summary post metabox
- `page-header.php` - Common admin page header
- `notice.php` - Admin notice template

### Frontend Templates (`front/`)

#### Quiz Templates (`quiz/`)
- `container.php` - Main quiz container
- `shortcode.php` - Quiz shortcode wrapper
- `title.php` - Quiz title display
- `start-message.php` - Quiz start screen
- `question-container.php` - Question display
- `answers-container.php` - Answer options
- `result-container.php` - Individual result
- `final-result-container.php` - Final score
- `explanation-container.php` - Answer explanations
- `progress-bar.php` - Quiz progress indicator
- `next-button.php` - Navigation button
- `attribution.php` - Quiz attribution

#### TOC Templates (`toc/`)
- `shortcode.php` - Table of Contents display

#### Main Frontend Template
- `nuclear-engagement-public-display.php` - Main public display wrapper

## Template Guidelines

1. **Separation of Logic** - Templates contain minimal PHP logic
2. **Escaping** - All output is properly escaped for security
3. **Hooks** - Templates include appropriate WordPress hooks
4. **Accessibility** - ARIA labels and semantic HTML
5. **Responsive** - Mobile-first design approach