This plugin is part of Gravity Perks, a suite of 31+ essential Gravity Forms addons with support you can count on.
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
- Redirect on Activation
Choose a custom page to redirect users after successful activation. - Customize via Post Editor
All activation content (including error messages) can be edited directly from the WordPress post editor. - User Friendly Default Content
Improves the user activation experience out-of-the-box with default content that suits most sites. - Supports Custom Page Templates
Developers who want to further customize the Activation Page can make a custom template. Users can also choose different layouts provided by their themes. - Merge Tags Make it Easy
GP Better User Activation provides over a dozen merge tags that present helpful content to the user and let you customize your presentation without creating links or writing code. - Integrates with Gravity Forms Auto Login
Automatically log users in after they activate with Gravity Forms Auto Login, also part of the Gravity Perks plugin suite. - Automatic Updates
Get updates and latest features right in your dashboard. - Awesome Support
We’re here to help! And we mean it.
Documentation
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 SettingsPrefer 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.
[gpbua] merge tag to insert the user activation content anywhere in your page layout.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 ViewsActivation 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 (<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 a link with “Set your password.” 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 SettingFAQs
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).
| <?php | |
| /** | |
| * Gravity Perks // GP Better User Activation // Enable Editor on Activation Page | |
| * http://gravitywiz.com/documentionat/gravity-forms-better-user-activation/ | |
| */ | |
| add_action( 'init', function() { | |
| remove_action( 'admin_head', array( gp_better_user_activation(), 'remove_default_content_editor' ) ); | |
| } ); |
