custom-facebook-feed
Last commit date
css
13 years ago
img
13 years ago
README.txt
13 years ago
custom-facebook-feed-admin.php
13 years ago
custom-facebook-feed.php
13 years ago
gpl-2.0.txt
13 years ago
README.txt
87 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.2.5 |
| 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 WordPress site. |
| 15 | |
| 16 | Other Facebook plugins use iframes to show your feed which don't allow you to customize how they look, aren't responsive and are not crawlable by search engines. The Custom Facebook Feed inherits your theme's style to display a feed which is responsive, crawlable and seamlessly matches the look and feel of your site. |
| 17 | |
| 18 | * **Completely Customizable** - by default inherits your theme's styles |
| 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** - works on any screen size |
| 21 | * Use the shortcode to display the feed in a page, post or widget anywhere on your site |
| 22 | * Limit the number of posts to be shown in your feed |
| 23 | * Set a maximum length for both the post title and body text |
| 24 | * Use the shortcode to display feeds from multiple Facebook pages anywhere on your site |
| 25 | |
| 26 | To display photos, videos and the number of likes, shares and comments for each post 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"). |
| 27 | |
| 28 | == Installation == |
| 29 | |
| 30 | 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). |
| 31 | 2. Activate the plugin through the 'Plugins' menu in WordPress. |
| 32 | 3. Navigate to the plugin settings page to configure your feed. |
| 33 | 4. Use the shortcode `[custom-facebook-feed]` in your page, post or widget to display your feed. |
| 34 | 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]`. |
| 35 | 6. You can limit the length of the title and body text by using `titlelength=100` and `bodylength=150` (for example) in the shortcode. `[custom-facebook-feed titlelength=100 bodylength=150]`. |
| 36 | |
| 37 | == Frequently Asked Questions == |
| 38 | |
| 39 | = How do I find the Page ID of my Facebook page? = |
| 40 | |
| 41 | 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`. |
| 42 | |
| 43 | = Are there any limitations on which page feeds I can display? = |
| 44 | |
| 45 | 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. |
| 46 | |
| 47 | 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. |
| 48 | |
| 49 | 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. |
| 50 | |
| 51 | = What's an Access Token and why do I need one? = |
| 52 | |
| 53 | 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. |
| 54 | |
| 55 | = Can I show photos and videos in my feed? = |
| 56 | |
| 57 | This plugin only allows you to display text 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/wordpress-plugin/ "Custom Facebook Feed PRO"). |
| 58 | |
| 59 | = Is the content of my feed crawlable by search engines? = |
| 60 | |
| 61 | 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. |
| 62 | |
| 63 | = Can I prevent my comments on posts from displaying in the feed? = |
| 64 | |
| 65 | Yep. Comments will show up if you use the Access Token from an account which has adminstrative rights to your page (such as an owner or administrator). To prevent your comments showing up you need to sign up for a new Facebook account which is not associated with your page, register as a developer with this new account, and then use that Access Token to display your feed. |
| 66 | |
| 67 | == Screenshots == |
| 68 | |
| 69 | 1. Feed displayed in a page or post. By default the feed inherits your theme's default styles and is completely responsive. |
| 70 | 2. Feed displayed in a side widget. |
| 71 | 3. Configuring the plugin |
| 72 | 4. Adding the shortcode to your page or post. The shortcode parameters are optional and can be used to override the default settings you set on the plugin settings page |
| 73 | 5. Adding the shortcode to a widget |
| 74 | |
| 75 | == Changelog == |
| 76 | |
| 77 | = 1.2.5 = |
| 78 | * Added clear fix |
| 79 | |
| 80 | = 1.2.1 = |
| 81 | * Minor bug fixes |
| 82 | |
| 83 | = 1.2 = |
| 84 | * Added the ability to define a maximum length for both the post title and body text |
| 85 | |
| 86 | = 1.0 = |
| 87 | * Launch! |