PluginProbe ʕ •ᴥ•ʔ
Smash Balloon Social Post Feed – Simple Social Feeds for WordPress / 4.0.1
Smash Balloon Social Post Feed – Simple Social Feeds for WordPress v4.0.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 4 years ago assets 4 years ago inc 4 years ago languages 5 years ago templates 4 years ago vendor 5 years ago README.txt 4 years ago changelog.txt 5 years ago composer.json 5 years ago custom-facebook-feed.php 4 years ago email.php 5 years ago gpl-2.0.txt 5 years ago
README.txt
972 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: 4.1
5 Requires PHP: 5.6
6 Tested up to: 5.8
7 Stable tag: 4.0.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**, **search engine crawlable**, and **GDPR compliant** 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 using our visual feed customizer - 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 **GDPR Compliant**
40 Automatically integrates with many of the popular GDPR cookie consent plugins and includes a 1-click easy GDPR setting.
41
42 **Responsive and Mobile Optimized**
43 Facebook feed layouts look great on any screen size and in any container width.
44
45 **Unlimited Feeds from Unlimited Different Facebook Pages**
46 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.
47
48 **Built for Speed**
49 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.
50
51 **Like Box Widget and Visual Header**
52 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.
53
54 **So Much More**
55 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.
56
57 ### Pro Version (Custom Facebook Feed Pro)
58
59 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.
60
61 * [Find out more about Custom Facebook Feed Pro](https://smashballoon.com/custom-facebook-feed/?utm_campaign=facebook-free&utm_source=readme&utm_medium=findout "Custom Facebook Feed Pro")
62 * [Try out the Custom Facebook Feed Pro demo](https://smashballoondemo.com/?utm_campaign=facebook-free&utm_source=readme&utm_medium=demo "Custom Facebook Feed Pro Demo").
63
64 ### Benefits of Displaying a Facebook Feed on Your Website
65
66 * **Increase social engagement** between you and your users, customers, or fans
67 * **Save time** by using the Custom Facebook Feed to generate dynamic, search engine crawlable content on your website
68 * **Get more likes** by displaying your Facebook content directly on your site
69 * **Improve your SEO** as all of that quality keyword-rich Facebook content from posts and Facebook comments is directly embedded into your website
70 * Display your Facebook content your way to perfectly match your website's style
71 * **No Coding Required** - choose from tons of built-in customization options to create a truly unique feed of your Facebook content.
72 * The Custom Facebook Feed plugin is **updated regularly** with new features, bug-fixes and Facebook API changes
73 * Support is quick and effective
74 * We're dedicated to providing the **most customizable**, **robust** and **well supported** Facebook feed plugin in the world!
75
76 ### How to use the Custom Facebook Feed plugin
77
78 Once you've installed the plugin there are only a few steps to get up and running:
79
80 1) Use the button on the 'Facebook Feed' settings page to log into your Facebook account and authorize the plugin.
81 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.
82
83 That's it! You can then customize the Facebook feed as needed using the settings on the Facebook Feed > Customize page.
84
85 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").
86
87 ### Requesting support
88
89 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.
90
91 ### Who's behind this plugin?
92
93 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.
94
95 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").
96
97 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").
98
99 == Installation ==
100
101 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).
102 2. Activate the plugin through the 'Plugins' menu in WordPress.
103 3. Navigate to the 'Facebook Feed' settings page to configure your feed.
104 4. Use the shortcode `[custom-facebook-feed]` in your page, post or widget to display your feed.
105 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]`.
106
107 == Frequently Asked Questions ==
108
109 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
110
111 = Are there any limitations on which Facebook page or Facebook group feeds I can display? =
112
113 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.
114
115 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.
116
117 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.
118
119 = Can I display feeds from multiple Facebook pages? =
120
121 Yep! Create as many feeds as you like from different Facebook pages. Just click "Add New" to create a new feed and then embed it anywhere on your site.
122
123 = Can I display feeds from a Facebook Group? =
124
125 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.
126
127 = Can I display the feed from a personal Facebook profile? =
128
129 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.
130
131 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.
132
133 Once you've done so, the plugin will be able to retrieve and display all of your posts.
134
135 = Does the plugin work with Facebook oEmbeds? =
136
137 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.
138
139 = Can I show photos and videos in my Custom Facebook feed? =
140
141 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.
142
143 = Can I show the comments, shares and likes associated with each Facebook post? =
144
145 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.
146
147 = Is the content of my Custom Facebook Feed crawlable by search engines? =
148
149 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.
150
151 = How do I embed the Custom Facebook Feed directly into a WordPress page template? =
152
153 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]'); ?>`.
154
155 = My Facebook feed posts are not showing up, or all I can see is the Facebook Like box but no posts =
156
157 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.
158
159 = Create a basic slideshow from your Facebook posts =
160
161 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:
162
163 1) Add a class to the shortcode of the Facebook feed that you want to convert into a slideshow:
164
165 `[custom-facebook-feed class="slideshow"]`
166
167 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:
168
169 `[custom-facebook-feed class="slideshow" num=10]`
170
171 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:
172
173 `var shortcodeClass = 'slideshow',
174 cffSpeed = 5000,
175 $cff = $('#cff.'+ shortcodeClass);
176 $cffItem = $cff.find('.cff-item'),
177 cffNum = $cffItem.length,
178 cffCur = 0;
179 $cffItem.hide();
180 setTimeout(function(){ $cff.find('.cff-item').eq(0).show(); }, 200);
181 setInterval(function(){
182 $cff.find('.cff-item').eq(cffCur).fadeOut( "fast", function() {
183 if( cffCur == cffNum-1 ) cffCur = -1;
184 cffCur++;
185 $cff.find('.cff-item').eq(cffCur).fadeIn();
186 });
187 }, cffSpeed);`
188
189 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).
190
191 = Changing the font in your Facebook feed and using Google Fonts =
192
193 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.
194
195 = Can I display my Facebook posts horizontally or in multiple columns? =
196
197 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.
198
199 = My Facebook feed appears to have stopped updating / working =
200
201 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").
202
203 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.
204
205 **Potential solutions**
206
207 * 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.
208
209 * 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.
210
211 = I'm receiving an error message when trying to display my Facebook posts =
212
213 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.
214
215 = Creating a Masonry grid layout from your Facebook posts =
216
217 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.
218
219 = How do I customize my Facebook feed? =
220
221 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.
222
223 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]`.
224
225 = The Custom Facebook Feed shortcode options aren't working =
226
227 The most common causes of this are:
228
229 1) There's HTML tags within the [custom-facebook-feed] shortcode which are preventing it from working correctly
230
231 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.
232
233 2) The shortcode includes curly single quote characters
234
235 If your shortcode includes single quotes then check that they are the standard single quotes and not the curly kind.
236
237 3) Typo in the shortcode option
238
239 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").
240
241 = Facebook avatar pictures aren't showing up in my Facebook feed =
242
243 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.
244
245 == Other Notes ==
246
247 = At Smash Balloon we have two goals: =
248
249 1. Creating and maintaining the most useful, functional, customizable, robust and down-right awesomist Facebook feed plugin your website has ever seen.
250 2. To provide the quickest, friendliest and most mind-blowingly amazing product support you have ever experienced.
251
252 == Screenshots ==
253
254 1. By default the Facebook feed inherits your theme's default styles and the Facebook feed is completely responsive
255 2. Completely customize the way your Facebook feed looks to perfectly match your site
256 3. Use custom CSS to customize every part of the Facebook feed
257 4. Display Facebook events in your Facebook feed
258 5. Configuring the Custom Facebook Feed plugin
259 6. General Facebook Feed options - Custom Facebook Feed Layout and Style page
260 7. Facebook Feed Typography options - Custom Facebook Feed Layout and Style page
261 8. Misc Facebook Feed options - Custom Facebook Feed Layout and Style page
262 9. It's super easy to display your Facebook feed in any page or post
263
264 == Changelog ==
265 = 4.0.1 =
266 * Fix: Fixed a compatibility issue with the Complianz Cookie Consent plugin integration.
267 * Fix: Removed the limit to the number of sources shown at one time when creating a feed.
268 * Fix: When using a narrow screen, modals inside the feed creator in the backend would be cut off.
269 * Fix: Fixed an issue where settings were not preserved even when using the preserve settings option and deleting the plugin.
270 * Fix: Improved security hardening.
271 * Fix: Fixed some options and tables not being removed from the WordPress database on uninstall.
272 * Fix: Locations of feeds sorted by source would not work if the source ID was not a number.
273 * Fix: Fixed PHP warnings when viewing dashboard notifications.
274 * Fix: Fixed locale setting causing a PHP warning if not set.
275
276 = 4.0 =
277 * Important: Minimum supported WordPress version has been raised from 3.0 to 4.1.
278 * New: Our biggest update ever! We've completely redesigned the plugin settings from head to toe to make it easier to create, manage, and customize your Facebook feeds.
279 * New: All your feeds are now displayed in one place on the "All Feeds" page. This shows a list of any existing (legacy) feeds and any new ones that you create. Note: If you updated from a version prior to v2.19 then you may need to view your feeds on your webpage so that the plugin can locate them and list them here.
280 * New: Easily edit individual feed settings for new feeds instead of cumbersome shortcode options.
281 * New: It's now much easier to create feeds. Just click "Add New", select your feed type, connect your account, and you're done!
282 * New: Brand new feed customizer. We've completely redesigned feed customization from the ground up, reorganizing the settings to make them easier to find.
283 * New: Live Feed Preview. You can now see changes you make to your feeds in real time, right in the settings page. Easily preview them on desktop, tablet, and mobile sizes.
284 * New: Elementor and WordPress widgets. We've added new Elementor and WordPress widgets to make it easier to embed your feeds.
285 * New: Color Scheme option. It's now easier than ever to change colors across your feed without needing to adjust individual color settings. Just set a color scheme to effortlessly change colors across your entire feed.
286 * New: You can now change the number of columns in your feed across desktop, tablet, and mobile.
287 * New: Easily import and export feed settings to make it simple to move feeds across sites.
288
289 = 2.19.3 =
290 * Fix: Fixed an issue with a blank screen sometimes appearing when trying to connect a Facebook account
291
292 = 2.19.2 =
293 * Tested with WordPress 5.8 update.
294 * Fix: PHP error "Uncaught Error: array_merge() does not accept unknown named parameters" when visiting the "About" page using PHP 8+.
295 * Fix: Fixed an issue with GDPR Cookie Consent by Web Toffee integration.
296
297 = 2.19.1 =
298 * New: In this update, the plugin will now use a persistent cache to store your Facebook group posts. This will help minimize any affects of a Facebook API change on May 25th which will only allow Facebook Groups to retrieve content from the past 90 days. The plugin will store your group posts in the persistent cache so that those posts can continue to be displayed beyond 90 days. This update will also make a one-time request to get the last 100 posts from your group and store those too, so that the affect of this change will be minimal for our users. Please [see here](https://smashballoon.com/doc/facebook-api-change-limits-groups-to-90-days/) for more information.
299 * Tweak: Updated jQuery methods in preparation for jQuery migrate removal in an upcoming WordPress core update.
300 * Tweak: Added option to enqueue CSS and JS files only when shortcode is on the page.
301 * Tweak: Added an reset error log button to the settings page.
302 * Tweak: Added an option to hide the call-to-action button in the post content.
303 * Fix: Changed how access tokens are retrieved to prevent conflict with the "Rank Math SEO" plugin when connecting an account.
304 * Fix: Fixed an error in the Feed Finder tool when removing accounts.
305 * Fix: Fixed an issue with duplicated records in the feed finder.
306 * Fix: Fixed "Unknown error" response with API story tag calls.
307
308 = 2.19 =
309 * New: Improved the error reporting system to make resolving issues easier.
310 * New: The locations of the Facebook feeds on your site will now be logged and listed on a single page for easier management. After this feature has been active for awhile, a "Feed Finder" link will appear under your connected accounts on the plugin Settings page which allows you to see a list of all feeds on your site along with their locations.
311 * Tweak: When clearing the plugin cache, the cache in the Litespeed plugin will now also be cleared if being used on the site.
312 * Fix: Fixed an issue with anonymous avatars not displaying correctly in group feeds.
313
314 = 2.18.3 =
315 * Tweak: Updated deprecated jQuery functions to prevent potential issues with newer versions.
316 * Tweak: Due to an API bug which Facebook hasn't resolved yet that affects buy/sell posts in groups, we have added a 'salesposts' shortcode option which will work around the issue until they fix it. If you are displaying posts from a group and receiving an "API Error 100" notice then adding `salesposts=true` to your shortcode and clearing the plugin cache should resolve the issue.
317 * Fix: When displaying the feed in multiple columns, clicking the "See more" link in the post text wouldn't correctly reconfigure the layout.
318 * Fix: Fixed a layout issue with the posts and Like Box which occurred when using a multi-column layout and applying feed padding.
319 * Fix: Fixed an issue with the background color not being applied correctly when set to be black.
320
321 = 2.18.2 =
322 * Tweak: Now displays a notice to logged-in admins which lets you know if the Like Box or header cover photo is being intentionally hidden due to the GDPR setting.
323 * Fix: Fixed an error which occurred when deleting the plugin.
324
325 = 2.18.1 =
326 * Fix: Fixed an issue with the integration with the Complianz plugin
327 * Fix: Resolved a PHP warning related to the preg_replace_callback function which was displayed under certain conditions
328 * Fix: Resolved a PHP deprecation notice related to the strpos function in PHP 7.3
329
330 = 2.18 =
331 * New: The plugin code has been completely refactored to improve performance and maintainability. If you experience any issues with this update then please open a support ticket [here](https://wordpress.org/support/plugin/custom-facebook-feed/) so that we can address it right away. Thank you!
332 * New: Integrations with popular GDPR cookie consent solutions added: Cookie Notice by dFactory, GDPR Cookie Consent by WebToffee, Cookiebot by Cybot A/S, Complianz by Really Simple Plugins, and Borlabs Cookie by Borlabs. See the GDPR setting in the following location for more information: Facebook Feed > Customize > Misc > GDPR.
333 * Note: The minimum supported PHP version has been increased to PHP version 5.6. If you are using a lower version then a notice will be displayed with a button to revert back to the previous version.
334
335 = 2.17.1 =
336 * 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 Facebook post date.
337 * Tweak: Minor frontend CSS improvements.
338 * Tweak: Added support for improved notices on the plugin settings page.
339 * Fix: Fixed an issue with the Facebook Like Box widget displaying an error if the width was set to a fractional pixel.
340
341 = 2.17 =
342 * 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.
343 * 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.
344
345 = 2.16.1 =
346 * Fix: Added a workaround for a Facebook API bug which sometimes displays a button in a post with the text "No Button".
347 * Fix: Added an additional check when formatting the post text for the share link to prevent potential issues.
348 * Fix: Fixed a typo in the "restrictedpage" shortcode option.
349
350 = 2.16 =
351 * 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/).
352 * 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
353 * Fix: Fixed a minor compatibility issue with the upcoming WordPress 5.5 release
354 * Fix: Removed the see more/less links from post text when using the email share link.
355 * Fix: Removed a stray "section" closing tag which was causing a layout issue in some themes and inadvertently displayed the PPCA notice.
356
357 = 2.15.1 =
358 * 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.
359 * Fix: Disabled the "About Us" page plugin installation if using a version of WordPress earlier than 4.6.
360
361 = 2.15 =
362 * 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.
363 * 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.
364 * 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.
365 * New: Added capability "manage_custom_facebook_feed_options". Users with this capability can make changes to Facebook Feed settings and view admin only messages.
366 * New: Added a PHP filter "cff_post_text" to change the post text before outputting it in the feed HTML.
367
368 = 2.14.1 =
369 * Fix: Some connection error notices not clearing automatically.
370
371 = 2.14 =
372 * 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.
373 * 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.
374 * 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.
375 * 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.
376
377 = 2.13 =
378 * 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.
379 * New: Added support for translations.
380
381 = 2.12.4 =
382 * Tested with upcoming WordPress 5.4 update.
383 * Tweak: Updated Facebook API calls
384 * Fix: Minor bug fixes
385
386 = 2.12.3 =
387 * 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/)
388 * 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.
389 * Tweak: Added 'rel="noopener"' to all external links and added 'rel="noreferrer"' to all non-Facebook links. Thanks to Dev VIP for the suggestion.
390 * Fix: Fixed an issue with some Facebook call-to-action link URLs when a link protocol wasn't included
391 * Fix: Fixed a JavaScript conflict with the [Forminator](https://wordpress.org/plugins/forminator/) plugin
392 * Fix: Fixed duplicate Facebook post message displaying due to ellipsis HTML character
393 * 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
394
395 = 2.12.2 =
396 * Fix: Fixed a JavaScript error in the admin caused by the previous update. Apologies for any inconvenience.
397
398 = 2.12.1 =
399 * Fix: Fixed an issue with Facebook post date timezones due to changes in the WordPress 5.3 update
400 * 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
401 * Fix: Fixed a JavaScript error in the admin when using older web browsers
402 * Tweak: Improved the manual account connection process
403 * Tweak: Some minor UI tweaks to match the new WordPress 5.3 UI style
404
405 = 2.12 =
406 * New: Added a backup cache so the Facebook feed will still display even if there's an error from the Facebook API.
407 * 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.
408 * Tweak: Added a filter which can be used to filter the Facebook API data when returned; `cff_filter_api_data`.
409 * Tweak: Updated Facebook API error messages
410 * Fix: Fixed an issue with some @tag links in Facebook post text due to a Facebook API change
411 * Fix: Fixed a rare issue with ellipsis chracter symbols in Facebook shared link descriptions causing the entire link description not to be displayed
412
413 = 2.11.1 =
414 * Tweak: Added the link source URL below the title for Facebook shared link posts
415 * Fix: Some themes would prevent the Facebook "Share" link from working successfully
416 * 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
417
418 = 2.11 =
419 * 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.
420 * New: Updated to use v4.0 of the Facebook API
421
422 = 2.10 =
423 * 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.
424 * 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
425 * Fix: Photo icons weren't showing for Facebook album posts
426 * Tweak: Now uses the Facebook `visitor_posts` endpoint to display visitor Facebook post feeds
427
428 = 2.9.1 =
429 * New: Added support for v3.3 of the Facebook API.
430 * Fix: The Facebook Access Token selection area was being cut off on small screens when a lot of Facebook pages were listed.
431
432 = 2.9 =
433 * 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.
434 * 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`.
435 * New: Improved the Facebook Access Token retrieval process to make it more intuitive.
436 * Tweak: Facebook avatar images are now circular to match Facebook.
437 * Tweak: Animated the social media icons when the Facebook "Share" button is clicked.
438 * 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.
439 * Tweak: Changed the elements used for icons from `<i>` to `<span>` to aid accessibility.
440 * Tweak: Removed the Google+ share option as the platform has been deprecated.
441 * 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.
442 * 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.
443 * 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.
444 * 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.
445 * Fix: Fixed an accessibility error caused by the Facebook share icons being empty links.
446 * Fix: Removed the use of the ENT_HTML5 constant as it isn't supported in PHP 5.4.
447 * Fix: Fixed a rare issue with Facebook tags in Facebook post stories when the locale was set to be Greek.
448
449 = 2.8 =
450 * 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.
451 * 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
452 * 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?
453 * 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
454 * Tweak: The Timezone setting can now be set in the Custom Facebook Feed shortcode. Eg: `timezone="America/Los_Angeles"`
455 * Tweak: Minor UI changes to the Facebook Feed admin pages
456 * Tweak: Reduced some of the Facebook data in the System Info
457 * Fix: If you backdate a Facebook post it will now be ordered correctly in your Facebook feed
458 * Fix: Fixed a theme conflict related to the Color Picker in the Facebook Feed admin section
459 * Verified compatibility with WordPress 5.0 and Gutenburg
460
461 = 2.7.2 =
462 * **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.
463 * Fix: Fixed a rare issue caused by some themes including the JavaScript file incorrectly
464
465 = 2.7.1 =
466 * Tweak: Made some adjustments to the Facebook Access Token login process
467
468 = 2.7 =
469 * 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!
470 * Tweak: Removed the minimum caching time if you're using your own Facebook Page Access Token
471
472 = 2.6.4 =
473 * **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.
474
475 = 2.6.3 =
476 * Fix: Fixed an issue where Facebook API errors were being cached
477
478 = 2.6.2 =
479 * Fix: Replaced all HTTP links in the Facebook feed with HTTPS
480 * Fix: Fixed a rare issue which affected the layout of other Facebook widgets
481 * Fix: Automatically remove slashes at the end of the Facebook Page ID as it caused an error
482 * 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
483 * Fix: Fixed an issue which caused an occasional Facebook API rate limit error
484
485 = 2.6.1 =
486 * Fix: Removed an unnecessary Facebook API call
487 * Fix: Removed a PHP notice which was displayed under rare circumstances
488 * Fix: Minor Facebook bug fixes
489
490 = 2.6 =
491 * Fix: Fixed an issue connecting to the Facebook API caused by a recent Facebook platform change
492 * Tweak: Increased the minimum caching time to be 15 minutes to reduce Facebook API requests
493
494 = 2.5.2 =
495 * 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.
496 * 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.
497
498 = 2.5.1 =
499 * Fix: Prevented a PHP notice which would be displayed under rare circumstances in the Facebook feed
500 * Fix: Replaced a function due to a deprecation in PHP 7.2
501
502 = 2.5 =
503 * New: Added the Facebook post story as part of the page/author name at the top of the Facebook post
504 * 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`
505 * 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`
506 * 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
507 * 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
508 * Tweak: Reorganized the Custom Facebook Feed settings pages to be more intuitive
509 * Tweak: Added aria-hidden=true to icons to help improve accessibility
510 * 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
511 * Tweak: Facebook error messages are now only shown to admins
512 * 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`
513 * Fix: Included a fallback in case the Facebook author name and avatar aren't available in visitor Facebook posts
514 * Fix: Fixed an issue with apostrophes in the Facebook feed header not being escaped correctly
515 * Fix: Fixed an issue with the Facebook icons when Font Awesome 5 was added to a site
516 * Fix: Added support for the @[ID:page-name] Facebook tagging format
517 * Fix: The Facebook post description is now able to be displayed even if the Facebook post text is hidden
518
519 = 2.4.6 =
520 * Compatible with WordPress 4.8
521
522 = 2.4.5 =
523 * Tweak: Updated plugin links for new WordPress.org repo
524 * Fix: Minor bug fixes
525
526 = 2.4.4 =
527 * 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]`
528 * Fix: Fixed an issue with the order of Facebook group posts in some Facebook feeds
529
530 = 2.4.3 =
531 * Fix: Fixed a potential security vulnerability
532 * Tested with upcoming WordPress 4.6 update
533
534 = 2.4.2 =
535 * 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.
536 * 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.
537 * Tweak: Created some specific [setup directions](https://smashballoon.com/custom-facebook-feed/docs/free/) for the free version.
538 * Fix: Minor bug fixes
539
540 = 2.4.1.2 =
541 * Updated to be compatible with Facebook API version 2.6
542
543 = 2.4.1.1 =
544 * Fix: Fixed a JavaScript error in the admin area when using WordPress 4.5
545
546 = 2.4.1 =
547 * 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.
548 * Tweak: Tested with WordPress 4.5
549 * Fix: Fixed an issue where the "Share" button in the plugin Like Box wasn't working correctly
550 * Fix: Added support for wp-config proxy settings. Credit to [@usrlocaldick](https://wordpress.org/support/topic/proxy-support-1) for the patch.
551
552 = 2.4 =
553 * 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
554 * New: You can now click on the name of a setting on the admin pages to reveal the corresponding shortcode for that setting
555 * New: Added quick links to the top of the Customize settings pages to make it easier to find certain settings
556 * New: Added a setting to allow you to disable the default plugin text and link styles (Customize > Misc > Disable default styles)
557 * 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
558 * Tweak: Updated the Font Awesome icon font to version 4.5
559 * Tweak: Moved the 'Show Header' setting to the 'General' tab on the Customize page
560 * Fix: Hashtag linking now works with all languages and character sets
561 * Fix: Fixed an error that occurred when trying to activate the Pro version with the free version still activated
562 * Fix: Fixed a rare error which occurred when the Facebook post contained no text and no story
563 * Fix: Fixed an issue when trying to display Facebook posts by only visitors to your Facebook page caused by a recent Facebook API update
564
565 = 2.3.10 =
566 * 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.
567
568 = 2.3.9 =
569 * 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
570
571 = 2.3.8 =
572 * 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
573 * Fix: Hashtags containing Chinese characters are now linked
574 * 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
575 * Tweak: Added a timezone for Sydney, Australia
576
577 = 2.3.7 =
578 * 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
579 * Fix: Removed specific encoding parameters from the cURL request method to prevent encoding issues on some servers
580
581 = 2.3.6 =
582 * 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)
583 * Fix: The plugin now works with Access Tokens which use the new recently-released version 2.4 of the Facebook API
584
585 = 2.3.5 =
586 * 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.
587 * Fix: Hashtags which contain foreign characters are now correctly linked to the hashtag on Facebook
588 * Fix: Links within Facebook post descriptions weren't opening in a new tab
589 * Fix: Removed empty style tags from some elements
590 * Fix: The URLs used for the 'Share' icons are now encoded to prevent any HTML validation errors
591 * Fix: Shared Facebook posts now link to the new shared post and not to the original post that was shared on Facebook
592 * Fix: Corrected a minor issue with the plugin caching string
593 * Fix: Fixed a minor issue with tags in the Facebook post text when creating/sharing an event
594 * Tweak: Add some stricter CSS to some parts of the feed to prevent theme conflicts
595 * 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
596
597 = 2.3.4 =
598 * 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.
599 * Fix: Fixed a rare bug which would occur if your Facebook page or Facebook group name contained a number
600
601 = 2.3.3 =
602 * Fix: Removed a PHP notice which was missed in the last update. Apologies for the two updates in quick succession.
603
604 = 2.3.2 =
605 * Fix: Fixed some stray PHP notices which were inadvertently introduced in a recent update
606 * Tweak: Added an option to not load the icon font included in the plugin
607
608 = 2.3.1 =
609 * New: Added a shortcode option to allow you to offset the number of posts to be shown. Eg: offset=2
610 * New: Added an email link to the sharing icons
611 * 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.
612 * Tweak: Added a prefix to the IDs on all Facebook posts so that they can now be targeted via CSS
613 * Tweak: Added "nofollow" to all links by default. This can be disabled by using `nofollow=false` in the shortcode.
614 * Tweak: Added some missing settings to the System Info section
615 * Tweak: Added the 'Timezone' setting to the main Settings page so that it's easier to find
616 * Fix: Added a workaround for Facebook changing the event URLs in their API from absolute to relative URLs
617 * 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
618 * Fix: Fixed a minor bug in the WP_Http fallback method
619 * Fix: Removed duplicate IDs on the share icons and replaced with classes
620 * Fix: Added a check to the file_get_contents data retrieval method to check whether the Open SSL wrapper is enabled
621 * Fix: The `eventtitlelink` shortcode option now works correctly
622 * Fix: Added a workaround for 'story_tags' which Facebook deprecated from their API
623 * Fix: Removed query string from the end of CSS and JavaScript file references and replaced it with the wp_enqueue_script 'ver' parameter instead
624
625 = 2.3 =
626 * Happy New Year!
627 * 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.
628 * 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
629 * Tweak: Increased the accuracy of the character count when links are included in the Facebook text
630 * Tweak: Improved the efficiency of the Facebook post caching
631 * Tweak: Replaced the rel attribute with the HTML5 data attribute when storing data on an element
632 * Tweak: Added HTTPS stream wrapper check to the System Info to aid in troubleshooting
633 * Tweak: Updated the plugin's icon font to the latest version
634 * 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.
635 * Tweak: Added a shortcode option to only show the Smash Balloon credit link on certain feeds: `[custom-facebook-feed credit=true]`
636 * Fix: Fixed an issue with quotes being escaped in custom/translated text
637 * Fix: Display an error message if WPHTTP function isn't working correctly
638 * Fix: The `postbgcolor` shortcode option is now working correctly
639
640 = 2.2.1 =
641 * Fix: Fixed a minor JavaScript error which occurs if a Facebook post doesn't contain any text
642
643 = 2.2 =
644 * New: Added a text area to the Support tab which contains all of the plugin settings and site info for easier troubleshooting
645 * 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
646 * Tweak: If the user doesn't add a unit to the width, height or padding then automatically add 'px'
647 * 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
648 * Fix: Fixed an issue with Facebook hashtags not being linked when followed immediately by punctuation
649 * Fix: When displaying a shared link if the caption is the same as the link URL then don't display it
650 * Fix: Added a space before the feed header's style attribute to remove HTML validation error
651 * Fix: Prefixed the 'top' and 'bottom' classes used on the Facebook Like box to prevent CSS conflicts
652 * Fix: Fixed an issue with the link color not being applied to Facebook hashtag links
653
654 = 2.1.3 =
655 * Fix: Fixed an issue with the Facebook Access Token used in the plugin hitting its request limit
656
657 = 2.1.2 =
658 * Fix: Added in a missing closing div tag to the Facebook feed when an error is being displayed
659
660 = 2.1.1 =
661 * Fix: Fixed an issue with the date not being hidden when unchecked in the Show/Hide section
662 * 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'
663
664 = 2.1 =
665 * New: Added an option to preserve/save your plugin options after uninstalling the plugin. This makes manually updating the plugin much easier.
666 * New: Added a 'Settings' link to the plugin on the Plugins page
667 * 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
668 * Tweak: Reduced the size of the author's Facebook profile picture from 50px to 40px to match Facebook
669 * Tweak: The link description text is now 12px in size by default
670 * Tweak: Added some default character limits to the post text and descriptions
671 * Tweak: If the post author is being hidden then change the default date position to be the bottom of the post
672 * 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
673 * Fix: Added a fb-root element to the Like box to prevent a browser console warning
674 * Fix: Renamed the ShowError function to prevent conflicts
675 * Fix: Fixed an issue with the 'seconds' custom text string not being saved correctly
676 * Fix: When linking the post text to the Facebook post the correct text color is now applied
677
678 = 2.0.1 =
679 * Tweak: Improved error handling and added an [Error Message reference](https://smashballoon.com/custom-facebook-feed/docs/errors/) to the website
680
681 = 2.0 =
682 * 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.
683 * New: Added options to add a background color and rounded corners to your posts
684 * New: If your Facebook event has an end date then it will now be displayed after the start date
685 * New: Hashtags in the post descriptions are now also linked
686 * New: Tested and approved for the upcoming WordPress 4.0 release
687 * Tweak: Moved the 'View on Facebook' link to the left side
688 * Tweak: Added error handling to improve user experience
689 * 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
690 * Fix: Removed some redundant inline CSS used on the posts
691 * 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
692 * Fix: Added the trim() function to the 'Test connection to Facebook API' function to improve reliability
693 * Fix: Fixed an occasional JavaScript error which occurred when the post text was hidden
694
695 = 1.9.9.3 =
696 * New: Hashtags in link, photo and video descriptions are now also linked
697 * Fix: Fixed an issue with hashtags being linked when the post text is also linked, which interfered with the text formatting
698
699 = 1.9.9.2 =
700 * Fix: Removed a couple of stray PHP notices
701
702 = 1.9.9.1 =
703 * Fix: Fixed an occasional issue with hashtags in inline CSS inadvertently being linked
704
705 = 1.9.9 =
706 * 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.
707 * New: Added a Facebook icon to the Custom Facebook Feed admin menu
708 * Fix: Corrected the left side margin on the "Like" box so that it aligns correctly with posts
709
710 = 1.9.8.1 =
711 * Fix: Fixed an admin JavaScript error introduced by the last update
712
713 = 1.9.8 =
714 * Tweak: The Access Token field is now hidden by default and is revealed by a checkbox
715 * Fix: Fixed an issue with link colors not being applied to all links
716 * Fix: Removed the link box container from posts which contain non-youtube/vimeo links
717 * Fix: Links which don't contain a 'http://' protocol are now linked correctly
718
719 = 1.9.7 =
720 * Fix: Fixed an issue with a generic function name which was occasionally causing an error
721
722 = 1.9.6 =
723 * Tweak: Added an HTML wrapper element around the feed
724
725 = 1.9.5 =
726 * 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.
727 * Tweak: Added a few stricter CSS styles to help minimize the chance of theme stylesheets distorting post formatting
728 * Tweak: Added a span to the header text to allow CSS to be applied
729 * Fix: Fixed a bug with the post author text bumping down below the author image in the Firefox browser
730 * Fix: Corrected a bug which caused some links not to have the color applied
731 * Fix: Fixed a float issue in Firefox which sometimes caused the feed to be pushed off the page
732
733 = 1.9.4 =
734 * New: Added background and border styling options to shared links
735 * Tweak: Reduced the clickable area of the post author
736 * Tweak: Added a 'Customize' tab to the Settings page
737 * Fix: Fixed an issue with post tag linking not working correctly in some languages
738 * Fix: Fixed an issue with line breaks not being respected in IE8
739
740 = 1.9.2 =
741 * Fix: Added title and alt attributes to the post author's Facebook profile picture
742 * Fix: Improved the reliability of the post tag linking
743 * Fix: Fixed an issue with HTML characters not rendering correctly when linking the post text
744 * Fix: Improved the reliability of the CSS clearing method used on the feed container
745 * Compatible with WordPress 3.9
746
747 = 1.9.1 =
748 * Fix: Fixed an issue with the 'textlink' shortcode option
749 * Fix: Fixed an bug with post text sometimes being duplicated when linked
750 * Fix: Removed error_reporting(0);
751
752 = 1.9.0 =
753 * New: Added the ability to change the text size and color of the post author
754 * New: Define the format, size and color of shared link titles
755 * New: You can now define the color of the links in your post text, descriptions and Facebook events
756 * Tweak: Moved the Feed Header options to the Typography page
757 * Tweak: Moved the Ajax setting to the Misc page
758 * Tweak: Now removes any query strings attached to the Facebook Page ID
759 * Fix: Fixed an issue with some themes causing the clear element to prevent links being clickable
760 * Fix: Some minor bug fixes
761
762 = 1.8.2.3 =
763 * New: Now supports Facebook tags - creates links when using the @ symbol to tag other people or Facebook pages in your posts
764 * Tweak: Changed the method used for link replacement in posts
765 * Fix: Fixed issue with php include
766
767 = 1.8.1 =
768 * New: Added an 'exclude' shortcode option to allow you to easily exclude specific parts of the post
769 * New: Timeline events are now cached to help reduce page load time
770 * 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
771 * Tweak: Changed author images back to loading via PHP rather than JavaScript due to issues with certain WordPress themes
772 * Fix: Reset the timezone after the shortcode has run
773 * Fix: Fixed an issue with the shared link descriptions not being hidden when specified
774 * Fix: Fixed a rare issue with the 'textlink' shortcode option
775 * Fix: Use a fallback JSON string if unable to find the cached version in the database
776
777 = 1.8.0 =
778 * New: Added a built-in color picker
779 * New: Added class to posts based on the author to allow for independent styling
780 * Tweak: Now loads the author's Facebook profile picture in using JavaScript to help speed up load times
781 * Tweak: Now automatically set the Facebook post limit based on the number of Facebook posts to be displayed
782 * Tweak: Core improvements to the way Facebook posts are output
783 * Tweak: Changed 'Layout & Style' page name to 'Customize'
784 * Tweak: Moved the Support information to a tab on the Settings page
785 * Tweak: Improved the 'Test connection to Facebook API' function
786 * Fix: Encode Facebook URLs so that they pass HTML validation
787 * Fix: Fixed an issue with Facebook post captions not displaying under some circumstances
788 * Fix: More robust method for stripping the URL when a user enters Facebook page URL instead of their Facebook Page ID
789
790 = 1.7.2 =
791 * Tweak: Moved the 'Show post author' option from the General settings tab to the Post Layout tab
792 * Tweak: Added the ability to show or hide the author to the 'include' shortcode option
793 * Fix: Added CSS box-sizing property to feed header so that padding doesn't increase its width
794 * Fix: Fixed showheader=false and headeroutside=false shortcode options
795 * Fix: Now allows users to enter their Facebook page URL as their Facebook Page ID
796
797 = 1.7.0 =
798 * New: Added ability to add a customizable header to your feed
799 * New: Added a Custom JavaScript section to allow you to add your own JS or jQuery functionality to the feed
800 * New: Added a 'Custom Text / Translate' tab to house all customizable text
801 * New: You can now choose to show posts only by other people on your Facebook page
802 * New: Set your timezone so that dates/times are displayed in your local time
803 * 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
804 * Tweak: Plugin now detects whether the page is using SSL and pulls https resources
805 * Tweak: Added a button to test the connection to Facebook's API for easier troubleshooting
806 * Fix: Now using HTML encoding to parse any raw HTML tags in the Facebook post text or descriptions
807 * Fix: Added a protocol to the beginning of links which don't include one
808 * Fix: Fixed date width issue in IE7
809 * Fix: Removed stray PHP notices
810 * Fix: Added a space between the Like Box attributes
811
812 = 1.6.8.2 =
813 * Fix: Fixed a CSS bug in Firefox which was causing the page author name to bump down below the avatar
814
815 = 1.6.8.1 =
816 * Tweak: Moved 'View on Facebook' link up to be level with the date rather than on the line below it
817 * Fix: Don't show the caption when it is the same as the Facebook post text
818 * Fix: Fixed issue with enqueueing JavaScript file
819
820 = 1.6.8 =
821 * New: Added option to remove border from the Facebook Like box when showing faces
822 * New: Set Facebook "Like" box text color to either blue or white
823 * Tweak: Moved descripion below video or link title and added link source
824 * Tweak: Added ability to manually translate the '2 weeks ago' text
825 * Tweak: Replaced 'View Link' with 'View on Facebook' so that shared links now link to the Facebook post
826 * Tweak: Facebook "Like" box is now responsive
827 * Tweak: Displays Facebook post caption if no description is available
828 * Tweak: Vertically center multi-line author names rather than bumping them down below the Facebook profile picture
829 * Tweak: Checks whether the Access Token is inputted in the correct format
830 * Fix: Fixed bug in the 'Show posts on my page by others' option
831 * Fix: If displaying a Facebook group then automatically hides the Facebook "Like" box
832 * Fix: 'others=false' shortcode option now working correctly
833 * Fix: Strip any white space characters from beginning or end of Access Token and Facebook Page ID
834
835 = 1.6.7.1 =
836 * Fix: Fixed a bug in 1.6.7 which was causing an issue displaying the Facebook feed in some circumstances
837
838 = 1.6.7 =
839 * New: Your Facebook feed can now be completely displayed in any language - added i18n support for date translation
840 * Tweak: Improved documentation within the plugin
841 * Tweak: Changed order of methods used to retrieve Facebook feed data
842
843 = 1.6.6.3 =
844 * New: Added support for Facebook group events
845
846 = 1.6.6.1 =
847 * Fix: Resolved jQuery UI draggable bug which was causing issues with drag and drop
848
849 = 1.6.6 =
850 * New: Now works with Facebook groups
851 * Fix: Fixed an issue with the 'Show posts by others' option not working correctly in the previous version
852
853 = 1.6.4 =
854 * New: Added localization support. Full support for various languages coming soon
855 * New: Added CSS classes to different Facebook post types to allow for different styling based on post type
856 * New: Option to link statuses to either the status post itself or the directly to the Facebook page/timeline
857 * New: Added option to add thumbnail faces of fans to the Facebook Like box and define a width
858 * Tweak: Added separate classes to 'View on Facebook' and 'View Link' links so that they can be targeted with CSS
859 * 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'.
860
861 = 1.6.3 =
862 * New: Added support for Facebook 'Offers'
863 * Fix: Fixed an issue with the 'others' shortcode option not working correctly
864 * Fix: Prefixed the 'clear' class to prevent conflicts
865
866 = 1.6.2 =
867 * New: Post caching now temporarily stores your Facebook post data in your WordPress database to allow for super quick load times
868 * New: Define your own caching time. Check for new Facebook posts every few seconds, minutes, hours or days. You decide.
869 * New: Define your own custom text for the 'See More' and 'See Less' buttons
870 * New: Add your own CSS class to your Custom Facebook Feeds
871 * New: Define a Facebook post limit which is higher or lower than the default 25
872 * New: Include the Facebook Like box inside or outside of the Facebook feed's container
873 * New: Customize the Facebook event date independently
874 * New: Improved layout of admin pages for easier navigation and customization
875 * Fix: Provided a fix for the Facebook API duplicate post bug
876 * Fix: Fixed bug which ocurred when multiple Facebook feeds are displayed on the same page with different text lengths defined
877
878 = 1.5.2 =
879 * Fix: Fixed JavaScript error in previous update
880
881 = 1.5.1 =
882 * New: Added a 'See More' link to expand any text which is longer than the character limit defined
883 * New: Choose to show Facebook posts by other people in your feed
884 * New: Option to show the post author's Facebook profile picture and name above each post
885 * New: Added options to customize and format the Facebook post date
886 * New: Add your own text before and after the date and in place of the 'View on Facebook' and 'View Link' text links
887 * New: Specify the format of the Facebook Event date
888 * Tweak: Default date format is less specific and better mimics Facebook's - credit Mark Bebbington
889 * Tweak: Changed the layout of the Typography section to allow for the additional options
890 * Fix: When a Facebook photo album is shared it now links to the album itself on Facebook and not just the cover photo
891 * Fix: Fixed issue with hyperlinks in post text which don't have a space before them not being converted to links
892
893 = 1.4.8 =
894 * Minor fixes
895
896 = 1.4.7 =
897 * Tweak: Added links to statuses which link to the Facebook page
898 * Tweak: Added classes to Facebook event date, location and description to allow custom styling
899 * Tweak: Removed 'Where' and 'When' text from Facebook events and made bold instead
900
901 = 1.4.6 =
902 * Fix: Fixed 'num' option in shortcode
903
904 = 1.4.4 =
905 * New: Added more shortcode options
906 * Minor tweaks
907
908 = 1.4.2 =
909 * New: Add your own custom CSS to allow for even deeper customization
910 * New: Optionally link your post text to the Facebook post
911 * New: Optionally link your event title to the Facebook event page
912 * Some minor modifications
913
914 = 1.4.1 =
915 * Fix: Set all parts of the Facebook feed to display by default on activation
916
917 = 1.4.0 =
918 * Major Update!
919 * New: Loads of new customization options for your Custom Facebook Feed
920 * New: Define Facebook feed width, height, padding and background color
921 * New: Change the font-size, font-weight and color of the Facebook post text, description, date, links and event details
922 * New: Choose whether to show or hide certain parts of the Facebook posts
923 * New: Select whether the Facebook Like box is shown at the top of bottom of the Facebook feed
924 * New: Choose Facebook Like box background color
925
926 = 1.3.6 =
927 * Minor modifications
928
929 = 1.3.5 =
930 * New: Shared Facebook events now display event details (name, location, date/time, description) directly in the Facebook feed
931
932 = 1.3.4 =
933 * New: Email addresses within the Facebook post text are now hyperlinked
934 * Fix: Links beginning with 'www' are now also hyperlinked
935
936 = 1.3.3 =
937 * New: Added support for Facebook events - display the Facebook event details (name, location, date/time, description) directly in the Facebook feed
938 * Fix: Links within the Facebook post text are now hyperlinked
939 * Tweak: Added additional methods for retrieving Facebook feed data
940
941 = 1.3.2 =
942 * Fix: Now using the built-in WordPress HTTP API to get retrieve the Facebook data
943
944 = 1.3.1 =
945 * Fix: Fixed issue with certain Facebook statuses not displaying correctly
946
947 = 1.3.0 =
948 * Tweak: If 'Number of Posts to show' is not set then default to 10 Facebook posts
949
950 = 1.2.9 =
951 * Fix: Now using cURL instead of file_get_contents to prevent issues with php.ini configuration on some web servers
952
953 = 1.2.8 =
954 * Fix: Fixed bug in specifying the number of Facebook posts to display
955
956 = 1.2.7 =
957 * Tweak: Prevented likes and comments by the page author showing up in the Facebook feed
958
959 = 1.2.6 =
960 * Tweak: Added help link to Custom Facebook Feed settings page
961
962 = 1.2.5 =
963 * Fix: Added clear fix
964
965 = 1.2.1 =
966 * Fix: Minor bug fixes
967
968 = 1.2 =
969 * New: Added the ability to define a maximum length for both the Facebook post text and description
970
971 = 1.0 =
972 * Launch!