Introduction

Smart Social Feed addon allows the user to get feeds and updates from different social media platforms. It has easy to use methods as this addon provides a user-friendly interface.

This addon can be used to get feeds from social platforms like Facebook, YouTube, Twitter, Instagram and Vimeo.

Compatibility

EE Compatible Version: EE4, EE5.

Plateforms

Facebook

Smart Social Feed addon provides the facebook updates of the respective page in no time. Enter facebook page ID to get started. You can also select the types of feeds that you wish to receive, for instance, only videos, only photos, all of them etc.

Twitter

Smart social feed addon updates you with all the tweets for a given Twitter account. The user has to insert the Twitter username to enjoy the benefits of such a feature.

Instagram

Smart social feed addon helps the user to stay updated with the Instagram posts as well. Insert the Instagram ID to use this feature. Currently, We provide the Instagram feed using the Facebook Instagram graph API. We do not provide the “Albums” type of feed in the current version.

YouTube

Smart social feed addon provides the feeds and updates related to the YouTube channel of the user. Enter the channel ID of a given username to get the benefits of this service

Vimeo

Smart social feed addon helps in fetching feeds or videos for a given user ID or channel ID. The associated videos can be received easily using this feature. You can select between user uploaded video or channel videos that you wish to receive.

Convert profile to page

Due to Facebook’s privacy policy, we are not able to use the addon to get all of your posts from the personal profile, only from a public page, as posts from a personal profile are protected for privacy reasons of Facebook.

If you’re using the profile to represent a business, product, organization, public figure, or something else other than yourself, then we had advise converting your profile to a page per Facebook’s recommendation: http://www.facebook.com/help/175644189234902/

There are many advantages to using pages over the profiles. It is in fact against Facebook policies to use a profile to represent something other than yourself. See “Why should I convert my profile to a page” in the above link.

Steps to create the page from Profile.

    1. Go to Create a Facebook Page Based on Your Profile.
    2. Click on the “Get Started” button.
    3. Select the appropriate category for your business page.
    4. Select the “Friends” and “Followers” for your page.
    5. Select the “Videos”, “Photos” and the “Albums’ for your page.
    6. Finally, click on the “Create Page” button.

Once you have converted to a page then the addon will be able to retrieve and display all of your posts.

Link your instagram to facebook

Before you start you need to do something very first to work with the Instagram feed.

Essentials setups you need.

  1. You have an Instagram creator account or Instagram business account.
  2. Need to connect the Facebook page to that account.

Set up a Business Account on Instagram.

First of all, download the Instagram app on your mobile and create an account.

Follow the steps to create the Instagram account.

If you have a personal account then convert it to a business account. It is a must to have a business account to link with Facebook.

To convert your personal profile to a business account.

  1. First, go to the profile and tap on the  icon in upper right corner.
  2. Tap on settings  icon.
  3. Tap on the account.
  4. Tap switch on Switch to professional account.
  5. Tap on business.
  6. If you’d like, you can follow the steps to connect your business account to a Facebook Page associated with your business. This step is optional and will make it easier to use all of the features available for businesses across the Facebook family of apps. At this time, only one Facebook Page can be connected to your business account.
  7. Add your business category and contact information.
  8. Now Instagram setup is completed. Move to the further steps to connect with the Facebook account.

Connect Facebook page to the account.

  1. First, Select your Facebook page Or Create new page if you had not created yet.
  2. Select “Settings” from the menu.
  3. Select “Instagram” from the menu.
  4. Now select “Connect Account” to add an Instagram account. Login into your Instagram account. Till now you have not converted your personal account into the business you will be prompted.
  5. Also, you can remove your Instagram account anytime by selecting the “Disconnect Account”.

Authenticate Instagram Facebook Graph API

Steps to create the App and authenticate Instagram Facebook Graph API.

  1. Go to All Apps – Facebook for Developers.
  2. Click on the “Create App” button.
  3. Select the “For Everything Else” option.
  4. Enter the name of the app and click on “Create App ID”.
  5. Complete the security check and click on the “Submit” button.
  6. Add the “Facebook Login” product so click on the “Set Up” button of that product.
  7. Go to the “PRODUCTS > Facebook Login > Settings”.
  8. Open smart social feed addon in the ExpressionEngine admin. Click on the “Create New” button.
  9. Enter the title for the setting and click on the “Instagram Settings (Facebook API)” tab.
  10. Copy the URL of “Set OAuth Redirect URI” of addon setting and paste to the “Valid OAuth Redirect URIs” textbox of the settings of the “Facebook Login” product.
  11. Go to the “Settings > Basic” of the app. Copy “App ID” from the basic page of the app.
  12. Paste “App ID” to the “Application ID” of the addon setting.
  13. Click on the “Show” button of the “App Secret” input field.
  14. Enter the password of your Facebook account and click on the “Submit” button.
  15. Copy “App Secret” from the basic page of the app.
  16. Paste “App Secret” to the “Application Secret” of the addon setting.
  17. Click on the “Get User Token” button of the addon setting. One popup is opened and provides permission in it so the “Application User Token” input field fills up automatically.
  18. Click on the “Submit” button of the addon setting.

Instruction

  1. Your app must be in the “In development” mode.
  2. Your site must have SSL.

Installation

Follow below steps to install Smart Social Feed version:

EE4 and EE5:

  1. Download and Extract ZIP file of the module. (We recommend to use the latest version.)
  2. Copy Smart_Social_Feed > system > user > addons > smart_social_feed folder to “Your Site > system > user > addons” Folder.
  3. Copy Smart_Social_Feed > themes > user > smart_social_feed folder to “Your Site > themes > user” Folder.
  4. Login to backend panel with Super admin credentials.
  5. Go to “Developer > Add-Ons” and Install Smart Social Feed module.

Note: If you purchased the addon from Devot:ee then you can get the license key from the licenses tab in your profile.

Social Feed

Social Feed List allows to create or edit Social media feeds as per your requirements.
You can create a new feed just by clicking on CREATE NEW button.
Also, you can edit and manage the previously created feeds with ease.

Create feeds for social platforms like Facebook, Twitter, Instagram, YouTube, Vimeo with ease.Once created it will be displayed in the row of the table.

Social Feed List (Default view)


It contains five columns. These are listed below in detail.

  1. ID
    This column contains the ID of the created feed. This is used for parameter feed_id in tags for creating feed.
  2. Label
    This column consists of the name of the already created feeds.
  3. Short Name
    This column contains the short name of the created feed. This is used for parameter feed_name in tags for creating feed.
  4. Manage
    It has three sub elements:

    1. Edit:
      This is used to edit the previously created feed.
    2. Synchronize feed:
      This is used to call API again and save data to the database.
      So every time synchronize is clicked the api is called and data is fetched again and save to the database by removing previously saved data.
    3. Clear cache :
      It helps in removing the cached data from the database which was saved during the call to API.
  5. Multiple Delete
    The already created feeds can be deleted using this option.
    Check the feeds that need to be omitted. now, select “remove” which will appear as soon as the feed is checked.
    Apply submit to complete the process.

Facebook

Social Feed List allows you to create or edit Facebook feeds in an easy way. CREATE NEW button helps in creating the required feed. Here, you can easily manage the previously created feed.

You can edit or modify the fields whenever required.

Smart Social Feed:Facebook (Default view)

There are multiple fields that can be changed as per your requirements. Details about those fields are mentioned below:

  1. Important URLs:
    Important URLs contains two sub-links.

    1. Generate Credentials from here.
    2. Click on this link to generate your Application ID and Application Secret for Facebook app.

    3. More information about this here

    This section provides further details regarding the usage of the Facebook feature in this addon.

  2. Application ID:
    This field contains your Facebook Application ID which is generated by your Facebook app.
  3. Application Secret:
    This field must contain your Facebook Application Secret which is generated by your facebook app.
  4. Facebook page ID:
    This section contains your facebook page ID whose feed you want to fetch. In case, you do not have a Facebook ID, get one with the help of the link present below this field. .
  5. Limit to page posts:
    This field allows you to fetch data which is only posted or published by the page. In case you want this feature, select yes or no otherwise.
  6. Types of feed:
    This field contains multiple options to fetch the selected type of feed from the facebook page. For Instance, select videos option, in case, only the posts related to videos is required. You can select multiple options.
  7. Cache Duration:
    Duration in minutes after which data will be fetched from social sites api call instead of data cached in database. For given duration the data will be return from database that is saved when making first api call to social sites. Default value will be 30 minutes.
  8. Limit:
    Limit to number of posts or data you want to fetch. Default value will be 10.

Twitter

Social Feed List allows you to create or edit Twitter feeds for a given Twitter user in an easy way. CREATE NEW button helps in creating the required feed.

Here, you can easily manage the previously created feed.

Smart Social Feed:Twitter (Default view)

You can edit or modify the fields whenever required. Details about these fields are mentioned below.

  1. Important URLs:
    Important URLs contains two sub-links.

    1. Generate Credentials from here.
    2. Click on this link to generate your Consumer Key(API Key) and Consumer Secret(API Secret) for a Twitter app.

    3. More information about this here
  2. To get further information related to the usage of this addon for Twitter, click on this.

  3. Consumer Key (API Key):
    This field contains your Twitter Consumer Key which is generated from your Twitter app.
  4. Consumer Secret(API Secret):
    This field contains your Twitter Consumer Secret which is generated from your Twitter app.
  5. Twitter Username:
    To get the information related to the tweets of a certain user, this field is used. Enter the Twitter username of that user here.
  6. Include Retweets:
    Select Yes in case you want to fetch the retweets too ,otherwise, go for No option.
  7. Cache Duration:
    Mention the cache duration here only in minutes. During this period, the data is fetched from the database where it was saved while making the first API call to the social media api. After that period, data will again be fetched from API and will be saved to the database. This cycle goes on. The default value of this field is 30 minutes.
  8. Limit:
    It puts a limit on the number of posts or data you want to fetch. The default value is 10 posts.

Instagram

Social Feed List allows you to create or edit Instagram feeds for a given Instagram user in an easy way and also according to your requirement. CREATE NEW button helps in creating the required feed.

Here, you can easily manage the previously created feed.

Smart Social Feed:Instagram (Default view)

Edit or modify the fields whenever required. Details about these fields are mentioned below.

  1. Important URLs:
    Important URLs contains two sub-links.

    1. Generate Credentials from here.
    2. You can generate your CLIENT ID and get REDIRECT URI for Instagram by following this link.

    3. More information about this here.

    To get further information related to the usage of this addon for Instagram , click on this.

  2. Instagram Access Token:
    This field consists of your Instagram access token. In case you do not have your token, generate one from the link mentioned below this label as ‘https://api.instagram.com/oauth/authorize/?client_id=CLIENT-ID&redirect_uri=REDIRECT-URI&response_type=token’ where ‘CLIENT-ID’ and ‘REDIRECT-URI’. Here, replace the ‘CLIENT-ID’ and ‘REDIRECT-URI’ with your Client-ID and Redirect-URI respectively. Get your access token in the url.
  3. Instagram User ID:
    This field contains Instagram User ID of the user whose feeds and posts you want to fetch.
    NOTE: In case you are using sandbox mode for Instagram, then add that user to the sandbox account.
  4. Cache Duration:
    Mention the cache duration here only in minutes. During this period, the data is fetched from the database where it was saved while making the first API call to the social media api. After that period, data will again be fetched from API and will be saved to the database. This cycle goes on. The default value of this field is 30 minutes.
  5. Limit:
    It puts a limit on the number of posts or data you want to fetch. The default value is 10 posts.

Instagram Facebook Graph API

You must have your Instagram Account linked to a Facebook Business Page. If you had not linked yet then you can get more detail about this thing from this “Link your instagram to facebook” page.

Social Feed List allows you to create or edit Instagram feeds for a given Instagram user in an easy way and also according to your requirement. CREATE NEW button helps in creating the required feed.

Check this page “Authenticate Instagram Facebook Graph API” to get each step of the process of authentication for Instagram Facebook graph API.

Here, you can easily manage the previously created feed.

Smart Social Feed:
Instagram Facebook Graph API(Default view)

Edit or modify the fields whenever required. Details about these fields are mentioned below.

  1. Set OAuth Redirect URI:

    You need to add “Set OAuth Redirect URI” URL in “Facebook Login-settings-> Valid OAuth Redirect URLs” of facebook app. Please see below screenshot.


  2. Application ID:

    This field contains Facebook Application ID of the user’app whose feeds and posts you want to fetch.

  3. Application Secret:

    This field contains Facebook Application Secret of the user’s app whose feeds and posts you want to fetch.

  4. Cache Duration:

    Mention the cache duration here only in minutes.
    During this period, the data is fetched from the database where it was saved while making the first API call to the social media api.
    After that period, data will again be fetched from API and will be saved to the database.
    This cycle goes on. The default value of this field is 30 minutes.

YouTube

Social Feed List allows you to create or edit YouTube feeds for a given YouTube channel in an easy way. CREATE NEW button helps in creating the required feed.

Here, you can easily manage the previously created feed also.

Smart Social Feed:YouTube (Default view)

Edit or modify the fields whenever required. Details about these fields are mentioned below.

  1. Important URLs:
    Important URLs contains two sub-links.

    1. Generate Credentials from here.
      Click here to generate your Google API Key.
    2. More information about this here
      Get further details about usage of this addon for YouTube from here.
  2. Channel ID:
    This field must contain your YouTube channel ID. If you dont have channel ID you can fetch it from the link mentioned below.
  3. API Key:
    This field must contain Google API Key.
  4. Cache Duration:
    Mention the cache duration here only in minutes. During this period, the data is fetched from the database where it was saved while making the first API call to the social media api. After that period, data will again be fetched from API and will be saved to the database. This cycle goes on. The default value of this field is 30 minutes.
  5. Limit:
    It puts a limit on the number of posts or data you want to fetch. The default value is 10 posts.

Vimeo

Social Feed List allows you to create or edit Vimeo feeds for a given Vimeo user in an easy way. CREATE NEW button helps in creating the required feed.

Here, you can easily manage the previously created feed also.

Smart Social Feed:Vimeo (Default view)

Edit or modify the fields whenever required. Details about these fields are mentioned below.

  1. Important URLs:
    Important URLs contains two sub-links.

    1. Generate Credentials from here.
      Generate your Access token for Vimeo using this link.
    2. More information about this here
      Get further details about usage of this addon for Vimeo here.
  2. Vimeo Feed Type:
    It gives two options. They are

    1. User Feeds
    2. Channel Feeds

    The selection of an option depends on the type of videos you want to fetch. If you need user-uploaded videos then go for the User Feed, otherwise, select Channel Feed for channel videos.

  3. Vimeo User ID/Vimeo Channel ID:
    This field must contain Vimeo User ID or Vimeo Channel ID which is entirely based on Vimeo Feed Type that you select
    How to get User ID or Channel ID?

Vimeo:User ID

Vimeo:Channel ID

  1. Include Private Videos:
    Select Yes if you also want to include private videos while fetching Videos of the related channel, otherwise select No.
  2. Cache Duration:
    Mention the cache duration here only in minutes. During this period, the data is fetched from the database where it was saved while making the first API call to the social media api. After that period, data will again be fetched from API and will be saved to the database. This cycle goes on. The default value of this field is 30 minutes.
  3. Limit:
    Limit the number of posts or data you want to fetch. The default value is 10.

Custom Sidebar

We provide one “customSidebar” function in the MCP file. You can add more menus in the sidebar of the addon using this function.

/* To get dynamic menu in the addon */    
   function customSidebar(){
       $sidebar = ee('CP/Sidebar')->make();
       $this->navSettings  = $sidebar->addHeader('Test Link', '');
   }

Facebook

You can create or edit a smart social feed for facebook for fetching facebook feeds or posts. Details for the same are shared below.

Tag for facebook feed will look like this.

 {exp:smart_social_feed:pull} Content data {/exp:smart_social_feed:pull}

Parameters

  1. feed_id
  2. feed_name
  3. plateform
  4. order_by
  5. sort

Variables

  1. ssf_id
  2. post_identifier
  3. post_saved_time
  4. post_from_name
  5. post_from_id
  6. post_id
  7. plateform
  8. post_name
  9. post_message
  10. post_description
  11. post_created_time
  12. post_total_likes
  13. post_total_comments
  14. post_total_shares
  15. post_thumbnail_image
  16. post_full_image
  17. post_url
  18. post_story
  19. post_type
  20. post_relative_date
  21. page_source

Following Parameters can be use in Facebook feed

feed_id

Feed id of Feeds made from backend.

Example:

 feed_id = "5"

feed_name

Name of feed being created from backend.

Example:

 feed_name = "social_feed"

plateform

Select plateforms if data to be displayed of specific plateform.

Example:

 plateform = "facebook|twitter|instagram|youtube|vimeo"

order_by

This parameter is used to order the data by certain column .

Example:

 order_by = "ssf_id"

sort

This parameter is used to sort the fetched data. Default sorting is descending. You can either sort ascending,descending or random. ASC for ascending , DESC for descending and RAND for random.

Example:

{exp:smart_social_feed:pull feed_id="1" }
    {if no_results}<p>No results!</p>{/if}
    {if count == 1}
    <div class="feed-wrapper">
    {/if}
        <p>count              : {count}</p>
        <p>Total Results      : {total_results}</p>
        <p>id                 : {id}</p>
        <p>plateform          : {plateform}</p> //current plateform (i.e., facebook)
        <p>SSF Id             : {ssf_id}</p>
        <p>Post Identifier    : {post_identifier}</p>
        <p>Post  Saved Time   : {post_saved_time format="%d-%m-%Y"}</p>
        <p>Post Id            : {post_id}</p>
        <p>Post From Name     : {post_from_name}</p>
        <p>Post From Id       : {post_from_id}</p>
        <p>Post Name          : {post_name}</p>
        <p>Post Message       : {post_message}</p>
        <p>Post Description   : {post_description}</p>
        <p>Post Created Time  : {post_created_time}</p>
        <p>Relative Date      : {post_relative_date}</p>
        <p>Total Likes        : {post_total_likes}</p>
        <p>Total Comments     : {post_total_comments}</p>
        <p>Total Shares       : {post_total_shares}</p>
        {if post_thumbnail_image} // get thumbnail image 
        <p>Thumbnail Image    : <img src="{post_thumbnail_image}"></p>
        {/if}
        {if post_full_image} // get full image 
        <p>Full Image    : <img src="{post_full_image}"></p>
        {/if}
        <p>Post Url           : {post_url}</p>
        <p>Post Story         : {post_story}</p>
        <p>Post Type          : {post_type}</p>
        {if post_type == "video" && post_source != ""} // Return video URL
        <div>
            <iframe src="{post_source}"></iframe>
        </div>
        {/if}
    {if count == total_results}
    </div>
    {/if}
{/exp:smart_social_feed:pull}

Twitter

You can create or edit a smart social feed for twitter for fetching twitter feeds or tweets. Details for the same are shared below.

Tag for twitter feed will look like this.

 {exp:smart_social_feed:pull} Content data {/exp:smart_social_feed:pull}

Parameters

  1. feed_id
  2. feed_name
  3. plateform
  4. order_by
  5. sort

Variables

  1. ssf_id
  2. post_identifier
  3. post_saved_time
  4. plateform
  5. post_from_name
  6. post_from_id
  7. post_id
  8. post_description
  9. post_created_time
  10. favorite_count
  11. retweet_count
  12. geo
  13. coordinates
  14. place
  15. post_relative_date
  16. post_video

Following Parameters can be use in Twitter feed

feed_id

Feed id of Feeds made from backend.

Example:

 feed_id = "5"

feed_name

Name of feed being created from backend.

Example:

 feed_name = "social_feed"

plateform

Select plateforms if data to be displayed of specific plateform.

Example:

 plateform = "facebook|twitter|instagram|youtube|vimeo"

order_by

This parameter is used to order the data by certain column .

Example:

 order_by = "ssf_id"

sort

This parameter is used to sort the fetched data. Default sorting is descending. You can either sort ascending,descending or random. ASC for ascending , DESC for descending and RAND for random.

Example:

 sort = "ASC"

Example:

{exp:smart_social_feed:pull feed_id="1" }
    {if no_results}<p>No results!</p>{/if}
    {if count == 1}
    <div class="feed-wrapper">
    {/if}
        <p>count              : {count}</p>
        <p>Total Results      : {total_results}</p>
        <p>id                 : {id}</p>
        <p>plateform          : {plateform}</p>  //current plateform (i.e., twitter)
        <p>SSF Id             : {ssf_id}</p>
        <p>Post Identifier    : {post_identifier}</p>
        <p>Post  Saved Time   : {post_saved_time format="%d-%m-%Y"}</p>
        <p>Post Id            : {post_id}</p>
        <p>Post From Name     : {post_from_name}</p>
        <p>Post From Id       : {post_from_id}</p>
        <p>Post Description   : {post_description}</p>
        <p>Post Created Time  : {post_created_time}</p>
        <p>Total Favorites    : {favorite_count}</p>
        <p>Total Retweets     : {retweet_count}</p>
        <p>Geo                : {geo}</p>
        <p>Coordinates        : {coordinates}</p>
        <p>Place              : {place}</p>
        <p>Post type          : {post_type}</p>

        {if plateform == "twitter"} // Give you proper relative date. (i.e., 2m, 6h, 2days etc.)
        <p>Relative Date      : {post_relative_date}</p>
        {/if}

        {if post_full_image} // If any image uploaded in tweets
        <p>Post full image    : <img src="{post_full_image}"></p>
        {/if}
        
        {if post_url} // give post URL if post type is video, photo or GIF
        <p>Post url           : {post_url}</p>
        {/if}
        
        {if post_type == "video" && post_video != ""} // Return video URL if uploaded in tweets
        <div>
            <iframe src="{post_video}"></iframe>
        </div>
        {/if}
    {if count == total_results}
    </div>
    {/if}
{/exp:smart_social_feed:pull}

Instagram

You can create or edit a smart social feed for instagram for fetching instagram feeds or posts. Details for the same are shared below.

Tag for instagram feed will look like this.

 {exp:smart_social_feed:pull} Content data {/exp:smart_social_feed:pull}

Parameters

  1. feed_id
  2. feed_name
  3. plateform
  4. order_by
  5. sort

Variables

  1. ssf_id
  2. post_identifier
  3. post_saved_time
  4. plateform
  5. post_from_name
  6. post_from_id
  7. post_id
  8. post_created_time
  9. post_total_likes
  10. post_total_comments
  11. post_thumbnail_image
  12. post_full_image
  13. post_url
  14. post_relative_date
  15. post_video
  16. post_description
  17. post_type
  18. post_carousel

Following Parameters can be use in Instagram feed

feed_id

Feed id of Feeds made from backend.

Example:

 feed_id = "5"

feed_name

Name of feed being created from backend.

Example:

 feed_name = "social_feed"

plateform

Select plateforms if data to be displayed of specific plateform.

Example:

 plateform = "facebook|twitter|instagram|youtube|vimeo"

order_by

This parameter is used to order the data by certain column .

Example:

 order_by = "ssf_id"

sort

This parameter is used to sort the fetched data. Default sorting is descending. You can either sort ascending,descending or random. ASC for ascending , DESC for descending and RAND for random.

Example:

 sort = "ASC"

Example:

{exp:smart_social_feed:pull feed_id="1" }
    {if no_results}<p>No results!</p>{/if}
    {if count == 1}
    <div class="feed-wrapper">
    {/if}
        <p>count                   : {count}</p>
        <p>Total Results           : {total_results}</p>
        <p>id                      : {id}</p>
        <p>plateform               : {plateform}</p> //current plateform (i.e., instagram)
        <p>SSF Id                  : {ssf_id}</p>
        <p>Post Identifier         : {post_identifier}</p>
        <p>Post  Saved Time        : {post_saved_time format="%d-%m-%Y"}</p>
        <p>Post Id                 : {post_id}</p>
        <p>Post From Name          : {post_from_name}</p>
        <p>Post From Id            : {post_from_id}</p>
        <p>Post Created Time       : {post_created_time}</p>
        <p>Relative Date           : {post_relative_date}</p>
        <p>Total Likes             : {post_total_likes}</p>
        <p>Total Comments          : {post_total_comments}</p>
        <p>Post thumbnail Image    : {post_thumbnail_image}</p>
        <p>Post Full Image         : {post_full_image}</p>
        <p>Post URL                : {post_url}</p>

        //New Variables added in v1.1.7
        <p>Post Video              : {post_video}</p>
        <p>Post Description        : {post_description}</p>
        <p>Post Type               : {post_type}</p> // video, image, carousel
        <div>
            Post Carousel          : 
            {post_carousel}
                {if post_carousel:count == 1}<div>{/if} // Count variable
                {post_carousel:type} // video, image
                {post_carousel:url} // Video or Image URL
                {if post_carousel:count == post_carousel:total_results}</div>{/if} // Count variable
            {/post_carousel}
        </div>
    {if count == total_results}
    </div>
    {/if}
{/exp:smart_social_feed:pull}

Instagram Facebook Graph API

You can create or edit a smart social feed for instagram for fetching instagram feeds or posts. Details for the same are shared below.

Tag for instagram feed will look like this.

 {exp:smart_social_feed:pull} Content data {/exp:smart_social_feed:pull}

Parameters

  1. feed_id
  2. feed_name
  3. plateform
  4. order_by
  5. sort

Variables

  1. ssf_id
  2. post_identifier
  3. post_saved_time
  4. plateform
  5. post_from_name
  6. post_from_id
  7. post_id
  8. post_created_time
  9. post_total_likes
  10. post_total_comments
  11. post_thumbnail_image: This variable gives result only for “VIDEO” type of feed.
  12. post_full_image
  13. post_url
  14. post_relative_date
  15. post_video
  16. post_description
  17. post_type
  18. post_carousel

Following Parameters can be use in Instagram feed

feed_id

Feed id of Feeds made from backend.

Example:

 feed_id = "5"

feed_name

Name of feed being created from backend.

Example:

 feed_name = "social_feed"

plateform

Select plateforms if data to be displayed of specific plateform.

Example:

 plateform = "facebook|twitter|instagram|youtube|vimeo"

order_by

This parameter is used to order the data by certain column .

Example:

 order_by = "ssf_id"

sort

This parameter is used to sort the fetched data. Default sorting is descending. You can either sort ascending,descending or random. ASC for ascending , DESC for descending and RAND for random.

Example:

 sort = "ASC"

Example:

{exp:smart_social_feed:pull feed_id="1" }

    {if no_results}<p>No results!</p>{/if}

    {if count == 1}

    <div class="feed-wrapper">

    {/if}

        <p>count                   : {count}</p>

        <p>Total Results           : {total_results}</p>

        <p>id                      : {id}</p>

        <p>plateform               : {plateform}</p> //current plateform (i.e., instagram)

        <p>SSF Id                  : {ssf_id}</p>

        <p>Post Identifier         : {post_identifier}</p>

        <p>Post  Saved Time        : {post_saved_time format="%d-%m-%Y"}</p>

        <p>Post Id                 : {post_id}</p>

        <p>Post From Name          : {post_from_name}</p>

        <p>Post From Id            : {post_from_id}</p>

        <p>Post Created Time       : {post_created_time}</p>

        <p>Relative Date           : {post_relative_date}</p>

        <p>Total Likes             : {post_total_likes}</p>

        <p>Total Comments          : {post_total_comments}</p>

        <p>Post thumbnail Image    : {post_thumbnail_image}</p>

        <p>Post Full Image         : {post_full_image}</p>

        <p>Post URL                : {post_url}</p>


        //New Variables added in v1.1.7

        <p>Post Video              : {post_video}</p>

        <p>Post Description        : {post_description}</p>

        <p>Post Type               : {post_type}</p> // video, image

    {if count == total_results}

    </div>

    {/if}

{/exp:smart_social_feed:pull}

YouTube

You can create or edit a smart social feed for YouTube for fetching YouTube feeds or videos. Details for the same are shared below.

Tag for YouTube feed will look like this.

 {exp:smart_social_feed:pull} Content data {/exp:smart_social_feed:pull}

Parameters

  1. feed_id
  2. feed_name
  3. plateform
  4. order_by
  5. sort

Variables

  1. ssf_id
  2. post_identifier
  3. post_saved_time
  4. plateform
  5. post_from_name
  6. post_from_id
  7. post_id
  8. post_name
  9. post_description
  10. post_created_time
  11. post_thumbnail_image
  12. post_full_image
  13. post_url
  14. youtube_embed
  15. post_relative_date
  16. post_video

Following Parameters can be used in YouTube feed

feed_id

Feed id of Feeds made from backend.

Example:

 feed_id = "5"

feed_name

Name of feed being created from backend.

Example:

 feed_name = "social_feed"

plateform

Select plateforms if data to be displayed of specific plateform.

Example:

 plateform = "facebook|twitter|instagram|youtube|vimeo"

order_by

This parameter is used to order the data by certain column .

Example:

 order_by = "ssf_id"

sort

This parameter is used to sort the fetched data. Default sorting is descending. You can either sort ascending,descending or random. ASC for ascending , DESC for descending and RAND for random.

Example:

 sort = "ASC"

Example:

{exp:smart_social_feed:pull feed_id="1" }
    {if no_results}<p>No results!</p>{/if}
    {if count == 1}
    <div class="feed-wrapper">
    {/if}
        <p>count                   : {count}</p>
        <p>Total Results           : {total_results}</p>
        <p>id                      : {id}</p>
        <p>plateform               : {plateform}</p>  //current plateform (i.e., youtube)
        <p>SSF Id                  : {ssf_id}</p>
        <p>Post Identifier         : {post_identifier}</p>
        <p>Post  Saved Time        : {post_saved_time format="%d-%m-%Y"}</p>
        <p>Post Id                 : {post_id}</p>
        <p>Post From Name          : {post_from_name}</p>
        <p>Post From Id            : {post_from_id}</p>
        <p>Post Created Time       : {post_created_time}</p>
        <p>Relative Date           : {post_relative_date}</p>
        <p>Post Description        : {post_description}</p>
        <p>Post thumbnail Image    : {post_thumbnail_image}</p>
        <p>Post Full Image         : {post_full_image}</p>
        <p>Post URL                : {post_url}</p>
        <p>Youtube Embed           : {post_video}</p>
    {if count == total_results}
    </div>
    {/if}
{/exp:smart_social_feed:pull}

Vimeo

You can create or edit a smart social feed for YouTube for fetching YouTube feeds or videos. Details for the same are shared below.

Tag for youtube feed will look like this.

 {exp:smart_social_feed:pull} Content data {/exp:smart_social_feed:pull}

Parameters

  1. feed_id
  2. feed_name
  3. plateform
  4. order_by
  5. sort

Variables

  1. ssf_id
  2. post_identifier
  3. post_saved_time
  4. plateform
  5. post_from_id
  6. post_id
  7. post_name
  8. post_description
  9. post_created_time
  10. post_total_likes
  11. post_total_comments
  12. post_thumbnail_image
  13. post_full_image
  14. vimeo_embed
  15. post_url
  16. post_relative_date
  17. post_video

Following Parameters can be used in Vimeo feed

feed_id

Feed id of Feeds made from backend.

Example:

 feed_id = "5"

feed_name

Name of feed being created from backend.

Example:

 feed_name = "social_feed"

plateform

Select plateforms if data to be displayed of specific plateform.

Example:

 plateform = "facebook|twitter|instagram|youtube|vimeo"

order_by

This parameter is used to order the data by certain column .

Example:

 order_by = "ssf_id"

sort

This parameter is used to sort the fetched data. Default sorting is descending. You can either sort ascending,descending or random. ASC for ascending , DESC for descending and RAND for random.

Example:

 sort = "ASC"

Example:

{exp:smart_social_feed:pull feed_id="1" }
    {if no_results}<p>No results!</p>{/if}
    {if count == 1}
    <div class="feed-wrapper">
    {/if}
        <p>count                   : {count}</p>
        <p>Total Results           : {total_results}</p>
        <p>id                      : {id}</p>
        <p>plateform               : {plateform}</p>    //current plateform (i.e., vimeo)
        <p>SSF Id                  : {ssf_id}</p>
        <p>Post Identifier         : {post_identifier}</p>
        <p>Post  Saved Time        : {post_saved_time format="%d-%m-%Y"}</p>
        <p>Post Id                 : {post_id}</p>
        <p>Post Name               : {post_name}</p>
        <p>Post From Id            : {post_from_id}</p>
        <p>Post Description        : {post_description}</p>
        <p>Post Created Time       : {post_created_time}</p>
        <p>Relative Date           : {post_relative_date}</p>
        <p>Post Likes              : {post_total_likes}</p>
        <p>Post Comments           : {post_total_comments}</p>
        <p>Post thumbnail Image    : {post_thumbnail_image}</p>
        <p>Post Full Image         : {post_full_image}</p>
        <p>Post URL                : {post_url}</p>
        <p>Post Vimeo Embed        : {post_video}</p>
    {if count == total_results}
    </div>
    {/if}
{/exp:smart_social_feed:pull}

Changelog

V1.2.0

  • To match permission modal changes of Instagram, We have integrated same permission within the module functionality in our addon for Instagram feed. Sandbox invite user feed is no longer work with Instagram API. You have to generate app from client’s Instagram to show their feed.

V1.1.9

  • Facebook and Instagram announced a slew of API shutdowns and changes designed to stop developers from being able to pull your data or your friends’ data without express permission, drag in public content or trick you into sharing. We have added permission modal withing the addon so one can now add client ID and client secret of Facebook and click a single button to get access token withing the addon. You can only access feed of user whose API you are using and only after approve permission.

V1.1.8

  • Add scope list in generate token URL for Instagram so user authorize full content access.
  • Trim all setting information so if accidentally user pass key or secret with blank spaces, it won’t give error.
  • Module uses file_get_contents( ) function to grab third party feeds. It will only work if allow_url_fopen variable is set ON from php.ini. We have put error message if this variable is not enabled in server.
  • In Instagram feeds, You can only fetch data of Public account. We have add a notice message for that in form.

V1.1.7

  • Solved a bug where Instagram feed not saves post creation time in database. (And because of this use was not able to get post relative date.)
  • Added backend filter field for Instagram form to restrict API data by post type. (i.e., image, video, Carousel).
  • Add new fields for Instagram feed.
     {post_video}, {post_description}, {post_type}, {post_carousel} {!-- data --}{/post_carousel}

V1.1.6

  • Solved a bug where Twitter description and URLs have non UTF-8 characters (Symbols) instead of actual data sometimes.

V1.1.5

  • New design layout to match all backend design with EE3 and EE4.
  • Resolve a bug where front-end tags was showing one empty row instead of moving to NO_RESULTS state if API key and Secret is valid but there is no data in users social account to display.
  • Resolve a bug where in back-end setting page it was giving PHP notice sometimes.
  • Change database Field Types to “text” for some of the fields from “varchar” and “mediumtext”.

V1.1.4

  • Added new variables for Twitter
     {post_full_image}, {post_url}, {post_type}, {post_twitter_video}

V1.1.3

  • Solved a bug where if feed not fetch any data via backend sync button, It will give you success message.
  • Solved a bug where after error on backend social feed settings page it submitted a new form instead of edit the same form.
  • Solved a bug where custom_validation library conflict with other ZealousWeb modules.
  • Module is now available in EE2 ( > EE2.8.0 )

V1.1.2

  • Added Facebook settings that will give option to user to fetch feeds of his own posts or any posts in his page.
  • Updated information links to module that locate user to documentation.

V1.5.0

  • Added New Instagram Facebook graph API compatibility.

V1.6.1

  • Removed the two invalid scops: manage_pages, publish_pages.

V2.0.0

  • Upgradation work for the Facebook like remove the deprecated fields and disabled the user feed option and provide detail to convert the profile to the page.
  • Updated the license verification process and setup so please update the license in your addon.

V2.0.1

  • Fix bug of pulling the duplicate posts for Instagram.

Loading your cart...