FISM Station Finder

A production WordPress plugin for finding Financial Issues radio and TV stations across the United States. The finder combines responsive search and filtering, ZIP-code radius lookup, clustered Leaflet maps, station details, and WordPress dashboard management in one deployable plugin.

Use the live Station Finder

What it does

• Switches between radio and TV datasets without a page reload
• Searches by city, state, call letters, frequency, channel, network, or area code
• Filters by state and ZIP-code radius
• Clusters nearby station markets on an interactive Leaflet/OpenStreetMap map
• Presents station schedules, network details, and station links
• Gives WordPress administrators add, edit, delete, search, and reset controls
• Seeds 449 radio listings and 111 TV listings from bundled JSON
• Migrates older state-level coordinates to bundled city-level coordinates
• Provides combined and single-mode shortcodes

Shortcodes

[fism_station_finder]
[fism_station_finder type="radio"]
[fism_station_finder type="tv"]
[fism_radio_finder]
[fism_tv_finder]

Set tabs="no" on the flexible shortcode to lock the experience to one station type.

Architecture

WordPress shortcode
      |
      +-- sanitized station data from wp_options
      +-- bundled state and city coordinates
      |
      v
JSON payload embedded on the rendered page
      |
      v
Browser application
  - search and filters
  - ZIP-radius calculation
  - Leaflet map and clusters
  - station detail panel

The browser does not call a public WordPress AJAX endpoint for station data. The plugin prints the payload only where the shortcode is rendered.

Installation

1. Copy this directory to wp-content/plugins/fism-station-finder.
2. Activate FISM Station Finder in WordPress.
3. Add one of the shortcodes above to a page.
4. Manage records under WordPress Admin → Station Finder.

The frontend loads Leaflet 1.9.4 from unpkg.com; a production deployment should allow that origin in its Content Security Policy or self-host the dependency.

Security and data handling

• Administrative mutations require the manage_options capability.
• Save, delete, and reset actions use WordPress nonces.
• Station fields are normalized and sanitized before storage and escaped during output.
• Station data included here is public broadcast information; no user data or production credentials are included.

See SECURITY.md for reporting guidance.

About the work

Built by Elijah Kelley for a national media organization. The live finder currently makes hundreds of station listings usable from a single responsive interface.