Skip to main content
On this page

FluentCommunity Comments

FluentCommunity is a powerful community-building and discussion solution. The TanaFlows theme integrates FluentCommunity comments out-of-the-box as a high-performance Lazy Component. Comments are only loaded when the browser is idle, ensuring maximum page speed while still providing deep engagement capabilities.

Here is the step-by-step guide to setting up FluentCommunity in Ghost Admin and activating it for individual posts.

Step 1: Configure FluentCommunity in Ghost Admin

First, declare your FluentCommunity URL in the theme’s custom settings:

  1. Go to Ghost Admin > Settings > Design > Custom Settings.
  2. Find the Comment Provider option and select: FluentCommunity.
  3. Find the 3rd Comment ID / Base URL field (or 3rd_comment_id) and enter your FluentCommunity community root URL.
    • Example: https://community.yourdomain.com (do not add a trailing slash /).
  4. Click Save.

Step 2: Enable Comments for Specific Posts

To optimize Largest Contentful Paint (LCP) speeds, the FluentCommunity comment system is not automatically loaded on all posts. You must manually activate it on posts where you want to allow discussions by linking them to their corresponding topic on FluentCommunity.

  1. Open your post in the Ghost Editor.

  2. Click the plus + icon and insert an HTML card.

  3. Paste the following script inside the HTML card:

    <script>
      window.fcomSlug = "community-post-slug";
    </script>

  4. Replace "community-post-slug" with the slug of the corresponding discussion topic on your FluentCommunity site.

    • Example: If the link to your community topic is https://community.yourdomain.com/posts/tana-learning-guide, the slug is tana-learning-guide.
    • The code will look like:
      <script>
        window.fcomSlug = "tana-learning-guide";
      </script>

  5. Publish or update the post.

How It Works and Key Features

Once you insert the activation code:

  • Discussion Thread Display: The theme automatically connects to the FluentCommunity API to fetch the comments list (including avatars, member names, text, and nested replies) and displays it directly below the post.
  • “Join the Discussion” CTA: Displays a call-to-action block attracting readers to participate. When clicked, users are redirected directly to the specific Space/Group on your community to start commenting.
  • Caching Mechanism: When readers return to a previously visited post, the comments list displays instantly without waiting to download scripts again, thanks to a secure temporary cache (sessionStorage).