Gravity Forms Better User Activation

How do I enable this functionality?

After the GP Better User Activation perk is installed, you’ll want to start by selecting a Custom Activation page. This is as simple as visiting the Perk Settings Page under Forms > Perks. Choose any existing page from the drop-down titled “Custom user activation page” to serve as the new Custom Activation page.

GP Better User Activation Settings

Prefer to make a new page? Simply Add New Page from the WP admin and leave the content area blank. Choose the slug that you want visitors to land on during activation, such as “/activate”. Then return to the Perk Settings and select the new page from the drop-down menu “Custom user activation page”.

After you select a Custom Activation Page, the plugin will already begin to work, sending any new user activations to the selected page. To edit the content of the page, simply visit the page in edit mode. You’ll notice the normal content editor has been replaced by a set of tabs with four different views. Edit the default content as desired.

Feature Details

Customize Activation Views

There are four different “Activation Views” that are used to display content depending on the result of the attempted user activation. With GP Better User Activation, you’re able to customize each of these views to cover all the different screens the user may see when activating.

This content is edited on the Custom Activation Page, which provides the tabs in the screenshot below. If you don’t see these tabs, check that you’ve set the page properly under the Perk Settings option “Custom user activation page” detailed under the documentation section How do I enable this functionality?

GP Better User Activation — Activation Views

Activation Success

Content shown to the user when they successfully activate. The default content includes the users login information and link to the login page. Not shown if you redirect the user to a Custom Success Redirection page.

User Already Active

Sometimes users are so eager to activate, they press the activate link over and over again like chimpanzees demanding grapes from their handlers. When this happens, the User Already Active content will be displayed.

No Key

Key is missing entirely from the activation link. This typically occurs when the user copies and pastes the link or if the link is broken in the email layout. GP Better User Activation displays the Activation Key Form so users can enter their key manually in this situation.

Other Error

Presented when invalid keys or any other errors that might occur block the user activation. GP Better User Activation provides a merge tag {gpbua:error_message} to display the error message to the user.

Merge Tags

All GP Better User Activation merge tags are prefixed with “gpbua” as in {gpbua:username}.

• {gpbua:login}
  Creates a link to the site login page.

• {gpbua:login_url}
  Renders only the URL for the site login page.

• {gpbua:home}
  Creates a link to the site homepage.

• {gpbua:home_url}
  Renders only the URL for the site homepage.

• {gpbua:reset_password}
  Creates a link to the reset password page.

• {gpbua:reset_password_url}
  Renders only the URL for the reset password page.

• {gpbua:username}
  Shows the username of the user being activated.

• {gpbua:password}
  Displays “Check your email for the set password link.” as the text if the password is emailed. Otherwise, it will show “Set at registration” if the password is mapped to a field.

• {gpbua:email}
  Show the email of the user being activated.

• {gpbua:activation_form}
  Show the activation form that accepts the activation key. Usually used only in the “No Key” view when the activation key is missing.

• {gpbua:error_message}
  Show the activation error message. Use only in error view shown when an error is preventing user activation.

Redirect on Successful Activation

If you want to redirect your users to a different page after they are successfully activated, you can control this via the “Redirect Page” option on the Perk Settings page. Select the existing page (or make a new page) and select it from the Redirect Page setting.

GP Better User Activation — Redirect Page Setting

Translations

You can use the free Loco Translate plugin to create translations for any of our Perks. If you’ve never used Loco translate before, here’s a tutorial written for beginners.

FAQs

How do I enable the post content editor when editing the activation page?

By default, the post content editor is hidden. If you’d like to enable it for whatever reason, you can do so by installing the following snippet (installation instructions).

Hooks

• gpbua_activation_page_id
  
• gpbua_activation_redirect_url
  
• gpbua_activation_success
  
• gpbua_activation_url
  
• gpbua_hide_title
  

Related Resources

• Complete Guide to Gravity Forms Login (Auto Login, Activate Users, More!)
  Learn how to enhance the login and user registration experience on your site using Gravity Perks and other tools!
• Customizing the User Activation Email for Gravity Forms
  Easily create your own custom user activation emails powered by Gravity Forms notifications.
• Register Multiple Users From a Single Form
  Register multiple users to your WordPress site with a single form submission.
• Show Login Link for Existing Users with Gravity Forms User Registration
  Automatically show a login link when a user attempts to register with an existing email.