Polymedia

Fixed

• craft up could fail when a core or third-party migration re-saved sections before this plugin's m260507_000000_field_settings migration had run. The element-validation hook queried the not-yet-created polymedia_field_settings table and threw The table does not exist. AssetFieldSettings::getAllowedProviders() now returns no restrictions when the table is absent, so migrations complete cleanly.

Added

• Track pickers on the asset edit screen for video items — Captions, Subtitles, and Descriptions. Each is a multi-select .vtt picker that can also upload into the item's folder. Tracks are site-scoped, with srclang and label derived from the current site on save. Previously tracks could only be attached programmatically via RelatedAssets::attach().
• Poster image picker on the Add media URL create screen, so a poster can be set when first creating an item — previously only available on the asset edit screen. The picker is image-only and supports inline upload, with uploads landing in the item's own folder.
• Add media URL button on the standalone Assets index toolbar, beside Upload files. Previously only available in field selection modals.
• Each new .pmedia is now created inside its own dedicated folder (named after the title slug plus a short uid), so its poster and track files sit alongside it instead of cluttering the parent folder. Posters and tracks uploaded inline are co-located into that folder automatically.
• polymedia/migrate/folders console command to move existing .pmedia items (and their co-located poster/track files) into per-item folders. Supports --dry-run; safe to run repeatedly — items already in their own folder are skipped.

Changed

• Removed the target-volume dropdown from the Add media URL screen. New .pmedia manifests now land in the volume/folder the user is currently browsing (or the field's upload location), matching how Craft handles normal asset uploads. Falls back to the configured default volume, then the first writable volume.
• Hard-deleting a .pmedia now also removes its dedicated folder and the poster/track files inside it. A .pmedia that shares a folder with other items leaves the folder untouched.

Added

• "Allowed Providers" setting on plain craft\fields\Assets fields when the polymedia kind is enabled. Mirrors the same filter on PolymediaField, so any Assets field can restrict media URL selections to specific providers. Toggles live as the kind is checked/unchecked.
• polymedia_field_settings table for per-field plugin settings keyed by field UID.
• AssetFieldSettings, ProviderFilter services. PolymediaAssetFieldBehavior attached to native Assets fields.
• Plugin icon (src/icon.svg).

Changed

• Provider filter validation extracted to a shared service. PolymediaField and plain Assets fields now run identical validation logic.

Removed

• Unused per-placement poster override code (FieldOverrides service, FieldRelationRecord, polymedia_field_relations table). The schema, service, and allowPosterOverride config key were never reachable from Twig or the CP UI.

Added

• PolymediaAssetBehavior attached to all Asset elements, exposing getPlayer(), getElement(), getData(), getPoster(), getTracks(), getTranscript(), and getIsPolymedia() directly on assets in Twig.

Fixed

• Restored "Add Media URL" button in asset selection modals and slideouts.

Added

• Initial release.
• URL detection for 16 media providers (HLS, DASH, Mux, YouTube, Vimeo, Spotify, TikTok, Wistia, JW Player, Twitch, Cloudflare, Shaka, PeerTube, Video.js, MP4, Audio).
• .pmedia JSON manifest files stored as Craft assets.
• MediaItemRecord database mirror for fast index queries.
• Deterministic thumbnail derivation (YouTube, Vimeo, Mux, Cloudflare, Wistia).
• Custom polymedia file kind with asset index table attributes (Type, Provider, Duration).
• CP "Add media URL" modal with signed-URL warning.
• Asset edit sidebar panel with playback defaults.
• Related assets system (poster, captions, subtitles, descriptions, transcript).
• VTT validation with BOM stripping.
• PolymediaField field type (extends Assets) with provider filtering and per-placement poster overrides.
• Renderer service with player(), element(), data(), is(), scripts().
• craft.polymedia.* Twig variable API.
• Media Chrome <media-controller> rendering with correct provider element tags.
• Script loader modes: CDN, self-host, none.
• Asset indexer reconciler for orphaned .pmedia files.
• 102 unit tests, 268 assertions.