[benecaster_episode_share]
Renders social share buttons for an episode. Share links are auto-generated from the episode URL and title — no per-platform URL entry required. Platforms with a null or suppressed URL (via benecaster_episode_share_links filter) are silently omitted.
Share text supports merge tags: {{episode_title}}, {{show_name}}, {{episode_number}}. The per-show default text is set in Settings → Show → Episode Page (share_buttons block config). The shortcode text attr overrides it for a specific placement.
Note: Twitter/X appends the episode URL automatically in the tweet composer — the text value should not include the URL. All other platforms receive the URL as a separate parameter.
Output filterable via benecaster_episode_share_output. Share text filterable per-platform via benecaster_episode_share_text. Share link array filterable via benecaster_episode_share_links (existing filter from Benecaster episode template).
Parameters
| Name | Type | Default | Required | Description |
|---|---|---|---|---|
episode_id |
int |
(current episode)
|
No | Episode to generate share links for |
show_id |
int |
(current show)
|
No | Used for show name merge tag resolution |
style |
string |
buttons
|
No | buttons — labeled button row; icons — icon-only row; minimal — icon row, no labels, no borders |
platforms |
string |
(all enabled for show)
|
No | Comma-separated platform slugs to include. Built-in: twitter, facebook, linkedin, threads, email, copy. Omit to use the show's configured platform set. |
text |
string |
(per-show default)
|
No | Share message template. Supports merge tags {{episode_title}}, {{show_name}}, {{episode_number}}. Falls back to per-show default set in Episode Page block config, then to {{episode_title}}. |
Example
<!-- Default share buttons for current episode -->
[benecaster_episode_share]
<!-- Icons only, specific platforms -->
[benecaster_episode_share style="icons" platforms="twitter,facebook,copy"]
<!-- Custom share text with merge tags -->
[benecaster_episode_share text="🎧 {{episode_title}} — new episode of {{show_name}}"]
<!-- Minimal style, all platforms, specific episode -->
[benecaster_episode_share episode_id="123" style="minimal"]