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.
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.
-
Nick Humphries
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"
-
Luke Towers 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!
-
Gavin Foster
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!
-
johny chodec
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.
-
Luke Towers 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.
-
Cy Messenger
Found the plugin useful on 4 Sep, 2019
Great plugin, easy configuration and excellent support!
-
1.1.2 |
Fixed a bug where not finding the defined feed would cause the page to crash Oct 22, 2020 |
---|---|
1.1.1 |
Added ability to use the feed code instead of the ID when configuring the Feed component Oct 21, 2020 |
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 |