Usage insights

🔒 Pro feature — requires the Pro plugin.

Usage insights show how often each technique, diagnostic, advice item and treatment detail appears in logged treatments. Students see their own figures on a My Usage page. Administrators get Usage Analytics in wp-admin, for one student or for every student at once.

With only the free plugin active, neither the [dclb_usage] page nor the Usage Analytics screen exists. The My Usage button label and Usage page settings on Site Setup also stay hidden until Pro is active.

Student usage insights

What it is

A front-end report, scoped to the logged-in student, headed Insights · My Usage:

Track how your logged treatments distribute across techniques, diagnostics, and follow-up advice. Adjust filters to compare rotations or highlight growth over time.

It lets students see which interventions they use most, which they have never recorded, and how that has changed over time.

Setting up the page

The report is a shortcode:

[dclb_usage]

The shortcode has no attributes.

When Pro is activated, it uses an existing page that contains the shortcode, or creates and publishes a My Usage page (address /my-usage/). To use a different page, go to Plugin Settings → Site Setup → Pages and set Usage page. The text on the button that links students to this page is set by My Usage button label on Site Setup. Leave it blank to use the default.

The page shares the logbook’s navigation header, so students can move between their overview, the entry form, their reflections journal and My Usage.

Who sees what

• Logged out: “Please log in to view your usage insights”, with a log-in link.
• Logged in: the student only ever sees their own entries. There is no way to view another person’s data on this page.
• Levels: only levels where the student has an active allocation are counted. A student with no active allocation sees “This student does not have any active level allocations yet.”

Filters

The Refine this report panel has two groups. Changing any filter refreshes the report straight away. Without JavaScript, use Apply filters.

Group	Filter	Default	Notes
Clinic scope	Study level	All assigned levels	The list shows every level in the program. Choosing one the student isn’t allocated to falls back to all assigned levels.
Clinic scope	Clinic focus	All clinics	Limits the report to one clinic type.
Date range	From date / To date	Empty (all dates)	Either date can be left blank.

The page address updates as filters change, so a student can bookmark a filtered view.

What the report shows

Summary tiles: Student, Level, Clinic focus, Treatments analyzed, and Date range (shown only when a date is set).

Four category sections, with a Jump to: link for each:

• Techniques
• Diagnostics
• Advice & Education
• Treatment Details

Each section has a table with these columns:

Column	Meaning
Item	Every catalogue item available at the selected level(s) and clinic, in alphabetical order. Items never used are included and shown as zero.
Treatments	How many analysed treatments recorded this item
% of treatments	That count as a share of Treatments analyzed, to one decimal place. A dash (—) means zero. One treatment can record several items, so the percentages in a section can add up to more than 100%.

Trend lines. Each section has a Usage momentum panel with a View trend line button. It opens a line chart over time with:

• a thicker All items line (the section’s total)
• a line for each of the section’s three most-used items
• legend buttons that show or hide each line

The time range is split into up to eight periods. Each period is one or more whole weeks starting on a Monday, so a long date range uses wider periods. Close the chart with Close or the Escape key.

What is counted: published entries only. Drafts and voided entries are left out.

Empty states

Message	Meaning
No treatments match your filters yet. Try adjusting the date range or clinic.	No published entries match the current filters
This student does not have any active level allocations yet.	The student has no active allocation, so no levels are in scope
No catalog data available for these filters.	Treatments exist, but the selected level and clinic have no catalogue items
Unable to refresh this report. Please try again.	A filter change failed to load, for example after a dropped connection or an expired login

Usage Analytics

Where to find it

Clinical Training Logbook → Usage Analytics in wp-admin. Only administrators can open it.

How to use it

The page opens showing All students: a combined report across every student and every level in the program. That makes it easy to see what the program as a whole is treating.

1. Student: keep All students, or choose one student. The list shows users with an eligible student role, sorted by name, up to the first 200. Changing it refreshes the report.
2. Study level: default All assigned levels. For one student, only levels they are actively allocated to count. For All students, every level counts.
3. Clinic focus: default All clinics.
4. From date / To date: optional. Changing either refreshes the report.
5. Select Apply filters. The Study level and Clinic focus menus only take effect when you do this.

The report itself (summary tiles, the four category sections, the tables, the Jump to: links and the View trend line charts) is the same as the student report described above. The Student tile shows the student’s name, or All students.

There is no export on this screen. For downloadable data, use the reports on Logbook Entries (see Logbook entries and reports).

Messages specific to this screen

Message	Meaning
No study levels have been created yet, so there is nothing to report on.	All students is selected but the program has no levels yet. Add levels in Logbook Configuration (see Program catalogue).
This student does not have any active level allocations yet.	The chosen student has no active allocation (see Student allocations)
Unable to refresh this report. Please try again.	The refresh failed. Reload the page and try again.

Limits and edge cases

• The Student list stops at 200 students. On larger programs, students beyond that are not listed.
• A single student’s report only covers levels where they have an active allocation. Once an allocation is completed or archived, that level’s entries drop out of their report. Use All students to include every level.
• Catalogue items that have been deleted are not listed.

Worked example

A program coordinator wants to know whether second-year students are using cupping in the teaching clinic. She opens Usage Analytics, leaves All students selected, chooses the second-year level under Study level and the teaching clinic under Clinic focus, sets From date to the start of semester, and selects Apply filters. Treatments analyzed reads 214, and in Techniques the cupping row shows 9 treatments (4.2%). She opens View trend line for Techniques and hides every line except cupping. Use rose in the last two periods, after a practical workshop. She then switches Student to one student and checks that student’s own pattern.

Troubleshooting

Problem	Fix
A student says their usage page is empty	Check they have an active allocation (Student Allocations) and published entries in the selected date range
Changing Study level in wp-admin doesn’t change the report	Select Apply filters. Only Student and the dates refresh on their own
A student is missing from the Student list	Check their role is ticked under Eligible student roles on Site Setup. The list also stops at 200 students
Percentages add up to more than 100%	This is expected. One treatment can record several items in the same category