=== Social Post Feed - Smash Balloon ===
Contributors: smashballoon, craig-at-smash-balloon
Tags: Facebook, Facebook feed, Facebook posts, Facebook group, Facebook page, Facebook wall
Requires at least: 3.0
Requires PHP: 5.2
Tested up to: 5.4
Stable tag: 2.15
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Formerly "Custom Facebook Feed". Display completely customizable Facebook feeds of any public Facebook page or Group.

== Description ==

Display Facebook posts on your WordPress site. **Completely customizable**, **responsive** and **search engine crawlable** Facebook feeds. Display **unlimited feeds** from **any public Facebook page** or your **Facebook Group**, and completely match the look and feel of your site with tons of customization options!

### Facebook Feed Features
**Super Simple to Set Up**
One of our main priorities has always been to make our Facebook plugin as easy as possible to setup and use. Get up and running in less less than 1 minute with our signature quick setup - no Facebook Developer App required.

**Display Feeds from ANY Facebook Page or Your Facebook Group**
Use the plugin to display feeds from any public page - even pages you aren't an admin of - or from any group that you are an admin of.

**Completely Customizable**
By default the feed will adopt the styles of your WordPress theme, but your feeds can be completely customized to look however you like - with tons of options to customize every part of your posts and feed.

**SEO Friendly**
The Facebook feed content is crawlable by search engines adding SEO value to your site, while other Facebook plugins embed the feed using iframes which are not crawlable.

**Responsive and Mobile Optimized**
Feed layouts look great on any screen size and in any container width.

**Unlimited Feeds from Unlimited Different Facebook Pages**
We don't limit how many feeds you can display on your site. Just use the shortcode to embed as many feeds as you like into pages, posts or widgets anywhere on your site.

**Built for Speed**
Built-in caching means that your Facebook feeds load lightning fast. Set your own caching time - check for new posts every few seconds, minutes, hours or days. You decide.

**Like Box Widget and Visual Header**
Include the official Facebook Like Box widget at the top or bottom of your feed and display a beautiful visual header with your page or group cover photo, profile picture, bio, and number of likes.

**So Much More**
Show and hide certain parts of each post, choose whose posts to show in the feed, customize colors, font sizes and styles, the number of posts to display, set max text lengths, translate text, custom CSS, and much, much more.

### Pro Version (Custom Facebook Feed Pro)

This free plugin allows you to display text and links from Facebook posts. In order to maintain the plugin on an ongoing basis, and to provide quick and effective support for free, we offer a Pro version of the plugin which allows you to display photos and videos, the number of likes, shares, reactions and comments for posts in each Facebook feed, choose from multiple layout options, filter posts by type or #hashtag/string, load more posts into your feed, and more. [Click here](https://smashballoon.com/differences-between-the-free-version-and-pro-version-of-the-custom-facebook-feed-plugin/ "Differences between free and Pro version of Custom Facebook Feed plugin") for a full list of all differences between the free and Pro versions.

* [Find out more about the Pro version](https://smashballoon.com/custom-facebook-feed/?utm_campaign=facebook-free-readme&utm_source=proversion&utm_medium=findout "Pro Version")
* [Try out the Pro demo](https://smashballoon.com/custom-facebook-feed/demo/?utm_campaign=facebook-free-readme&utm_source=proversion&utm_medium=demo "Pro Demo").

### Benefits of Displaying a Facebook Feed on Your Website

* **Increase social engagement** between you and your users, customers, or fans
* **Save time** by using the plugin to generate dynamic, search engine crawlable content on your website
* **Get more likes** by displaying your Facebook content directly on your site
* **Improve your SEO** as all of that quality keyword-rich Facebook content from posts and comments is directly embedded into your website
* Display your Facebook content your way to perfectly match your website's style
* **No Coding Required** - choose from tons of built-in customization options to create a truly unique feed of your Facebook content.
* The plugin is **updated regularly** with new features, bug-fixes and API changes
* Support is quick and effective
* We're dedicated to providing the **most customizable**, **robust** and **well supported** Facebook feed plugin in the world!

### How to use the plugin

Once you've installed the plugin there are only a few steps to get up and running:

1) Use the button on the 'Facebook Feed' settings page to log into your Facebook account and authorize the plugin.
2) Save the plugin settings and add the `[custom-facebook-feed]` shortcode to any page, post, or widget where you want the feed to be displayed.

That's it!  You can then customize the feed as needed using the settings on the Customize page.

For full step-by-step setup directions with screenshots, see [here](https://smashballoon.com/custom-facebook-feed/docs/free/?utm_campaign=facebook-free-readme&utm_source=howto&utm_medium=setup "Free Setup Doc").

### Requesting support

Customer support is a huge deal to us. We pride ourselves on always providing quick, effective, and courteous support to all of our users. If you're having an issue using the plugin then just let us know and we'll be there to help as soon as possible.  You can either open a ticket on the support forum on [WordPress.org](https://wordpress.org/support/plugin/custom-facebook-feed/ "Support forum"), or directly on [our website](https://smashballoon.com/custom-facebook-feed/support/ "Support form").  We also have a large collection of help documentation and FAQs [on our website](https://smashballoon.com/custom-facebook-feed/faq/ "Support FAQs") for all common issues related to plugin.

### Who's behind this plugin?

We're Smash Balloon; a fun-loving WordPress plugin development company birthed into existence in early 2013. We specialize in creating social media plugins that are not only intuitive and simple to use, but also designed to integrate seamlessly into your website and allow you to display your social media content in powerful and unique ways. Over 1 million awesome people have decided to actively use our free plugins, which is an incredible honor that we don't take lightly. This compels us to try to provide the quickest and most effective customer support that we can, blowing users away with the best customer service they've ever experienced.

To find out more about the team, see [here](https://smashballoon.com/about/?utm_campaign=facebook-free-readme&utm_source=who&utm_medium=about "Team Smash Balloon"), or check out our other free plugins for [Instagram](https://wordpress.org/plugins/instagram-feed "Instagram Feed free plugin"), [Twitter](https://wordpress.org/plugins/custom-twitter-feeds/ "Custom Twitter Feeds free plugin"), and [YouTube](https://wordpress.org/plugins/feeds-for-youtube/ "Feeds for YouTube free plugin").

== Installation ==

1. Install the plugin either via the WordPress plugin directory, or by uploading the files to your web server (in the `/wp-content/plugins/` directory).
2. Activate the plugin through the 'Plugins' menu in WordPress.
3. Navigate to the 'Facebook Feed' settings page to configure your feed.
4. Add the `[custom-facebook-feed]` shortcode to your page, post or widget to display your feed.
5. You can display multiple feeds of different Facebook pages by specifying a Page ID directly in the shortcode: `[custom-facebook-feed id=smashballoon num=5]`.

== Frequently Asked Questions ==

For a full list of FAQs and help with troubleshooting please visit the **[FAQ & Troubleshooting](https://smashballoon.com/custom-facebook-feed/faq/)** section of the Smash Balloon website

= How do I find the Page ID of my Facebook page? =

If you have a **page** with a URL like this: `https://www.facebook.com/smashballoon` then the Page ID is just `smashballoon`. If your page URL is structured like this: `https://www.facebook.com/pages/smashballoon/123654123654123` then the Page ID is actually the number at the end, so in this case `123654123654123`.

Copy and paste the ID into the [Pro demo](https://smashballoon.com/custom-facebook-feed/demo/?utm_campaign=facebook-free-readme&utm_source=faq&utm_medium=demoid) to test it.

= Are there any limitations on which Facebook page or Facebook group feeds I can display? =

The feed you're trying to display has to be from a publicly accessible Facebook page or Facebook group. This means that you can't display the feed from your own personal profile. This is to do with FB privacy policies. You can't display a non-public Facebook feed publicly.

If your Facebook page has any restrictions on it (age, for example) then it means that people have to be signed into FB in order to view your page. This isn't desirable for most FB pages as it means that it isn't accessible by people who don't have a FB account and that your Facebook page can't be crawled and indexed by search engines.

An easy way to determine whether your Facebook page is set to public is to sign out of your FB account and try to visit your page. If Facebook forces you to sign in to view your page then it isn't public. You can change your page to public in your Facebook page settings simply by removing any age or location restrictions you have on it ([screenshot](https://smashballoon.com/wp-content/uploads/2013/06/facebook-page-restrictions.png)), which will then allow the plugin to access and display your feed.

= Can I display feeds from multiple pages? =

You can set your default Facebook Page ID on the plugin settings page within the WordPress admin, you can then define different page IDs in the shortcodes you use to show multiple feeds from different pages. Just use the id option in your shortcode like so: [custom-facebook-feed id=another_page_id]. You can use as many shortcodes as you like with as many different IDs as you like.

= Can I display feeds from a Facebook Group? =

Yep! First, authorize the plugin by using the big blue button on the plugin settings page and then select your Facebook group. You must be a member of the group and an admin of the Facebook group must have installed our app in the group settings. Directions for this are provided when you authorize the plugin via the plugin settings page.

= Can I display the feed from a personal profile? =

Due to FB's privacy policy you're not able to use the plugin to display all of your posts from a personal profile, only from a public page, as posts from a personal profile are protected for privacy reasons. You may have limited success in displaying certain posts from a personal profile but most posts are not able to be displayed.

If you're using the profile to represent a business, organization, product, public figure or the like, then we'd advise converting your profile to a page per [FB's recommendation](http://www.facebook.com/help/175644189234902/), as there are many advantages to using pages over profiles.

Once you've done so, the plugin will be able to retrieve and display all of your posts.

= Can I show photos and videos in my feed? =

This free plugin only allows you to display text from your posts. To display photos and videos in your feed you would need to upgrade to the Pro version of the plugin. Try out a demo of the Pro version on our [website](https://smashballoon.com/custom-facebook-feed/demo/?utm_campaign=facebook-free-readme&utm_source=faq&utm_medium=media "Demo"), and find out more about the Pro version [here](https://smashballoon.com/custom-facebook-feed/?utm_campaign=facebook-free-readme&utm_source=faq&utm_medium=pro "Pro"). [Click here](https://smashballoon.com/differences-between-the-free-version-and-pro-version-of-the-custom-facebook-feed-plugin/ "Differences between free and Pro version") for a full list of all differences between the free version and Pro version.

= Can I show the comments, shares and likes associated with each post? =

This is a feature of the [Pro version of the plugin](https://smashballoon.com/custom-facebook-feed/?utm_campaign=facebook-free-readme&utm_source=faq&utm_medium=comments "Pro Version"). To display comments, shares and likes you would need to upgrade from the free version to the Pro version.

= Is the content of my feed crawlable by search engines? =

It sure is. Unlike other Facebook plugins which use iframes to embed your feed into your page once it's loaded, our plugin uses PHP to embed your Facebook feed content directly into your page. This adds dynamic, search engine crawlable content to your site.

= How do I embed the feed directly into a WordPress page template? =

You can embed your feed directly into a template file by using the WordPress [do_shortcode](http://codex.wordpress.org/Function_Reference/do_shortcode "WordPress.org do_shortcode reference") function: `<?php echo do_shortcode('[custom-facebook-feed]'); ?>`.

== Screenshots ==

1. By default the Facebook feed inherits your theme's default styles and the feed is completely responsive
2. Completely customize the way your Facebook feed looks to perfectly match your site
3. Use custom CSS to customize every part of the feed
4. Display Facebook events in your feed
5. Configuring the plugin
6. General options - Layout and Style page
7. Typography options - Layout and Style page
8. Misc options - Layout and Style page
9. It's super easy to display your feed in any page or post

== Changelog ==
= 2.15 =
* New: Added a new visual header option which displays the cover photo, avatar, page name, bio, and number of likes from your Facebook page at the top of your feeds. To enable the header, go to Facebook Feed > Customize > General > Header > Header Type > Visual.
* New: To help us improve the plugin we've added the ability to opt-in to usage tracking so that we can understand what features and settings are being used, and which features matter to you the most. This is disabled by default and will only be enabled if you explictly choose to opt in. If opted in, the plugin will send a report in the background once per week with your plugin settings and basic information about your website environment. No personal or sensitive data is collected (such as email addresses, Instagram account information, license keys, etc). To enable or disable usage tracking at a later date use the setting at: Instagram Feed > Customize > Advanced > Misc > Enable Usage Tracking. See [here](https://smashballoon.com/custom-facebook-feed/docs/usage-tracking/) for more information.
* New: Added a setting to display a different number of posts on mobile devices vs desktop. While on the configure tab, check the box "Show different number for mobile" to reveal the setting.
* New: Added capability "manage_custom_facebook_feed_options". Users with this capability can make changes to Facebook Feed settings and view admin only messages.
* New: Added a PHP filter "cff_post_text" to change the post text before outputting it in the feed HTML.

= 2.14.1 =
* Fix: Some connection error notices not clearing automatically.

= 2.14 =
* New: Email alerts for critical Facebook feed issues. If there's an issue with a Facebook feed on your website which hasn't been resolved yet then you'll receive an email notification to let you know. This is sent once per week until the issue is resolved. These emails can be disabled by using the following setting: Facebook Feed > Customize > Misc > Feed Issue Email Report.
* New: Admin notifications for critical Facebook feed issues. If there is an error with a feed, admins will see notices in the dashboard and on the front-end of the site along with instructions on how to resolve the issue. Front-end admin notifications can be disabled by using the following setting: Facebook Feed > Customize > Misc > Disable Admin Error Notice.
* New: Added a WordPress 'Site Health' integration. If there is a critical error with your feeds, it will now be flagged in the site health page.
* New: Added "About Us" page for those who would like to learn more about Smash Balloon and our other products. Go to Facebook Feed -> About Us in the dashboard.

= 2.13 =
* New: Added a "Custom Facebook Feed" Gutenberg block to use in the block editor, allowing you to easily add a Facebook feed to posts and pages.
* New: Added support for translations.

= 2.12.4 =
* Tested with upcoming WordPress 5.4 update.
* Tweak: Updated API calls
* Fix: Minor bug fixes

= 2.12.3 =
* Tweak: Added a text link in the settings page footer to our new free [YouTube plugin](https://wordpress.org/plugins/feeds-for-youtube/)
* Tweak: When reconnecting an account on the settings page, if there's an issue with the existing access token then it'll be automatically replaced.
* Tweak: Added 'rel="noopener"' to all external links and added 'rel="noreferrer"' to all non-FB links. Thanks to Dev VIP for the suggestion.
* Fix: Fixed an issue with some call-to-action link URLs when a link protocol wasn't included
* Fix: Fixed a JavaScript conflict with the [Forminator](https://wordpress.org/plugins/forminator/) plugin
* Fix: Fixed duplicate post message displaying due to ellipsis HTML character
* Fix: If a shared link post had no post text then the link title was used causing it to be displayed twice in the post

= 2.12.2 =
* Fix: Fixed a JavaScript error in the admin caused by the previous update. Apologies for any inconvenience.

= 2.12.1 =
* Fix: Fixed an issue with post date timezones due to changes in the WordPress 5.3 update
* Fix: Fixed a rare issue where a JavaScript error would occur in the WordPress admin if an account was manually connected and the Page ID used was the full URL
* Fix: Fixed a JavaScript error in the admin when using older web browsers
* Tweak: Improved the manual account connection process
* Tweak: Some minor UI tweaks to match the new WordPress 5.3 UI style

= 2.12 =
* New: Added a backup cache so the feed will still display even if there's an error from the API.
* New: You can now easily manage multiple Facebook page or group accounts on the plugin settings page allowing you to easily add them to other feeds on your site. When you connect a page or group you will now see it listed in the "Connected Accounts" section. You can add it to the primary feed or to another feed by using the new `account` shortcode option.
* Tweak: Added a filter which can be used to filter the API data when returned; `cff_filter_api_data`.
* Tweak: Updated API error messages
* Fix: Fixed an issue with some @tag links in post text due to a API change
* Fix: Fixed a rare issue with ellipsis chracter symbols in shared link descriptions causing the entire link description not to be displayed

= 2.11.1 =
* Tweak: Added the link source URL below the title for shared link posts
* Fix: Some themes would prevent the "Share" link from working successfully
* Fix: Fixed an issue with the "Feed Columns" setting not working if the minified versions of the plugin CSS/JavaScript files were being used

= 2.11 =
* New: Added a "Feed Columns" setting to allow you to display your feed in multiple columns. This can be found under the "General" tab on the "Customize" page, or by using the `cols` and `colsmobile` shortcode settings.
* New: Updated to use v4.0 of the API

= 2.10 =
* New: Facebook Groups are making their long-awaited return to the plugin! Just click the 'Log in and get my Access Token' button on the plugin's Settings page and select 'Facebook Group'. Follow the prompts to connect your Group and display your feed.
* Fix: Fixed an issue where a lists of groups or pages wouldn't be displayed when retrieving an Access Token due to a server configuration issue
* Fix: Photo icons weren't showing for album posts
* Tweak: Now uses the `visitor_posts` endpoint to display visitor post feeds

[See changelog for all versions](https://plugins.svn.wordpress.org/custom-facebook-feed/trunk/changelog.txt).