49
$15
Add to project

Product support

Visit this product's website for support.

Categories

About

Adds the ability to display and interact with a Facebook Page feed. Posts are pulled from Facebook and stored locally in the database before being rendered by the Feed component allowing you to precisely control what appears on your website.

This plugin will save you ~15 hours of development by greatly simplifying the experience of getting setup with a FB Page Access Token, syncing the FB feed with your website, and providing a clean backend interface for precise control over the posts displayed on your site.

Syncing your feeds

All feeds are synced daily by default. You can change the frequency of the syncing process by overriding the plugin's configuration by copying the default configuration file (in yourproject/plugins/luketowers/easyfacebookfeed/config/config.php) to yourproject/config/luketowers/easyfacebookfeed/config.php and changing the configuration as desired.

NOTE: In order for automatic syncing to occur you must have setup the scheduler when you installed OctoberCMS.

You are also able to run the following console command to manually sync all or specific feeds as desired:

php artisan facebook:sync code-for-feed --full

By default running the command without providing a specific feed (via code-for-feed) will sync all of your feeds. Also, by default (unless you have passed the --full option), the sync will be a shallow one; i.e. only the 100 most recent posts are synced. If you pass --full, all posts will be synced.

Frontend feed displayed in theme

Installation

To install from the Marketplace, click on the "Add to Project" button and then select the project you wish to add it to and pay for the plugin. Once the plugin has been added to the project, go to the backend and check for updates to pull in the plugin.

To install from the backend, go to Settings -> Updates & Plugins -> Install Plugins and then search for LukeTowers.EasyFacebookFeed.

After installing the plugin you will need to setup at least one feed to get started. Go to example.com/backend/luketowers/easyfacebookfeed/feeds to setup your first feed. Click the "New Feed" button and follow the instructions to get your Facebook Page ID, App ID, App Secret, and Page Access Token.

NOTE: In order for automatic syncing to occur you must have setup the scheduler when you installed OctoberCMS. If you haven't already, make sure you do so as a part of the installation process for this plugin.

Component: Facebook Feed (fbFeed)

Purpose

Displays a feed of posts from a Facebook page.

Configuration:

Property Inspector Name Description
feed Feed The ID of the pre configured Facebook Page Feed to use
limit Maximum posts to display The maximum number of posts to display from the feed at once
types Types of posts to display The types of posts that should be displayed from the selected feed.
order Post order The order that the posts should be displayed in. Options are desc (Newest first), asc (Oldest first), or random (Random order)

Type Options:

Code Description
album Photo albums
event Events
map Shared location posts
multi_share Shared posts
photo Photos
share Links
status Posts
video_inline Videos

Component properties

Variable Type Description
__SELF__.items Collection Collection of LukeTowers\EasyFacebookFeed\Models\FeedItem models representing the feed items

Default output

The default component partial outputs a containing div that holds a separatly rendered div for each item in the feed depending on that item's type:

<div class="fbfeed_container">
    {% for item in __SELF__.items %}
        <div class="fbfeed-item item-{{ item.type }}">
            {% partial '@item-' ~ item.type ~ '.htm' item=item %}
        </div>
    {% endfor %}
</div>

Overriding either the default partial or any of the item type specific partials for your specific use case is easy by following the OctoberCMS documentation.

  • Found the plugin useful on 17 Jun, 2020

    A great plugin! Saved a huge amount of development time

    The authentication/setup steps may need some tweaking as Facebook has updated their token generation GUI. Make sure you select the correct Facebook app and set the Token Type to "User Token"

  • author

    Replied on 18 Jun, 2020

    Thanks! I've got an update to the plugin coming in the next couple days that actually improves the setup steps a bit already so I'll be sure to add those comments in!

  • Found the plugin useful on 16 Dec, 2019

    Awesome plugin just saved me HOURS of work. Facebook api seems to get more and more convoluted and this plugin definitely makes light work of getting a workable, styled feed onto a page. The ability to hide and pin posts in the backend was very well received by the client too. EXCELLENT job Mr Towers!

  • Found the plugin useful on 10 Sep, 2019

    I am getting this error.

    "(#10) To use 'Page Public Content Access', your use of this endpoint must be reviewed and approved by Facebook."

    It seems like plugin functionality is only available with business verification and tons of other stuff on fb side. And all I want to do is to display my own fb page for gods sake. Never mind.

  • author

    Replied on 10 Sep, 2019

    Instead of posting a review, post an issue on the support link and you'll actually get help with your issue.

    You need to follow the setup instructions using an account that has admin access to the page. If you do that then you will get a token that allows you access to that specific page. If you want to have a generic token that allows access to all public pages, then yes, you have to go through business verification; but if you follow all the steps using an account that has access to a specific page then it works just fine for that page alone.

  • Found the plugin useful on 4 Sep, 2019

    Great plugin, easy configuration and excellent support!

  • Please login to rate the plugin or write a review.
1.1.0

Item featured images are now stored locally, added ability to "resync" individual feed items, made some improvements to the Setup step

Jun 19, 2020
1.0.6

Minor performance improvement by removing an unnecessary query from the Feed component

May 13, 2020
1.0.5

Removed dependency on Font Awesome from the default styling

Nov 25, 2019
1.0.4

Updated links to FindMyFBID in the setup instructions

Sep 08, 2019
1.0.3

Added ability to choose whether to fully sync a feed on creation or just the most recent 100 posts

Sep 04, 2019
1.0.2

Improved handling of invalid data from Facebook

Sep 02, 2019
1.0.1

First version of EasyFacebookFeed

Jul 13, 2019