custom-facebook-feed
Last commit date
css
12 years ago
img
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
159 lines
| 1 | === Custom Facebook Feed === |
| 2 | Contributors: smashballoon |
| 3 | Tags: facebook, custom, customizable, feed, seo, search engine, responsive, mobile, shortcode, social, status |
| 4 | Requires at least: 3.0 |
| 5 | Tested up to: 3.5.1 |
| 6 | Stable tag: 1.4.4 |
| 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 customizable Facebook feed of any public Facebook page on your website. |
| 11 | |
| 12 | == Description == |
| 13 | |
| 14 | Display a **customizable**, **responsive** and **search engine crawlable** version of your Facebook feed on your website. Completely match the look and feel of the site! |
| 15 | |
| 16 | = Features = |
| 17 | |
| 18 | * **Completely Customizable** - By default the feed will adopt the style of your website, but can be completely customized to look however you like - with tons of styling options and custom CSS! |
| 19 | * 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 |
| 20 | * Completely **responsive** and mobile optimized - layout looks great on any screen size and in any container width |
| 21 | * Display **feeds from multiple Facebook pages** and use the shortcode to embed them into a page, post or widget anywhere on your site |
| 22 | * Show **events** with name, date/time, location and description |
| 23 | * Add your own **custom CSS** |
| 24 | * Show and hide certain parts of each post |
| 25 | * Control the width, height, padding and background color of your feed |
| 26 | * Customize the size, weight and color of text |
| 27 | * Select the number of posts to display |
| 28 | * Set a maximum character length for both the post title and body text |
| 29 | |
| 30 | To display photos, videos, the number of likes, shares and comments for each post, multiple layout options and more then [upgrade to the PRO version](http://smashballoon.com/custom-facebook-feed/wordpress-plugin/ "Custom Facebook Feed PRO"). Try out the [PRO demo](http://smashballoon.com/custom-facebook-feed/demo "Custom Facebook Feed Demo"). |
| 31 | |
| 32 | == Installation == |
| 33 | |
| 34 | 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). |
| 35 | 2. Activate the plugin through the 'Plugins' menu in WordPress. |
| 36 | 3. Navigate to the 'Facebook Feed' settings page to configure your feed. |
| 37 | 4. Use the shortcode `[custom-facebook-feed]` in your page, post or widget to display your feed. |
| 38 | 5. You can display multiple feeds of different Facebook pages by specifying a Page ID directly in the shortcode: `[custom-facebook-feed id=SarahsBakery show=5]`. |
| 39 | |
| 40 | == Frequently Asked Questions == |
| 41 | |
| 42 | = How do I find the Page ID of my Facebook page? = |
| 43 | |
| 44 | If you have a Facebook page with a URL like this: `https://www.facebook.com/Your_Page_Name` then the Page ID is just `Your_Page_Name`. If your page URL is structured like this: `https://www.facebook.com/pages/Your_Page_Name/123654123654123` then the Page ID is actually the number at the end, so in this case `123654123654123`. |
| 45 | |
| 46 | = Are there any limitations on which page feeds I can display? = |
| 47 | |
| 48 | The feed you're trying to display has to be a publicly accessible page. This means that you can't display the feed from your own personal profile or a group. This is to do with Facebook's privacy policies. You can't display a non-public feed publicly. |
| 49 | |
| 50 | If your 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 pages as it means that it isn't accessible by people who don't have a Facebook account and that your page can't be crawled and indexed by search engines. |
| 51 | |
| 52 | An easy way to determine whether your 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 page to public in your Facebook page settings simply by removing any restrictions you have on it, which will then allow the Custom Facebook Feed plugin to access and display your feed. |
| 53 | |
| 54 | = What's an Access Token and why do I need one? = |
| 55 | |
| 56 | 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. |
| 57 | |
| 58 | = Can I display feeds from multiple Facebook pages? = |
| 59 | |
| 60 | Yep. You set your default Facebook page ID in the plugin's settings but then you can 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: id=another_page_id. |
| 61 | |
| 62 | = Can I show photos and videos in my feed? = |
| 63 | |
| 64 | This plugin only allows you to display textual updates from your 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"). |
| 65 | |
| 66 | = Can I show the comments associated with each post? = |
| 67 | |
| 68 | For this feature please upgrade to the [PRO version of the plugin](http://smashballoon.com/custom-facebook-feed/ "Custom Facebook Feed PRO"). |
| 69 | |
| 70 | = Is the content of my feed crawlable by search engines? = |
| 71 | |
| 72 | It sure is. Unlike other Facebook plugins which use iframes to embed your feed into your page once it's loaded, the Custom Facebook Feed uses PHP to embed your feed content directly into your page. This adds dynamic, search engine crawlable content to your site. |
| 73 | |
| 74 | = How do I embed the feed directly into a WordPress page template? = |
| 75 | |
| 76 | You can embed the feed directly into a template file by using the WordPress do_shortcode function: do_shortcode('[custom-facebook-feed]''); |
| 77 | |
| 78 | == Screenshots == |
| 79 | |
| 80 | 1. By default the feed inherits your theme's default styles and is completely responsive |
| 81 | 2. Completely customize the way your feed looks to perfectly match your site |
| 82 | 3. Use custom CSS to customize every part of the feed |
| 83 | 4. Display events |
| 84 | 5. Configuring the plugin |
| 85 | 6. Use the styling options to customize your feed |
| 86 | 7. It's super easy to display your feed in any page or post |
| 87 | 8. Add the shortcode to a widget |
| 88 | |
| 89 | == Changelog == |
| 90 | |
| 91 | = 1.4.4 = |
| 92 | * New: Added more shortcode options |
| 93 | * Minor tweaks |
| 94 | |
| 95 | = 1.4.2 = |
| 96 | * New: Add your own custom CSS to allow for even deeper customization |
| 97 | * New: Optionally link your post text to the Facebook post |
| 98 | * New: Optionally link your event title to the Facebook event page |
| 99 | * Some minor modifications |
| 100 | |
| 101 | = 1.4.1 = |
| 102 | * Fix: Set all parts of the feed to display by default on activation |
| 103 | |
| 104 | = 1.4.0 = |
| 105 | * Major Update! |
| 106 | * New: Loads of new customization options for your feed |
| 107 | * New: Define feed width, height, padding and background color |
| 108 | * New: Change the font-size, font-weight and color of the post text, description, date, links and event details |
| 109 | * New: Choose whether to show or hide certain parts of the posts |
| 110 | * New: Select whether the Like box is shown at the top of bottom of the feed |
| 111 | * New: Choose Like box background color |
| 112 | |
| 113 | = 1.3.6 = |
| 114 | * Minor modifications |
| 115 | |
| 116 | = 1.3.5 = |
| 117 | * New: Shared events now display event details (name, location, date/time, description) directly in the feed |
| 118 | |
| 119 | = 1.3.4 = |
| 120 | * New: Email addresses within the post text are now hyperlinked |
| 121 | * Fix: Links beginning with 'www' are now also hyperlinked |
| 122 | |
| 123 | = 1.3.3 = |
| 124 | * New: Added support for events - display the event details (name, location, date/time, description) directly in the feed |
| 125 | * Fix: Links within the post text are now hyperlinked |
| 126 | * Tweak: Added additional methods for retrieving feed data |
| 127 | |
| 128 | = 1.3.2 = |
| 129 | * Fix: Now using the built-in WordPress HTTP API to get retrieve the Facebook data |
| 130 | |
| 131 | = 1.3.1 = |
| 132 | * Fix: Fixed issue with certain statuses not displaying correctly |
| 133 | |
| 134 | = 1.3.0 = |
| 135 | * Tweak: If 'Number of Posts to show' is not set then default to 10 |
| 136 | |
| 137 | = 1.2.9 = |
| 138 | * Fix: Now using cURL instead of file_get_contents to prevent issues with php.ini configuration on some web servers |
| 139 | |
| 140 | = 1.2.8 = |
| 141 | * Fix: Fixed bug in specifying the number of posts to display |
| 142 | |
| 143 | = 1.2.7 = |
| 144 | * Tweak: Prevented likes and comments by the page author showing up in the feed |
| 145 | |
| 146 | = 1.2.6 = |
| 147 | * Tweak: Added help link to settings page |
| 148 | |
| 149 | = 1.2.5 = |
| 150 | * Fix: Added clear fix |
| 151 | |
| 152 | = 1.2.1 = |
| 153 | * Fix: Minor bug fixes |
| 154 | |
| 155 | = 1.2 = |
| 156 | * New: Added the ability to define a maximum length for both the post title and body text |
| 157 | |
| 158 | = 1.0 = |
| 159 | * Launch! |