Pro Shortcodes Reference
BuddyPress Member Blog overviewFree + ProGet BuddyPress Member Blog →
Pro. This feature requires WB Member Blog Pro. The free plugin must be installed and active first. See the Pro index for every Pro module.
WB Member Blog Pro adds 13 shortcodes. Each one belongs to a Pro module and works only while that module is switched on under WB Plugins > Member Blog > Manage Modules. Each also has a matching block, see Blocks.
For the free plugin’s shortcodes, and the rules every list follows (independent pagination, designed empty states, admin hints), see the Shortcodes Reference.
All Pro shortcodes
Section titled “All Pro shortcodes”| Shortcode | Module | What it shows |
|---|---|---|
[bp-member-blog-author-settings] |
Author Dashboard | The member’s blog settings: notifications, co-authors, series |
[bp-member-blog-analytics] |
Post Analytics | A member’s view statistics |
[bp-member-blog-scheduled] |
Post Scheduling | A member’s scheduled posts |
[bp-member-blog-calendar] |
Post Scheduling | A publishing calendar |
[bp-member-blog-coauthors] |
Co-Authors | The byline of a post, with every co-author |
[bp-member-blog-invitations] |
Co-Authors | A member’s pending co-author invitations |
[bp-member-blog-coauthored-posts] |
Co-Authors | Posts a member co-wrote |
[bp-member-blog-series-nav] |
Post Series | Previous and next links within a series |
[bp-member-blog-series-toc] |
Post Series | A series table of contents |
[bp-member-blog-series-list] |
Post Series | A directory of series |
[bp-member-blog-custom-field] |
Custom Fields | The value of one custom field |
[bpmb_my_credit_history] |
Post Credits | A member’s credit balance history |
[bpmb_credit_packs] |
Post Credits | Credit packs members can buy |
When a module is switched off, a page that still holds one of its shortcodes shows a “Not available right now” notice instead of the shortcode text. Administrators also see a note naming the module and a link to WB Plugins > Member Blog > Manage Modules. [bp-member-blog-custom-field] shows nothing to visitors, only the admin note. Remove the shortcode from the page, or switch the module back on. The matching blocks leave the inserter while their module is off.
Author Dashboard
Section titled “Author Dashboard”[bp-member-blog-author-settings]
Section titled “[bp-member-blog-author-settings]”The member’s My Blog Settings screen, for sites that want it on its own page. A signed-out visitor sees “Please log in to view your blog settings.”
| Attribute | Default | Description |
|---|---|---|
tab |
(empty) | The sub-tab that opens first: notifications, coauthors or series. Empty opens the first one available. A ?settings_tab= value in the address overrides it. |
Which sub-tabs appear depends on the Author Dashboard settings and on which modules are on.
Post Analytics
Section titled “Post Analytics”[bp-member-blog-analytics]
Section titled “[bp-member-blog-analytics]”A member’s view totals (today, this week, this month, all time), a daily views chart, top posts and traffic sources.
| Attribute | Default | Description |
|---|---|---|
user_id |
Signed-in member | Whose statistics to show. Viewing another member’s requires the ability to edit others’ posts. |
days |
30 |
How many days the daily chart covers |
A signed-out visitor sees “Your blog analytics” with a Log in button. A member whose role is not allowed to use analytics sees “You do not have permission to access analytics.”
Post Scheduling
Section titled “Post Scheduling”[bp-member-blog-scheduled]
Section titled “[bp-member-blog-scheduled]”A member’s posts scheduled to publish later, paged.
| Attribute | Default | Description |
|---|---|---|
user_id |
Signed-in member | Whose scheduled posts to show. Another member’s requires the ability to edit others’ posts. |
A signed-out visitor sees “Scheduled posts” with a Log in button.
[bp-member-blog-calendar]
Section titled “[bp-member-blog-calendar]”A month calendar of posts.
| Attribute | Default | Description |
|---|---|---|
scope |
member |
member shows the signed-in member’s own drafts and scheduled posts. community shows every member’s posts and is shown only to users who can edit others’ posts (editors and administrators); anyone else sees nothing. |
With scope="member", a signed-out visitor sees “Please log in to view your publishing calendar.”
Co-Authors
Section titled “Co-Authors”[bp-member-blog-coauthors]
Section titled “[bp-member-blog-coauthors]”The byline for a post, naming the author and every co-author.
| Attribute | Default | Description |
|---|---|---|
post_id |
Current post | Which post’s byline |
separator |
, |
Text between names |
link |
yes |
Link each name to the writer’s profile |
[bp-member-blog-invitations]
Section titled “[bp-member-blog-invitations]”The signed-in member’s pending co-author invitations, each with Accept and Decline. No attributes. When there are none it shows “No pending invitations”. A signed-out visitor sees “Co-author invitations” with a Log in button.
[bp-member-blog-coauthored-posts]
Section titled “[bp-member-blog-coauthored-posts]”Posts a member co-wrote with other members, paged.
| Attribute | Default | Description |
|---|---|---|
user_id |
Signed-in member | Whose co-written posts to show |
limit |
10 |
Posts per page |
A signed-out visitor sees “Co-written posts” with a Log in button.
Post Series
Section titled “Post Series”[bp-member-blog-series-nav]
Section titled “[bp-member-blog-series-nav]”Previous and next links for the series the current post belongs to. Renders nothing on a post that is not in a series.
| Attribute | Default | Description |
|---|---|---|
style |
buttons |
buttons (compact), arrows or numbers (every part as a numbered link) |
post_id |
Current post | The post whose series to navigate |
show_title |
yes |
Show the series name in the bar: yes or no. The part count and links stay either way. |
[bp-member-blog-series-toc]
Section titled “[bp-member-blog-series-toc]”The numbered list of every post in a series, with the post being read highlighted. Renders nothing when there is no series to show.
| Attribute | Default | Description |
|---|---|---|
series_id |
0 |
The series. 0 uses the series of the current post. |
show_progress |
yes |
Tick off the parts the reader has read: yes or no. Follows the progress tracking settings, so nothing is ticked where progress is off. |
highlight |
yes |
Highlight the post being read: yes or no. |
[bp-member-blog-series-list]
Section titled “[bp-member-blog-series-list]”A paged directory of series that have published posts.
| Attribute | Default | Description |
|---|---|---|
author_id |
0 |
Only series by this member. 0 shows everyone’s. |
count |
10 |
Series per page |
columns |
2 |
Grid columns, 1 to 4 |
show_count |
yes |
Show how many posts each series has |
With nothing to list it shows “No series yet”.
Custom Fields
Section titled “Custom Fields”[bp-member-blog-custom-field]
Section titled “[bp-member-blog-custom-field]”The value of one custom field on a post, formatted for its field type (for example a video field shows a player). Renders nothing when the key is missing or the post has no value.
| Attribute | Default | Description |
|---|---|---|
key |
(empty) | The field key. Required. |
post_id |
Current post | Which post to read from. The value is shown only to a visitor who can read that post, so pointing it at a draft, private or password-protected post shows nothing to anyone else. |
sep |
, |
Separator between values of a multi-value field |
show_empty |
0 |
1 shows “Not provided” when the post has no value, instead of nothing. |
[bp-member-blog-custom-field key="location"][bp-member-blog-custom-field key="ingredients" sep=" | "]Post Credits
Section titled “Post Credits”[bpmb_my_credit_history]
Section titled “[bpmb_my_credit_history]”The signed-in member’s credit transactions, paged.
| Attribute | Default | Description |
|---|---|---|
per_page |
20 |
Rows per page |
A signed-out visitor sees “Your credit history” with a Log in button. While post credits are switched off in the Post Credits settings, visitors see nothing and admins see a note saying why.
[bpmb_credit_packs]
Section titled “[bpmb_credit_packs]”Credit packs members can buy, each sold as a WooCommerce product. Each pack card shows what one credit buys, for example “1 credit = 1 published post”.
| Attribute | Default | Description |
|---|---|---|
columns |
3 |
Grid columns. Never more than the number of packs; a single pack is shown as one wide card. |
| Situation | What shows |
|---|---|
| WooCommerce active, packs exist | The pack grid |
| WooCommerce active, no packs yet | “No credit packs on sale yet”, and admins are told where to add a pack |
| WooCommerce not active | “No credit packs on sale yet”, and admins are told to activate WooCommerce |