Gravity Forms Better User Activation

What does it do?

GP Better User Activation allows you to take complete control of your User Registration Activation page. Choose any page on your site, modify it as desired, and users will be automatically directed to this page when activating their accounts.

Features

Documentation

1. How do I enable this functionality?
2. Feature Details
   1. Customize Activation Views
      1. Activation Success
      2. User Already Active
      3. No Key
      4. Other Error
   2. Merge Tags
   3. Redirect on Successful Activation
3. FAQs
   1. How do I enable the post content editor when editing the activation page?

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.

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?

---

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 provides a merge tag {gpbua:activation_form} in the default content that 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 (<a>) to the site login page.

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

• {gpbua:home}
  Creates a link (<a>) to the site homepage.

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

• {gpbua:reset_password}
  Creates a link (<a>) 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}
  Show the password of the user being activated.

• {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.

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_redirect_url
  
• gpbua_activation_success
  
• gpbua_hide_title