=== DL Shows & Movies ===
Contributors: biggerbenson
Tags: tv shows, movies, music, video, streaming, entertainment, shortcode, media library
Requires at least: 6.0
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.2.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

A streaming-style entertainment hub for TV shows, movies, and music with beautiful single pages, media players, and shortcodes.

== Description ==

**DL Shows & Movies** by [Dchamp Legacy](https://dchamplegacy.com) turns your WordPress site into a cinematic entertainment catalog. Display TV shows, movies, and music with a dark, cinema-inspired interface.

= Features =

* **Three content types** - TV Shows, Movies, and Music
* **Clean permalinks** - `/shows/your-show`, `/movies/your-movie`, `/music/your-track`
* **Media players** - YouTube, Vimeo, HLS (.m3u8), SoundCloud, and Spotify
* **Seasons & episodes** - Manage show seasons and switch episodes on the frontend
* **Rich metadata** - Synopsis, cast, credits, ratings, genres, and categories
* **Image support** - Cover photo, portrait poster, landscape banner, artist image, hero background, and gallery
* **Featured slider** - Highlight featured shows, movies, and music
* **Shortcodes** - Embed content grids on any page
* **Organized admin** - Dashboard, settings, meta boxes, and shortcode reference
* **Secure** - Nonces, capability checks, sanitization, and escaping throughout

= Shortcodes =

* `[dlsm_shows]` - Display TV shows grid
* `[dlsm_movies]` - Display movies grid
* `[dlsm_music]` - Display music grid
* `[dlsm]` - Display all content types
* `[dlsm_featured]` - Display featured content

= Shortcode Attributes =

* `limit` - Number of items (default: 12)
* `genre` - Filter by genre slug
* `category` - Filter by category slug
* `orderby` - date, title, rating, rand
* `order` - ASC or DESC
* `columns` - Grid columns (2-6)
* `view` - grid or list
* `search` - 1 to show search bar
* `featured_slider` - 1 shows featured slider above the grid (default). Use 0 to hide.

= Example =

`[dlsm_shows limit="8" genre="kids" columns="4" search="1"]`

== External services ==

DL Shows & Movies can embed media from third-party platforms when you add URLs in the admin. No data is sent until a visitor views a page that includes that embed. The visitor's browser loads the embed directly from the service.

= YouTube =
Used to play YouTube videos and trailers you provide.
Data: the video ID from your saved URL is requested by the visitor's browser when the player or trailer is shown.
Service: YouTube (Google). Terms: https://www.youtube.com/t/terms — Privacy: https://policies.google.com/privacy

= Vimeo =
Used to play Vimeo videos and trailers you provide.
Data: the video ID from your saved URL is requested by the visitor's browser when the player or trailer is shown.
Service: Vimeo. Terms: https://vimeo.com/terms — Privacy: https://vimeo.com/privacy

= SoundCloud =
Used to play SoundCloud audio you provide.
Data: the track/playlist URL you saved is requested by the visitor's browser when the audio player is shown.
Service: SoundCloud. Terms: https://soundcloud.com/terms-of-use — Privacy: https://soundcloud.com/pages/privacy

= Spotify =
Used to play Spotify content you provide.
Data: the track/album/playlist/show ID from your saved URL is requested by the visitor's browser when the player is shown.
Service: Spotify. Terms: https://www.spotify.com/legal/end-user-agreement/ — Privacy: https://www.spotify.com/legal/privacy-policy/

= HLS streams =
Used when you provide a direct `.m3u8` stream URL. Playback is handled in the visitor's browser (native HLS or hls.js bundled with this plugin). No third-party SaaS is contacted by the plugin itself beyond the stream host you configure.

== Installation ==

1. Upload the `dl-shows-movies` folder to `/wp-content/plugins/`
2. Activate the plugin through the **Plugins** menu
3. Go to **DL Shows & Movies** in the admin menu to add content
4. Visit **Settings -> Permalinks** and click **Save** to refresh URLs
5. Embed content using shortcodes on any page

== Frequently Asked Questions ==

= How do I add a new TV show? =

Go to **DL Shows & Movies -> TV Shows -> Add New**. Fill in the details, media sources, and images, then publish.

= What URL will my show have? =

Shows use `/shows/your-show-slug`.

= Which video formats are supported? =

YouTube, Vimeo, HLS streams (.m3u8), SoundCloud, and Spotify embeds.

= Can I embed shows on a page? =

Yes. Use `[dlsm_shows]` or other shortcodes on any page or post.

== Screenshots ==

1. Featured slider and content grid with search and filters on different devices
2. Single show page with hero, player button, cast, and gallery tabs
3. TV Shows or Movies with Episodes
4. Audio Music Player

== Changelog ==

= 1.2.0 =
* Renamed plugin to DL Shows & Movies (slug: dl-shows-movies)
* Documented external media services
* Theme CSS variables use wp_add_inline_style
* Removed load_plugin_textdomain for WordPress.org hosting
* Contributors set to biggerbenson

= 1.1.0 =
* Interim rename and WordPress.org compliance updates

= 1.0.7 =
* Hid trailer title and controls on single-page background video
* Improved responsive layout

= 1.0.6 =
* Featured slider on archive pages
* Borderless archive layout

= 1.0.5 =
* Featured slider above shortcode grids
* Grid contrast fixes

= 1.0.4 =
* Seasons and episodes for TV shows

= 1.0.3 =
* Trailer as single-page hero background

= 1.0.2 =
* Identifier refresh

= 1.0.1 =
* Fixed single page 404 and template loading

= 1.0.0 =
* Initial release

== Upgrade Notice ==

= 1.2.0 =
Renamed to DL Shows & Movies. Upload as the dl-shows-movies folder, activate, then visit Settings -> Permalinks and click Save. Update shortcodes to dlsm_*.
