Running into issues? While we have excellent support, should you need it, we always recommend checking out this list of common questions. With a little luck, and good work on our part, you'll find your answer right now!

Social networks changes frequently. Always ensure you're running the latest version of JFBConnect, as this will solve many common issues. See the JFBConnect changelog for the most recent version and fixes available.

If you're having issues with the preview that is generated for your site when sharing your content on a social network, try the following steps. Please note, after fixing any errors, it may take a few days for Facebook to rescan all of your pages.You can do this manually for pages you are testing at our Social Debug site or Facebook's Open Graph Debugger (using the Fetch new scrape information button).

  1. Test with our site Social Debug. If this properly shows your preview/tags without any warnings or errors, it means that JFBConnect is correctly setting your Open Graph Tags.
  2. If the preview is still incorrect in Facebook, test with the Open Graph Debugger Tool
  3. If you encounter an error like in the following image in the Facebook tool:
    gzip error
    there is a known issue with Joomla 3.x where the Facebook Open Graph Debugger and certain server configurations can prevent Facebook from scanning your page for Open Graph tags properly. We suggest turning off Gzip Page Compression in the Global Configuration area and re-testing the Open Graph tags.
    1. If GZip compression is needed, there are plenty of ways to keep GZip compression, but you can't use the GZip option that's in Joomla. We're still unsure why Facebook can't read pages when GZip compression is enabled in Joomla, but it can't, so that's not something you can use.  GZip compression can be enabled in Apache directly, which has the additional benefits that it will compress all assets on the page (Javascript, CSS and Image files), and it's at the server level, which makes it much faster. The GZip option in Joomla *only* compresses the output HTML, which is generally not the biggest hog of resources on your page load time anyways.
    2. We would recommend contacting your hosting provider to ask them to enable GZip compression for your server/site within Apache and see if that improves load times and it should definitely work with Facebook
  4. If you encounter the following error about non-matching og:url and a canonical url:
    Mismatch og:url and canonical url    og:url tag in the header is not the same URL as rel='canonical' link in the html.
    The values for the Open Graph tag og:url does not match the value in the head section for rel="canonical". Facebook will follow the canonical URL, which can explain why it's gathering incorrect Open Graph tag values. JFBConnect only sets the og:url value and is not responsible for setting the canonical value. Some other extension, your template or possibly Joomla itself is setting this value. The quickest way to find this is to search your directories for 'rel="canonical" to see anything setting the tag on your pages. Once you narrow down what is setting it and why it is the incorrect value, re-scrape your page to check the share preview again.
  5. If you encounter multiple og:image tags on your page, Facebook will choose the most appropriate image to use for your link.
    1. Please ensure that your images are the recommended sizes. Smaller images that don't meet the recommended size guidelines are given lower priority. See Facebook's recommendations here.
    2. Multiple image tags are allowed to be set on a page, but it's fine if you just want to include one image. Turn on the 'Enable Social Toolbar' option in JFBConnect general configuration area. Then log in on your front-end as a superadmin and click the 'Social Meta' button in our toolbar. You will then see a detailed list of what is setting the og:image values. This can help pinpoint how to narrow down the image tags set on the page.
  6. If your Open Graph tags look correct on the page, you've re-scraped your pages, but your changes are not taking effect: There are times when some properties may not be changed or some values may be cached. Please see Facebook's developer documentation on updating your objects.

I ran the Autotune Error Check and am getting the following error:

  • Test: Facebook Javascript library inclusion Fail: Another Facebook extension is installed, including the Facebook Javascript library, and may conflict. - This error means that another extension, plugin or template on your site is including Facebook's deprecated all.js Javascript library. That is the 'old' version of the Facebook Javascript API which was discontinued. It's no longer meant to be used and can cause conflicts with some JFBConnect features, as JFBConnect uses the recommended sdk.js library. Some common extensions that included Facebook features are JomSocial, EasySocial, K2. You will need to check your plugins, components and/or template for any Facebook features and try to disable them.
  • Error Code: 406 - Unknown Error - The full error coming back from Autotune is usually "Not Acceptable! An appropriate representation of the requested resource could not be found on this server. This error was generated by Mod_Security." It seems like mod_security (an Apache firewall addon) is blocking our automated tool from scanning your page. Mod_security, in general, tries to prevent 'bad' requests (malicious, automated, and various other kinds). It may be detecting our tool is automated (not a real browser) and denying it. You'll need to investigate your mod_security logs, or disable it, to let the Autotune tool perform its checks. Additionally, we recommend testing your page with other automated checkers, such as http://www.internetmarketingninjas.com/header-checker/
  • Facebook API Error: (#10) Changing app settings through API calls has been disabled for this app. Go to your app's advanced settings to enable this. Facebook Application configuration could not be loaded. Please check your App ID and Secret Key. - Go into your app on https://developers.facebook.com/ and navigate to Settings > Advanced. If you scroll down on that page, there's an option called "Allow API Access to App Settings" that needs to be enabled to resolve this error. Once it's on, you'll be able to use Autotune in JFBConnect to set up the application.

You can set the width to "100%" (make sure you include the %) and it will be forced into a responsive mode which should work on your desktop and mobile views.

In SH404SEF (or any other SEF extension you're using), find and update the setting so that you skip SEF URLs for the JFBConnect component.

If you encounter the following error "Maximum PHP file upload size is too small", please try editing your php.ini file and updating the following settings:

upload_max_filesize="3M"
post_max_size="3M"

After you make the changes and restart Apache, please go to the System -> System Information -> PHP Information section in the Joomla Admin area. Then, search for the values you updated "upload_max_filesize" and "post_max_size". There will be a few columns after each value. The first column is the "Local" value, which is what is currently being used. Please make sure that is at the 3M value you specified above to make sure the values took effect and then try the installation again.

Add-ons or settings in Firefox may be causing this. Please temporarily disable any add-ons that may be blocking the plugins. Also, selecting "Always use private browsing mode" under Tools | Options | Privacy (in Firefox) can prevent the Facebook plugin from displaying correctly on the front end of a website.

The 5 most common causes of that issue are:

  1. Your Twitter Application wasn't set up properly. As of 6/2018, Twitter has made a chance to their app settings for "Callback URL". The URL should be your website followed by index.php, like "https://yoursite.com/index.php"
  2. You didn't copy the API Key and Secret properly to JFBConnect
  3. Your Twitter API and Secret Keys may need to be regenerated in your Twitter application. This may be done inside the Twitter Development area for your app.
  4. The "Enable Callback Locking" setting is enabled. Please disable this from the Twitter Development area > Settings tab.
  5. Your server time is incorrect (uncommon)

Please verify #1 and #2 and go through our Twitter Application Setup Guide again.

First, create a template override of the K2 item.php file. Inside the override file, place the following example code to add the social sharing buttons with a Box Count layout:

<div style="position: relative; top:0px; left:0px; z-index: 99;" class="scsocialbuttons box_count">
{JLinkedShare counter=top}
{SCTwitterShare href= data_count=vertical size=medium}
{SCGooglePlusOne size=tall}
{SCPinterestShare href= image= pin_count=above}
{JFBCLike layout=box_count}
</div>
<div style="clear:left"></div>
The example above uses the default styling provided in the /media/sourcecoast/css/jfbconnect.css file, but you can add your own classes to each Easy-Tag above if desired. An example with your own classes:
<div class="social_custom">{JLinkedShare counter=top}</div>
<div class="social_custom">{SCTwitterShare data_count=vertical size=medium}</div>
<div class="social_custom">{SCGooglePlusOne size=tall}</div>
<div class="social_custom scpin">{SCPinterestShare image= pin_count=above}</div>
<div class="social_custom">{JFBCLike layout=box_count}</div>
When you define your own classes, you may need to define your own styles. For this second example, here are the styles.
.social_custom {
    float: left;
    margin-right: 10px;
}

.scpin { 
    margin-top:38px;
}

The examples above add the social sharing buttons. For more details on how to customize or add the Comments box or different JFBConnect Easy-Tags, see our Easy-Tag documentation.

The activity logs are where it should be posting. The Activity Log is a view of all actions available to the Timeline. Facebook chooses which ones actually show up in your Timeline view to you or viewers of your profile, and that's all based on different social relevance factors to the viewer. Each item in the activity log can actually be forced to go on the Timeline by using the "Always show on Timeline" setting.

Add a Share button to your Profile header

Create a template override for the com_community/layouts/profile/focus.php file. Then add the following easy-tag to the new file. This example shows the Facebook Share button, but you can replace with whatever Easy-tag you prefer.

{JFBCShare href=<?php echo CRoute::getExternalURL('index.php?option=com_community&view=profile&userid=' . $profile->id); ?> layout=button_count}

Depending on how your theme/template for JomSocial is configured, the easy-tag may need to be placed in a different view file than the focus.php file. If so, you may also need to update the href value that's being computed to get the user's profile ID correctly.

Add a Share button to your News feed

Adding a share button to your JomSocial news feed is very similar to adding it to the profile header, with a couple of differences.

  • Create a template override for com_community/layouts/stream/actions.php. A good place to put the share button code is in the "joms-stream__actions" div by the Like buttons.
  • When a user enters a post and submits it to the feed, the button needs to show up automatically. The JFBConnect easy-tags add the Javascript HTML version of the social plugins, but this requires Facebook to parse the page for the buttons to render. To get the buttons to show up right away without refreshing the news feed, the code block will need to be the IFrame version for the share button.
  • Again, you may use any social plugin here instead of the share button, but please make sure to use the IFrame version.
<?php
if ($config->get('usejfbc')) {
   if (class_exists('JFBCFactory')) {
      $link = CRoute::getExternalURL('index.php?option=com_community&view=profile&userid='.$act->actor.'&actid='.$act->id);
      $fbClient = JFBCFactory::provider('facebook');
      $fbAppId = JFBCFactory::provider('facebook')->appId;
      echo '<iframe src="https://www.facebook.com/plugins/share_button.php?href='.$link.'&layout=button_count&size=small&mobile_iframe=true&appId='.$fbAppId.'&width=81&height=20" width="81" height="20" style="border:none;overflow:hidden" scrolling="no" frameborder="0" allowTransparency="true"></iframe>';
   }
}
?>

Right now, for user social posting, we mainly only support Facebook. The currently available options are:

  • Enable the "Push status updates to social network" in the JFBConnect -> Profiles -> JomSocial area. When enabled, user status updates will be pushed to their Facebook Timeline if they have granted permission to do so when they authenticated with Facebook. Any status updates in JomSocial not marked as public will not be pushed.
  • Creation of Open Graph Actions. With these, user actions (uploading a photo to JomSocial, Joining a group, even reading an article) can be pushed to the user's Activity Stream in Facebook. There is a settings area in the standard Joomla Edit Profile area where they can disable the automatic activity pushing for each action. For more information on Open Graph Actions, see:https://www.sourcecoast.com/jfbconnect/docs/open-graph/actions/

Our documentation for Posting to Channels is intended for you, the admin, to push content to Channels. It is not meant for your end-users to push their activity to your managed social network channels.

In Joomla, you can disable the "Allow User Registrations" setting. Once that done, users will still be able to register and login through social networks and register through Joomla itself.

Simply use the {JFBCLogin} tag anywhere on your site and the Login buttons will appear for guest users.

  1. Specify the desired providers by adding the providers field with a comma-separated list. Example: {JFBCLogin providers=facebook,google,linked}
  2. If you'd prefer to use your own images for the login buttons, for each provider you are displaying, add an image to the corresponding /media/sourcecoast/images/provider folder. Then add the image name to the JFBCLogin tag. Example: {JFBCLogin image=icon_label.png}
  3. You can also include a logout button, when users are logged in, by specifying {JFBCLogin logout=true}

There are more options for the look of the button that can be seen in the Tag section of the JFBConnect Configuration Guide:

These tags can be placed in an article, a custom HTML module, or any template file.  All settings in the JFBConnect component (new user type, redirections, etc) will be used automatically.

To properly integrate JFBConnect with JFusion, you should:

  • Order the JFBConnect Authentication plugin before (lower number) the JFusion Authentication plugin
  • Order the JFBConnect User plugin before (lower number) the JFusion User plugin
  • In JFusion, for the setting of "What method would you like to use for dual login?", select "Let jfusion create cookies without accessing files".

The Smarty template system will interpret any tags inside squigglies {} as commands for their system. To properly use the JFBConnect tags, you need to include them as follows:

{literal}

  {JFBCComments}
{/literal}

You can use any JFBConnect easy-tag above, not just for the comments widget.

Social Stream
SourceCoast Joomla Social Extensions
Friday, 25 May 2018
JFBConnect 8.0 Coming Soon! Stay tuned.
Refer and Earn

Like our extensions? You're not alone! That's why they're used on tens of thousands of websites. Now you can earn 20% of any sale you refer to SourceCoast.com.

We provide excellent documentation, well laid out sales pages and great support. All you need to do is spread the word and we'll take care of the rest.

Learn About Our Affiliate Program