Plus for FluentCommunity — User Manual

Plus for FluentCommunity

Complete User Manual — Installation, Licensing, All Features & Analytics

Version 1.4.x

1. Getting Started

Plus for FluentCommunity is a WordPress plugin that extends FluentCommunity with enhancements, analytics, premium styling controls, and integrations.

1.1 Requirements

WordPress 6.0 or higher
PHP 8.1 or higher
FluentCommunity (free) installed and activated — this plugin cannot run without it
FluentCommunity Pro required only for Download Tracking (uses the Pro document library)
An active Plus for FluentCommunity license is required for all premium Add-On features
Translation-ready — compatible with Loco Translate and any standard .po/.mo workflow (see Chapter 7)

1.2 Installation

Method A: Upload via WordPress Dashboard

Go to Plugins → Add New Plugin and click Upload Plugin.
Select your fluentcommunity-plus.zip file and click Install Now.
Click Activate Plugin when installation completes.

Method B: FTP Upload

Unzip fluentcommunity-plus.zip on your computer.
Upload the fluentcommunity-plus folder to /wp-content/plugins/ on your server.
In WordPress admin go to Plugins and activate Plus for FluentCommunity.

1.3 First Steps After Activation

Go to FluentCommunity → Plus Settings in your WordPress admin sidebar.
You land on the Enhancements tab — all core features here are free with no license required.
Purchase and activate a license to unlock premium Add-On features (see Chapter 2).
Always click Save Settings after making changes on any tab.

Note: The settings page will not appear if FluentCommunity is not installed and active. Install FluentCommunity first.

2. Licensing

2.1 Purchasing a License

Visit jeffbrigman.com/shop/plus-for-fluentcommunity to purchase. After checkout you will receive a confirmation email with your license key. Keep it safe.

2.2 Activating Your License

Go to FluentCommunity → Plus Settings → License tab.
Paste your license key into the License Key field.
Click Activate License.
A green confirmation message confirms activation. All Add-On tabs become visible and unlocked immediately.

Tip: If activation fails, confirm your server can make outbound HTTPS requests. Some hosting environments restrict external API calls — contact your host if needed.

2.3 Deactivating a License

Go to the License tab and click Deactivate License. The license slot is freed and can be used on another site. Always deactivate before migrating to a new domain or server.

2.4 What Requires a License

No license required — free for everyone:

Block Self Reactions
Custom Default Avatar
Default Dark Mode
Custom Copyright
Timestamp Format
Custom Editor Labels
Online Now Widget
Reserved Usernames
DM Restrictions (requires Fluent Messaging)
Group Chat Controls (requires Fluent Messaging v2.4.0+)

Active license required — all Add-On features:

Menu Styling
Topic Styling
Badge Styling
Webhooks
Profile Fields
Admin Notes
Analytics (activity tracking, download tracking, referrer & UTM tracking, full dashboard)
Integrations (Bricks Builder)

Note: Without an active license, all Add-On tabs are hidden from the settings navigation entirely. They reappear immediately after a valid license is activated.

3. Navigating the Settings

3.1 Settings Page Layout

All settings are at FluentCommunity → Plus Settings. The page uses left-side tab navigation. Add-On tabs only appear when a valid license is active AND the add-on is enabled in the Add-Ons tab.

Tab	Visibility	Description
Enhancements	Always	Core free features. No license needed.
Add-Ons	Always	Enable/disable each premium add-on. Requires active license to interact with toggles.
Menu Styling	Licensed + enabled	Sidebar collapse behavior and persistence.
Topic Styling	Licensed + enabled	Topic badge colors, layout, and visibility.
Badge Styling	Licensed + enabled	Badge appearance: colors, borders, fonts.
Webhooks	Licensed + enabled	Badge event webhooks for automation.
Profile Fields	Licensed + enabled	Custom fields on member profile pages.
Admin Notes	Licensed + enabled	Private staff notes on member profiles, audit log, and bulk management.
Analytics	Licensed + enabled	Full analytics dashboard and tracking settings.
Integrations	Licensed + enabled	Bricks Builder CSS compatibility.
Help	Always	Documentation and support links.
License	Always	License key management.

3.2 Saving Settings

Each tab has a Save Settings button in the top-right corner. Settings are saved per-tab. Switching tabs without saving will lose unsaved changes — the plugin warns you before switching.

4. Enhancements — Core Features Free

All features in this section are free, require no license, and are controlled via the Enhancements tab. Each has its own on/off toggle and expandable settings.

4.1 Block Self Reactions

Prevents users from liking or reacting to their own posts and comments. Bookmarks are still allowed. A customizable error toast appears when a self-reaction is attempted.

Setting	Default	Description
Enable	Off	Master toggle.
Post Error Message	You cannot react to your own post.	Toast shown when a user tries to react to their own post.
Comment Error Message	You cannot react to your own comment.	Toast shown for self-reactions on comments.

Tip: Keep messages friendly and brief — they appear as small notifications inside FluentCommunity.

4.2 Custom Default Avatar

Replaces the default avatar for users without a profile picture. Supports role-based avatars, a site-wide default, and a fallback option.

Priority Order

Role-Based Avatars — Checked first. If the user's role has an avatar set, that is used.
Default Avatar — Used if no role-specific avatar matches.
Fallback — Used if no custom avatars are configured at all.

Setting	Default	Description
Enable	Off	Master toggle.
Role-Based Avatars	—	Add entries per role each with its own avatar image URL.
Default Avatar URL	—	Image URL used for all users without a role-specific avatar.
Fallback	None	None (FC default), Gravatar, or UI Avatars (auto-generated initials).

Note: Avatar images should be square, at least 200×200 pixels, and hosted at a publicly accessible URL.

4.3 Default Dark Mode

Sets dark mode as the default theme for new visitors. Once a user manually sets their theme preference inside FluentCommunity, their choice is respected on all future visits.

Setting	Default	Description
Enable	Off	When enabled, new visitors and users without a saved preference see dark mode by default.

4.4 Custom Copyright

Customizes the copyright text displayed in the FluentCommunity portal footer.

Setting	Default	Description
Enable	Off	Master toggle.
Start Year	—	Optional. Creates a year range like "2023–2025". Leave blank for current year only.
Copyright Text	All Rights Reserved	Text displayed after the year.
Enable Link	Off	Wraps the copyright text in a clickable hyperlink.
Link URL	—	The URL for the copyright link.
Open in New Tab	Off	Opens the link in a new browser tab.
Nofollow	Off	Adds `rel="nofollow"` to the link.

4.5 Timestamp Format

Replaces FluentCommunity's default relative timestamps ("3 hours ago") with exact formatted dates and times.

Setting	Default	Description
Enable	Off	When off, FluentCommunity uses its default relative timestamp behavior.
Date Format	Jan. 15, 2025	Options: Jan. 15, 2025 / January 15, 2025 / 01/15/2025 / 15/01/2025 / 2025-01-15
Time Format	3:45pm	Options: 3:45pm / 3:45 PM / 15:45 (24-hour)
Timezone	America/New_York	Timezone used to display all timestamps.

Tip: For global communities, consider UTC or your server timezone to avoid confusion across time zones.

4.6 Custom Editor Labels

Replaces placeholder text in the FluentCommunity post editor with custom wording that fits your community's personality.

Setting	Default	Description
Enable	Off	Master toggle.
Title Placeholder	Your witty post title!	Shown in the post title field before the user types.
Content Placeholder	A penny for your thoughts.	Shown in the post body field before the user types.

4.7 Online Now Widget

Displays a live online user counter and expandable member list in the FluentCommunity sidebar. Shows green dots for online now and yellow dots for recently online.

User Status Classification

Online Now (green dot) — Active within the Online Now Window (default 15 min).
Recently Online (yellow dot) — Active within the Recently Online Cutoff but outside the Online Now Window.
Inactive Pool — Not active in the last 24 hours. Used by the FOMO feature only.

Setting	Default	Description
Enable	Off	Master toggle for the entire widget.
Refresh Interval	60 sec	How often the widget polls the server. Minimum 15 seconds.
Online Now Window	15 min	Activity within this many minutes = green dot "Online Now".
Recently Online Cutoff	4 hours	Active within this period but outside Online Now Window = yellow dot.
Enable FOMO	Off	Inflate the displayed count using random draws from the inactive member pool. The modal user list always shows only real users.
FOMO Min / Max Bump	5 / 20	Range of extra users added to the online count.
Recently Online FOMO Min / Max	2 / 8	Range of extra users added to the recently online count.
Flush & Reload Button	—	Immediately clears cached FOMO values and regenerates them.

Note: FOMO inflates the displayed number only. The member list modal always reflects real user activity. Use responsibly.

4.8 Reserved Usernames

Prevents specific usernames from being registered in your community. Case-insensitive. Only exact matches are blocked.

Setting	Default	Description
Enable	Off	Master toggle.
Reserved Usernames	admin, mod, administrator, moderator	Comma-separated list of blocked usernames.

Tip: Include common variations: admin, administrator, mod, moderator, staff, support, help, owner, official.

4.9 Messaging Controls

Two free enhancements that bring staff oversight to Fluent Messaging. Both features require the Fluent Messaging plugin to be installed and active. Settings for both are found together in the Messaging Controls section of the Enhancements tab.

Note: These features have no effect if Fluent Messaging is not installed.

DM Restrictions

Prevents regular members from initiating new direct message threads with community staff. Staff members can always message anyone freely. Members can still reply in threads that staff initiate with them.

Setting	Default	Description
DM Restrictions Toggle	Off	Enables the feature. No effect without Fluent Messaging active.
Block messaging to: Community Admins	On	Blocks DMs to WP administrators and FluentCommunity community admins.
Block messaging to: Community Moderators	On	Blocks DMs to FluentCommunity community-level moderators.
Block messaging to: Space Admins & Moderators	On	Blocks DMs to admins and moderators assigned to individual spaces (excludes community admins/mods).
Error Message	—	Reserved for future use if Fluent Messaging adds a customizable error hook. Fluent Messaging currently displays its own generic alert.

How It Works

When a regular member attempts to start a new DM with a restricted role, the request is blocked server-side and an error is shown.
Members can still send messages to each other freely — only messaging selected staff roles is restricted.
If a staff member initiates a thread with a member, the member can reply freely in that thread.
The three role checkboxes are independent — you can block only space admins/mods without affecting community admins or moderators.
Staff always bypass restrictions regardless of settings — they can initiate and reply to anyone.

Tip: Fluent Messaging's "Any Community Members" setting must be enabled for your community. DM Restrictions adds the middle ground that setting lacks.

Group Chat Controls

Allows regular members to create group chats — a feature Fluent Messaging restricts to moderators only by default. When enabled, a designated staff member is automatically added to every group created by a regular member for moderation oversight.

Setting	Default	Description
Group Chat Toggle	Off	Enables the feature. No effect without Fluent Messaging v2.4.0+ active.
Auto-Add Staff to Member Groups	—	Multi-select dropdown of community staff. Selected users are auto-added to every group a regular member creates. Hold Ctrl/Cmd to select multiple.

How It Works

When a regular member creates a group chat, designated staff are automatically added as members.
Auto-added staff appear visibly in the member list — they are not hidden.
Auto-added staff cannot be removed by the group creator or other regular members. They can choose to leave on their own.
Moderators and admins can still create groups as normal — this only extends the ability to regular members.
The "Make admin" / "Dismiss admin" labels and the "Admin" badge in group chat are relabeled to "Make owner" / "Dismiss owner" / "Owner" for clarity.
DM Restrictions role blocking also applies to group member add actions — members cannot add restricted staff roles to groups either.

Note: Requires Fluent Messaging v2.4.0 or higher. The Auto-Add Staff dropdown only lists users with community admin, community moderator, or WP admin roles.

5. Add-Ons — Premium Features License Required

All add-ons require an active license. Without a valid license, add-on tabs are hidden from the settings navigation entirely and their functionality is disabled.

5.1 Enabling Add-Ons

Activate your license first (see Chapter 2).
Go to FluentCommunity → Plus Settings → Add-Ons.
Toggle on the add-ons you want to use and click Save Settings.
Enabled add-on tabs appear in the left navigation immediately.

Note: The Add-Ons tab shows a license overlay when no valid license is active. Activate your license to interact with the toggles.

5.2 Menu Styling

Adds sidebar collapse behavior to the FluentCommunity menu. Two modes available — only one can be active at a time.

Setting	Default	Description
Persistent Menu State	Off	Remembers whether each user last had the sidebar expanded or collapsed.
Icon-Only Collapse	Off	Sidebar shrinks to 72px showing only icons with hover tooltips.
Full Collapse	Off	Sidebar hides completely. Content expands to full width when collapsed.

Note: Icon-Only and Full Collapse are mutually exclusive.

5.3 Topic Styling

Customizes the topic filter buttons above posts in FluentCommunity spaces.

Setting	Default	Description
Hide Unused Topics	Off	Hides topic buttons with no posts in the current space.
Stack Layout	Off	Topics display in a vertical stack instead of a horizontal scroll row.
Topic Filter Style	Default	Visual style for topic buttons.
Topic Colors	—	Per-topic color customization: default, hover, and active state colors.

Tip: Leave hover/active fields blank to auto-generate a slightly modified version of the default color.

5.4 Badge Styling

Overrides FluentCommunity user badge colors and typography. When active, Plus badge settings override any colors set in the native FluentCommunity badge editor.

Setting	Default	Description
Enable Badge Styling	Off	Master toggle.
Badge Selection	—	Choose which badge to style from the dropdown.
Background / Text / Border Color	—	Per-badge color controls.
Border Radius	—	Corner rounding in pixels. 0 = square corners.
Font Weight / Size / Padding	—	Typography and spacing controls.

5.5 Webhooks

Fires HTTP POST requests to automation platforms when badges are assigned or removed. Works with Flowmattic, Zapier, Make, or any custom webhook endpoint.

Setting	Default	Description
Enable Webhooks	Off	Master toggle for badge webhooks.
Webhook URL	—	Your automation platform's webhook endpoint URL.

Webhook Payload Fields

event — "assigned" or "removed"
user_id, user_email, user_name — Member identity
badge_slug, badge_title — Badge identity
timestamp — Event date and time

5.6 Profile Fields

Adds custom data fields to FluentCommunity member profile pages. Admins define the fields; members fill them in from their profile edit page.

Setting	Default	Description
Enable	Off	Master toggle.
Section Title	Additional Information	Heading displayed above the custom fields block on profile pages.
Field Layout	—	Drag and drop fields into rows of 1–3 columns.

Field Types

Type	Use For
Text	Single-line input: job title, location, etc.
Textarea	Multi-line input for bios or longer content.
Email	Email address with format validation.
URL	Website URL — displays as a clickable link.
Date	Date picker — displays as a formatted date.
Select Dropdown	Predefined options in a dropdown. One option per line.
Checkbox	Single checkbox storing yes/no.
Radio Buttons	Single-choice from multiple options. One option per line.

Visibility Options

Option	Who Can See
Public (Everyone)	All visitors including guests.
Members Only	Logged-in community members only.
Owner Only	The profile owner and admins only.
Administrators Only	Users with admin access only.

5.7 Admin Notes License Required

A private note-taking system for your staff team. Notes are attached to individual member profiles and are completely invisible to regular members. Any staff member with appropriate access can add, edit, and view notes on any member profile.

🔒 Requires an active license + Admin Notes add-on enabled in the Add-Ons tab.

Access & Permissions

The Notes button appears on member profiles for any user who is:

A WordPress administrator (manage_options capability)
A FluentCommunity community-level admin or moderator
A FluentCommunity space-level admin or moderator (any space)

Note: Regular members never see the Notes button or any note content regardless of their membership level.

Using the Notes Modal (Front End)

On any member's profile page, a Notes button appears next to the Message and Follow buttons. Clicking it opens a modal where you can:

Read all existing notes for that member, newest first
Add a new note with optional image attachments
Edit or delete any existing note
Pin a note (blue left border — floats to top)
Mark a note as Urgent (red left border — triggers an email to all staff)
Add tags to categorize notes
Watch a member — receive an email notification when any new note is added
See who has viewed each note ("Viewed by: You, Jeff, Sarah")

Tip: Notes are automatically marked as read after viewing for 3 seconds. The Viewed By display updates immediately without a page reload.

Notes Log (WP Admin)

Go to FluentCommunity → Plus Settings → Admin Notes to access the full notes log. This shows all notes across all members in a card-based layout with the following columns:

Column	Description
Member	The member the note is about. Displays name, handle, and any Pin/Urgent badges.
Note	Full note text with auto-linked URLs, edit timestamp, and image thumbnails.
Tags	Color-coded tag pills assigned to the note.
Admin	The staff member who wrote the note.
Viewed By	Names of all staff who have opened the member's notes modal and viewed this note.
Date	Creation date and time.
Actions	Edit and Delete buttons.

Filtering and Search

Filter by member or by the admin who wrote the note using the dropdowns above the log.
Use the search bar to search note content across all members.
Sort by newest or oldest.

Bulk Delete

Four bulk delete actions are available at the top of the Admin Notes tab. Each action audits all affected notes before deletion and refreshes both the log and audit trail automatically.

Action	Description
Delete by Member	Delete all notes for a specific member.
Delete by Admin	Delete all notes written by a specific staff member.
Delete by Date Range	Delete all notes created between two dates.
Delete All Notes	Permanently remove every note in the system. Requires double confirmation.

Audit Log

An append-only audit trail is maintained below the main notes log. Every edit and deletion is recorded with the original and new content, the staff member who performed the action, and the timestamp. The audit log cannot be edited.

Click Export Log CSV to download the full notes log as a CSV file.
Click Export & Clear Audit Log to download and then permanently clear the audit trail.

Email Notifications

Trigger	Recipients	Description
Urgent flag set	All staff (WP admins + FCom admins/mods + space admins/mods)	Sent immediately when any note is marked Urgent. Includes member profile link and community URL.
Watch notification	Staff members watching that member	Sent when a new note is added for a watched member. Does not notify the note's author.
Daily digest	All staff	Sent at 8am covering notes from the last 24 hours. Can also be triggered manually via Send Digest Now.

Note: All email notifications are sent asynchronously via WP-Cron so they do not slow down the note-saving action.

5.8 Integrations — Bricks Builder

Fixes CSS conflicts between Bricks Builder and FluentCommunity for sites using both.

Setting	Default	Description
Enable Integrations Add-On	Off	Toggle in Add-Ons tab to reveal the Integrations settings tab.
Enable Bricks Integration	Off	Activates CSS compatibility fixes. Only enable if using Bricks Builder.

Resolves CSS layer conflicts between Bricks' @layer styles and FluentCommunity's unlayered CSS.
Fixes layout breaks when FC portals appear inside Bricks templates.

Note: Only enable if you actively use Bricks Builder. No effect on sites without it.

5.9 Analytics Add-On

The Analytics feature is a premium add-on requiring an active license. Enable it in the Add-Ons tab to reveal the full Analytics settings tab and dashboard. See Chapter 6 for complete documentation.

Setting	Default	Description
Enable Analytics	Off	Toggle in Add-Ons tab. Requires active license. Reveals the Analytics tab and enables all tracking features.

6. Analytics License Required

🔒 Requires an active license + Analytics add-on enabled in the Add-Ons tab.

The Analytics system gives you a complete view of community activity — member engagement, popular content, visitor origins, device data, and campaign performance.

6.1 Overview

Activity Tracking — Logs community events (posts, comments, reactions, logins, page views, space visits) to a dedicated database table.
Download Tracking — Logs file downloads from the FC Pro document library (requires FluentCommunity Pro).

With Extended Tracking enabled, each event is also enriched with IP address, country, city, device, browser, OS, referrer, and UTM data.

6.2 Tracking Settings

Setting	Default	Description
Download Tracking	Off	Track file downloads from FC Pro document library. Requires FluentCommunity Pro.
Extended Tracking	Off	Enrich every event with IP, geolocation, device, browser, OS, referrer, and UTM data.
Override FC Analytics Link	Off	Makes the Analytics link inside the FC portal open Plus Analytics instead of FC's built-in stats page.
Download Retention	90 days	Days to keep download records before auto-deletion. Set to 0 to keep forever.
Activity Retention	90 days	Days to keep activity log records. Set to 0 to keep forever.

Track Events — Individual Toggles

Toggle	Default	What It Logs
Posts	Off	Log each time a member creates a post.
Comments	Off	Log each time a member adds a comment.
Reactions	Off	Log reaction add and remove events.
Space Joins	Off	Log when a member joins or leaves a space.
Logins	Off	Log each member login.
Post Views	Off	Log when a post page is viewed.
Space Visits	Off	Log when a space is navigated to.

Note: Referrer and UTM tracking always work regardless of event toggle settings.

6.3 Activity Tracking — Event Types

Event	Requires	Description
post_created	Posts toggle	Fires when a member publishes a post.
comment_added	Comments toggle	Fires on new comment.
reaction_added / removed	Reactions toggle	Fires when a reaction is added or removed.
space_joined / left	Space Joins toggle	Fires when a member joins or leaves a space.
login	Logins toggle	Fires on each successful member login.
post_view	Post Views toggle	Fires when a post page is viewed.
space_visit	Space Visits toggle	Fires when a space is navigated to.
portal_visit	Always active	Fires when someone arrives with an external referrer or UTM parameters. Captures members and guests.

6.4 Download Tracking

Tracks file downloads from the FluentCommunity Pro document library. Requires FluentCommunity Pro installed and active, and the Download Tracking toggle enabled in Tracking Settings.

6.5 Extended Tracking

Field	Source	Description
IP Address	Server	Client IP. Respects CF-Connecting-IP and X-Forwarded-For for CDN/proxy setups.
Country & City	ip-api.com	Geolocation resolved from IP. Free, no API key required.
Device Type	User-Agent	Desktop, Mobile, or Tablet.
Browser	User-Agent	Chrome, Firefox, Safari, Edge, or Opera + version number.
OS	User-Agent	Windows, macOS, iOS, Android, or Linux.
Referrer	HTTP Referer header	External URL the visitor came from. Internal URLs are filtered out.
UTM Source / Medium / Campaign	URL parameters	Captured from `utm_source`, `utm_medium`, `utm_campaign`.

Note: IP address and geolocation data may be subject to GDPR. Update your privacy policy if applicable.

6.6 The Analytics Dashboard

Period Selector — Filter all cards and data to 7d, 30d, 90d, or All time.
Refresh Button — Reloads all cards and charts.
Summary Cards — Click any card to open a detailed breakdown modal.

6.7 Dashboard Cards

Card	Availability	What It Shows
All Activity	Always	Total logged events in period. Click for full activity feed.
Total Members	Always	All-time member count. Click for top posters and commenters.
Posts (Period)	Always	Posts in selected period. Click for sortable post list.
Total Spaces	Always	All spaces. Click for spaces ranked by post activity.
Total Downloads	Extended	Total file downloads. Click for trend chart and full log.
Top Country	Extended	Most active country. Click for world breakdown and city list.
Top Device	Extended	Most common device type. Click for full breakdown.
Top Browser	Extended	Most used browser. Click for doughnut chart and ranked list.
Top OS	Extended	Most common OS. Click for doughnut chart and ranked list.
Top Referrer	Extended	Highest-traffic external domain.
Top UTM Source	Extended	Highest-traffic UTM source. Click for full breakdown.

6.8 All Activity Feed

Control	Default	Description
Type Filter	All types	Filter by event type.
Space Filter	All spaces	Limit activity to a specific space.
Sort By / Direction	Date / Desc	Sort by Date, User, Event Type, Space, or Referrer.
Per Page	25	10, 25, 50, or 100 rows per page.

The Export CSV button downloads all filtered activity data — not just the current page.

6.9 Online Now in Analytics

The All Activity overview card displays a live Online Now count. Clicking it opens the All Activity modal where the full Online Now member list is shown at the top.

6.10 Referrer Tracking

Records which external websites sent visitors to your community via the HTTP Referer header. Captured server-side — no JavaScript required. Works for both logged-in members and guests.

Note: Some sites use a strict referrer policy that prevents the HTTP Referer header from being sent. Use UTM parameters on any links you control on those platforms.

6.11 UTM Tracking

Captures UTM parameters from the URL on every page load. Works even when no HTTP referrer is sent — making this the most reliable method for emails and social posts.

Parameter	Example	Description
utm_source	utm_source=newsletter	Where the traffic is from.
utm_medium	utm_medium=email	The marketing channel.
utm_campaign	utm_campaign=spring-launch	The specific campaign name.

Tip: Always add UTM parameters to links you share in emails and newsletters.

6.12 Data Management

Action	Description
Clear Activity Log	Permanently deletes all activity log entries. Cannot be undone.
Clear Download Log	Permanently deletes all download tracking records.
Clear Everything	Deletes both logs at once.

Per-User Management

View Activity — Opens that user's individual activity profile.
Delete User Data — Permanently deletes all log entries for that user.
Exclude from Tracking — Future activity from this user will not be logged.
Re-include — Removes the user from the excluded list.

6.13 Exporting Data

Open the All Activity modal and apply filters as needed.
Click Export CSV — all filtered results download, not just the current page.
CSV includes: User, Event Type, Detail, Space, Device, OS, Browser, Location, Referrer, Date.

7. Translations

Plus for FluentCommunity is fully translation-ready. All 557 user-facing strings are wrapped in standard WordPress internationalization functions and a complete .pot file is included in the plugin.

7.1 Overview

The plugin ships with a .pot (Portable Object Template) file at languages/fluentcommunity-plus.pot. This file contains every translatable string in the plugin and serves as the source file for creating translations in any language.

All admin UI text, settings labels, error messages, and dashboard strings are covered.
JavaScript-rendered strings (analytics dashboard, profile field builder, admin notes audit log) are also fully translatable via server-injected variables.
Translations are loaded automatically — place your compiled .mo file in the languages/ folder and WordPress handles the rest.

Tip: The .pot file is regenerated with each release. When updating the plugin, re-sync your translation in Loco Translate to pick up any new strings.

7.2 Translating with Loco Translate

Loco Translate is the recommended tool for creating and managing translations directly from the WordPress admin.

Initial Setup

Install and activate the free Loco Translate plugin from the WordPress plugin directory.
Go to Loco Translate → Plugins and find Plus for FluentCommunity in the list.
Click New language, select your target language, and choose a location to save the files.
Loco Translate will automatically detect the included .pot file and populate all 557 strings ready for translation.

Translating Strings

Use the built-in editor to translate strings one by one, or use the Auto-translate feature for a first-pass machine translation.
Click Save when done — Loco Translate compiles the .po source and .mo binary file automatically.
The translated strings are active immediately — no server restart or cache clearing required.

Updating After a Plugin Update

After updating Plus for FluentCommunity, open your translation in Loco Translate.
Click Sync to pull in any new or changed strings from the updated .pot file.
Translate the new strings and save.

Note: Translations saved by Loco Translate inside the plugin's own languages/ folder will persist across plugin updates when using the manual upload installation method. If updating via a future auto-updater, keep a backup of your .po file.

8. Help & Support

Resource	URL
Plugin Website	jeffbrigman.com
Purchase / Renew License	jeffbrigman.com/shop/plus-for-fluentcommunity
Support	jeffbrigman.com/community

8.1 Common Issues

Add-On tabs not visible in the navigation

Your license is not active. Go to the License tab, enter your key, and click Activate License.

Admin Notes button not appearing on profiles

Confirm the Admin Notes add-on is enabled in the Add-Ons tab and your license is active. The button only appears for WordPress admins, FluentCommunity community admins/moderators, and space admins/moderators.

Analytics tab not showing

Requires both an active license AND the Analytics toggle enabled in the Add-Ons tab.

Settings do not save

Click Save Settings after every change. Switching tabs before saving will lose unsaved changes.

Analytics cards show dashes or zero

Check that the relevant event toggles are on in Tracking Settings. Data only collects going forward after enabling.

Referrer card shows no data

Extended Tracking must be enabled. Use UTM parameters on links shared on platforms with strict referrer policies.

Download tracking not recording

Requires FluentCommunity Pro installed and active, and the Download Tracking toggle enabled in Analytics → Tracking Settings.

License activation fails

Your server needs to make outbound HTTPS requests to the licensing API. Contact your host if outbound connections are restricted.

Translations not loading

Confirm your compiled .mo file is in the plugin's languages/ folder and named correctly (e.g. fluentcommunity-plus-fr_FR.mo). If using Loco Translate, re-save your translation to recompile the .mo file.