Responsive Facebook Comments

Download

After purchasing the extension from our Joomla store, you will receive a link to download the ResponsiveFacebookComments_UNZIP.zip file.

Unzip the file using any unzip software. Upon unzip you will find 2 different versions of plugin and a readme file. These are supported by both Joomla 3 and Joomla 4

• plg_rfbcomment_X.x - This is a content plugin which can be used to add the Facebook comment plugin automatically below the Joomla articles( No 3rd party components supported). You can manage the plugin settings to exclude or include any category or articles.
• plg_sys_rfbcomment_X.x - This is a system plugin which offers a short code to add into any article, module or component. Just add the shortcode and enable the plugin.
• ReadMe.txt - Provides information about the plugin version and the shortcode.

Installation

Go to Extensions > Extension Manager and click on the Upload Package File Tab.

Click on browse to choose the correct installation file and click on "Upload and Install"

After installation go to Extensions > Plugin Manager. On the Search Bar type Responsive Facebook Comments.Now click on the Responsive Facebook Comments to configure the plugin. Upon clicking you will be able to see the following with default "Plugin" Tab opened.

In the plugin tab set status to "Enabled" and do the settings for other tabs

Content Plugin

Moderator Settings

• Number of Posts : Option to set the count for number the comments to show.
• Moderating Using : Moderator can be username or an App id. (Moderation Settings)
• User ID : Enter the user name of the Moderator. Multiple moderator can be added. One per line.

Manage Contents

• Excluded Categories : Select the categories to exclude.
• Exclude Views : Select the views to exclude FB comments from showing.
• Exclude Article ID(s) : Add the ids(one per line) to exclude.
• Padding : Padding around the comment module in px. Ex : 10px
• Margin : Margin around the comment module in px. Ex : 10px

System Plugin

You can either use the content version or the system version of the plugin according to you requirements. If you are using the System version you have to add the shortcode.

To use this plugin simply you have write the below code at your desired location.

{rfbcomment}100%{end-rfbcomment}

To make changes to the configuration, search for System - Responsive Facebook Comments in the plugin manager and go to Configuration tab.

• Number of Posts : Option to set the count for number the comments to show.
• Padding : Padding around the comment module in px. Ex : 10px
• Margin : Margin around the comment module in px. Ex : 10px
• App Id : Enter the app id to manage.

You can also follow the article on how to create app id for facebook comments - Click Here

App ID Setup

Why Use App ID Instead of User ID

Using an App ID for moderation provides several advantages over User ID:

• Receive notifications when new comments are posted
• Manage all comments from a centralized dashboard
• Add multiple moderators easily
• Access advanced settings like spam filters and blacklists

Creating a Facebook App

1. Log in to your personal Facebook account
2. Visit https://developers.facebook.com/
3. Click on "My Apps" in the top navigation
4. Click "Create App"
5. Select "Consumer" as the app type
6. Enter your website or business name as the App Display Name
7. Enter your contact email for notifications
8. Click "Create App" and complete any verification steps

Configuring Your App

1. In your app dashboard, go to "Settings > Basic" from the left menu
2. Scroll down and click "+ Add Platform"
3. Select "Website"
4. Enter your complete website URL (including https://)
5. Click "Save Changes"
6. On the Basic Settings page, locate your App ID at the top
7. Copy this App ID and paste it into your plugin settings

Moderation

Accessing the Moderation Dashboard

Once you've set up your App ID, access the moderation dashboard at:

https://developers.facebook.com/tools/comments/

Select your app from the dropdown if prompted. You should now see all comments from your website.

Setting Up Notifications

To receive notifications when new comments are posted:

1. Log in to Facebook with the same account used to create the app
2. Go to Account Settings > Notifications
3. Find the "Apps" section and ensure notifications are enabled
4. Check your email settings if you want email notifications

Adding Multiple Moderators

1. Go to your App Dashboard at https://developers.facebook.com/apps/
2. Select your app from the list
3. Go to Settings > Advanced
4. Under "Moderators", add the Facebook usernames or email addresses
5. Send invitations to these users

Troubleshooting

Moderation Tool Errors

If you see an error like "Sorry, the link you followed may be broken..." when accessing the moderation tool:

1. Verify App Status: Ensure your app is set to "Live" status in the App Dashboard
2. Check App Configuration: Verify your website URL is correctly entered in the app settings
3. Update Facebook's Cache: Use the Facebook Debugger tool (explained below)
4. Check App Permissions: Ensure you have administrator permissions for the app

Missing Notifications

If you're not receiving notifications for new comments:

1. Check Facebook Notification Settings: Go to Facebook Settings > Notifications and ensure app notifications are enabled
2. Verify App Configuration: Confirm your app is properly configured for the website
3. Test with a New Comment: Post a test comment on your site and check if you receive a notification
4. Check Facebook Login Status: Ensure you're logged into Facebook with the same account used to create the app

Facebook Debugger Tool

The Facebook Debugger is essential for troubleshooting:

1. Access the Debugger: Visit https://developers.facebook.com/tools/debug/
2. Enter Your URL: Input the URL of a page on your site that has comments enabled
3. Examine the Results: Check if your App ID appears in the parsed Open Graph tags
4. Clear the Cache: Click "Fetch New Information" to refresh Facebook's cache

FAQ

Frequently Asked Questions

Q: Can I use both plugin versions simultaneously?
A: Yes, you can install both and use them for different purposes. Just be careful not to add Facebook comments twice on the same page.

Q: How do I delete all existing comments?
A: Comments can only be deleted individually from the moderation dashboard. There's no bulk delete option provided by Facebook.

Q: Will comments appear immediately or require approval?
A: By default, comments appear immediately. To require approval, you must change this in the Facebook moderation settings.

Q: Can visitors comment without a Facebook account?
A: No, visitors must have a Facebook account to comment using this plugin.

Q: Why aren't notifications working?
A: Notifications only work with App ID moderation, not User ID. Follow the App ID setup instructions in this documentation to enable notifications.

Q: Why does the moderation tool show an error message?
A: This typically occurs when:
1. The Facebook App ID isn't properly configured
2. Facebook hasn't properly indexed your site with the App ID
3. The moderation tool can't find comments associated with your App ID

Use the Facebook Debugger tool to refresh Facebook's cache of your site, which often resolves this issue.

Q: How long does it take for moderation to start working?
A: After setting up an App ID, it can take 1-2 hours for Facebook to index your site properly. Add a test comment and check back after a few hours if you don't see it in the moderation tool immediately.

Advanced Features

Language Settings

The plugin automatically detects your site's language, but you can override this with the shortcode:

{rfbcomment lang="fr_FR"}100%{end-rfbcomment}

Color Scheme

Choose between two color schemes to match your site's design:

• Light: White background with dark text (default)
• Dark: Dark background with light text

For the System Plugin, specify the color scheme in the shortcode:

{rfbcomment colorscheme="dark"}100%{end-rfbcomment}

Order of Comments

Control how comments are sorted:

• Default Order: Top comments first (most relevant)
• Reverse Chronological: Newest comments first
• Chronological: Oldest comments first

Set the order in the System Plugin shortcode:

{rfbcomment order="reverse_time"}100%{end-rfbcomment}

Custom Styling

For more control over the appearance, add custom CSS to your template:

.rfbcomment-container {
  border: 1px solid #e9e9e9;
  border-radius: 5px;
  box-shadow: 0 2px 5px rgba(0,0,0,0.1);
}

@media (max-width: 768px) {
  .rfbcomment-container {
    padding: 5px !important;
  }
}