Profile Completeness Setup

Overview

This document provides instructions on how to set up the Profile Completeness extension.

Note: Profile completeness is done on a user role basis, so you will not find a tab for this extension in UM settings.

User Roles #

Go to wp-admin > Ultimate Member > User Roles > Edit Role and select "Yes" in the "Enable profile completeness" setting in the "Profile Completeness" section to enable this feature for a role. 

Profile completeness options appear once the feature is enabled:

  • Enable profile completeness - Turn on/off profile completeness features for this role.
  • Percentage (%) required for completion - Consider the profile complete when the user completes (%) by filling profile information.
  • Setup Fields - fields which are used to calculate the profile completeness.
  • Upgrade to role automatically when profile is completed - If the profile is filled in more percent than set in the "Percentage (%) required for completion" option, then the role will be changed.
  • Require profile to be complete to browse the site? - Prevent users from browsing the site if their profile is not completed.
    • Allowed pages - Optional. Comma separated list of pages (use page ID), that don't depend on the "Require profile to be complete to browse the site" option.
    • Redirect no-completed user - Optional. Where to redirect a user if the profile is not completed.
      • Redirect URL no-completed user - Optional. Redirect a user to the custom URL if the profile is not completed.
  • Require profile to be complete to browse user profiles? - Prevent users from browsing other profiles if their profile is not completed.
  • Require profile to be complete to leave a comment? - Prevent users from leaving comments if their profile is not completed.
  • Enable email reminder? - Enable the email notification reminder about a need for profile completeness.
    • Email notification period (days) - Optional. A period to send the email notification reminder.

Setup Fields

In the Setup Fields section you can add and select which fields are used to calculate the completeness of a user's profile. After choosing these fields, you can configure additional options related to profile completeness. Finally, you need to click the "Update Role" button to save these changes once everything is configured to your liking.

Image - The Profile Completeness section on wp-admin > Ultimate Member > User Roles > Edit Role.

Display the profile completeness #

You can use the User Meta profile tool, widgets and shortcodes to display the profile completeness elements where you need.

Note: The profile completeness elements are visible to users if they have not completed their profile. The profile completeness elements are not visible to users who have already completed their profile.

Displaying on profile #

You can display Profile completeness bar within the profile either by adding the field to the profile form or selecting the profile completeness bar in the user meta section of profile.

User Meta #

To add the profile completeness bar below the user's name, go to Ultimate Member > Forms > Edit Form (profile), find the box User Meta. Click on the Add New Field button and select Profile Completeness. Click on Update to save changes.

Widgets #

The profile completeness extension provides two widgets: 

  • Ultimate Member - Complete your Profile
  • Ultimate Member - Profile Progress Bar

To add the widgets, go to wp-admin > Appearance > Widgets, click "add block", search for a widget, drag and drop a widget to the sidebar or footer.

Shortcodes #

You can use the following shortcodes to display the profile completeness anywhere on your site.

  • [ultimatemember_profile_completeness] - displays the profile completeness widget
  • [ultimatemember_profile_progress_bar] - displays the profile completeness bar

Display completed profiles in the members directory #

To set up your member directory to display profile completeness information, follow these steps:

  1. Display Completed Profiles Only:
    • Navigate to wp-admin > Ultimate Member Member Directories > Edit Member Directory.
    • In the "General Options" box, use the settings "Only show members who have completed their profile" and "Required completeness (%)" to display completed profiles only.
  2. Sorting Profiles:
    • After activating the extension, you can configure the default sorting of users in the member directory by least completed or most completed.
    • Go to Ultimate Member > Member Directories > Edit Member Directory>Sorting>Default Sorts by
  3. Display Profile Completeness Field for Admin or Author:
    • You can add the "Profile Completeness" field to be displayed to the admin or author in the extra user information section.
    • Go to Ultimate Member > Member Directories > Edit Member Directory> Profile Card section 
    • Enable the 'Show extra user information below tagline?'
    • In the 'Choose field(s) to display in extra user information section' option select 'Profile Completeness'
  4. Add Meta Filter "Profile Completeness" to the Member Directory:
    • You can add a meta filter "Profile Completeness" to the member directory.
    • Go to Ultimate Member > Member Directories > Edit Member Directory>Search Options
    • Enable Filters feature
    • In Choose filter(s) meta to enable option, select "Profile Completeness"