bookmark_borderUser Registration Add-On Login Widget

In addition to creating or updating users, the User Registration add-on for Gravity Forms also contains a widget which will allow users to log in and register from the front-end of your site.

user-registration-widget-logged-outuser-registration-widget-logged-in

Adding the Login Widget

This section will show you how to add the Login widget included with the User Registration add-on. If you already know how to activate a widget, you can continue on the the next section which contains information on the settings contained within the Login widget.

  1. user-registration-widget-adding-1From within your WordPress admin dashboard, hover over Appearance on the left side admin menu, and click on Widgets.
  2. user-registration-widget-adding-2Once you are on the Widget page, click on the widget labeled Login, select the widget area that you want the widget to be added to, and click Add Widget. If you prefer, you may also drag the Login widget over the your desired widget area.
  3. user-registration-widget-adding-3You should now see the widget within your widget area listing on the left side. Simply click it to access the settings for it.

Configuring the Login Widget

Immediately upon adding the Login widget, basic functionality such as logging in, logging out, and user registration will be available. Using the settings in this section, you can further customize the Login widget.

Login Form Options

Login Form Options

  • Login Redirect URL
    This setting will allow you to define a custom URL that the user will be sent to upon successfully logging in when using the widget.
  • Links
    This is a listing of links and their locations that will be displayed within the widget. By default, Register and Forgot Password? are included here. If you would like to change the text or the URL that a user will be sent to when clicking them, they can be changed here.
    Additional links may also be added here. To do so, click the Add Link button for an additional field set to customize.
  • Tab Index Start
    This is used to set a custom tab index. Setting a custom tab index may resolve accessibility issues if needed. As it is rather uncommon to change this, changing this value should only be done if you have a specific need for it.

Logged In Options

Logged In Options

  • Title
    The Title setting is used to set a custom title to the welcome message. This, as well as the Welcome Message, are used to display custom information to the user within the widget when logged in.
  • Welcome Message
    Just like the Title option above, this inserts a message within the widget for users that are logged in. This is displayed within the widget area, below the content of the Title setting.
  • Links
    Similar to the links in the Login Form Options section, this is used to define custom links inside the widget. This differs only in that they are displayed when a user is already logged in.
  • Login Redirect URL
    This is the URL that a user will be sent to upon successfully logging out through the Login widget.
  • Show user avatar
    Enabled by default, this setting will determine if the logged in user’s avatar is displayed within the widget.

Merge Tags

  • {register_url}
    Outputs the URL to the registration page for the site. This utilizes the main User Registration Add-On setting. If no custom registration page has been defined here, it will default to the built in WordPress registration page URL.
  • {password_url}
    Outputs the URL to the forgot password form that is built into WordPress
  • {logout_url}
    Outputs the URL to logout of WordPress. If a Logout Redirect URL has been configured in the widget in which it is used, it will also redirect to this URL when the user clicks on this logout link.
  • {admin_url}
    Outputs the URL to the WordPress admin. When configuring links in the Login widget this can be handy for adding a link to the admin as part of the links you output via the widget.

Once finished with configuring your settings, don’t forget to click the Save button, so that your Login widget settings are active.