Overview
Uncanny CEUs includes a set of shortcodes — each with a matching Gutenberg block — for displaying credit information anywhere on your site. Use them to show learners their earned credits, how many credits remain before a rollover date, certificate descriptions, and more.
Every shortcode below has an equivalent block in the Uncanny Continuing Education Credits block category. Shortcodes are ideal for page builders, widgets, and templates; blocks offer the same output with a visual settings panel in the WordPress editor. Both produce identical results, so use whichever fits your workflow.
Wherever a shortcode references “credits,” the output uses the credit label you set under Uncanny CEUs > Settings (for example, CEUs, CPDs, or PDUs)
Shortcodes/Blocks
Here’s a list of shortcodes and blocks and how to use them:
Available Course Credits
[uo_ceu_available course-id="id"]
Block Name: Available Credits
This shortcode displays the number of credits available for the course (as set in the Edit page for that course). The course-id attribute is optional and is used to associated the shortcode with a particular course. If the shortcode is used on a course page, no ID is required. On other pages it should be added. If you are using blocks, the optional Course ID will appear in the block side menu, under Available Credits Settings.
Earned Course Credits
[uo_ceu_earned course-id="id" since-rollover="yes"]
Block Name: Earned Credits
This shortcode shows the number of credits earned by the learner for the associated course. Once again, course-id is optional and not required on a course page. If the user has not earned any credits for the course, the system will display a value of 0. If since_rollover is set to yes, it shows the number of credits earned since the rollover date. If credits were earned before the date, a value of 0 is shown. If you are using blocks, the options Course ID and Since Rollover will appear in the block side menu, under Earned Credits Settings.
Total Credits Earned
[uo_ceu_total user-id=""]
Block Name: Total Credits
This shortcode shows the total number of credits (regardless of rollover date) for the associated user. If the user_id attribute is not included, the value is shown for the current user. If you are using blocks, the option User ID will appear in the block side menu, under Total Credits Settings.
Total Credits Earned since Rollover Date
[uo_ceu_total_rollover user-id=""]
Block Name: Total Rollover Credits
This shortcode is much like the total one except that it only sums credits earned on or after the rollover date. If you are using blocks, the options User ID and On or After Rollover will appear in the block side menu.
Days Remaining until Rollover Date
[uo_ceu_days_remaining]
Block Name: Days Remaining
This shortcode/block outputs the number of days that remain until the rollover date. Learners can reference this value so they know how much time they have until all of their credits must be earned.
Credits Remaining before Rollover Date
[uo_ceu_credits_remaining user_id="id"]
Block Name: Credits Remaining
This shortcode/block shows users how many credits they need to earn before the rollover date. If no user_id is specified, the shortcode/block will show the value for the current user. As a reminder, the number of credits shown is the highest of a user’s associated individual and group credit requirements.
Certificate Trigger Description
[uo_ceu_certificate_description certificate-id="678"]Block Name: Certificate Trigger Description
This shortcode/block displays the description text configured on a CEU certificate trigger. Useful for showing learners what a certificate represents on a course or profile page. The LearnDash certificate ID is optional. If no ID is used, it defaults to the current certificate/post.
See Continuing Education Certificates for how to configure the description.
Continuing Education Report
[uo_ceu_report]Block Name: Continuing Education Report
This shortcode/block displays a front-end credit report. By default it shows a learner-facing search report; with the enhanced attribute enabled it becomes a full report for administrators and group leaders, with column customization, filtering, export, and inline credit editing.
| Attribute | Description |
|---|---|
enhanced | off (default) shows the standard learner search report; on loads the enhanced report (admins and group leaders only). |
columns | A comma-separated list of columns to show, each as `key |
mode | The data source used to build the report: meta (recommended), json (fastest), legacy, or tables. |
add | on enables the “Add credits” action in the enhanced report. |
edit | on enables inline editing of existing credit records. |
delete | on enables deleting credit records. |
Because the enhanced report and its add/edit/delete actions are powerful, they are only available to administrators and group leaders. For a full walkthrough, see Continuing Education Report and Add and Remove Credits.
Using the Blocks
To add any of these as a block, edit a page or post, click the + (Add Block) button, and search for the block name from the Quick Reference table above — or browse the Uncanny Continuing Education Credits block category. Each block exposes the same options as its shortcode in the block’s sidebar settings panel.