WP Manifestindependent plugin directory
manifest / media / spark-radio-station

Spark Radio Station

spark-radio-station is a tool to set up post types and custom fields, and package output as json.

by MiniMax Agent · github.com/dewolfe001/spark-radio-station · website

★ 0stars

Install

Download source zip No release zip yet

This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.

Install straight from GitHub with WP-CLI:

wp plugin install https://github.com/dewolfe001/spark-radio-station/archive/refs/heads/main.zip
No built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
Readme github.com/dewolfe001/spark-radio-station ↗

Complete radio station content management system with REST API endpoints for headless WordPress integration.

Description

Spark Radio Station is a comprehensive WordPress plugin designed for radio stations that want to manage their content through WordPress while using a modern frontend framework. Perfect for headless WordPress setups.

Features

  • Custom Post Types: DJs, Radio Shows, Events, Program Schedule, Recently Played Tracks
  • Custom Taxonomies: Music Genres, Event Categories
  • REST API Endpoints: Complete API for all content types
  • Admin Interface: Easy-to-use admin panels for content management
  • Sample Data Import: Get started quickly with sample content
  • CORS Support: Ready for headless implementations

Custom Post Types

DJ Profiles

  • Personal information and bio
  • Social media links
  • Years on air and specialties
  • Profile photos and quotes

Radio Shows

  • Show descriptions and schedules
  • Host assignments
  • Genre classifications
  • Air time management

Events

  • Event details and locations
  • Ticket information and pricing
  • Featured events and lineups
  • Event categories

Program Schedule

  • Weekly programming grid
  • Show-to-timeslot assignments
  • Day-by-day scheduling
  • Host associations

Recently Played Tracks

  • Track and artist information
  • Album details and artwork
  • Play times and durations
  • Genre classifications

REST API Endpoints

  • /wp-json/radio-station/v1/djs - Get all DJs
  • /wp-json/radio-station/v1/shows - Get all shows
  • /wp-json/radio-station/v1/events - Get all events
  • /wp-json/radio-station/v1/news - Get all news posts
  • /wp-json/radio-station/v1/schedule - Get program schedule
  • /wp-json/radio-station/v1/recently-played - Get recently played tracks
  • /wp-json/radio-station/v1/current-show - Get current show

Perfect for Headless WordPress

This plugin is specifically designed for headless WordPress implementations where you want to:

  • Manage content in WordPress
  • Use a modern frontend framework (React, Vue, etc.)
  • Maintain full control over the user experience
  • Leverage WordPress's content management capabilities

Installation

  1. Upload the plugin files to the /wp-content/plugins/spark-radio-station directory, or install the plugin through the WordPress plugins screen directly.
  2. Activate the plugin through the 'Plugins' screen in WordPress
  3. Navigate to 'Spark Radio' in the admin menu to access the main dashboard
  4. (Optional) Use the 'Import Sample Data' submenu to populate your site with sample content
  5. Start adding your DJs, shows, events, and schedule entries

Frequently Asked Questions

Is this plugin compatible with my theme?

This plugin is designed primarily for headless WordPress implementations and doesn't provide frontend templates. It focuses on content management and API endpoints.

Can I customize the API endpoints?

Yes! The plugin is built with extensibility in mind. You can hook into the REST API registration and modify or add endpoints as needed.

How do I handle CORS for my frontend application?

WordPress handles CORS automatically for REST API endpoints. For additional CORS configuration, you may need to add headers in your theme or use a CORS plugin.

Can I import my existing radio station data?

The plugin includes a sample data importer to help you get started. For custom data import, you can extend the import functionality or use WordPress's built-in import tools.

Screenshots

  1. Main admin dashboard with quick links and API information
  2. DJ management interface with custom fields
  3. Program schedule management
  4. Event management with featured events
  5. REST API endpoints overview

Changelog

1.0.0

  • Initial release
  • Custom post types for DJs, Shows, Events, Schedule, and Tracks
  • Complete REST API implementation
  • Admin interface with custom meta boxes
  • Sample data importer
  • Custom taxonomies for genres and event categories

Upgrade Notice

1.0.0

Initial release of Spark Radio Station plugin.

Developer Notes

Extending the Plugin

The plugin is built with WordPress best practices and is fully extensible. You can:

  • Add custom meta fields using the existing meta box system
  • Extend the REST API with additional endpoints
  • Customize the admin interface with additional functionality
  • Add custom taxonomies for further content organization

Hooks and Filters

The plugin provides several hooks and filters for customization:

  • spark_radio_dj_meta_fields - Filter DJ meta fields
  • spark_radio_show_meta_fields - Filter show meta fields
  • spark_radio_api_response - Filter API responses
  • spark_radio_after_sample_import - Action after sample data import

API Response Format

All API endpoints return JSON responses with consistent formatting. Each content type includes relevant meta data and properly formatted fields for easy frontend consumption.

Support

For support, feature requests, or bug reports, please contact the plugin author or visit the plugin's repository.