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
137 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.1 |
| 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 | The Custom Facebook Feed allows you to display a completely customizable, responsive, and search engine crawlable version of your Facebook page on your own website. No more ugly iframes! Customize your feed to seamlessly match the look and feel of your site. |
| 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! |
| 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 | * Control the width, height, padding and background color of your feed |
| 22 | * Customize the size, weight and color of text |
| 23 | * Select which parts of each post to display or hide |
| 24 | * Select the number of posts to display |
| 25 | * Set a maximum length for both the post title and body text |
| 26 | * Use the shortcode to display the feed in a page, post or widget anywhere on your site |
| 27 | |
| 28 | To display photos, videos, the number of likes, shares and comments for each post, and for multiple layout options 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"). |
| 29 | |
| 30 | == Installation == |
| 31 | |
| 32 | 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). |
| 33 | 2. Activate the plugin through the 'Plugins' menu in WordPress. |
| 34 | 3. Navigate to the 'Facebook Feed' settings page to configure your feed. |
| 35 | 4. Use the shortcode `[custom-facebook-feed]` in your page, post or widget to display your feed. |
| 36 | 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]`. |
| 37 | |
| 38 | == Frequently Asked Questions == |
| 39 | |
| 40 | = How do I find the Page ID of my Facebook page? = |
| 41 | |
| 42 | 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`. |
| 43 | |
| 44 | = Are there any limitations on which page feeds I can display? = |
| 45 | |
| 46 | 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. |
| 47 | |
| 48 | 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. |
| 49 | |
| 50 | 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. |
| 51 | |
| 52 | = What's an Access Token and why do I need one? = |
| 53 | |
| 54 | 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. |
| 55 | |
| 56 | = Can I show photos and videos in my feed? = |
| 57 | |
| 58 | 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/wordpress-plugin/ "Custom Facebook Feed PRO"). |
| 59 | |
| 60 | = Can I show the comments associated with each post? = |
| 61 | |
| 62 | For this feature please upgrade to the [PRO version of the plugin](http://smashballoon.com/custom-facebook-feed/wordpress-plugin/ "Custom Facebook Feed PRO"). |
| 63 | |
| 64 | = Is the content of my feed crawlable by search engines? = |
| 65 | |
| 66 | 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. |
| 67 | |
| 68 | == Screenshots == |
| 69 | |
| 70 | 1. By default the feed inherits your theme's default styles and is completely responsive. |
| 71 | 2. Completely customize the way your feed looks to perfectly match your site. |
| 72 | 3. Configuring the plugin |
| 73 | 4. Use the styling options to customize your feed |
| 74 | 5. It's super easy to display your feed in any page or post |
| 75 | 6. Add the shortcode to a widget |
| 76 | |
| 77 | == Changelog == |
| 78 | |
| 79 | = 1.4.1 = |
| 80 | * Fix: Set all parts of the feed to display by default on activation |
| 81 | |
| 82 | = 1.4.0 = |
| 83 | * Major Update! |
| 84 | * New: Loads of new customization options for your feed |
| 85 | * New: Define feed width, height, padding and background color |
| 86 | * New: Change the font-size, font-weight and color of the post text, description, date, links and event details |
| 87 | * New: Choose whether to show or hide certain parts of the posts |
| 88 | * New: Select whether the Like box is shown at the top of bottom of the feed |
| 89 | * New: Choose Like box background color |
| 90 | |
| 91 | = 1.3.6 = |
| 92 | * Minor modifications |
| 93 | |
| 94 | = 1.3.5 = |
| 95 | * New: Shared events now display event details (name, location, date/time, description) directly in the feed |
| 96 | |
| 97 | = 1.3.4 = |
| 98 | * New: Email addresses within the post text are now hyperlinked |
| 99 | * Fix: Links beginning with 'www' are now also hyperlinked |
| 100 | |
| 101 | = 1.3.3 = |
| 102 | * New: Added support for events - display the event details (name, location, date/time, description) directly in the feed |
| 103 | * Fix: Links within the post text are now hyperlinked |
| 104 | * Tweak: Added additional methods for retrieving feed data |
| 105 | |
| 106 | = 1.3.2 = |
| 107 | * Fix: Now using the built-in WordPress HTTP API to get retrieve the Facebook data |
| 108 | |
| 109 | = 1.3.1 = |
| 110 | * Fix: Fixed issue with certain statuses not displaying correctly |
| 111 | |
| 112 | = 1.3.0 = |
| 113 | * Tweak: If 'Number of Posts to show' is not set then default to 10 |
| 114 | |
| 115 | = 1.2.9 = |
| 116 | * Fix: Now using cURL instead of file_get_contents to prevent issues with php.ini configuration on some web servers |
| 117 | |
| 118 | = 1.2.8 = |
| 119 | * Fix: Fixed bug in specifying the number of posts to display |
| 120 | |
| 121 | = 1.2.7 = |
| 122 | * Tweak: Prevented likes and comments by the page author showing up in the feed |
| 123 | |
| 124 | = 1.2.6 = |
| 125 | * Tweak: Added help link to settings page |
| 126 | |
| 127 | = 1.2.5 = |
| 128 | * Fix: Added clear fix |
| 129 | |
| 130 | = 1.2.1 = |
| 131 | * Fix: Minor bug fixes |
| 132 | |
| 133 | = 1.2 = |
| 134 | * New: Added the ability to define a maximum length for both the post title and body text |
| 135 | |
| 136 | = 1.0 = |
| 137 | * Launch! |