[benecaster_timestamp]
Renders a clickable timecode link that seeks the in-page player to a specific point in the episode. Designed for use in show notes — type # in the TipTap episode content field to open the timecode entry popover, enter a timecode in MM:SS or HH:MM:SS format, and confirm to insert the timestamp node.
The time attribute is stored in seconds (integer). The editor converts typed MM:SS or HH:MM:SS input to seconds on insert. Display label defaults to the formatted timecode: MM:SS for durations under one hour, HH:MM:SS at one hour or above.
On the front end, clicking the rendered link fires a JavaScript seek event to the nearest benecaster_player instance on the page. Degrades gracefully to a formatted timecode label if no player is present.
Output filterable via benecaster_timestamp_output.
Parameters
| Name | Type | Default | Required | Description |
|---|---|---|---|---|
time |
int |
— | Yes | Timecode in seconds. Required. The TipTap picker accepts MM:SS or HH:MM:SS and converts to seconds on insert. |
episode_id |
int |
(current episode)
|
No | Episode the timecode belongs to. When specified, the seek target is the player for this episode if multiple players are present on the page. |
label |
string |
(formatted timecode)
|
No | Display text. Defaults to the formatted timecode (e.g. '14:32' or '1:04:15'). Override for contextual anchors such as 'skip to the interview'. |
Example
<!-- Simple timecode link — displays '14:32', seeks player to 14 min 32 sec -->
[benecaster_timestamp time="872"]
<!-- Custom prose label -->
[benecaster_timestamp time="872" label="skip to the interview"]
<!-- Hour-long episode — displays '1:04:15' -->
[benecaster_timestamp time="3855"]
<!-- Specific episode on a page with multiple players -->
[benecaster_timestamp time="120" episode_id="42" label="jump to the intro"]