PluginProbe ʕ •ᴥ•ʔ
Smash Balloon Social Post Feed – Simple Social Feeds for WordPress / 2.17.1
Smash Balloon Social Post Feed – Simple Social Feeds for WordPress v2.17.1
4.8.1 trunk 1.0 1.1 1.12.1 1.2.3 1.2.4 1.2.5 1.2.7 1.2.8 1.2.9 1.3.0 1.3.1 1.3.2 1.3.3 1.3.4 1.3.5 1.3.6 1.3.7 1.4.0 1.4.1 1.4.2 1.4.3 1.4.4 1.4.5 1.4.6 1.4.7 1.4.8 1.5 1.5.1 1.5.2 1.5.9 1.6.0 1.6.1 1.6.2 1.6.3 1.6.4 1.6.4.1 1.6.5 1.6.5.1 1.6.6 1.6.6.1 1.6.6.2 1.6.6.3 1.6.7 1.6.7.1 1.6.8 1.6.8.1 1.6.8.2 1.7.0 1.7.1 1.7.2 1.8.0 1.8.1 1.8.2 1.8.2.1 1.8.2.2 1.8.2.3 1.9.0 1.9.1 1.9.3 1.9.4 1.9.5 1.9.6 1.9.7 1.9.8 1.9.8.1 1.9.9 1.9.9.1 1.9.9.2 1.9.9.3 2.0 2.0.1 2.1 2.1.1 2.1.2 2.1.3 2.10 2.11 2.11.1 2.12 2.12.1 2.12.2 2.12.3 2.12.4 2.13 2.14 2.14.1 2.15 2.15.1 2.16 2.16.1 2.17 2.17.1 2.18 2.18.1 2.18.2 2.18.3 2.19 2.19.1 2.19.2 2.19.3 2.2 2.2.1 2.3 2.3.1 2.3.10 2.3.2 2.3.3 2.3.4 2.3.6 2.3.7 2.3.8 2.3.9 2.4 2.4.1 2.4.1.1 2.4.1.2 2.4.2 2.4.3 2.4.4 2.4.5 2.4.6 2.5 2.5.1 2.5.2 2.6 2.6.1 2.6.2 2.6.3 2.6.4 2.7 2.7.1 2.7.2 2.8 2.9 2.9.1 4.0 4.0.1 4.0.2 4.0.3 4.0.4 4.0.5 4.1 4.1.1 4.1.2 4.1.3 4.1.4 4.1.5 4.1.6 4.1.7 4.1.8 4.1.9 4.2 4.2.1 4.2.2 4.2.3 4.2.4 4.2.5 4.2.6 4.3.0 4.3.1 4.3.2 4.3.3 4.3.4 4.7.5 4.7.6 4.7.7
custom-facebook-feed / README.txt
custom-facebook-feed Last commit date
admin 5 years ago blocks 6 years ago css 5 years ago fonts 5 years ago img 5 years ago inc 5 years ago js 5 years ago languages 6 years ago templates 6 years ago README.txt 5 years ago changelog.txt 6 years ago class-cff-education.php 6 years ago class-cff-error-reporter.php 6 years ago class-cff-sitehealth.php 6 years ago custom-facebook-feed-admin.php 5 years ago custom-facebook-feed.php 5 years ago email.php 6 years ago gpl-2.0.txt 13 years ago
README.txt
899 lines
1 === Smash Balloon Social Post Feed ===
2 Contributors: smashballoon
3 Tags: Facebook, Facebook feed, Facebook posts, Facebook group, Facebook page
4 Requires at least: 3.0
5 Requires PHP: 5.2
6 Tested up to: 5.6
7 Stable tag: 2.17.1
8 License: GPLv2 or later
9 License URI: http://www.gnu.org/licenses/gpl-2.0.html
10
11 Formerly "Custom Facebook Feed". Display completely customizable Facebook feeds of a Facebook page or Group. Supports Facebook oEmbeds.
12
13 == Description ==
14
15 Display Facebook posts on your WordPress site. **Completely customizable**, **responsive** and **search engine crawlable** Facebook feeds. Display **unlimited Facebook feeds** from your **Facebook page** or **Facebook Group**, and completely match the look and feel of your site with tons of customization options! Automatically powers any Facebook oEmbeds on your site.
16
17 *"The perfect Facebook plugin with amazing support! What else do you want? Get it!"* - [JoeJeffries](http://wordpress.org/support/topic/you-dont-already-have-this?facebook)
18
19 *"I honestly cannot recommend this Facebook plugin enough. The plugin itself is gorgeous and super customizable, and if you run into trouble...support will get you out of it. Five Stars across the board."* - [pamsavoybarnett](http://wordpress.org/support/topic/love-this-plugin-w-awesome-support?facebook)
20
21 **Please note:** This free Facebook plugin allows you to display text and links from Facebook posts. To display **photos, videos, comments,** and more, we offer a Pro version of the plugin. See the Pro Version section below for more information.
22
23 ### Facebook Feed Features
24 **NEW: Now Supports Facebook oEmbeds**
25 With WordPress removing support for Facebook oEmbeds, the plugin will now automatically power any Facebook embeds on your site preventing them from breaking. No developer app required.
26
27 **Super Simple to Set Up**
28 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.
29
30 **Display Feeds from Your Facebook Page or Facebook Group**
31 Use the plugin to display Facebook feeds from a Facebook page or Facebook group that you are an admin of.
32
33 **Completely Customizable**
34 By default the Facebook 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 Facebook posts and feed.
35
36 **SEO Friendly**
37 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.
38
39 **Responsive and Mobile Optimized**
40 Facebook feed layouts look great on any screen size and in any container width.
41
42 **Unlimited Feeds from Unlimited Different Facebook Pages**
43 We don't limit how many Facebook feeds you can display on your site. Just use the shortcode to embed as many Facebook feeds as you like into pages, posts or widgets anywhere on your site.
44
45 **Built for Speed**
46 Built-in caching means that your Facebook feeds load lightning fast. Set your own caching time - check for new Facebook posts every few seconds, minutes, hours or days. You decide.
47
48 **Like Box Widget and Visual Header**
49 Include the official Facebook Like Box widget at the top or bottom of your Facebook feed and display a beautiful visual header with your Facebook page or Facebook group cover photo, profile picture, bio, and number of likes.
50
51 **So Much More**
52 Show and hide certain parts of each Facebook post, choose whose posts to show in the feed, customize colors, font sizes and styles, the number of Facebook posts to display, set max text lengths, translate text, custom CSS, and much, much more.
53
54 ### Pro Version (Custom Facebook Feed Pro)
55
56 In order to maintain the free version of the Custom Facebook Feed plugin on an ongoing basis, and to provide quick and effective support for free, we offer a Pro version of the plugin. Custom Facebook Feed Pro allows you to display photos, videos, the number of likes, shares, reactions and comments for each Facebook post, choose from multiple layout options, filter Facebook posts by type or #hashtag/string, load more Facebook 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 Custom Facebook Feed free and Pro versions.
57
58 * [Find out more about Custom Facebook Feed Pro](https://smashballoon.com/custom-facebook-feed/?utm_campaign=facebook-free-readme&utm_source=proversion&utm_medium=findout "Custom Facebook Feed Pro")
59 * [Try out the Custom Facebook Feed Pro demo](https://smashballoon.com/custom-facebook-feed/demo/?utm_campaign=facebook-free-readme&utm_source=proversion&utm_medium=demo "Custom Facebook Feed Pro Demo").
60
61 ### Benefits of Displaying a Facebook Feed on Your Website
62
63 * **Increase social engagement** between you and your users, customers, or fans
64 * **Save time** by using the Custom Facebook Feed to generate dynamic, search engine crawlable content on your website
65 * **Get more likes** by displaying your Facebook content directly on your site
66 * **Improve your SEO** as all of that quality keyword-rich Facebook content from posts and Facebook comments is directly embedded into your website
67 * Display your Facebook content your way to perfectly match your website's style
68 * **No Coding Required** - choose from tons of built-in customization options to create a truly unique feed of your Facebook content.
69 * The Custom Facebook Feed plugin is **updated regularly** with new features, bug-fixes and Facebook API changes
70 * Support is quick and effective
71 * We're dedicated to providing the **most customizable**, **robust** and **well supported** Facebook feed plugin in the world!
72
73 ### How to use the Custom Facebook Feed plugin
74
75 Once you've installed the plugin there are only a few steps to get up and running:
76
77 1) Use the button on the 'Facebook Feed' settings page to log into your Facebook account and authorize the plugin.
78 2) Save the plugin settings and add the `[custom-facebook-feed]` shortcode to any page, post, or widget where you want the Facebook feed to be displayed.
79
80 That's it! You can then customize the Facebook feed as needed using the settings on the Facebook Feed > Customize page.
81
82 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 "Custom Facebook Feed Free Setup Doc").
83
84 ### Requesting support
85
86 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 Custom Facebook Feed 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/ "Custom Facebook Feed Free support forum"), or directly on the Custom Facebook Feed section of [our website](https://smashballoon.com/custom-facebook-feed/support/ "Custom Facebook Feed website support form"). We also have a large collection of help documentation and FAQs [on our website](https://smashballoon.com/custom-facebook-feed/faq/ "Custom Facebook Feed support FAQs") for all common issues related to the Custom Facebook Feed plugin.
87
88 ### Who's behind this plugin?
89
90 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.
91
92 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").
93
94 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").
95
96 == Installation ==
97
98 1. Install the Custom Facebook Feed either via the WordPress plugin directory, or by uploading the files to your web server (in the `/wp-content/plugins/` directory).
99 2. Activate the plugin through the 'Plugins' menu in WordPress.
100 3. Navigate to the 'Facebook Feed' settings page to configure your feed.
101 4. Use the shortcode `[custom-facebook-feed]` in your page, post or widget to display your feed.
102 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]`.
103
104 == Frequently Asked Questions ==
105
106 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
107
108 = Are there any limitations on which Facebook page or Facebook group feeds I can display? =
109
110 The Facebook 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 Facebook profile. This is to do with Facebook's privacy policies. You can't display a non-public Facebook feed publicly.
111
112 If your Facebook page has any restrictions on it (age, for example) then it means that people have to be signed into Facebook in order to view your page. This isn't desirable for most Facebook pages as it means that it isn't accessible by people who don't have a Facebook account and that your Facebook page can't be crawled and indexed by search engines.
113
114 An easy way to determine whether your Facebook page is set to public is to sign out of your Facebook 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 Facebook 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 Custom Facebook Feed plugin to access and display your feed.
115
116 = Can I display feeds from multiple Facebook pages? =
117
118 You can set your default Facebook Page ID on the Custom Facebook Feed settings page within the WordPress admin, you can then define different page IDs in the shortcodes you use to show multiple feeds from different Facebook 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.
119
120 = Can I display feeds from a Facebook Group? =
121
122 Yep! First, authorize the plugin by using the big blue Facebook button on the "Facebook Feed" settings page and then select your Facebook group. You must be a member of the group and an admin of that Facebook group must have installed our app in the Facebook group settings. Directions for this are provided when you authorize the plugin via the Facebook Feed settings page.
123
124 = Can I display the feed from a personal Facebook profile? =
125
126 Due to Facebook'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.
127
128 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 [Facebook's recommendation](http://www.facebook.com/help/175644189234902/), as there are many advantages to using pages over profiles.
129
130 Once you've done so, the plugin will be able to retrieve and display all of your posts.
131
132 = Does the plugin work with Facebook oEmbeds? =
133
134 In version 2.5, support was added to allow the plugin to power your Facebook oEmbeds as official support for these is no longer available in WordPress core. Just connect your account on the oEmbeds settings page inside the plugin and the plugin will power all Facebook embeds on your site, old and new. No developer app or account required.
135
136 = Can I show photos and videos in my Custom Facebook feed? =
137
138 This free plugin only allows you to display text from your Facebook 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 the [Custom Facebook Feed website](https://smashballoon.com/custom-facebook-feed/demo/?utm_campaign=facebook-free-readme&utm_source=faq&utm_medium=media "Custom Facebook Feed 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 "Custom Facebook Feed 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 of Custom Facebook Feed plugin") for a full list of all differences between the free version and Pro version.
139
140 = Can I show the comments, shares and likes associated with each Facebook post? =
141
142 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 "Custom Facebook Feed Pro"). To display comments, shares and likes you would need to upgrade from the free version to the Pro version.
143
144 = Is the content of my Custom Facebook Feed crawlable by search engines? =
145
146 It sure is. Unlike other Facebook plugins which use iframes to embed your Facebook feed into your page once it's loaded, the Custom Facebook Feed uses PHP to embed your Facebook feed content directly into your page. This adds dynamic, search engine crawlable content to your site.
147
148 = How do I embed the Custom Facebook Feed directly into a WordPress page template? =
149
150 You can embed your Facebook 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]'); ?>`.
151
152 = My Facebook feed posts are not showing up, or all I can see is the Facebook Like box but no posts =
153
154 Please refer to [this FAQ](https://smashballoon.com/facebook-feed-doesnt-show-can-see-like-box-posts-gives/?utm_campaign=facebook-free-readme&utm_source=faq&utm_medium=errors "My Facebook feed posts are not showing up, or all I can see is the Facebook Like box but no posts") for potential solutions on how to resolve this issue.
155
156 = Create a basic slideshow from your Facebook posts =
157
158 The Custom Facebook Feed plugin doesn't currently have a slideshow feature built into it, but it's possible to achieve a basic slideshow by doing the following:
159
160 1) Add a class to the shortcode of the Facebook feed that you want to convert into a slideshow:
161
162 `[custom-facebook-feed class="slideshow"]`
163
164 2) Set the number of posts to display to be the number of Facebook posts you want to include in the slideshow (10 for example). You can do this by using the `num` shortcode option:
165
166 `[custom-facebook-feed class="slideshow" num=10]`
167
168 3) Add the following to the plugin's **Custom JavaScript** section, which is under the 'Misc' tab on the plugin's 'Customize' page. Please note, if you change the class option in the shortcode above to be anything but "slideshow" then make sure to change that on the first line of the snippet below:
169
170 `var shortcodeClass = 'slideshow',
171 cffSpeed = 5000,
172 $cff = $('#cff.'+ shortcodeClass);
173 $cffItem = $cff.find('.cff-item'),
174 cffNum = $cffItem.length,
175 cffCur = 0;
176 $cffItem.hide();
177 setTimeout(function(){ $cff.find('.cff-item').eq(0).show(); }, 200);
178 setInterval(function(){
179 $cff.find('.cff-item').eq(cffCur).fadeOut( "fast", function() {
180 if( cffCur == cffNum-1 ) cffCur = -1;
181 cffCur++;
182 $cff.find('.cff-item').eq(cffCur).fadeIn();
183 });
184 }, cffSpeed);`
185
186 4) You can change the speed of the transition by editing the **cffSpeed = 5000** value at the top of the snippet. 5000 is equal to 5 seconds (5000ms).
187
188 = Changing the font in your Facebook feed and using Google Fonts =
189
190 Please refer to [this FAQ](https://smashballoon.com/changing-the-font-in-your-facebook-feed-using-google-fonts/?utm_campaign=facebook-free-readme&utm_source=faq&utm_medium=fonts "Changing the font in your Facebook feed and using Google Fonts") for directions on how to use Google fonts in your Facebook posts.
191
192 = Can I display my Facebook posts horizontally or in multiple columns? =
193
194 Please refer to [this FAQ](https://smashballoon.com/can-display-facebook-post-horizontally-multiple-columns/?utm_campaign=facebook-free-readme&utm_source=faq&utm_medium=horizontal "Can I display my Facebook posts horizontally or in multiple columns?") for directions on how to display your Facebook posts in multiple columns.
195
196 = My Facebook feed appears to have stopped updating / working =
197
198 If your Facebook feed doesn't appear to be showing the most recent Facebook posts then the most likely explanation is that the recent Facebook posts in your feed may be shared from a user's personal Facebook profile. Facebook's privacy policy doesn't allow posts that you share from personal Facebook profiles to be shared outside of Facebook as the posts don't technically belong to your Facebook page, they belong to the user who posted it to their personal Facebook profile. There's an example of a post shared from a user's personal Facebook profile [here](https://smashballoon.com/wp-content/uploads/2014/11/sharing-photo-facebook-profile.jpg "Example of Facebook post shared from personal Faceboo profile").
199
200 Please note, this isn't a limitation of our plugin, it's a restriction which Facebook places on it's content in order to protect the privacy of their Facebook users.
201
202 **Potential solutions**
203
204 * You could re-post the Facebook post to your page rather than sharing it to your Facebook page. If you re-post the content as your own post on your Facebook page then the content now originates from your Facebook page and will be displayed in the Facebook feed on your website.
205
206 * If you were to share a post from another Facebook page or public source, rather than sharing it from someone's personal Facebook profile, then it would show up in your feed outside of Facebook, but by default any posts that originate from a personal Facebook profile are protected by Facebook's privacy policy and is the private content of that Facebook profile owner.
207
208 = I'm receiving an error message when trying to display my Facebook posts =
209
210 Please refer to our [Error Message Reference page](https://smashballoon.com/custom-facebook-feed/docs/errors/?utm_campaign=facebook-free-readme&utm_source=faq&utm_medium=errors "I'm receiving an error message when trying to display my Facebook posts") for information on how to resolve common error messages.
211
212 = Creating a Masonry grid layout from your Facebook posts =
213
214 Please refer to [this FAQ](https://smashballoon.com/creating-a-masonry-grid-layout-from-your-facebook-posts/?utm_campaign=facebook-free-readme&utm_source=faq&utm_medium=masonry "Creating a Masonry grid layout from your Facebook posts") for directions on how to create a Masonry grid layout from your Facebook feed posts.
215
216 = How do I customize my Facebook feed? =
217
218 You can customize the Facebook feed by setting the options on the Customize page, which can be found under the Facebook Feed menu in your left hand WordPress admin menu. If you need even deeper customization than the built in options allow then you can add your own CSS to the plugin in the Custom CSS section under the Misc tab to further customize your Facebook feed.
219
220 You can also override these styles for individual Facebook feeds by setting options within the shortcode. For example, you can change the height of a specific Facebook feed like so: `[custom-facebook-feed height=500px]`.
221
222 = The Custom Facebook Feed shortcode options aren't working =
223
224 The most common causes of this are:
225
226 1) There's HTML tags within the [custom-facebook-feed] shortcode which are preventing it from working correctly
227
228 If you copied and pasted the shortcode into the Visual editor on your WordPress page/post editor then it may have inadvertently included some HTML tags from the page that you copied it from. The easiest way to check this is to view the 'Text' view in your WordPress editor and see whether there are any stray HTML tags in the shortcode itself.
229
230 2) The shortcode includes curly single quote characters
231
232 If your shortcode includes single quotes then check that they are the standard single quotes and not the curly kind.
233
234 3) Typo in the shortcode option
235
236 Ensure that there aren't any spelling errors in the shortcode options that you're using and that the format is consistent with that demonstrated on the [Shortcode Options reference page](https://smashballoon.com/custom-facebook-feed/docs/shortcodes/?utm_campaign=facebook-free-readme&utm_source=faq&utm_medium=shortcode "The shortcode options aren't working").
237
238 = Facebook avatar pictures aren't showing up in my Facebook feed =
239
240 The most common reason for this is that an add-on or extension you have installed in your web browser is blocking the pictures being loaded from Facebook. Try checking to see whether you have any add-ons or extensions installed in your browser and, if so, try disabling them to see whether that solves the problem and displays the pictures from Facebook.
241
242 == Other Notes ==
243
244 = At Smash Balloon we have two goals: =
245
246 1. Creating and maintaining the most useful, functional, customizable, robust and down-right awesomist Facebook feed plugin your website has ever seen.
247 2. To provide the quickest, friendliest and most mind-blowingly amazing product support you have ever experienced.
248
249 == Screenshots ==
250
251 1. By default the Facebook feed inherits your theme's default styles and the Facebook feed is completely responsive
252 2. Completely customize the way your Facebook feed looks to perfectly match your site
253 3. Use custom CSS to customize every part of the Facebook feed
254 4. Display Facebook events in your Facebook feed
255 5. Configuring the Custom Facebook Feed plugin
256 6. General Facebook Feed options - Custom Facebook Feed Layout and Style page
257 7. Facebook Feed Typography options - Custom Facebook Feed Layout and Style page
258 8. Misc Facebook Feed options - Custom Facebook Feed Layout and Style page
259 9. It's super easy to display your Facebook feed in any page or post
260
261 == Changelog ==
262 = 2.17.1 =
263 * Tweak: Added shortcode options for the "Before Date" and "After Date" settings, so that a custom text string can be displayed before and after the post date.
264 * Tweak: Minor frontend CSS improvements.
265 * Tweak: Added support for improved notices on the plugin settings page.
266 * Fix: Fixed an issue with the Facebook Like Box widget displaying an error if the width was set to a fractional pixel.
267
268 = 2.17 =
269 * New: Added support for Facebook oEmbeds. When you share a link to a Facebook post or video, WordPress automatically converts it into an embedded Facebook post for you (an "oEmbed"). However, on October 24, 2020, WordPress is discontinuing support for Facebook oEmbeds and so any existing or new embeds will no longer work. Don't worry though, we have your back! This update adds support for Facebook oEmbeds and so, after updating, the Custom Facebook Feed plugin will automatically keep your oEmbeds working. It will also power any new oEmbeds you post going forward.
270 * New: Install our other free social media plugins right from the Custom Facebook Feed settings menu. Use our Instagram, YouTube, and Twitter plugins to add even more social content to your website and help further engage your viewers and increase your followers.
271
272 = 2.16.1 =
273 * Fix: Added a workaround for a Facebook API bug which sometimes displays a button in a post with the text "No Button".
274 * Fix: Added an additional check when formatting the post text for the share link to prevent potential issues.
275 * Fix: Fixed a typo in the "restrictedpage" shortcode option.
276
277 = 2.16 =
278 * Important: Due to upcoming Facebook API changes on September 4, 2020, it will only be possible to display feeds from Facebook pages which you are an admin of. If a PPCA Error notice is displayed above your feed then this change will affect one or more of your feeds. For more information about this change, please [see here](https://smashballoon.com/facebook-api-changes-september-4-2020/).
279 * Tweak: Added the "pagetype" setting to the shortcode when clicking the "Add to another feed" button on the Settings page to ensure it's set correctly
280 * Fix: Fixed a minor compatibility issue with the upcoming WordPress 5.5 release
281 * Fix: Removed the see more/less links from post text when using the email share link.
282 * Fix: Removed a stray "section" closing tag which was causing a layout issue in some themes and inadvertently displayed the PPCA notice.
283
284 = 2.15.1 =
285 * Fix: The opt-in notice to help improve the plugin was not dismissing as expected for some sites due to the admin JavaScript file being cached by the browser.
286 * Fix: Disabled the "About Us" page plugin installation if using a version of WordPress earlier than 4.6.
287
288 = 2.15 =
289 * 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.
290 * 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.
291 * 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.
292 * New: Added capability "manage_custom_facebook_feed_options". Users with this capability can make changes to Facebook Feed settings and view admin only messages.
293 * New: Added a PHP filter "cff_post_text" to change the post text before outputting it in the feed HTML.
294
295 = 2.14.1 =
296 * Fix: Some connection error notices not clearing automatically.
297
298 = 2.14 =
299 * 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.
300 * New: Admin notifications for critical Facebook feed issues. If there is an error with a Facebook 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.
301 * 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.
302 * 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.
303
304 = 2.13 =
305 * 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.
306 * New: Added support for translations.
307
308 = 2.12.4 =
309 * Tested with upcoming WordPress 5.4 update.
310 * Tweak: Updated Facebook API calls
311 * Fix: Minor bug fixes
312
313 = 2.12.3 =
314 * Tweak: Added a text link in the Facebook Feed settings page footer to our new free [YouTube plugin](https://wordpress.org/plugins/feeds-for-youtube/)
315 * Tweak: When reconnecting a Facebook account on the settings page, if there's an issue with the existing Facebook access token then it'll be automatically replaced.
316 * Tweak: Added 'rel="noopener"' to all external links and added 'rel="noreferrer"' to all non-Facebook links. Thanks to Dev VIP for the suggestion.
317 * Fix: Fixed an issue with some Facebook call-to-action link URLs when a link protocol wasn't included
318 * Fix: Fixed a JavaScript conflict with the [Forminator](https://wordpress.org/plugins/forminator/) plugin
319 * Fix: Fixed duplicate Facebook post message displaying due to ellipsis HTML character
320 * Fix: If a shared Facebook link post had no post text then the link title was used causing it to be displayed twice in the Facebook post
321
322 = 2.12.2 =
323 * Fix: Fixed a JavaScript error in the admin caused by the previous update. Apologies for any inconvenience.
324
325 = 2.12.1 =
326 * Fix: Fixed an issue with Facebook post date timezones due to changes in the WordPress 5.3 update
327 * Fix: Fixed a rare issue where a JavaScript error would occur in the WordPress admin if a Facebook account was manually connected and the Facebook Page ID used was the full URL
328 * Fix: Fixed a JavaScript error in the admin when using older web browsers
329 * Tweak: Improved the manual account connection process
330 * Tweak: Some minor UI tweaks to match the new WordPress 5.3 UI style
331
332 = 2.12 =
333 * New: Added a backup cache so the Facebook feed will still display even if there's an error from the Facebook API.
334 * New: You can now easily manage multiple Facebook page or Facebook group accounts on the Facebook Feed plugin settings page allowing you to easily add them to other Facebook feeds on your site. When you connect a Facebook page or Facebook group you will now see it listed in the "Connected Accounts" section. You can add it to the primary Facebook feed or to another Facebook feed by using the new `account` shortcode option.
335 * Tweak: Added a filter which can be used to filter the Facebook API data when returned; `cff_filter_api_data`.
336 * Tweak: Updated Facebook API error messages
337 * Fix: Fixed an issue with some @tag links in Facebook post text due to a Facebook API change
338 * Fix: Fixed a rare issue with ellipsis chracter symbols in Facebook shared link descriptions causing the entire link description not to be displayed
339
340 = 2.11.1 =
341 * Tweak: Added the link source URL below the title for Facebook shared link posts
342 * Fix: Some themes would prevent the Facebook "Share" link from working successfully
343 * Fix: Fixed an issue with the "Feed Columns" setting not working if the minified versions of the Custom Facebook Feed plugin CSS/JavaScript files were being used
344
345 = 2.11 =
346 * New: Added a "Feed Columns" setting to allow you to display your Facebook 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.
347 * New: Updated to use v4.0 of the Facebook API
348
349 = 2.10 =
350 * New: Facebook Groups are making their long-awaited return to the Custom Facebook Feed plugin! Just click the 'Log in and get my Facebook Access Token' button on the Facebook Feed Settings page and select 'Facebook Group'. Follow the prompts to connect your Facebook Group and display your feed.
351 * Fix: Fixed an issue where a lists of Facebook groups or pages wouldn't be displayed when retrieving a Facebook Access Token due to a server configuration issue
352 * Fix: Photo icons weren't showing for Facebook album posts
353 * Tweak: Now uses the Facebook `visitor_posts` endpoint to display visitor Facebook post feeds
354
355 = 2.9.1 =
356 * New: Added support for v3.3 of the Facebook API.
357 * Fix: The Facebook Access Token selection area was being cut off on small screens when a lot of Facebook pages were listed.
358
359 = 2.9 =
360 * New: You can now select between a "Regular" or "Boxed" Facebook post style. Settings for this can be found at: `Facebook Feed > Customize > Style Posts > Post Item`. A Box Shadow setting has been added to the "Boxed" Facebook post style.
361 * New: Added some settings to control the size and color of the Facebook shared link URLs and descriptions. These can be found at: `Facebook Feed > Customize > Style Posts > Shared Link Boxes`.
362 * New: Improved the Facebook Access Token retrieval process to make it more intuitive.
363 * Tweak: Facebook avatar images are now circular to match Facebook.
364 * Tweak: Animated the social media icons when the Facebook "Share" button is clicked.
365 * Tweak: Changed the way the Facebook Like Box loads to avoid a conflict with the Facebook Messenger widget. It no longer uses the Facebook JavaScript SDK.
366 * Tweak: Changed the elements used for icons from `<i>` to `<span>` to aid accessibility.
367 * Tweak: Removed the Google+ share option as the platform has been deprecated.
368 * Tweak: Removed the social media share widgets from the footer of the admin so that they're only loaded when the "Share the plugin" button is clicked.
369 * Fix: The Custom Facebook Feed plugin now uses the built-in WordPress HTTP API to get data from Facebook instead of making it's own cURL requests to the Facebook API.
370 * Fix: Fixed an issue where the Facebook avatars of people posting to the Facebook page weren't being displayed. Individual Facebook API requests for avatars have now been removed and bundled into the main Facebook API request.
371 * Fix: If the link to the Facebook profile of a visitor posting to your page is not available then remove the link from the Facebook avatar and author name.
372 * Fix: Fixed an accessibility error caused by the Facebook share icons being empty links.
373 * Fix: Removed the use of the ENT_HTML5 constant as it isn't supported in PHP 5.4.
374 * Fix: Fixed a rare issue with Facebook tags in Facebook post stories when the locale was set to be Greek.
375
376 = 2.8 =
377 * New: Added support for Facebook Notes in timeline feeds. If your Facebook timeline feed contains a note then the Custom Facebook Feed plugin will now get the content from the note and display it within the Facebook post.
378 * New: Facebook call-to-action buttons - such as "Learn More", "Shop Now", and "Message Facebook Page" - are now supported in your Facebook posts. These text strings can be translated using the settings at: Facebook Feed > Customize > Custom Text/Translate
379 * New: Added a setting that you can enable if you are displaying Facebook posts from a restricted (non-public) Facebook page. This will allow the Facebook page avatar to be displayed, and is located at: Facebook Feed > Customize > Misc > Misc Settings > Is Facebook Page restricted?
380 * New: If a Facebook visitor posts to your Facebook page then their avatar will now be displayed and cached for 6 months. To clear the cache of these Facebook avatar images use the button located at: Facebook Feed > Customize > Misc > Misc Settings > Clear Avatar Cache
381 * Tweak: The Timezone setting can now be set in the Custom Facebook Feed shortcode. Eg: `timezone="America/Los_Angeles"`
382 * Tweak: Minor UI changes to the Facebook Feed admin pages
383 * Tweak: Reduced some of the Facebook data in the System Info
384 * Fix: If you backdate a Facebook post it will now be ordered correctly in your Facebook feed
385 * Fix: Fixed a theme conflict related to the Color Picker in the Facebook Feed admin section
386 * Verified compatibility with WordPress 5.0 and Gutenburg
387
388 = 2.7.2 =
389 * **Important:** If you are displaying a Facebook feed from a Facebook page which you are *not* an admin of then it is advised that you obtain a new Facebook Access Token in the plugin using the "Log in and get my Access Token" button. This will switch you from using the "SlickRemix" app to using our own "Smash Balloon" Facebook app which was recently approved by Facebook, and will prevent you from experiencing any potential interuptions in your Facebook feeds going forward. This will be the final time this is required.
390 * Fix: Fixed a rare issue caused by some themes including the JavaScript file incorrectly
391
392 = 2.7.1 =
393 * Tweak: Made some adjustments to the Facebook Access Token login process
394
395 = 2.7 =
396 * New: Now easily get your own Facebook Access Token to avoid any Facebook connection issues. Simply click the blue Facebook "Log in and get my Facebook Access Token" button on the Custom Facebook Feed settings page and connect your Facebook account to get your token. The Facebook Access Token will work to get Facebook posts from ANY Facebook page. Thanks to our friends at SlickRemix for powering our new login and getting the Custom Facebook Feed plugin back up and running again!
397 * Tweak: Removed the minimum caching time if you're using your own Facebook Page Access Token
398
399 = 2.6.4 =
400 * **Important:** If you are displaying Facebook posts from a Facebook page that **you are an admin of** then it is now highly recommended that you retrieve your own Facebook Access Token for that Facebook page to avoid any Facebook API rate limit errors. Simply follow these [step-by-step](https://smashballoon.com/custom-facebook-feed/page-token/?utm_campaign=facebook-free-readme&utm_source=changelog&utm_medium=limits) instructions to obtain one.
401
402 = 2.6.3 =
403 * Fix: Fixed an issue where Facebook API errors were being cached
404
405 = 2.6.2 =
406 * Fix: Replaced all HTTP links in the Facebook feed with HTTPS
407 * Fix: Fixed a rare issue which affected the layout of other Facebook widgets
408 * Fix: Automatically remove slashes at the end of the Facebook Page ID as it caused an error
409 * Fix: The API response test in the System Info now only tests with your Facebook token if you have the "Use my own Facebook Access Token" setting enabled
410 * Fix: Fixed an issue which caused an occasional Facebook API rate limit error
411
412 = 2.6.1 =
413 * Fix: Removed an unnecessary Facebook API call
414 * Fix: Removed a PHP notice which was displayed under rare circumstances
415 * Fix: Minor Facebook bug fixes
416
417 = 2.6 =
418 * Fix: Fixed an issue connecting to the Facebook API caused by a recent Facebook platform change
419 * Tweak: Increased the minimum caching time to be 15 minutes to reduce Facebook API requests
420
421 = 2.5.2 =
422 * Important: Due to sudden changes in the Facebook API it is no longer possible to display Facebook posts from a Facebook Group. Please [see here](https://smashballoon.com/facebook-api-changes-april-4-2018/) for more information. We apologize for any frustration or inconvenience this has caused.
423 * Removed: Due to Facebook API restrictions, it is no longer possible to display information about a Facebook event when it is posted or shared to your Facebook Page timeline.
424
425 = 2.5.1 =
426 * Fix: Prevented a PHP notice which would be displayed under rare circumstances in the Facebook feed
427 * Fix: Replaced a function due to a deprecation in PHP 7.2
428
429 = 2.5 =
430 * New: Added the Facebook post story as part of the page/author name at the top of the Facebook post
431 * New: Added an option to use minified versions of the plugin CSS and JavaScript files: `Facebook Feed > Customize > Misc > Misc Settings > Minify CSS and JavaScript files`
432 * New: Added support for clearing the cache of major caching plugins when the Facebook feed cache is cleared. You can enable this by setting the following setting to be "Yes": `Facebook Feed > Customize > Misc > Misc Settings > Force cache to clear on interval`
433 * Tweak: Improved the text truncation so that it applies to both the Facebook post text and Facebook description as one block of text and accounts for HTML link tags
434 * Tweak: Added an "Auto" option to the Facebook Post Limit setting where it will automatically adjust the post limit based on the number of Facebook posts you choose to display in your Facebook feed
435 * Tweak: Reorganized the Custom Facebook Feed settings pages to be more intuitive
436 * Tweak: Added aria-hidden=true to icons to help improve accessibility
437 * Tweak: The icon font stylesheet handle has been renamed so it will only be loaded once if another of our social media plugins is installed
438 * Tweak: Facebook error messages are now only shown to admins
439 * Tweak: Added a setting to workaround a theme issue that affects the shortening of the Facebook post text. If you're experiencing an issue with the shortening of Facebook post text then you can enable the following setting: `Facebook Feed > Customize > Misc > Misc Settings > Fix Facebook text shortening issue`
440 * Fix: Included a fallback in case the Facebook author name and avatar aren't available in visitor Facebook posts
441 * Fix: Fixed an issue with apostrophes in the Facebook feed header not being escaped correctly
442 * Fix: Fixed an issue with the Facebook icons when Font Awesome 5 was added to a site
443 * Fix: Added support for the @[ID:page-name] Facebook tagging format
444 * Fix: The Facebook post description is now able to be displayed even if the Facebook post text is hidden
445
446 = 2.4.6 =
447 * Compatible with WordPress 4.8
448
449 = 2.4.5 =
450 * Tweak: Updated plugin links for new WordPress.org repo
451 * Fix: Minor bug fixes
452
453 = 2.4.4 =
454 * New: If your Facebook posts have been created in more than one language on Facebook then it's now possible to display each language by using the `locale` setting in the shortcode. Eg: English: `[custom-facebook-feed locale=en_EN]`, German: `[custom-facebook-feed locale=de_DE]`
455 * Fix: Fixed an issue with the order of Facebook group posts in some Facebook feeds
456
457 = 2.4.3 =
458 * Fix: Fixed a potential security vulnerability
459 * Tested with upcoming WordPress 4.6 update
460
461 = 2.4.2 =
462 * Tweak: Facebook group wall posts are now ordered based on recent activity, rather than by the date they were created, to better reflect the order on the Facebook Group wall.
463 * Tweak: The "5 hours ago" date text strings can now be translated directly in the shortcode if you're displaying different feeds in different languages. See the bottom of the [Shortcode Options table](https://smashballoon.com/custom-facebook-feed/docs/shortcodes/) for more information.
464 * Tweak: Created some specific [setup directions](https://smashballoon.com/custom-facebook-feed/docs/free/) for the free version.
465 * Fix: Minor bug fixes
466
467 = 2.4.1.2 =
468 * Updated to be compatible with Facebook API version 2.6
469
470 = 2.4.1.1 =
471 * Fix: Fixed a JavaScript error in the admin area when using WordPress 4.5
472
473 = 2.4.1 =
474 * New: If a post contains either a photo or video then an icon and link are now added to view it on Facebook. You can disable this by unchecking the "Media Link" option in the following location: Customize > Post Layout > Show/Hide. You can also remove it by using the "exclude" shortcode option: exclude="medialink". You can translate or change the text for this link on the "Custom Text / Translate" settings page.
475 * Tweak: Tested with WordPress 4.5
476 * Fix: Fixed an issue where the "Share" button in the plugin Like Box wasn't working correctly
477 * Fix: Added support for wp-config proxy settings. Credit to [@usrlocaldick](https://wordpress.org/support/topic/proxy-support-1) for the patch.
478
479 = 2.4 =
480 * New: Added a setting to allow you to use a fixed pixel width for the Facebook feed on desktop but switch to a 100% width responsive layout on mobile
481 * New: You can now click on the name of a setting on the admin pages to reveal the corresponding shortcode for that setting
482 * New: Added quick links to the top of the Customize settings pages to make it easier to find certain settings
483 * New: Added a setting to allow you to disable the default plugin text and link styles (Customize > Misc > Disable default styles)
484 * New: Added a setting which allows you to manually change the request method used to fetch Facebook posts which is necessary for some server setups
485 * Tweak: Updated the Font Awesome icon font to version 4.5
486 * Tweak: Moved the 'Show Header' setting to the 'General' tab on the Customize page
487 * Fix: Hashtag linking now works with all languages and character sets
488 * Fix: Fixed an error that occurred when trying to activate the Pro version with the free version still activated
489 * Fix: Fixed a rare error which occurred when the Facebook post contained no text and no story
490 * Fix: Fixed an issue when trying to display Facebook posts by only visitors to your Facebook page caused by a recent Facebook API update
491
492 = 2.3.10 =
493 * Fix: If you're experiencing an issue with your Facebook feed not automatically updating successfully then please update the plugin and enable the following setting: Custom Facebook Feed > Customize > Misc > Misc Settings > Force cache to clear on interval. If you set this setting to 'Yes' then it should force your plugin cache to clear either every hour, 12 hours, or 24 hours, depending on how often you have the plugin set to check Facebook for new posts.
494
495 = 2.3.9 =
496 * Fix: Fixed an issue caused by the recent Facebook API 2.5 update where the posts wouldn't display when using a brand new Access Token
497
498 = 2.3.8 =
499 * Fix: Fixed a positioning issue with the Facebook "Like Box / Page Plugin" widget caused by a recent Facebook update which was causing it to overlap on top of other content
500 * Fix: Hashtags containing Chinese characters are now linked
501 * Fix: Fixed a minor issue in shared link posts where the post text linked to the shared link URL instead of the post on Facebook
502 * Tweak: Added a timezone for Sydney, Australia
503
504 = 2.3.7 =
505 * Fix: Fixed an issue caused by the WordPress 4.3 update where feeds from very long page IDs wouldn't update correctly due to the cache not clearing when expired
506 * Fix: Removed specific encoding parameters from the cURL request method to prevent encoding issues on some servers
507
508 = 2.3.6 =
509 * New: Added a couple of new customization options for the Facebook Like Box/Page Plugin which allow you to select a small/slim header for the Like Box and hide the call-to-action button (if available)
510 * Fix: The plugin now works with Access Tokens which use the new recently-released version 2.4 of the Facebook API
511
512 = 2.3.5 =
513 * New: Replace the Facebook 'Like Box' with the new Facebook 'Page Plugin' as the Facebook Like Box will be deprecated on June 23rd, 2015. Settings can be found under the Misc tab on the plugin's Customize page.
514 * Fix: Hashtags which contain foreign characters are now correctly linked to the hashtag on Facebook
515 * Fix: Links within Facebook post descriptions weren't opening in a new tab
516 * Fix: Removed empty style tags from some elements
517 * Fix: The URLs used for the 'Share' icons are now encoded to prevent any HTML validation errors
518 * Fix: Shared Facebook posts now link to the new shared post and not to the original post that was shared on Facebook
519 * Fix: Corrected a minor issue with the plugin caching string
520 * Fix: Fixed a minor issue with tags in the Facebook post text when creating/sharing an event
521 * Tweak: Add some stricter CSS to some parts of the feed to prevent theme conflicts
522 * Tweak: Automatically link the Facebook event name to the event now rather than it having to be enabled on the plugin's 'Typography' settings page
523
524 = 2.3.4 =
525 * Fix: The Facebook event description is no longer shown twice in event posts. It was previously shown in the post text itself and in the Facebook event details.
526 * Fix: Fixed a rare bug which would occur if your Facebook page or Facebook group name contained a number
527
528 = 2.3.3 =
529 * Fix: Removed a PHP notice which was missed in the last update. Apologies for the two updates in quick succession.
530
531 = 2.3.2 =
532 * Fix: Fixed some stray PHP notices which were inadvertently introduced in a recent update
533 * Tweak: Added an option to not load the icon font included in the plugin
534
535 = 2.3.1 =
536 * New: Added a shortcode option to allow you to offset the number of posts to be shown. Eg: offset=2
537 * New: Added an email link to the sharing icons
538 * New: Added a setting to load a local copy of the icon font instead of the CDN version. This can be found at the bottom of the 'Misc' settings page.
539 * Tweak: Added a prefix to the IDs on all Facebook posts so that they can now be targeted via CSS
540 * Tweak: Added "nofollow" to all links by default. This can be disabled by using `nofollow=false` in the shortcode.
541 * Tweak: Added some missing settings to the System Info section
542 * Tweak: Added the 'Timezone' setting to the main Settings page so that it's easier to find
543 * Fix: Added a workaround for Facebook changing the event URLs in their API from absolute to relative URLs
544 * Fix: Facebook removed the 'relevant_count' parameter from their API so added a workaround to get the number of photos attached to a Facebook post
545 * Fix: Fixed a minor bug in the WP_Http fallback method
546 * Fix: Removed duplicate IDs on the share icons and replaced with classes
547 * Fix: Added a check to the file_get_contents data retrieval method to check whether the Open SSL wrapper is enabled
548 * Fix: The `eventtitlelink` shortcode option now works correctly
549 * Fix: Added a workaround for 'story_tags' which Facebook deprecated from their API
550 * Fix: Removed query string from the end of CSS and JavaScript file references and replaced it with the wp_enqueue_script 'ver' parameter instead
551
552 = 2.3 =
553 * Happy New Year!
554 * New: Added a share link which allows you to share posts to Facebook, Twitter, Google+ or LinkedIn. This can be disabled at the very bottom of the Typography tab, or by using `showsharelink=false` in the [custom-facebook-feed] shortcode.
555 * Tweak: Using your own Facebook Access Token in the plugin is still optional but is now recommended in order to protect yourself against future Access Token related issues
556 * Tweak: Increased the accuracy of the character count when links are included in the Facebook text
557 * Tweak: Improved the efficiency of the Facebook post caching
558 * Tweak: Replaced the rel attribute with the HTML5 data attribute when storing data on an element
559 * Tweak: Added HTTPS stream wrapper check to the System Info to aid in troubleshooting
560 * Tweak: Updated the plugin's icon font to the latest version
561 * Tweak: Added the Smash Balloon logo to the credit link which can be optionally displayed at the bottom of your feed. The setting for this is at the bottom of the Misc tab on the Customize page.
562 * Tweak: Added a shortcode option to only show the Smash Balloon credit link on certain feeds: `[custom-facebook-feed credit=true]`
563 * Fix: Fixed an issue with quotes being escaped in custom/translated text
564 * Fix: Display an error message if WPHTTP function isn't working correctly
565 * Fix: The `postbgcolor` shortcode option is now working correctly
566
567 = 2.2.1 =
568 * Fix: Fixed a minor JavaScript error which occurs if a Facebook post doesn't contain any text
569
570 = 2.2 =
571 * New: Added a text area to the Support tab which contains all of the plugin settings and site info for easier troubleshooting
572 * New: You can now set the number of Facebook posts to '0' if you just want to show the Facebook Like box widget and no posts
573 * Tweak: If the user doesn't add a unit to the width, height or padding then automatically add 'px'
574 * Tweak: Added social media sharing links to the bottom of the settings page and an option to add a credit link to the bottom of the feed
575 * Fix: Fixed an issue with Facebook hashtags not being linked when followed immediately by punctuation
576 * Fix: When displaying a shared link if the caption is the same as the link URL then don't display it
577 * Fix: Added a space before the feed header's style attribute to remove HTML validation error
578 * Fix: Prefixed the 'top' and 'bottom' classes used on the Facebook Like box to prevent CSS conflicts
579 * Fix: Fixed an issue with the link color not being applied to Facebook hashtag links
580
581 = 2.1.3 =
582 * Fix: Fixed an issue with the Facebook Access Token used in the plugin hitting its request limit
583
584 = 2.1.2 =
585 * Fix: Added in a missing closing div tag to the Facebook feed when an error is being displayed
586
587 = 2.1.1 =
588 * Fix: Fixed an issue with the date not being hidden when unchecked in the Show/Hide section
589 * Fix: Fixed an issue with the date not being displayed below event posts when the date position was set to 'At the bottom of the post'
590
591 = 2.1 =
592 * New: Added an option to preserve/save your plugin options after uninstalling the plugin. This makes manually updating the plugin much easier.
593 * New: Added a 'Settings' link to the plugin on the Plugins page
594 * New: Added a field to the Misc settings page which allows users to enter their Facebook App ID in order to remove a couple of browser console warnings caused by the Facebook Like box widget
595 * Tweak: Reduced the size of the author's Facebook profile picture from 50px to 40px to match Facebook
596 * Tweak: The link description text is now 12px in size by default
597 * Tweak: Added some default character limits to the post text and descriptions
598 * Tweak: If the post author is being hidden then change the default date position to be the bottom of the post
599 * Fix: The post author link is no longer the full width of the post and is only wrapped around the author image and name which helps prevent inadvertently clicking on the post author
600 * Fix: Added a fb-root element to the Like box to prevent a browser console warning
601 * Fix: Renamed the ShowError function to prevent conflicts
602 * Fix: Fixed an issue with the 'seconds' custom text string not being saved correctly
603 * Fix: When linking the post text to the Facebook post the correct text color is now applied
604
605 = 2.0.1 =
606 * Tweak: Improved error handling and added an [Error Message reference](https://smashballoon.com/custom-facebook-feed/docs/errors/) to the website
607
608 = 2.0 =
609 * New: Added an option to display the post date immediately below the author name - as it is on Facebook. This is now the default date position.
610 * New: Added options to add a background color and rounded corners to your posts
611 * New: If your Facebook event has an end date then it will now be displayed after the start date
612 * New: Hashtags in the post descriptions are now also linked
613 * New: Tested and approved for the upcoming WordPress 4.0 release
614 * Tweak: Moved the 'View on Facebook' link to the left side
615 * Tweak: Added error handling to improve user experience
616 * Tweak: If the Facebook API can't be reached by the plugin for some reason then it no longer caches the empty response and instead keeps trying to retrieve the posts from Facebook until it is successful
617 * Fix: Removed some redundant inline CSS used on the posts
618 * Fix: If there is a token in the 'Access Token' field but the 'Enter my own Access Token' box is unchecked then the plugin will no longer use it
619 * Fix: Added the trim() function to the 'Test connection to Facebook API' function to improve reliability
620 * Fix: Fixed an occasional JavaScript error which occurred when the post text was hidden
621
622 = 1.9.9.3 =
623 * New: Hashtags in link, photo and video descriptions are now also linked
624 * Fix: Fixed an issue with hashtags being linked when the post text is also linked, which interfered with the text formatting
625
626 = 1.9.9.2 =
627 * Fix: Removed a couple of stray PHP notices
628
629 = 1.9.9.1 =
630 * Fix: Fixed an occasional issue with hashtags in inline CSS inadvertently being linked
631
632 = 1.9.9 =
633 * New: Hashtags in your posts are now linked to the hashtag search on Facebook. This can be disabled in the 'Post Text' section on the Typography settings page.
634 * New: Added a Facebook icon to the Custom Facebook Feed admin menu
635 * Fix: Corrected the left side margin on the "Like" box so that it aligns correctly with posts
636
637 = 1.9.8.1 =
638 * Fix: Fixed an admin JavaScript error introduced by the last update
639
640 = 1.9.8 =
641 * Tweak: The Access Token field is now hidden by default and is revealed by a checkbox
642 * Fix: Fixed an issue with link colors not being applied to all links
643 * Fix: Removed the link box container from posts which contain non-youtube/vimeo links
644 * Fix: Links which don't contain a 'http://' protocol are now linked correctly
645
646 = 1.9.7 =
647 * Fix: Fixed an issue with a generic function name which was occasionally causing an error
648
649 = 1.9.6 =
650 * Tweak: Added an HTML wrapper element around the feed
651
652 = 1.9.5 =
653 * New: Added an option to set a height on the Like box. This allows you to display more faces of your fans if you have that option selected.
654 * Tweak: Added a few stricter CSS styles to help minimize the chance of theme stylesheets distorting post formatting
655 * Tweak: Added a span to the header text to allow CSS to be applied
656 * Fix: Fixed a bug with the post author text bumping down below the author image in the Firefox browser
657 * Fix: Corrected a bug which caused some links not to have the color applied
658 * Fix: Fixed a float issue in Firefox which sometimes caused the feed to be pushed off the page
659
660 = 1.9.4 =
661 * New: Added background and border styling options to shared links
662 * Tweak: Reduced the clickable area of the post author
663 * Tweak: Added a 'Customize' tab to the Settings page
664 * Fix: Fixed an issue with post tag linking not working correctly in some languages
665 * Fix: Fixed an issue with line breaks not being respected in IE8
666
667 = 1.9.2 =
668 * Fix: Added title and alt attributes to the post author's Facebook profile picture
669 * Fix: Improved the reliability of the post tag linking
670 * Fix: Fixed an issue with HTML characters not rendering correctly when linking the post text
671 * Fix: Improved the reliability of the CSS clearing method used on the feed container
672 * Compatible with WordPress 3.9
673
674 = 1.9.1 =
675 * Fix: Fixed an issue with the 'textlink' shortcode option
676 * Fix: Fixed an bug with post text sometimes being duplicated when linked
677 * Fix: Removed error_reporting(0);
678
679 = 1.9.0 =
680 * New: Added the ability to change the text size and color of the post author
681 * New: Define the format, size and color of shared link titles
682 * New: You can now define the color of the links in your post text, descriptions and Facebook events
683 * Tweak: Moved the Feed Header options to the Typography page
684 * Tweak: Moved the Ajax setting to the Misc page
685 * Tweak: Now removes any query strings attached to the Facebook Page ID
686 * Fix: Fixed an issue with some themes causing the clear element to prevent links being clickable
687 * Fix: Some minor bug fixes
688
689 = 1.8.2.3 =
690 * New: Now supports Facebook tags - creates links when using the @ symbol to tag other people or Facebook pages in your posts
691 * Tweak: Changed the method used for link replacement in posts
692 * Fix: Fixed issue with php include
693
694 = 1.8.1 =
695 * New: Added an 'exclude' shortcode option to allow you to easily exclude specific parts of the post
696 * New: Timeline events are now cached to help reduce page load time
697 * New: Added an option for when the WordPress theme is loading the feed via AJAX so that the JavaScript runs after the feed has been loaded into the page
698 * Tweak: Changed author images back to loading via PHP rather than JavaScript due to issues with certain WordPress themes
699 * Fix: Reset the timezone after the shortcode has run
700 * Fix: Fixed an issue with the shared link descriptions not being hidden when specified
701 * Fix: Fixed a rare issue with the 'textlink' shortcode option
702 * Fix: Use a fallback JSON string if unable to find the cached version in the database
703
704 = 1.8.0 =
705 * New: Added a built-in color picker
706 * New: Added class to posts based on the author to allow for independent styling
707 * Tweak: Now loads the author's Facebook profile picture in using JavaScript to help speed up load times
708 * Tweak: Now automatically set the Facebook post limit based on the number of Facebook posts to be displayed
709 * Tweak: Core improvements to the way Facebook posts are output
710 * Tweak: Changed 'Layout & Style' page name to 'Customize'
711 * Tweak: Moved the Support information to a tab on the Settings page
712 * Tweak: Improved the 'Test connection to Facebook API' function
713 * Fix: Encode Facebook URLs so that they pass HTML validation
714 * Fix: Fixed an issue with Facebook post captions not displaying under some circumstances
715 * Fix: More robust method for stripping the URL when a user enters Facebook page URL instead of their Facebook Page ID
716
717 = 1.7.2 =
718 * Tweak: Moved the 'Show post author' option from the General settings tab to the Post Layout tab
719 * Tweak: Added the ability to show or hide the author to the 'include' shortcode option
720 * Fix: Added CSS box-sizing property to feed header so that padding doesn't increase its width
721 * Fix: Fixed showheader=false and headeroutside=false shortcode options
722 * Fix: Now allows users to enter their Facebook page URL as their Facebook Page ID
723
724 = 1.7.0 =
725 * New: Added ability to add a customizable header to your feed
726 * New: Added a Custom JavaScript section to allow you to add your own JS or jQuery functionality to the feed
727 * New: Added a 'Custom Text / Translate' tab to house all customizable text
728 * New: You can now choose to show posts only by other people on your Facebook page
729 * New: Set your timezone so that dates/times are displayed in your local time
730 * New: When a Facebook post contains a link to multiple images it now states the number of photos after the post text and links to the Facebook album
731 * Tweak: Plugin now detects whether the page is using SSL and pulls https resources
732 * Tweak: Added a button to test the connection to Facebook's API for easier troubleshooting
733 * Fix: Now using HTML encoding to parse any raw HTML tags in the Facebook post text or descriptions
734 * Fix: Added a protocol to the beginning of links which don't include one
735 * Fix: Fixed date width issue in IE7
736 * Fix: Removed stray PHP notices
737 * Fix: Added a space between the Like Box attributes
738
739 = 1.6.8.2 =
740 * Fix: Fixed a CSS bug in Firefox which was causing the page author name to bump down below the avatar
741
742 = 1.6.8.1 =
743 * Tweak: Moved 'View on Facebook' link up to be level with the date rather than on the line below it
744 * Fix: Don't show the caption when it is the same as the Facebook post text
745 * Fix: Fixed issue with enqueueing JavaScript file
746
747 = 1.6.8 =
748 * New: Added option to remove border from the Facebook Like box when showing faces
749 * New: Set Facebook "Like" box text color to either blue or white
750 * Tweak: Moved descripion below video or link title and added link source
751 * Tweak: Added ability to manually translate the '2 weeks ago' text
752 * Tweak: Replaced 'View Link' with 'View on Facebook' so that shared links now link to the Facebook post
753 * Tweak: Facebook "Like" box is now responsive
754 * Tweak: Displays Facebook post caption if no description is available
755 * Tweak: Vertically center multi-line author names rather than bumping them down below the Facebook profile picture
756 * Tweak: Checks whether the Access Token is inputted in the correct format
757 * Fix: Fixed bug in the 'Show posts on my page by others' option
758 * Fix: If displaying a Facebook group then automatically hides the Facebook "Like" box
759 * Fix: 'others=false' shortcode option now working correctly
760 * Fix: Strip any white space characters from beginning or end of Access Token and Facebook Page ID
761
762 = 1.6.7.1 =
763 * Fix: Fixed a bug in 1.6.7 which was causing an issue displaying the Facebook feed in some circumstances
764
765 = 1.6.7 =
766 * New: Your Facebook feed can now be completely displayed in any language - added i18n support for date translation
767 * Tweak: Improved documentation within the plugin
768 * Tweak: Changed order of methods used to retrieve Facebook feed data
769
770 = 1.6.6.3 =
771 * New: Added support for Facebook group events
772
773 = 1.6.6.1 =
774 * Fix: Resolved jQuery UI draggable bug which was causing issues with drag and drop
775
776 = 1.6.6 =
777 * New: Now works with Facebook groups
778 * Fix: Fixed an issue with the 'Show posts by others' option not working correctly in the previous version
779
780 = 1.6.4 =
781 * New: Added localization support. Full support for various languages coming soon
782 * New: Added CSS classes to different Facebook post types to allow for different styling based on post type
783 * New: Option to link statuses to either the status post itself or the directly to the Facebook page/timeline
784 * New: Added option to add thumbnail faces of fans to the Facebook Like box and define a width
785 * Tweak: Added separate classes to 'View on Facebook' and 'View Link' links so that they can be targeted with CSS
786 * Tweak: Prefixed every CSS class to prevent styling conflicts with theme stylesheets. Please note that if you used custom CSS to style parts of the feed that the CSS classes are now prefixed with 'cff-' to prevent theme conflicts. Eg. '.more' is now '.cff-more'.
787
788 = 1.6.3 =
789 * New: Added support for Facebook 'Offers'
790 * Fix: Fixed an issue with the 'others' shortcode option not working correctly
791 * Fix: Prefixed the 'clear' class to prevent conflicts
792
793 = 1.6.2 =
794 * New: Post caching now temporarily stores your Facebook post data in your WordPress database to allow for super quick load times
795 * New: Define your own caching time. Check for new Facebook posts every few seconds, minutes, hours or days. You decide.
796 * New: Define your own custom text for the 'See More' and 'See Less' buttons
797 * New: Add your own CSS class to your Custom Facebook Feeds
798 * New: Define a Facebook post limit which is higher or lower than the default 25
799 * New: Include the Facebook Like box inside or outside of the Facebook feed's container
800 * New: Customize the Facebook event date independently
801 * New: Improved layout of admin pages for easier navigation and customization
802 * Fix: Provided a fix for the Facebook API duplicate post bug
803 * Fix: Fixed bug which ocurred when multiple Facebook feeds are displayed on the same page with different text lengths defined
804
805 = 1.5.2 =
806 * Fix: Fixed JavaScript error in previous update
807
808 = 1.5.1 =
809 * New: Added a 'See More' link to expand any text which is longer than the character limit defined
810 * New: Choose to show Facebook posts by other people in your feed
811 * New: Option to show the post author's Facebook profile picture and name above each post
812 * New: Added options to customize and format the Facebook post date
813 * New: Add your own text before and after the date and in place of the 'View on Facebook' and 'View Link' text links
814 * New: Specify the format of the Facebook Event date
815 * Tweak: Default date format is less specific and better mimics Facebook's - credit Mark Bebbington
816 * Tweak: Changed the layout of the Typography section to allow for the additional options
817 * Fix: When a Facebook photo album is shared it now links to the album itself on Facebook and not just the cover photo
818 * Fix: Fixed issue with hyperlinks in post text which don't have a space before them not being converted to links
819
820 = 1.4.8 =
821 * Minor fixes
822
823 = 1.4.7 =
824 * Tweak: Added links to statuses which link to the Facebook page
825 * Tweak: Added classes to Facebook event date, location and description to allow custom styling
826 * Tweak: Removed 'Where' and 'When' text from Facebook events and made bold instead
827
828 = 1.4.6 =
829 * Fix: Fixed 'num' option in shortcode
830
831 = 1.4.4 =
832 * New: Added more shortcode options
833 * Minor tweaks
834
835 = 1.4.2 =
836 * New: Add your own custom CSS to allow for even deeper customization
837 * New: Optionally link your post text to the Facebook post
838 * New: Optionally link your event title to the Facebook event page
839 * Some minor modifications
840
841 = 1.4.1 =
842 * Fix: Set all parts of the Facebook feed to display by default on activation
843
844 = 1.4.0 =
845 * Major Update!
846 * New: Loads of new customization options for your Custom Facebook Feed
847 * New: Define Facebook feed width, height, padding and background color
848 * New: Change the font-size, font-weight and color of the Facebook post text, description, date, links and event details
849 * New: Choose whether to show or hide certain parts of the Facebook posts
850 * New: Select whether the Facebook Like box is shown at the top of bottom of the Facebook feed
851 * New: Choose Facebook Like box background color
852
853 = 1.3.6 =
854 * Minor modifications
855
856 = 1.3.5 =
857 * New: Shared Facebook events now display event details (name, location, date/time, description) directly in the Facebook feed
858
859 = 1.3.4 =
860 * New: Email addresses within the Facebook post text are now hyperlinked
861 * Fix: Links beginning with 'www' are now also hyperlinked
862
863 = 1.3.3 =
864 * New: Added support for Facebook events - display the Facebook event details (name, location, date/time, description) directly in the Facebook feed
865 * Fix: Links within the Facebook post text are now hyperlinked
866 * Tweak: Added additional methods for retrieving Facebook feed data
867
868 = 1.3.2 =
869 * Fix: Now using the built-in WordPress HTTP API to get retrieve the Facebook data
870
871 = 1.3.1 =
872 * Fix: Fixed issue with certain Facebook statuses not displaying correctly
873
874 = 1.3.0 =
875 * Tweak: If 'Number of Posts to show' is not set then default to 10 Facebook posts
876
877 = 1.2.9 =
878 * Fix: Now using cURL instead of file_get_contents to prevent issues with php.ini configuration on some web servers
879
880 = 1.2.8 =
881 * Fix: Fixed bug in specifying the number of Facebook posts to display
882
883 = 1.2.7 =
884 * Tweak: Prevented likes and comments by the page author showing up in the Facebook feed
885
886 = 1.2.6 =
887 * Tweak: Added help link to Custom Facebook Feed settings page
888
889 = 1.2.5 =
890 * Fix: Added clear fix
891
892 = 1.2.1 =
893 * Fix: Minor bug fixes
894
895 = 1.2 =
896 * New: Added the ability to define a maximum length for both the Facebook post text and description
897
898 = 1.0 =
899 * Launch!