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]|
|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]|
|Quiz Report||The Quiz Report allows Group Leaders to view quiz reports of their group members||[uo_groups_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]|
|Manage Essays||The Manage Essays page allows Group Leaders to manage submitted essay questions on the front end.||[uo_groups_essays]|
|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"|
|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"|
|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:
To hide an entry, set the associated Page to None in Settings.
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:
The table below outlines available attributes for the Group Leader Report.
|Shortcode and Attribute||Description||Attribute Values||Default Value|
|[uo_groups_course_report course-order="ID"]||Set the order that courses appear in the Course Report dropdown menu.||"ID", "title", "date", "menu_order"||"title"|
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.
|Shortcode and Attribute||Description||Attribute Values||Default Value|
|[uo_groups_quiz_report course-order="ID"]||Set the order that courses appear in the Quiz Report dropdown menu.||"ID", "title", "date", "menu_order"||"title"|
|[uo_groups_quiz_report quiz-orderby="ID"]||Set the order that quizzes appear in the Quiz Report dropdown menu.||"ID", "title", "date", "menu_order"||"title"|
|[uo_groups_quiz_report quiz-order="ASC"]||Set the order that quizzes appear as either descending or ascending.||"ASC", "DESC"||"ASC"|
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.
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.