JA Social Feed - Joomla extension documentation | Joomla Templates and Extensions Provider

JA Social Feed Plugin

Imports content automatically from popular social channels: Facebook, Twitter, Youtube ...

If you are new to Joomla, you can check our detail guide of how to install extensions in your Joomla site.

Documentation

The plugin allows you to import content automatically from popular social channels: Facebook, Twitter, Youtube, Vimeo, Instagram Flickr and Pinterest then save the content as Joomla articles or K2 articles. To import content, you have to follow the steps below.

Workflow of JA social plugin

Step 1: enable the plugin

In order to import content, you have to enable JA Social plugin

Enable JA Social plugin

Step 2: create profiles for each supported social channel

Once you install the plugin, you will see numbers of profiles in each supported social channel, these profiles settings are valid so you can use the profiles to import content to your site.

Create profile

You can also create new or customize the default profiles

Delete a profile

Delete profile

Create new profile

Create new profile

Customize a profile

Open any profile, then customize its settings.

Customize profile

Save imported content

You can save the imported content as Joomla articles or K2 articles to selected category.

Save content

Saved images

You can select to save images to your site hosting. In profile setting of each social channel, you will see field Save image under Advanced settings, enable this option so when you import content, images will be saved to your site hosting. The images are located in images/jasocial_feed.

Saved images
Note: after you work with a profile, you have to save the profile. The saving button for plugin (on top right corner) is not applied for saving profile. Your work with profile will be lost if you use saving button of plugin.
Save profile

Step 3: import content

In the Global setting panel, you will see settings for import content settings

global setting

Parameter explanation:

  • Enable the social channels that you want to import content from. In each enabled social channel, it will import content from enabled profiles only.
  • URL converter services: select service to import content (http://untiny.com/ or http://realurl.org/).
  • Cron Interval: set the duration to import content AUTOMATICALLY from enabled social channels, click "Run Now" to import content immediately.
The plugin will import from enabled profiles only
Import content for enabled profile only

Step 4: display content in your site

When you have content stored in your site, you can now display them in your site. The way you display them is up to you.

In each profile of any social channel, it includes setting of: Account settings, Article settings, and Advanced settings.

1. Facebook Application ID

Facebook has update

Steps to create a Facebook Application ID

Step 1 - Go to the Facebook Developers Apps page, and sign in with your Facebook username and password then go to My Apps > Add New App.

Step 2 - Enter a name for the application in the "App Name" field.

Step 3 - Read the Facebook Platform Policies and decide if you accept them.

Once done, open the Facebook tab then Facebook App ID and Facebook App Secret.

2. Account settings

Account setting

Parameters explanation

  • Status: enable the profile if you want to import content from the profile
  • FaceBook ID: add the facebook ID that you want to import content from, click on "Verify" button to check whether the account is valid or not.

3. Article settings

The panel includes settings for article when it's saved to your site.

Article settings

Parameter explanation:

  • Author: select the author from the user list for articles imported from the profile
  • Target Component: you can save the imported content as Joomla article for K2 articles. Incase you want to save as K2 articles, your site must have K2 installed.
  • Category: select the category corresponding to select "Target Component" to save the imported content to
  • Title Type: you can set the title for articles imported by Author name or custom text. When you select Custom Text, add the text that will be article title imported from the profile.
  • Source Text: add the text that will be displayed as source

Let's check imported content in our site.

4. Advanced settings

The panel includes settings for number of items to be imported, use image or not ...

Facebook advance setting

Parameters explanation:

  • Update Article: if Yes, when content from source is changed, it will be updated to your site when you import content.
  • Use Image: if Yes, the plugin will automatically extract image from the URL that user shares then add it into article for displaying. If No, it will import text only.
  • Minium | Maximum Image Width: set the minimum size for image to be used in articles for displaying
  • Save Image: you can select to saved the qualified image to your site hosting. The images will saved in folder: images/jasocial_feed.
  • Import Limit: set the maximum items to be imported from the profile each time you import content.

Article in front-page with image

Facebook in front page

1. Get Twitter OAuth information

Since 2013-06-11, Twitter has stopped supporting API v1 and fully moved to API v1.1

In API v1.1, Twitter deny non-Authorized request, that means you need to provide the information below to authorize your request.

To get content from Twitter, we need to get OAuth information. The OAuth includes: Consumer key, Consumer secret, Access token, Access token secret.

Step 1: create new application

#1: Login the site: https://apps.twitter.com/with your twitter account, if you do not have a twitter account yet, please register one.

#2: Now Click on button: Create a new application

create new application

#3: Add all requred information in this form then creat the twitter application

add required information

Step 2: Create my access token

When application is created successfully, open the Keys and Access Tokens tab and hit the buttons: Regenerate Consumer Key and Secret to generate consumer key then hit the button: Create my access token to create access token.

create access token

Step 3: Add OAuth information to the JA Social Feed plugin setting

After access token is created, copy the info to add to the Twitter: OAuth settings setting panel under the Global tab of JA Social feed plugin setting.

Get OAuth information

2. Twitter profile settings

Twitter profile settings are almost same as Facebook profile settings, just make sure you add valid Twitter Search

Twitter profile settings

Front-end appearance

Twitter front-end

Youtube account and article settings

Youtube account and article settings

Enter the youtube username that you want to import content from. Other settings are the same as settings in Facebook profile settings.

Imported content in your site

Youtube articles

Video settings

video settings

Parameters explanation:

  • Width | Height: set the size of video to be saved in article for displaying.
  • Show Suggested Vieos: if Yes, the suggested videos will be display when the video finishes.
  • Use HTTPS: the secure counterpart to HTTP, wraps a layer of encryption arround the information traveling between your computer and a web server .This is typically used to provide enhanced privacy and security for services like web browsing, email and instant messaging.
    Many sites that offer HTTPS support including content from other sites. When some parts of the site are not access using HTTPS, browsers generate a "mixed content" warning since not all items on this page are secure. Sites that use HTTPS and add default Youtube video embeds could generate this warning. To avoid that, and to allow your site to support HTTPS more consistently, you can choose the new Use HTTPS embed option.
    It is important to note that while embed components are all supported using HTTPS and do not generate the mixed content error, we do not yet support video streams over HTTPS.
  • Enable privacy-enhanced mode: Like most web properties, YouTube uses what are known as cookies to collect information. Cookies can be used to store data about the user's computer or the user watching a video. YouTube uses cookies to help maintain the integrity of video statistics, prevent fraud and to improve the site experience, among other things. We use cookies on both youtube.com and on videos embedded from youtube.com.
    We've been working to give our users more options and control over these cookies. One such option is the privacy-enhanced mode for our embed player. This mode restricts YouTube's ability to set cookies for a user who views a web page that contains a privacy-enhanced YouTube embed video player, but does not click on the video to begin playback. YouTube may still set cookies on the user's computer once the visitor clicks on the YouTube video player, but YouTube will not store personally-identifiable cookie information for playbacks of embedded videos using the privacy-enhanced mode.
  • Use old embed code:There are two styles of embed codes that are available for YouTube videos. The new embed code begins with "_QQ_"<iframe..."_QQ_" and supports both Flash and HTML5 video. The older style of embed code begins with "_QQ_"<object..."_QQ_" and only support Flash playback.
    Some services only support the older "_QQ_"<object..."_QQ_" embeds. If you do encounter a site that rejects your "_QQ_"<iframe..."_QQ_" embed code, the recommended course of action is that you use the older "_QQ_"<object..."_QQ_" code for the time being.

Front-end Appearance

Youtube front-page

1. Vimeo account and article settings

vimeo accoutn and article setting

Parameters explanation:

  • Type: supported vimeo types (Username, Album, Group or Chanel)
  • Username or ID: add the correct Vimeo Username or ID to import content from.
  • Target Component: select to save imported content as Joomla articles or K2 articles.
  • Category: select category where imported content will be saved to.

2. Video and advanced settings

Video settings

Parameters explanation

  • Width | Height: set the size of video to be saved in article for displaying.
  • Show Suggested Videos: if Yes, the suggested videos will be display when the video finishes.
  • Auto play: select Yes if you want video to auto play when user open article contain the video in front-page.
  • Loop: loop video or not.
  • Use old embed code:There are two styles of embed codes that are available for YouTube videos. The new embed code begins with "_QQ_"<iframe..."_QQ_" and supports both Flash and HTML5 video. The older style of embed code begins with "_QQ_"<object..."_QQ_" and only support Flash playback.
  • Some services only support the older "_QQ_"<object..."_QQ_" embeds. If you do encounter a site that rejects your "_QQ_"<iframe..."_QQ_" embed code, the recommended course of action is that you use the older "_QQ_"<object..."_QQ_" code for the time being.

  • In the advanced setting pannel, you can select to use image in imported content or not, update article and set limitation for number of items to be imported.

Front-end Appearance

vimeo front-page

Important:

On Wednesday, 1st of June, 2016, Instagram’s platform changes goes into effect for apps created before November 17, 2015. These changes include a more focused set of terms, a new permissions review process, and the deprecation of the /users/self/feed and /media/popular API endpoints.

Due to the changes, we also updated JA Social feed plugin. If you want to get post from ‘tag’, you will need an Application which is reviewed and approved from Instagram.

Get post from a specific account

Requirement: Don’t need Application info.

In Profile setting, set keyword to be name of account: for example: ‘joomlart’ (no @ before it)

Get post from Tag:

Requirement: Need Application which is reviewed and approved by Instagram.

Here are steps to register & ask for review in Instagram (If you already have Application with all conditions, ignore these steps) :

  1. Login to Instagram then go to link: https://www.instagram.com/developer/clients/manage/
  2. Click to button: Register a new Client
  3. Fill the Details >> Register:

instagram settings

Valid redirect URIs: must be the site path has JA Social Feed installed.

instagram settings

Once done, click on: Edit Client Info >> Permission tab >> click "Start a Submission". It will take at least one week to get review done.

Client Info will appear after step 3. Add all the info to JA Social Feed.

Add Client ID, Client Secret, Redirect URI to the Text field then save the settings.

instagram settings

Once done, hit the "Edit" button to get Access token key. If all the info is correct, access token key will be generated. Copy & paste the info to Access token field in the JA Social Feed configuration. Now you’re ready to Import post from Instagram.

Note:

  • If your Application in Sandbox Mode, you can only get post with Tag from your own account.
  • Your access_token isn’t valid forever, If the token is no longer valid, API responses will contain an “error_type=OAuthAccessTokenError”. In this case, please hit ‘Get Access token key’ button to get new Token key.
Instagram settings

Front-end appearance

Instagram front-end
Flickr setting

Front-end appearance

Flickr front-end

This is new feature of version 1.1.4, if you want to have the feature available, you have to upgrade the plugin to verison 1.1.4+

Pinterest settings

Parameters explanation:

  • Pinterest Username: add Pinterest username that you want to import content from
  • Pinterest board: add the pinterest board that you want to import content from. Leave it blank if you want import LATEST PINS.
  • Target component: select to save imported as Joomla articles or K2 items
  • Category: select category that imported content will be saved to

If you still have trouble or you want to suggest to improve the documentation, feel free to raise a ticket in JA Social feed forum

Support forum