When you activate Uncanny LearnDash Groups, three pages are automatically generated with custom shortcodes – the Group Management page, the Group Leader Report page, and the Group Leader Quiz report page. Each of these pages is automatically published to your site with a default slug (or WordPress permalink).
The pages that are auto-created or that you create using the plugin shortcodes can be renamed, URLs can be changed, and you can add them to your site menu however you like (more below). However, if customizing page URLs, please do not use /groups in the URL path. The LearnDash plugin uses /groups in URL paths and duplicating that may cause unpredictable behaviour.
The table below outlines each page that is available with the plugin and their corresponding shortcodes, block names (if applicable) and default WordPress permalinks.
| Page Name | Description | Shortcode / Block Name | Default WordPress URL (Permalink) |
|---|---|---|---|
| Group Management | The Group Management page provides all the functionality for Group Leaders to manage their own groups. | [uo_groups] Group Management | group-management |
| Course Report | The Course Report (which can also be accessed from the Group Management page) allows Group Leaders to view course reports of their group members. | [uo_groups_course_report] Course Report | group-management-report |
| Quiz Report | The Quiz Report allows Group Leaders to view quiz reports of their group members | [uo_groups_quiz_report] Quiz Report | group-quiz-report |
| Registration | The user Registration page is a custom registration page you can use when inviting users to join a site and group and redeem an enrolment code. | [uo_groups_registration_form] | user-registration |
| Buy Courses | The Buy Courses page allows Group Leaders and new customers to purchase courses and create new Groups directly. This page is only auto-generated if you activate the plugin after WooCommerce is installed and active. | [uo_groups_buy_courses] | group-management-buy-courses |
| Manage Assignments | The Manage Assignments page allows Group Leaders to manage submitted assignments on the front end. | [uo_groups_assignments] Assignment Management | N/A |
| Manage Essays | The Manage Essays page allows Group Leaders to manage submitted essay questions on the front end. | [uo_groups_essays] Essay Management | N/A |
| Manage Learner Progress | The Manage Learner Progress page allows admins and Group Leaders to view and edit course progress. | [uo_groups_manage_progress] | N/A |
Setting up the Group Management page
The Group Management page is the core of the Uncanny LearnDash Groups plugin, and where Group Leaders will access group management and reporting features. In version 2.0, we added a number of attributes to the [uo_groups] shortcode that enable you to control exactly which features to make available to your users. Each attribute can have the value of show or hide. The default value of all attributes, except the ability to email group members, is show.
The table below outlines available attributes for the Group Management Page.
| Attribute | Description | Attribute Values | Default Value |
|---|---|---|---|
| group_name_selector | The Group selection drop down menu at the top of the page. | "show" or "hide" | "show" |
| add_courses_button | The button that allows group leaders to purchase additional courses for their group. Only available if the group was custom built . | "show" or "hide" | "show" |
| seats_quantity | The display of total seats and seats remaining. | "show" or "hide" | "show" |
| add_seats_button | The button that allows group leaders to purchase additional seats for their group. Only available if the group was purchased via WooCommerce. | "show" or "hide" | "show" |
| add_user_button | The Add one and Add multiple entries in the Users menu | "show" or "hide" | "show" |
| remove_user_button | The button that enables Group Leaders to remove users from their group. | "show" or "hide" | "show" |
| first_last_name_required | Require first and last name entries in the Bulk Add & Invite Users tool | "yes" or "no" | "no" |
| group_email_button | The Email Users entry in the Users menu. | "show" or "hide" | "hide" |
| upload_users_button | The Upload Users entry in the Users menu. | "show" or "hide" | "show" |
| download_keys_button | The Download Keys entry in the Users menu. | "show" or "hide" | "show" |
| group_leader_section | The section that lists Group Leaders. | "show" or "hide" | "show" |
| add_group_leader_button | The button that enables Group Leaders to add more Group Leaders. | "show" or "hide" | "show" |
| key_options | All options related to key distribution except Download Keys. | "show" or "hide" | "show" |
| group_courses_section | The section that lists the group’s Courses. | "show" or "hide" | "show" |
| key_column | The column that shows enrollment keys. | "show" or "hide" | "show" |
| csv_export_button | The Export CSV option in the Users menu | "show" or "hide" | "show" |
| excel_export_button | Export to Excel option in the Users menu | "show" or "hide" | "hide" |
| enrolled_users_page_length | Specifies how many group members will be shown by default on page load | A numeric value | 50 |
| enrolled_users_length_menu | Specifies the options that are available in the page length dropdown for group members | A list of values. Example: "25, 50, 100, -1:All" | 25,50,100,All |
| group_leaders_page_length | Specifies how many group leaders will be shown by default on page load | A numeric value | 50 |
| group_leaders_length_menu | Specifies the options that are available in the page length dropdown for group leaders | A list of values. Example: "25, 50, 100, -1:All" | 25,50,100,All |
The entries in the Reports menu are controlled from the plugin Settings page:
- Course
- Quiz
- Progress
- Assignments
- Essays
To hide an entry, set the associated Page to None in Settings.
Example:
To hide all possible features, the shortcode would be:
[uo_groups group_name_selector="hide" add_courses_button="hide" seats_quantity="hide" add_seats_button="hide" add_user_button="hide" remove_user_button="hide" upload_users_button="hide" download_keys_button="hide" group_leader_section="hide" add_group_leader_button="hide" key_options="hide" csv_export_button=”hide”]
and you would set all report pages to None in Settings.
Setting up the Course Report page
You can set the order that courses appear in the courses dropdown menu on the Course Report with the following shortcode:
[uo_groups_course_report course-order="ID"]
The table below outlines available attributes for the Group Leader Report.
| Attribute | Description | Attribute Values | Default Value |
|---|---|---|---|
| course-order | Set the order that courses appear in the Course Report dropdown menu. | "ID", "title", "date", "menu_order" | "title" |
| csv-export-button | Show or hide the CSV export button | "show", "hide" | "hide" |
| excel-export-button | Show or hide the Excel export button | "show", "hide" | "hide" |
Setting up the Quiz Report page
You can set the order that courses and quizzes appear in their respective dropdown menus on the Quiz Report with the following shortcode:
[uo_groups_quiz_report course-order="ID" quiz-orderby="ID" quiz-order="ASC"]
The table below outlines available attributes for the Group Leader Quiz Report.
| Attribute | Description | Attribute Values | Default Value |
|---|---|---|---|
| course-order | Set the order that courses appear in the Quiz Report dropdown menu. | "ID", "title", "date", "menu_order" | "title" |
| quiz-orderby | Set the order that quizzes appear in the Quiz Report dropdown menu. | "ID", "title", "date", "menu_order" | "title" |
| quiz-order | Set the order that quizzes appear as either descending or ascending. | "ASC", "DESC" | "ASC" |
| csv-export-button | Show or hide the CSV export button | "show","hide" | "hide" |
| excel-export-button | Show or hide the Excel export button | "show","hide" | "hide" |
Adding Group Management Pages to the Site Menu
By default, none of the auto-generated or manually published pages with the Uncanny LearnDash Groups plugin are added to your site menu.
However, you can add the Group Leader Report page, the Group Quiz Report page, or any page you generate with the plugin shortcodes described above, to your site’s navigation menu. Before you do, remember that menu entries are shown to all users by default and these pages only apply to Group Leaders. Using a plugin that can control the visibility of menu entries by role, like the Nav Menu Roles plugin, is highly recommended.
To set up menu entries for your new Groups pages, follow these steps:
- Navigate to Appearance > Menus as an administrator.
- Expand the Group Management section. Drag the Group Management, Group Leader Report, Group Quiz Report, Buy Courses page or the Registration page to where you want the link to appear in the Menu Structure.
- If you have Nav Menu Roles installed, choose the Group Leader role for the menu visibility.
- Click Save Menu to save the change.
The menu links will be visible to all users, but only Group Leaders will be able to use these pages. Any user or administrator that is not a Group Leader, will see an appropriate message indicating they need to be a Group Leader to access and use the page. If you would like to hide these menu links from users that are not Group Leaders you can use a plugin such as Nav Menu Roles to do so.
Adding a button or link that links to the Group Management Page
You can add the following shortcode, which appears as a button, to a sidebar, post, or page:
[uo_groups_button text="Group Management"]
[uo_groups_link text="Group Management"]
The text attribute allows you to customize the label for the button. Like the Group Management menu link, this button/link will only be visible to logged-in users that are also Group Leaders.
Hi,
What is the attribute to hide the Assignments and Essay buttons?
Best regards,
Peter
Hi Peter, while it is possible to hide them with attributes (these ones would use assignments_button=”hide” essays_button=”hide”), our recommended approach is that you just remove the selections for those pages in the Groups settings page. When the sections are removed the buttons will be hidden automatically.
Hi,
is there a way to rename the menu items (Course, Quiz, Progress, Assignments, Essays)?
Yes, all strings in the plugin should be translation friendly. For renaming items your easiest option is to use a translation plugin; we typically use and test against Loco Translate.
any plans on a front-end group creation?
It is actually supported; have a look at https://www.uncannyowl.com/knowledge-base/front-end-learndash-group-creation/. If you use that shortcode, just make sure you protect the page to authorized users only.
Hi,
I see the comment that says group leaders can create new groups. I’m wondering if we can give group leaders the ability to divide a set number of seats they purchased (for example 100 seats) and then the group leader can divide those seats into different groups they can manage (a group of 20, a group of thirty, a group of 50, for a total of 100 seats.) and then assign courses from there. Their total number of seats would be limited to the 100 they purchased. I’m thinking of teachers creating classes from the 100 seats they purchased.
Hi Drew,
Your request comes up quite often, but at this time seat pools that span multiple groups are not possible. Now that LearnDash 3.2 supports a group hierarchy we’re reassessing what we can do, but right now we can’t confirm when or if we might add support.
Thank you for the quick response. Yes, it seems like this would be a very useful feature for this plugin. Teachers would need to form groups, but I can image it would be a feature other professionals would need to. Thanks for considering!
Hi!
I would like to know if it is possible to create courses in addition to groups through the frontend?
Sorry Michael, I’m afraid none of our plugins support front end course creation.