Shortcode Reference
Dantian Clinical Training Logbook has five shortcodes: two in the free plugin and three more when Pro is active. Each one renders a complete front-end screen, so each goes on its own page. Add a shortcode with the block editor’s Shortcode block, or type it into the classic editor.
You usually don’t need to create these pages yourself. When the plugin is activated, it gives each screen a page. If a published page already contains the shortcode, the plugin uses that page. Otherwise it creates a new one. Pro does the same for its three screens when Pro is activated. You can see and change these page assignments under Clinical Training Logbook → Plugin Settings → Site Setup → Pages. See Front-end pages.
| Shortcode | Plugin | Page created on activation | Attributes |
|---|---|---|---|
[dclb_entry] |
Free | Log a Treatment (/log-a-treatment/) |
entry_id |
[dclb_overview] |
Free | My Logbook (/my-logbook/) |
entry_page_url |
[dclb_journal] |
Pro | Reflective Journal (/reflective-journal/) |
entry_page_url |
[dclb_usage] |
Pro | My Usage (/my-usage/) |
None |
[dclb_trainer_workspace] |
Pro | Trainer Workspace (/trainer-workspace/) |
None |
The free plugin has no other shortcodes, and neither does Pro. Older shortcode names from earlier versions are no longer registered. A page that still uses one of them shows the raw shortcode text.
General placement advice
- Use one logbook shortcode per page. Each shortcode loads its own configuration under a fixed name. Two copies of the same shortcode, or several logbook shortcodes on one page, can interfere with each other.
- Don’t put the entry form and the overview on the same page. If Entry form page and Overview page point to the same page on Site Setup, the settings screen warns you. The My Logbook link would send students back to the form instead of their overview.
- Assign the pages on Site Setup. The navigation bar at the top of each student screen links to the assigned pages, so leave them assigned. Links to the journal and usage pages only appear once those pages are assigned.
- Every shortcode needs a logged-in visitor. Logged-out visitors see a short message with a log in link that brings them back to the same page after they sign in. Making the page itself private or members-only is optional.
[dclb_entry] — treatment entry form
Plugin: Free
Shows the form a student uses to log a treatment. It has four sections: Clinic Context (level, clinic type, treatment date, treatment number), Details (client name or alias, age, sex assigned at birth, case details), Diagnostics, Techniques & Advice, and Treatment Evidence (treatment notes upload and reflection). The same form edits existing entries. For the full walkthrough, see Logging treatments.
Attributes
| Attribute | Type | Default | Allowed values | Effect |
|---|---|---|---|---|
entry_id |
Whole number | 0 (new entry) |
The ID of an existing entry | Opens that entry for editing. It only loads if the entry belongs to the logged-in student. |
You rarely need entry_id. The plugin builds edit links itself by adding ?entry_id= to the entry page’s address, and that URL value takes priority over the attribute. If the entry doesn’t exist or belongs to someone else, the form says “That entry could not be loaded — it may have been removed, or it may belong to someone else. You can log a new treatment below.” and opens a blank form instead.
Examples
[dclb_entry]https://your-site.example/log-a-treatment/?entry_id=123Who can see it
| Visitor | What they see |
|---|---|
| Logged out | “Please log in to submit or edit logbook entries.”, where log in links to the WordPress login screen |
| Any logged-in user | The form. In the free plugin, the form doesn’t check the user’s role (see User roles and permissions). |
| No levels set up yet | “Treatment logging is unavailable until an administrator adds at least one study level.” |
🔒 Pro feature — requires the Pro plugin.
Once at least one active allocation exists on the site, Pro turns on allocation gating. From then on, a student without an active allocation sees Awaiting logbook allocation, and saving an entry for an unallocated or locked logbook is refused. See Student allocations.
Placement: a dedicated page, set as Entry form page on Site Setup. The overview’s edit and Log your first treatment buttons link here.
[dclb_overview] — student logbook overview
Plugin: Free
Shows the logged-in student’s own logbook: progress by program level and clinic type, requirement progress, a demographics summary, filters and search, and a paginated list of their entries with edit links. Students only ever see their own entries. See Student overview and progress.
Attributes
| Attribute | Type | Default | Allowed values | Effect |
|---|---|---|---|---|
entry_page_url |
URL | Empty | A full URL | Overrides where the overview’s Log a Treatment, Log your first treatment and edit links point. |
If you leave entry_page_url empty, links go to the page assigned as Entry form page on Site Setup. If no entry page is assigned either, they point back to the current page. Most sites should leave the attribute out and assign the page on Site Setup.
Examples
[dclb_overview][dclb_overview entry_page_url="https://your-site.example/log-a-treatment/"]Who can see it
| Visitor | What they see |
|---|---|
| Logged out | “Please log in to view your logged treatments.” with a log in link |
| Any logged-in user | Their own logbook, or “No treatments logged yet. Once you add entries they will appear here.” if they have none |
🔒 Pro feature — requires the Pro plugin.
While allocation gating is active, a student with no active allocation sees Awaiting logbook allocation in place of their progress board.
Placement: a dedicated page, set as Overview page on Site Setup. This is also where the optional Student login destination setting sends students after they log in.
[dclb_journal] — reflective journal
🔒 Pro feature — requires the Pro plugin.
Shows the logged-in student every reflection they’ve written, with filters and links back to the entry form for editing. When reflection feedback is turned on, it also shows trainers’ feedback. See Reflections, journal and feedback.
Attributes
| Attribute | Type | Default | Allowed values | Effect |
|---|---|---|---|---|
entry_page_url |
URL | Empty | A full URL | Overrides where the journal’s links to the entry form point. |
If you leave entry_page_url empty, links go to the assigned Entry form page, or to the current page if none is assigned.
Example
[dclb_journal]Who can see it
| Visitor | What they see |
|---|---|
| Logged out | “Please log in to review your reflections.” with a log in link |
| Any logged-in user | Their own reflections only. The journal never shows another student’s reflections, whatever the request contains. |
Placement: a dedicated page, assigned as Reflective Journal page on Site Setup. The navigation bar links to it with the label set under Reflection Settings → Reflections button label (default Review Reflections).
[dclb_usage] — student usage insights
🔒 Pro feature — requires the Pro plugin.
Shows how often the logged-in student has used each intervention: technique, diagnostic, advice and case detail. They can filter by level, clinic type and date range. See Usage insights.
Attributes: none. This shortcode accepts no attributes.
The filter form on the page uses these URL parameters, so you can link straight to a filtered view:
| Parameter | Meaning |
|---|---|
level |
Level ID |
clinic |
Clinic type ID |
start |
Start date (for example 2026-01-31) |
end |
End date |
The report always covers the logged-in student only. A level outside the student’s allocations, or a clinic type that doesn’t exist, is ignored.
Example
[dclb_usage]Who can see it
| Visitor | What they see |
|---|---|
| Logged out | “Please log in to view your usage insights.” with a log in link |
| Any logged-in user | Their own usage report |
Placement: a dedicated page, assigned as Usage page on Site Setup. The navigation bar links to it with the label set under Site Setup → My Usage button label (default My Usage).
[dclb_trainer_workspace] — trainer workspace
🔒 Pro feature — requires the Pro plugin.
This is the trainer’s whole workspace on one page. Trainers pick a cohort and a student, browse that student’s entries with date and level filters, open an entry’s details (evidence files and, when turned on, evidence review), read the student’s reflections and, when turned on, leave reflection feedback. See Trainer workspace.
Attributes: none. This shortcode accepts no attributes.
Example
[dclb_trainer_workspace]Who can see it
| Visitor | What they see |
|---|---|
| Logged out | “Please log in to view trainer dashboards.” with a log in link |
| Logged in, not a trainer | “You do not have access to trainer views.” and “If you should have trainer access, contact your site administrator.” |
| A trainer who isn’t named on any cohort | “You need to be assigned to a cohort to view trainer dashboards.” and “Contact your site administrator to be assigned to a cohort.” |
| A trainer named on one or more cohorts | The workspace, limited to students with an active allocation in those cohorts |
This includes administrators. An administrator only sees students in the workspace if they are named as a trainer on a cohort. Administrators can always review every student from the wp-admin screens. Students allocated without a cohort don’t appear in any trainer’s workspace. See Students without a cohort and Who counts as a trainer.
Placement: a dedicated page, assigned as Trainer Workspace page on Site Setup. Once this page is assigned, users with the Clinical Trainer role go straight to it after logging in. They also see a Your Trainer Workspace box on their wp-admin dashboard with a link to it. You don’t need to add this page to your public site menu.
Related
- Plugin settings and pages: assigning and replacing pages
- Settings reference: button labels and other settings that change what these screens show
- User roles and permissions: who can open each screen