Online Users Setup

Overview

This document offers a comprehensive guide to setting up and configuring the Online Users extension for Ultimate Member. The extension provides real-time online status indicators, allowing users to see who is currently active on the site. A green circle appears on a user's profile card in the Member Directory or on their profile page to signify their online presence. The guide covers key features, including privacy settings for controlling visibility, shortcodes for displaying online users, and a widget for seamless integration into sidebars or footers. 

Contents:

Settings#

Once the Online Users extension is activated, a new Online tab appears in the WordPress admin panel under: wp-admin > Ultimate Member > Settings > Extensions > Online.

In this tab, you will find the following option:

Show online stats in member directory

This setting controls whether a user's online status is displayed within the Member Directory.

  • Enabled (Checked): A green circle appears next to a user's profile photo in the member directory and user profile, along with the word "Online," indicating their active status.
  • Disabled (Unchecked): The online status will not be visible in the Member Directory and user profile.

Configuring Online Status Display

To enable the display of online status in the Member Directory and user profile:

  1. Navigate to wp-admin > Ultimate Member > Settings > Extensions > Online.
  2. Check the box labeled "Show Online Stats in Member Directory".
  3. Click Save Changes.

Display in Member Directory

When enabled, a green circle appears next to a user's profile photo on their profile card within the Member Directory, visually indicating their online status to other users.

Display in User Profile

In addition to the Member Directory, the same  green circle and the word "Online" appear next to the user's name on their profile page, confirming their active status.

User Profile#

The extension enhances user profiles by adding a green circle next to the user's name whenever they are online. This feature allows users to quickly identify active members on the site. Additionally, the extension introduces an Online Status field, which can be included in the profile form to display a user’s real-time online presence.

Setup in Profile Page

  1. Navigate to wp-admin > Ultimate Member > Forms.
  2. Select the form you want to edit and click Edit Form.
  3. In the Form Builder, click the + (plus sign) button to add a new field.
  4. The Fields Manager window will appear. Locate and select the Online Status field from the predefined field options.
  5. Once the field is added to the form, navigate to the User Meta section on the right-hand side. Click the Add New Field button.
  6. Next, select Online Status from the drop-down menu. Any fields added or chosen from the User Meta section will appear in the profile header area below the user's display name. Be sure to include the Online Status field to ensure it is displayed.
  7. Click Update to save changes.

Display of Online Status

  • Once configured, the online status field is displayed in the user profile.
  • If the online status field does not appear, try updating the user profile by clicking on the gear icon, selecting Edit Profile, and then saving the profile again or configure the setting in the User Account, shown below. 

User Account

When the Online User extension is activated, a privacy option is added under the Privacy tab of the user's account page, allowing users to control their online visibility.

  • Users can choose whether or not to display their online status to others.
  • If a user opts out, their status will not be shown in the member directory, profile, or widgets.

Privacy Setup

  1. Go to the User Account page on your site by hovering over the User Profile Icon > Account Settings.
  2. Click on the Privacy tab.
  3. Locate the "Show my online status?" option and select "Yes" to enable it.
  4. Then click the Update Privacy button to save.

Shortcodes #

[ultimatemember_online]

The [ultimatemember_online] shortcode displays a list of current online members. This can be placed on any page or post.

Available Attributes:

Attribute Type Default Description
max integer 11 Defines the maximum number of members to display per screen.
roles string 'all' Filters members based on user roles. Accepts a comma-separated list of roles.

Example Usage:

[ultimatemember_online max="6" roles="administrator,subscriber"]

The sample shortcode can display up to six users with the user roles administrator and subscriber; however, since only three users are online, it will only show those three users.

Widgets#

The extension introduces the Ultimate Member - Online Users widget, which can be added to a sidebar or footer to display online members.

Widget Features:

  • Allows customization of the widget title.
  • Set a maximum number of profile photos to display initially (default: 20).
  • If more than 20 users are online, a text link appears to reveal additional members.
  • Choose to display all roles or filter by a specific role.

Adding the Widget:

  1. Navigate to wp-admin > Appearance > Widgets.
  2. Click the + (plus sign) button to add a new widget.
  3. Search for "Ultimate Member - Online Users".
  4. Drag the widget to your desired sidebar or footer
  5. Customize the title and settings as needed.
  6. Click Update to save changes.
  7. Visit the page where you added the widget to check who is online.

With these steps, you can fully configure the Online Users extension to enhance user engagement on your website.