The Front End Login module lets you put a login form anywhere on your WordPress site, freeing you from the constraints of WordPress’ built-in login page. Use this module to create a login page that works with your organization’s branding and provides users with additional information or support. You can even place it side-by-side with a registration form to have a combined login + registration page, reducing the steps necessary for new users to create an account on your site.
The Front End Login module includes extensive customization options in its settings pane. Most are self-explanatory and won’t be covered here, but these are the most important options:
- Select Template: Choose the design template for the login form. Both templates support the same options.
- Login Page: Select the page you want to use as the login page for your site. This page must have the Front End Login Gutenberg block or uo_login_ui shortcode on it. When users attempt to access the default WordPress login page (/wp-login.php), they will automatically be redirected to this page instead.
- Manual User Verification: If enabled, users that register from the front end MUST be manually approved by an administrator before they can sign in. A “Verified” column will be added to the list of users in WordPress and any users listed as “Not Verified” cannot sign in. To verify a user, navigate to the user’s profile and look for the “Verify User” label. By selecting this field and saving the page, the users will be able to sign in. On verification, users will also be notified by email that the account has been verified and access has been granted. The Login Page setting (above) must set for user verification to work.
- Show Register Link: If enabled, a text link will appear below the form using the text in the Register Link Text field and linking to the URL in the Register Link field. This link can be to any page you want; even an external CRM (for example).
- Hide All For Logged In Users: If enabled, logged in users will see nothing where the login form was previously displayed.
- Message For Logged In Users: This content is displayed to logged in users (as long as Hide All For Logged In Users is not enabled).
- Google reCAPTCHA Settings: When the Site Key and Secret Key fields are populated with valid reCAPTCHA keys, a reCAPTCHA anti-bot widget will be displayed on the Login and Forgot Password forms. Users will be required to validate that they are not bots to enable form submission.
Important: Make sure that your login page is not cached. If you see password reset errors, redirect errors or users can’t sign in properly, check this first. Your host may also have server-side caching enabled for your login page (WP Engine and Siteground are known to do this, as are many others), so check with them if you’re not sure.
Also make sure that you are NOT using a reCaptcha plugin that also modifies login forms; it will create a conflict and you may be locked out. To include reCaptcha in the login form you must use the option included in the module.
The Front End Login module includes two shortcodes.
This shortcode displays the Front End Login form with the template and options selected in the Front End Login module settings. Please note that it will only work a login page has been set in the Front End Login settings.
This shortcode displays a default WordPress login form with no styling or settings applied, and also supports content for logged-in users with the syntax:
[uo_login sample='sample'] content if logged in [/uo_login]
The shortcode supports a redirect attribute:
This is useful if you want to have different login pages that will redirect users to different pages. Any redirect set in the shortcode attribute will override the redirect set in the login redirect module.
The redirect_to parameter
Version 3.2 of the Toolkit introduced support for the redirect_to parameter, so that when “?redirect_to=%URL%” is appended to the URL of a login page (where %URL% is the target URL), users are directed to that page on login. This feature allows site admins to direct all users to a single login page but set different redirect behaviours based on how they arrived on that page. By default, the redirect_to parameter is a lower priority than the Log In/Log Out Redirect module, so it will take priority.
An example of this module in use might look like this: “https://www.uncannyowl.com/login?redirect_to=https://www.uncannyowl.com/learner-dashboard”. The /login/ page in this example would have to include the uo_login or uo_login_ui shortcode.
Overriding the login templates
As of Uncanny LearnDash Toolkit version 3.1, developers can edit template files in an upgrade-safe way using overrides. Copy the template file into a directory within your theme named /uncanny-toolkit/, keeping the same file and folder structure but removing the /templates/ subdirectory.
For example, to override the default login form, copy:
The copied file will now override the default.
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.
If You Lock Yourself Out
If invalid settings have been made and saved, then after logout with invalid settings you find yourself locked out, take these steps immediately so that you can sign back in:
- Connect to your site by FTP.
- Find the folder for the Toolkit plugin in the plugins folder under /wp-content/.
- Rename the Toolkit folder temporarily to disable it.
- Log in now as an admin from the default WordPress login page.
- Change the folder name back by FTP and activate the Toolkit while you’re still signed in.
- Correct any settings from the Modules page and test the login page again in an incognito window or another browser so that you don’t accidentally lock yourself out again.
This type of scenario is possible if you turn on a maintenance mode or sitewide protection plugin that blocks access to the page set as your login page. If you do use a plugin that redirects access on a sitewide basis, make sure you exclude your login page from the redirect behaviour.