The LearnDash Group Registration module is part of the Uncanny Toolkit Pro for LearnDash. It’s used to allow users to register themselves directly into a LearnDash Group and to switch groups from the front end. Using this module, site owners can create unique registration pages for client organizations where staff/members/users can create accounts and be immediately and automatically added to LearnDash groups.
This is a complex module and we recommend starting by watching the YouTube video above in its entirety.
By turning on the module, each LearnDash Group is given a unique registration URL (visible only to administrators). This URL can then be shared, and by visiting that unique page, users are added directly to the associated group. To change groups or add users to additional groups, users can simply visit the registration URL of another LearnDash Group by visiting their registration URL.
This module does include its own registration form, but we strongly recommend that you use Gravity Forms with the User Registration add-on instead. Theme My Login is also supported.
It’s a good idea to review the module settings before going live with Group Registration:
- Allow users to join multiple LearnDash Groups?
Allows users to either switch groups or add new groups. Choosing No means a user visiting this page that’s already in another group (or groups) is removed from the group and added to the new group instead. Choosing Yes means a user visiting this page will be added to the group. Existing group memberships are unaffected.
- Hide native LearnDash content (LearnDash 3.2+)
In version 3.2 and above, LearnDash adds a table with some group info to group pages. If you want to hide this information, check this box.
- Existing Group Member Link Text/URL
After a new user registers, they need a way to get to their dashboard or course content. These fields let you customize the link they see after registration. We typically use something like, View My Courses or Take Me To My Courses and link to a dashboard page.
- Organization Labels
Because this module is typically used to give organizations a way to have their users enrol into their LearnDash Group, we added an optional way of providing group contact details. Each organization’s values are set from the Edit Group page, but the labels must be set here. Instead of Organization, you might want School, Team, Location, or something else entirely. The information itself is added to the registration page sidebars automatically (if it’s populated for the Group) so users registering from the page have confirmation they’re on the right group page and have a way to contact a representative if they need assistance.
Customizing the Registration Page
After defining the module settings, edit or create a LearnDash Group. While the post area of LearnDash Groups is normally not populated, when group registration is enabled, this is where you can (and should) include instructions and a registration form. If it’s left empty, or only instructions are included, the default registration form will be added to the registration page for the group (this is not recommended).
Examples that include Theme My Login and Gravity Forms registration forms are shown below.
The example above shows a Theme My Login registration form with instructions.
Note: Theme My Login integration with Uncanny LearnDash Groups will override Theme My Login integration with the Group Registration module. If you want to use Theme My Login with Uncanny LearnDash Groups, you will need to use either Gravity Forms or the built-in registration form with the Group Registration module.
The example above shows a Gravity Form example for a registration form. Make sure the “id” value is correct and that you’re using the User Registration add-on.
Finding the Group Registration URL
In versions of Toolkit Pro prior to version 3.8.3:
The registration URL for the group is displayed when the Permalink URL is clicked at the top of the post. The registration URL is only displayed when the user visiting the page is an administrator. The permalink here is NOT the registration URL. You must click this link to see the registration URL for this group.
In version 3.8.3 or higher:
In the list of groups under LearnDash LMS > Groups, look for the Signup URL links under each group. Click the Signup URL link to reveal the registration URL.
The sign-up URL will look like this, and is what should be distributed to users:
If the permalink leads to a 404 error, this typically suggests an issue with your permalink settings. Make sure to navigate to Settings > Permalinks as an admin and resave the settings. Unusual permalink settings also risk causing issues.
Block Name: Group Status
This shortcode/block displays the Organization Details of each group of which the user is a member. This only works for logged in users.
Block Name: Group Organization
This shortcode/block only works on group registration pages and only for logged-out users. It displays the Organization Details of the group associated with the registration page.
Block Name: Group Login
This shortcode/block only works on group registration pages and only for logged-out users. It displays a login form that automatically adds users to the associated group on login.
Integration with Uncanny LearnDash Groups
The Uncanny LearnDash Groups plugin includes a system to track and limit how many users can be added to a LearnDash Group. That that plugin is installed and active, the seat counts set via that plugin will restrict when users can be added from the unique Group Registration pages from this module.
If a user registers from a Group Registration page to a group with a defined seat limit, the registration will completed normally if the group has available seats. If no seats remain for the group, the user will be blocked from registering and will see a message that the group is full. The only way to allow registration when this happens is for an administrator (or a Group Leader, if the group was created via purchase) to add additional seats to the group.
Overriding the Group Registration template
Update: As of Uncanny LearnDash Toolkit Pro version 3.1, you can edit files in an upgrade-safe way using overrides. Copy the template into a directory within your theme named /uncanny-toolkit/, keeping the same file structure but removing the /templates/ subdirectory.
For example, to override the group registration template, copy:
The copied file will now override the default template in the Uncanny Toolkit.
Warning: Do not edit these files within the the Uncanny Toolkit plugin itself, as they are overwritten during the upgrade process and any customizations will be lost.