custom-facebook-feed
Last commit date
css
12 years ago
img
12 years ago
js
12 years ago
README.txt
12 years ago
custom-facebook-feed-admin.php
12 years ago
custom-facebook-feed.php
12 years ago
gpl-2.0.txt
13 years ago
README.txt
258 lines
| 1 | === Custom Facebook Feed === |
| 2 | Contributors: smashballoon |
| 3 | Tags: facebook, custom, customizable, feed, events, seo, search engine, responsive, mobile, shortcode, social, status, posts |
| 4 | Requires at least: 3.0 |
| 5 | Tested up to: 3.7.1 |
| 6 | Stable tag: 1.6.7 |
| 7 | License: GPLv2 or later |
| 8 | License URI: http://www.gnu.org/licenses/gpl-2.0.html |
| 9 | |
| 10 | The Custom Facebook Feed allows you to display a completely customizable Facebook feed of any public Facebook page or group on your website |
| 11 | |
| 12 | == Description == |
| 13 | |
| 14 | Display a **completely customizable**, **responsive** and **search engine crawlable** version of your Facebook feed on your website. Completely match the look and feel of the site with tons of customization options! |
| 15 | |
| 16 | *"The perfect plugin with amazing support! What else do you want? Get it!"* - [JoeJeffries](http://wordpress.org/support/topic/you-dont-already-have-this) |
| 17 | |
| 18 | *"Loving the Facebook feed plugin from @smashballoon. It's gonna transform my work's website! Great customer service too :)"* - [Grace Snow](https://twitter.com/GraceSnow/statuses/365915197149429760) |
| 19 | |
| 20 | *"I tried a few other Facebook plugins but this was by far the simplest and easiest to use. The others were quite confusing or didn't let you change even the simplest things. This plugin lets you change literally every part of it. Didn't have any issues setting it up at all and it's working great. Keep up the good work!"* - [Ben Donald](http://wordpress.org/support/topic/simple-to-set-up-and-looks-great) |
| 21 | |
| 22 | = Features = |
| 23 | |
| 24 | * **Completely Customizable** - By default the Facebook feed will adopt the style of your website, but can be completely customized to look however you like - with tons of styling and customization options! |
| 25 | * Facebook feed content is **crawlable by search engines** adding SEO value to your site - other Facebook plugins embed the feed using iframes which are not crawlable |
| 26 | * Completely **responsive** and mobile optimized - layout looks great on any screen size and in any container width |
| 27 | * Display **feeds from multiple different Facebook pages/groups** and use the shortcode to embed them into a page, post or widget anywhere on your site |
| 28 | * Show **events** from your Facebook feed with name, date/time, location and description |
| 29 | * Add your own **custom CSS** |
| 30 | * **Caching** means that your Facebook posts load lightning fast. Set your own caching time - check for new posts on Facebook every few seconds, minutes, hours or days. You decide. |
| 31 | * Show and hide certain parts of each Facebook post |
| 32 | * Choose to show the Facebook profile picture and name above each post |
| 33 | * Select whether to display Facebook posts by just the page owner, or everyone who posts on your Facebook page |
| 34 | * Control the width, height, padding and background color of your Facebook feed |
| 35 | * Customize the size, weight and color of text |
| 36 | * Select from a range of date formats or enter your own |
| 37 | * Use your own custom link text in place of the defaults |
| 38 | * Use the shortcode options to style multiple Facebook feeds in completely different ways |
| 39 | * Select the number of Facebook posts to display |
| 40 | * Set a maximum character length for both the text and descriptions of your Facebook posts |
| 41 | * Localization/i18n support to allow every part of the feed to be displayed in your language |
| 42 | |
| 43 | To display photos, videos, the number of likes, shares and comments for each Facebook post, multiple layout options, post filtering by type or #hashtag/string and more then [upgrade to the Pro version](http://smashballoon.com/custom-facebook-feed/ "Custom Facebook Feed Pro"). Try out the [Pro demo](http://smashballoon.com/custom-facebook-feed/demo "Custom Facebook Feed Demo"). |
| 44 | |
| 45 | == Installation == |
| 46 | |
| 47 | 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). |
| 48 | 2. Activate the plugin through the 'Plugins' menu in WordPress. |
| 49 | 3. Navigate to the 'Facebook Feed' settings page to configure your feed. |
| 50 | 4. Use the shortcode `[custom-facebook-feed]` in your page, post or widget to display your feed. |
| 51 | 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]`. |
| 52 | |
| 53 | == Frequently Asked Questions == |
| 54 | |
| 55 | = How do I find the Page ID of my Facebook page or group? = |
| 56 | |
| 57 | If you have a Facebook **page** with a URL like this: `https://www.facebook.com/smashballoon` then the Page ID is just `smashballoon`. If your page URL is structured like this: `https://www.facebook.com/pages/smashballoon/123654123654123` then the Page ID is actually the number at the end, so in this case `123654123654123`. |
| 58 | |
| 59 | If you have a Facebook **group** then use [this tool](http://lookup-id.com/ "Look Up my ID") to find your Group ID. |
| 60 | |
| 61 | Copy and paste the ID into the [Pro demo](http://smashballoon.com/custom-facebook-feed/demo/) to test it. |
| 62 | |
| 63 | = Are there any limitations on which Facebook page or group feeds I can display? = |
| 64 | |
| 65 | The Facebook feed you're trying to display has to be from a publicly accessible Facebook page or group. This means that you can't display the feed from your own personal Facebook profile or private Facebook group. This is to do with Facebook's privacy policies. You can't display a non-public Facebook feed publicly. |
| 66 | |
| 67 | 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. |
| 68 | |
| 69 | 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](http://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. |
| 70 | |
| 71 | = What's an Access Token and why do I need one? = |
| 72 | |
| 73 | An Access Token is required by Facebook in order to access their feeds. Don't worry, it's easy to get one. Just follow the step-by-step instructions [here](http://smashballoon.com/custom-facebook-feed/access-token/ "Getting an Access Token"). to get yours. Your Access Token will never expire. |
| 74 | |
| 75 | = Can I display feeds from multiple Facebook pages or groups? = |
| 76 | |
| 77 | 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. |
| 78 | |
| 79 | = Why isn't the feed from my group displaying? = |
| 80 | |
| 81 | Firstly, check that your group is public and not a private group. |
| 82 | Secondly, be sure to check the 'Show posts by others on my page' option in the Custom Facebook Feed settings page. |
| 83 | |
| 84 | = Can I display the feed from a personal Facebook profile? = |
| 85 | |
| 86 | 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 or group, 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. |
| 87 | |
| 88 | 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. |
| 89 | |
| 90 | Once you've done so, the plugin will be able to retrieve and display all of your posts. |
| 91 | |
| 92 | = Can I show photos and videos in my Custom Facebook feed? = |
| 93 | |
| 94 | This free plugin only allows you to display textual updates from your Facebook feed. To display photos and videos in your feed you need to upgrade to the Pro version of the plugin. Try out a demo of the Pro version on the [Custom Facebook Feed website](http://smashballoon.com/custom-facebook-feed/demo "Custom Facebook Feed Demo"), and find out more about the Pro version [here](http://smashballoon.com/custom-facebook-feed/ "Custom Facebook Feed Pro"). |
| 95 | |
| 96 | = Can I show the comments associated with each Facebook post? = |
| 97 | |
| 98 | For this feature please upgrade to the [Pro version of the plugin](http://smashballoon.com/custom-facebook-feed/ "Custom Facebook Feed Pro"). |
| 99 | |
| 100 | = Is the content of my Custom Facebook Feed crawlable by search engines? = |
| 101 | |
| 102 | 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. |
| 103 | |
| 104 | = How do I embed the Custom Facebook Feed directly into a WordPress page template? = |
| 105 | |
| 106 | You can embed your Facebook feed directly into a template file by using the WordPress do_shortcode function: <?php do_shortcode('[custom-facebook-feed]'); ?>. |
| 107 | |
| 108 | **For more detailed FAQs and help with troubleshooting please visit the [FAQ & Troubleshooting](http://smashballoon.com/custom-facebook-feed/faq/) section of the Smash Balloon website** |
| 109 | |
| 110 | == Screenshots == |
| 111 | |
| 112 | 1. By default the Facebook feed inherits your theme's default styles and is completely responsive |
| 113 | 2. Completely customize the way your Facebook feed looks to perfectly match your site |
| 114 | 3. Use custom CSS to customize every part of the Facebook feed |
| 115 | 4. Display Facebook events |
| 116 | 5. Configuring the Custom Facebook Feed plugin |
| 117 | 6. General options - Custom Facebook Feed Layout & Style page |
| 118 | 7. Typography options - Custom Facebook Feed Layout & Style page |
| 119 | 8. Misc options - Custom Facebook FeedLayout & Style page |
| 120 | 9. It's super easy to display your Facebook feed in any page or post |
| 121 | |
| 122 | == Changelog == |
| 123 | |
| 124 | = 1.6.7 = |
| 125 | * New: Your feed can now be completely displayed in any language - added i18n support for date translation |
| 126 | * Tweak: Improved documentation within the plugin |
| 127 | * Tweak: Changed order of methods used to retrieve feed data |
| 128 | |
| 129 | = 1.6.6.3 = |
| 130 | * New: Added support for group events |
| 131 | |
| 132 | = 1.6.6.1 = |
| 133 | * Fix: Resolved jQuery UI draggable bug which was causing issues with drag and drop |
| 134 | |
| 135 | = 1.6.6 = |
| 136 | * New: Now works with groups |
| 137 | * Fix: Fixed an issue with the 'Show posts by others' option not working correctly in the previous version |
| 138 | |
| 139 | = 1.6.4 = |
| 140 | * New: Added localization support. Full support for various languages coming soon |
| 141 | * New: Added CSS classes to different post types to allow for different styling based on post type |
| 142 | * New: Option to link statuses to either the status post itself or the directly to the page/timeline |
| 143 | * New: Added option to add thumbnail faces of fans to the Like box and define a width |
| 144 | * Tweak: Added separate classes to 'View on Facebook' and 'View Link' links so that they can be targeted with CSS |
| 145 | * 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'. |
| 146 | |
| 147 | = 1.6.3 = |
| 148 | * New: Added support for Facebook 'Offers' |
| 149 | * Fix: Fixed an issue with the 'others' shortcode option not working correctly |
| 150 | * Fix: Prefixed the 'clear' class to prevent conflicts |
| 151 | |
| 152 | = 1.6.2 = |
| 153 | * New: Post caching now temporarily stores your Facebook post data in your WordPress database to allow for super quick load times |
| 154 | * New: Define your own caching time. Check for new Facebook posts every few seconds, minutes, hours or days. You decide. |
| 155 | * New: Define your own custom text for the 'See More' and 'See Less' buttons |
| 156 | * New: Add your own CSS class to your Custom Facebook Feeds |
| 157 | * New: Define a post limit which is higher or lower than the default 25 |
| 158 | * New: Include the Like box inside or outside of the Facebook feed's container |
| 159 | * New: Customize the Facebook event date independently |
| 160 | * New: Improved layout of admin pages for easier navigation and customization |
| 161 | * Fix: Provided a fix for the Facebook API duplicate post bug |
| 162 | * Fix: Fixed bug which ocurred when multiple Facebook feeds are displayed on the same page with different text lengths defined |
| 163 | |
| 164 | = 1.5.2 = |
| 165 | * Fix: Fixed JavaScript error in previous update |
| 166 | |
| 167 | = 1.5.1 = |
| 168 | * New: Added a 'See More' link to expand any text which is longer than the character limit defined |
| 169 | * New: Choose to show Facebook posts by other people in your feed |
| 170 | * New: Option to show the post author's Facebook profile picture and name above each post |
| 171 | * New: Added options to customize and format the Facebook post date |
| 172 | * New: Add your own text before and after the date and in place of the 'View on Facebook' and 'View Link' text links |
| 173 | * New: Specify the format of the Facebook Event date |
| 174 | * Tweak: Default date format is less specific and better mimics Facebook's - credit Mark Bebbington |
| 175 | * Tweak: Changed the layout of the Typography section to allow for the additional options |
| 176 | * Fix: When a Facebook photo album is shared it now links to the album itself on Facebook and not just the cover photo |
| 177 | * Fix: Fixed issue with hyperlinks in post text which don't have a space before them not being converted to links |
| 178 | |
| 179 | = 1.4.8 = |
| 180 | * Minor fixes |
| 181 | |
| 182 | = 1.4.7 = |
| 183 | * Tweak: Added links to statuses which link to the Facebook page |
| 184 | * Tweak: Added classes to Facebook event date, location and description to allow custom styling |
| 185 | * Tweak: Removed 'Where' and 'When' text from Facebook events and made bold instead |
| 186 | |
| 187 | = 1.4.6 = |
| 188 | * Fix: Fixed 'num' option in shortcode |
| 189 | |
| 190 | = 1.4.4 = |
| 191 | * New: Added more shortcode options |
| 192 | * Minor tweaks |
| 193 | |
| 194 | = 1.4.2 = |
| 195 | * New: Add your own custom CSS to allow for even deeper customization |
| 196 | * New: Optionally link your post text to the Facebook post |
| 197 | * New: Optionally link your event title to the Facebook event page |
| 198 | * Some minor modifications |
| 199 | |
| 200 | = 1.4.1 = |
| 201 | * Fix: Set all parts of the Facebook feed to display by default on activation |
| 202 | |
| 203 | = 1.4.0 = |
| 204 | * Major Update! |
| 205 | * New: Loads of new customization options for your Custom Facebook Feed |
| 206 | * New: Define Facebook feed width, height, padding and background color |
| 207 | * New: Change the font-size, font-weight and color of the Facebook post text, description, date, links and event details |
| 208 | * New: Choose whether to show or hide certain parts of the Facebook posts |
| 209 | * New: Select whether the Facebook Like box is shown at the top of bottom of the Facebook feed |
| 210 | * New: Choose Facebook Like box background color |
| 211 | |
| 212 | = 1.3.6 = |
| 213 | * Minor modifications |
| 214 | |
| 215 | = 1.3.5 = |
| 216 | * New: Shared Facebook events now display event details (name, location, date/time, description) directly in the Facebook feed |
| 217 | |
| 218 | = 1.3.4 = |
| 219 | * New: Email addresses within the Facebook post text are now hyperlinked |
| 220 | * Fix: Links beginning with 'www' are now also hyperlinked |
| 221 | |
| 222 | = 1.3.3 = |
| 223 | * New: Added support for Facebook events - display the Facebook event details (name, location, date/time, description) directly in the Facebook feed |
| 224 | * Fix: Links within the Facebook post text are now hyperlinked |
| 225 | * Tweak: Added additional methods for retrieving Facebook feed data |
| 226 | |
| 227 | = 1.3.2 = |
| 228 | * Fix: Now using the built-in WordPress HTTP API to get retrieve the Facebook data |
| 229 | |
| 230 | = 1.3.1 = |
| 231 | * Fix: Fixed issue with certain Facebook statuses not displaying correctly |
| 232 | |
| 233 | = 1.3.0 = |
| 234 | * Tweak: If 'Number of Posts to show' is not set then default to 10 Facebook posts |
| 235 | |
| 236 | = 1.2.9 = |
| 237 | * Fix: Now using cURL instead of file_get_contents to prevent issues with php.ini configuration on some web servers |
| 238 | |
| 239 | = 1.2.8 = |
| 240 | * Fix: Fixed bug in specifying the number of Facebook posts to display |
| 241 | |
| 242 | = 1.2.7 = |
| 243 | * Tweak: Prevented likes and comments by the page author showing up in the Facebook feed |
| 244 | |
| 245 | = 1.2.6 = |
| 246 | * Tweak: Added help link to Custom Facebook Feed settings page |
| 247 | |
| 248 | = 1.2.5 = |
| 249 | * Fix: Added clear fix |
| 250 | |
| 251 | = 1.2.1 = |
| 252 | * Fix: Minor bug fixes |
| 253 | |
| 254 | = 1.2 = |
| 255 | * New: Added the ability to define a maximum length for both the Facebook post text and description |
| 256 | |
| 257 | = 1.0 = |
| 258 | * Launch! |