FluentCommunity integration guide

Product boundary

This plugin is a narrow FluentCommunity adapter. FluentCommunity owns its portal, router, native header, menus, profiles, spaces, courses, and membership permissions. Social Terminal and each Cointacted add-on continue to own their commands and data. The adapter registers reviewed native routes before the FluentCommunity router is constructed; it does not iframe WordPress pages or copy provider data into a second system.

Free includes the Terminal route and safe community discovery commands. Pro permits reviewed Cointacted add-ons to mount their native integration assets, routes, menus, member surfaces, and event adapters inside the FluentCommunity SPA. That admission does not grant the add-on's own Pro capability; both server-side grants are checked independently.

Gamification routes

Configure FluentCommunity destinations under Cointacted → Gamification → Display. The top-level Gamification page may contain any enabled sections in saved order. History, balances, achievements, ranks, both catalogs, quests, and streaks may also use focused top-level routes and optional menu entries. Profile Rewards tabs are configured independently.

Every top-level destination uses FluentCommunity's native page-title bar followed by the owning Gamification content. A composed page also displays a heading for each enabled section. Privacy opt-out, owner/visitor policy, selected point types, signed-out behavior, and empty-state behavior remain authoritative in Gamification.

Community commands and data

Community discovery commands use FluentCommunity's own permission model. Gamification activity sources listen to official member-action hooks and record replay-safe events only when configured. Native engagement points and levels remain FluentCommunity data; Gamification point types and rankings remain Cointacted data.

Troubleshooting

• Portal 404: confirm the adapter is current and the managed route is enabled before the router initializes.
• Broken or duplicate header: do not render a second page title inside the host title bar; use the current 1.0.80 route definitions.
• Profile tab absent: verify profile presentation, selected sections, viewer policy, and both required product capabilities.
• History visible to visitors: review Gamification's visitor activity policy; private ledger provenance must not leak.
• Menu missing: enable the route's community-menu option and confirm the current member can access it.

Do not use this plugin to replace FluentCommunity search, authentication, SEO, ecommerce, or native content ownership. Those integrations belong to their respective Cointacted, SnapWeb, or ShopiChain packages.