Community Support

A WordPress plugin that seamlessly integrates the Fluent Support portal into Fluent Community, providing a unified support experience for community members.

Description

Community Support bridges the gap between Fluent Community and Fluent Support by embedding the support ticket portal directly within your community portal. Users can create, view, and manage support tickets without leaving the community interface.

Features

• 🎫 Embedded Support Portal - Access Fluent Support directly within Fluent Community
• 🔗 Seamless Navigation - Adds a "Support" menu item to the community topbar
• 🎨 Theme Integration - Automatically adapts to Fluent Community's theme variables
• 🔐 User Authentication - Support is only visible to logged-in users
• 🌐 Internationalization Ready - Full i18n support with translatable strings
• ⚡ Dynamic Loading - Scripts load only when needed for optimal performance

Requirements

• WordPress 5.0 or higher
• PHP 7.4 or higher
• Fluent Community - Must be installed and active
• Fluent Support - Must be installed and active

Installation

1. Download the plugin zip file or clone this repository
2. Upload the community-support folder to /wp-content/plugins/
3. Activate the plugin through the 'Plugins' menu in WordPress
4. Ensure both Fluent Community and Fluent Support are installed and activated

Usage

Once activated, the plugin automatically:

1. Adds a "Support" menu item to the Fluent Community topbar (visible only to logged-in users)
2. Creates a /support route within the community portal
3. Embeds the Fluent Support customer portal within the community interface

Accessing Support

Users can access the support portal by:

• Clicking the "Support" link in the community topbar
• Navigating directly to your-site.com/portal/support (where "portal" is your community slug)

Hooks & Filters

Customizing the Page Title

// Change the support page title
add_filter('community_support/page_title', function($title) {
    return 'Help Center';
});

Customizing Portal Variables

// Modify Fluent Support portal variables
add_filter('community_support/customer_portal_vars', function($data) {
    // Customize portal data
    return $data;
});

Customizing Error Messages

// Customize the missing plugin message
add_filter('community_support_missing_plugin_message', function($message) {
    return '<div class="custom-notice">Please install Fluent Support.</div>';
});

// Customize error messages
add_filter('community_support_error_message', function($message, $exception) {
    return '<div class="custom-error">Something went wrong.</div>';
}, 10, 2);

File Structure

community-support/
├── community-support.php      # Main plugin file
├── README.md                  # This file
└── includes/
    ├── CSFrontendHandler.php  # Handles frontend rendering and Vue component injection
    ├── CSHelper.php           # Utility functions
    ├── CSMenuHandler.php      # Menu integration for Fluent Community
    └── CSShortcodeHandler.php # Processes Fluent Support shortcode

How It Works

1. CSMenuHandler - Adds a "Support" menu item to Fluent Community's header navigation
2. CSFrontendHandler - Injects a Vue.js component and custom route into Fluent Community's SPA
3. CSShortcodeHandler - Retrieves and processes the Fluent Support portal shortcode content
4. CSHelper - Provides utility functions for URL generation and plugin detection

The plugin registers a custom Vue component that:

• Loads the Fluent Support portal content
• Dynamically injects required CSS and JavaScript
• Handles the lifecycle of the support portal within the community SPA

Styling

The plugin includes custom CSS that:

• Integrates with Fluent Community's CSS variables (--fcom-*)
• Provides responsive styling for the support portal
• Ensures consistent look and feel with the community theme

Troubleshooting

Support page not appearing

1. Ensure both Fluent Community and Fluent Support are installed and active
2. Check that the user is logged in (support menu is only visible to authenticated users)
3. Clear any caching plugins

Styles not loading correctly

1. Check browser console for any CSS loading errors
2. Ensure Fluent Support assets are accessible
3. Try disabling other plugins to check for conflicts

Changelog

1.0.0

• Initial release
• Fluent Support portal integration
• Topbar menu integration
• Theme variable support

Author

Rahat Baksh

• GitHub: github.com/rahat1994

License

This plugin is licensed under the GPL v2 or later.

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.

Support

For issues and feature requests, please create an issue on the GitHub repository.