Form Field_Names

Markdown Guest 1 Views Size: 5.83 KB Posted on: Dec 10, 25 @ 11:09 PM

Podcast Episode Input Form - Field Reference

Section 1: Core Episode Information

Field	Field Name	Type	Required
Episode Title	`episode_title`	Text	✅
Subtitle/Short Description	`episode_subtitle`	Text
Season Number	`season_number`	Number
Episode Number	`episode_number`	Number
Series Information	`series_information`	Text
Publication Date & Time	`publication_datetime`	DateTime
Episode Duration	`episode_duration`	Time
Explicit Content	`explicit_content`	Boolean

Section 2: Content & Format

Field	Field Name	Type	Required
Content Format	`content_format`	Dropdown	✅
Primary Category	`primary_category`	Dropdown	✅
Secondary Topics/Keywords	`topics_keywords`	Array/Tags
Episode Summary	`episode_summary`	Rich Text	✅

Section 3: People

Field	Field Name	Type	Required
Host(s)	`hosts`	Array/Select	✅
Guest(s)	`guests`	Nested Array
- Guest Name	`guest_name`	Text
- Title/Company	`guest_title`	Text
- Bio	`guest_bio`	TextArea
- Website/Social Link	`guest_website`	URL
- Headshot	`guest_headshot`	Image

Section 4: Show Notes & Links

Field	Field Name	Type
Detailed Show Notes	`show_notes`	Rich Text
Resources & Links	`resources_links`	Nested Array
- Link Text	`link_text`	Text
- URL	`link_url`	URL
- Description	`link_description`	Text
Primary CTA Text	`primary_cta_text`	Text
Primary CTA URL	`primary_cta_url`	URL
Secondary CTA Text	`secondary_cta_text`	Text
Secondary CTA URL	`secondary_cta_url`	URL

Section 5: Timestamps (Chapters)

Field	Field Name	Type
Chapters	`chapters`	Nested Array
- Timecode	`chapter_timecode`	Time
- Chapter Title	`chapter_title`	Text
- Description	`chapter_description`	Text

Section 6: Media & Files

Field	Field Name	Type	Required
Episode Artwork	`episode_artwork`	Image	✅
Audio File (MP3)	`audio_file`	File	✅
Transcript (TXT)	`transcript_file`	File
Subtitles/Captions (SRT/VTT)	`subtitles_file`	File
Unique Words/Glossary File	`glossary_file`	File/Text

Section 7: Related Content & Merchandising

Field	Field Name	Type	Required
Related Episodes	`related_episodes`	Array/Select
Merchandise Ideas	`merchandise_ideas`	Array/Tags

Section 8: Publishing & Distribution

Field	Field Name	Type
Podcast Slugs/URLs	`episode_slug`	Text
Meta Description	`meta_description`	TextArea
Publish to Apple Podcasts	`publish_apple`	Boolean
Publish to Spotify	`publish_spotify`	Boolean
Publish to YouTube	`publish_youtube`	Boolean
Include in newsletter	`include_newsletter`	Boolean

Section 9: Internal & Workflow

Field	Field Name	Type
Internal Status	`internal_status`	Dropdown
Internal Notes	`internal_notes`	TextArea
Assigned Editor/Producer	`assigned_editor`	Dropdown

Field Types Reference

Basic Types

Text: Single-line text input
TextArea: Multi-line text input
Dropdown: Select from predefined options
Number: Numeric input
DateTime: Date and time picker
Time: Time input (HH:MM:SS)
Boolean: Checkbox or toggle switch
URL: URL input with validation
Image: Image upload with preview
File: File upload

Complex Types

Array/Tags: Multiple entries (tags/keywords)
Array/Select: Multiple selection from list
Nested Array: Repeating group of related fields
Rich Text: WYSIWYG editor with formatting

Implementation Notes

Array Fields Structure

{
  "topics_keywords": ["machine learning", "startup funding", "productivity"],
  "hosts": ["host_id_1", "host_id_2"],
  "guests": [
    {
      "guest_name": "Jane Smith",
      "guest_title": "CEO at TechCorp",
      "guest_bio": "Experienced technology leader...",
      "guest_website": "https://example.com",
      "guest_headshot": "/uploads/headshots/jane-smith.jpg"
    }
  ],
  "related_episodes": ["episode_id_123", "episode_id_456"]
}

Required Field Groups

The following fields are essential for publishing:

episode_title (for display)
content_format (for categorization)
primary_category (for directories)
episode_summary (for show description)
episode_artwork (for visual presentation)
audio_file (the actual episode content)
hosts (primary content creators)

File Upload Specifications

episode_artwork: 3000×3000px minimum, JPG/PNG
audio_file: MP3 format, ≤200MB
transcript_file: TXT format, UTF-8 encoding
subtitles_file: SRT or VTT format
glossary_file: TXT or JSON format

Data Validation Rules

episode_slug: Lowercase, alphanumeric with hyphens only
episode_duration: Format HH:MM:SS (e.g., 01:15:30)
chapter_timecode: Format HH:MM:SS
publication_datetime: Future dates only for scheduling
All URL fields must pass URL format validation

This markdown document can be used as a reference for:

Database schema design
API endpoint structure
Form validation rules
Data model documentation
Development team coordination

Raw Paste

# Podcast Episode Input Form - Field Reference

## Section 1: Core Episode Information
| Field | Field Name | Type | Required |
|-------|------------|------|----------|
| Episode Title | `episode_title` | Text | ✅ |
| Subtitle/Short Description | `episode_subtitle` | Text | |
| Season Number | `season_number` | Number | |
| Episode Number | `episode_number` | Number | |
| Series Information | `series_information` | Text | |
| Publication Date & Time | `publication_datetime` | DateTime | |
| Episode Duration | `episode_duration` | Time | |
| Explicit Content | `explicit_content` | Boolean | |

## Section 2: Content & Format
| Field | Field Name | Type | Required |
|-------|------------|------|----------|
| Content Format | `content_format` | Dropdown | ✅ |
| Primary Category | `primary_category` | Dropdown | ✅ |
| Secondary Topics/Keywords | `topics_keywords` | Array/Tags | |
| Episode Summary | `episode_summary` | Rich Text | ✅ |

## Section 3: People
| Field | Field Name | Type | Required |
|-------|------------|------|----------|
| Host(s) | `hosts` | Array/Select | ✅ |
| Guest(s) | `guests` | Nested Array | |
| - Guest Name | `guest_name` | Text | |
| - Title/Company | `guest_title` | Text | |
| - Bio | `guest_bio` | TextArea | |
| - Website/Social Link | `guest_website` | URL | |
| - Headshot | `guest_headshot` | Image | |

## Section 4: Show Notes & Links
| Field | Field Name | Type | Required |
|-------|------------|------|----------|
| Detailed Show Notes | `show_notes` | Rich Text | |
| Resources & Links | `resources_links` | Nested Array | |
| - Link Text | `link_text` | Text | |
| - URL | `link_url` | URL | |
| - Description | `link_description` | Text | |
| Primary CTA Text | `primary_cta_text` | Text | |
| Primary CTA URL | `primary_cta_url` | URL | |
| Secondary CTA Text | `secondary_cta_text` | Text | |
| Secondary CTA URL | `secondary_cta_url` | URL | |

## Section 5: Timestamps (Chapters)
| Field | Field Name | Type | Required |
|-------|------------|------|----------|
| Chapters | `chapters` | Nested Array | |
| - Timecode | `chapter_timecode` | Time | |
| - Chapter Title | `chapter_title` | Text | |
| - Description | `chapter_description` | Text | |

## Section 6: Media & Files
| Field | Field Name | Type | Required |
|-------|------------|------|----------|
| Episode Artwork | `episode_artwork` | Image | ✅ |
| Audio File (MP3) | `audio_file` | File | ✅ |
| Transcript (TXT) | `transcript_file` | File | |
| Subtitles/Captions (SRT/VTT) | `subtitles_file` | File | |
| Unique Words/Glossary File | `glossary_file` | File/Text | |

## Section 7: Related Content & Merchandising
| Field | Field Name | Type | Required |
|-------|------------|------|----------|
| Related Episodes | `related_episodes` | Array/Select | |
| Merchandise Ideas | `merchandise_ideas` | Array/Tags | |

## Section 8: Publishing & Distribution
| Field | Field Name | Type | Required |
|-------|------------|------|----------|
| Podcast Slugs/URLs | `episode_slug` | Text | |
| Meta Description | `meta_description` | TextArea | |
| Publish to Apple Podcasts | `publish_apple` | Boolean | |
| Publish to Spotify | `publish_spotify` | Boolean | |
| Publish to YouTube | `publish_youtube` | Boolean | |
| Include in newsletter | `include_newsletter` | Boolean | |

## Section 9: Internal & Workflow
| Field | Field Name | Type | Required |
|-------|------------|------|----------|
| Internal Status | `internal_status` | Dropdown | |
| Internal Notes | `internal_notes` | TextArea | |
| Assigned Editor/Producer | `assigned_editor` | Dropdown | |

## Field Types Reference

### Basic Types
- **Text**: Single-line text input
- **TextArea**: Multi-line text input
- **Dropdown**: Select from predefined options
- **Number**: Numeric input
- **DateTime**: Date and time picker
- **Time**: Time input (HH:MM:SS)
- **Boolean**: Checkbox or toggle switch
- **URL**: URL input with validation
- **Image**: Image upload with preview
- **File**: File upload

### Complex Types
- **Array/Tags**: Multiple entries (tags/keywords)
- **Array/Select**: Multiple selection from list
- **Nested Array**: Repeating group of related fields
- **Rich Text**: WYSIWYG editor with formatting

## Implementation Notes

### Array Fields Structure
```json
{
  "topics_keywords": ["machine learning", "startup funding", "productivity"],
  "hosts": ["host_id_1", "host_id_2"],
  "guests": [
    {
      "guest_name": "Jane Smith",
      "guest_title": "CEO at TechCorp",
      "guest_bio": "Experienced technology leader...",
      "guest_website": "https://example.com",
      "guest_headshot": "/uploads/headshots/jane-smith.jpg"
    }
  ],
  "related_episodes": ["episode_id_123", "episode_id_456"]
}
```

### Required Field Groups
The following fields are essential for publishing:
- `episode_title` (for display)
- `content_format` (for categorization)
- `primary_category` (for directories)
- `episode_summary` (for show description)
- `episode_artwork` (for visual presentation)
- `audio_file` (the actual episode content)
- `hosts` (primary content creators)

### File Upload Specifications
- `episode_artwork`: 3000×3000px minimum, JPG/PNG
- `audio_file`: MP3 format, ≤200MB
- `transcript_file`: TXT format, UTF-8 encoding
- `subtitles_file`: SRT or VTT format
- `glossary_file`: TXT or JSON format

### Data Validation Rules
- `episode_slug`: Lowercase, alphanumeric with hyphens only
- `episode_duration`: Format HH:MM:SS (e.g., 01:15:30)
- `chapter_timecode`: Format HH:MM:SS
- `publication_datetime`: Future dates only for scheduling
- All URL fields must pass URL format validation

This markdown document can be used as a reference for:
1. Database schema design
2. API endpoint structure
3. Form validation rules
4. Data model documentation
5. Development team coordination

Fork Edit