1. Home
  2. Knowledge Base
  3. Uncanny LearnDash Groups
  4. Set up Group Management Pages

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 NameDescription Shortcode / Block NameDefault WordPress URL (Permalink)
Group ManagementThe Group Management page provides all the functionality for Group Leaders to manage their own groups.[uo_groups]
Group Management
group-management
Course ReportThe 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 ReportThe Quiz Report allows Group Leaders to view quiz reports of their group members[uo_groups_quiz_report]
Quiz Report
group-quiz-report
RegistrationThe 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 CoursesThe 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 AssignmentsThe Manage Assignments page allows Group Leaders to manage submitted assignments on the front end.[uo_groups_assignments]
Assignment Management
N/A
Manage EssaysThe Manage Essays page allows Group Leaders to manage submitted essay questions on the front end.[uo_groups_essays]
Essay Management
N/A
Manage Learner ProgressThe 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.

Attributes:

  1. group_name_selector: The Group selection drop down menu at the top of the page
  2. add_courses_button: The button that allows group leaders to purchase additional courses for their group. Only available if the group was custom built
  3. seats_quantity: The display of total seats and seats remaining
  4. 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
  5. add_user_button: The Add one and Add multiple entries in the Users menu
  6. remove_user_button: The button that enables Group Leaders to remove users from their group
  7. group_email_button: The Email Users entry in the Users menu
  8. upload_users_button: The Upload Users entry in the Users menu
  9. download_keys_button: The Download Keys entry in the Users menu
  10. group_leader_section: The section that lists Group Leaders
  11. add_group_leader_button: The button that enables Group Leaders to add more Group Leaders
  12. key_options: All options related to key distribution except Download Keys
  13. group_courses_section: The section that lists the group’s Courses

The entries in the Reports menu are controlled from the plugin Settings page:

  1. Course
  2. Quiz
  3. Progress
  4. Assignments
  5. 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"]

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.

Shortcode and AttributeDescriptionAttribute ValuesDefault 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 AttributeDescriptionAttribute ValuesDefault 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:

  1. Navigate to Appearance > Menus as an administrator.
  2. 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.
  3. If you have Nav Menu Roles installed, choose the Group Leader role for the menu visibility.
  4. 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_url]

The text attribute allows you to customize the label for the button. Like the Group Management menu link, this button will only be visible to logged-in users that are also Group Leaders.

Was this article helpful?

4 replies
    • Ryan
      Ryan says:

      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.

      Reply
    • Ryan
      Ryan says:

      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.

      Reply

Comments/Questions

Please note that this is not an official support channel and questions/comments may go unanswered.
To request support, log in to your account and click Submit a Request.

Leave a Reply

Your email address will not be published. Required fields are marked *