[entronn_player] Shortcode Reference
Covers Entronn Video Player v1.0.1+. For setup guides, see the main Documentation.
Basic Usage
At minimum, the shortcode needs a video source. It works with either an HLS playlist or a plain MP4 file:
[entronn_player src="https://example.com/video/master.m3u8"]
Attributes are added as key="value" pairs inside the shortcode, in any order.
Attribute Reference
| Attribute | Type | Default | Description |
|---|---|---|---|
src | URL | — | HLS .m3u8 playlist or MP4 file. Required. |
poster | URL | none | Thumbnail image shown before playback starts. |
subtitle | URL | none | WebVTT (.vtt) caption track. Repeat the attribute for multiple tracks. |
autoplay | 0 / 1 | 0 | Starts playback automatically. Browsers require muted="1" alongside autoplay. |
loop | 0 / 1 | 0 | Restarts playback automatically when the video ends. |
muted | 0 / 1 | 0 | Starts the player muted. |
accent | hex color | theme default | Overrides the play-button and progress-bar accent color for this embed only. |
ad_preroll | URL / VAST tag | none | Ad shown before the video starts. Pro |
ad_midroll | URL / VAST tag | none | Ad shown at a timed point during playback (paired with ad_midroll_at). Pro |
ad_midroll_at | seconds | none | Playback timestamp at which the mid-roll ad plays. |
ad_postroll | URL / VAST tag | none | Ad shown after the video ends. Pro |
ad_skip | seconds | 5 | Countdown before the skip button appears on a skippable ad. |
ad_skippable | 0 / 1 | 1 | Set to 0 to make an ad non-skippable. |
sponsor_label | string | none | Label text for an optional sponsor button shown during ads. |
sponsor_url | URL | none | Destination link for the sponsor button. |
analytics | 0 / 1 | 1 | Opts this embed out of play/watch-time tracking when set to 0. Business |
Examples
A video with a poster image and captions:
[entronn_player src="…/master.m3u8" poster="…/thumb.jpg" subtitle="…/en.vtt"]
Muted autoplay, looping — typical for a hero background video:
[entronn_player src="…/master.m3u8" autoplay="1" muted="1" loop="1"]
A video with a skippable pre-roll ad and a sponsor button:
[entronn_player src="…/master.m3u8" ad_preroll="…/ad.mp4" ad_skip="5" sponsor_label="Visit sponsor" sponsor_url="https://example.com"]
URL Parameters
To restyle a single embed without editing the shortcode — useful for a campaign link or an A/B test — append color parameters to the page URL itself. They apply to Entronn players rendered on that page view only, and don't change your saved theme settings:
?entronn_color1=%233f51b5&entronn_color2=%237c4dff
entronn_color1— gradient start color (hex, URL-encoded).entronn_color2— gradient end color (hex, URL-encoded).
If a page has more than one player embed, the override currently applies to all of them.
Automatic <video> Upgrade
If a post already contains a standard HTML <video> tag, Entronn detects it at render time and upgrades it to the full player automatically — no need to replace it with a shortcode. The src, poster, and any <track> elements on the original tag carry over; attributes not expressible on a plain <video> tag (ads, accent overrides) fall back to your global defaults.
Need setup steps instead of an attribute list? Head back to the Documentation.