[benecaster_member_since]
Outputs a subscriber’s membership tenure label or date for standalone placement in emails, page content, and theme templates. Complements the tenure chip Benecaster appends automatically to supporter wall cards — use this shortcode when you want the tenure information in a custom position without the full badge chip markup.
Returns an empty string (no output, no wrapper) when any of the following are true: the site-wide tenure-badge toggle (benecaster_tenure_badge_enabled) is off, no user resolves from the user_id attribute and the current request has no logged-in user, or the resolved user has no token snapshot in benecaster_tenure.
Show resolution on multi-show installs: when show_id is omitted, the shortcode falls back to the earliest-token-across-all-shows snapshot (the same calculation used on the subscriber account page). Specify show_id to anchor tenure to a particular show.
Parameters
| Name | Type | Default | Required | Description |
|---|---|---|---|---|
user_id |
int |
(current user)
|
No | WordPress user ID. Defaults to the currently logged-in user. Renders nothing if no user resolves. |
show_id |
int |
— | No | Show ID to anchor the tenure calculation to. Optional on single-show installs — auto-resolved via benecaster_get_sole_show_id(). When omitted on multi-show installs, falls back to the earliest-token-across-all-shows snapshot. |
format |
string |
long
|
No | Output format. Options: long (e.g. 'Member since June 2024', formatted via date_i18n()), short (the milestone label, e.g. '1-Year Member'), raw (ISO 8601 date string, e.g. '2024-06-01'). Case-insensitive. Unknown values fall back to long. |
Example
<!-- Full date label — "Member since June 2024" -->
[benecaster_member_since]
<!-- Milestone label — "1-Year Member" -->
[benecaster_member_since format="short"]
<!-- Machine-readable ISO date -->
[benecaster_member_since format="raw"]
<!-- Specific user and show -->
[benecaster_member_since user_id="42" show_id="3" format="long"]