Version Description
Download this release
Release Info
Developer | deployer |
Plugin | Responsive Facebook Page Plugin |
Version | 1.5.5 |
Comparing to | |
See all releases |
Code changes from version 1.5.2 to 1.5.5
- facebook-page-feed-graph-api.php +6 -6
- readme.txt +84 -105
facebook-page-feed-graph-api.php
CHANGED
@@ -1,14 +1,14 @@
|
|
1 |
<?php
|
2 |
/**
|
3 |
* Plugin Name: Facebook Page Plugin
|
4 |
-
* Plugin URI: https://
|
5 |
* Description: It's time to upgrade from your old like box! Display the Facebook Page Plugin from the Graph API using a shortcode or widget. Now available in 95 different languages
|
6 |
-
* Version: 1.5.
|
7 |
* Author: Cameron Jones
|
8 |
-
* Author URI:
|
9 |
* License: GPLv2
|
10 |
|
11 |
-
* Copyright 2015 Cameron Jones (email : cameronjonesweb
|
12 |
|
13 |
This program is free software; you can redistribute it and/or modify
|
14 |
it under the terms of the GNU General Public License, version 2, as
|
@@ -28,7 +28,7 @@ class cameronjonesweb_facebook_page_plugin {
|
|
28 |
|
29 |
define( 'CJW_FBPP_PLUGIN_DIR', plugin_dir_path( __FILE__ ) );
|
30 |
define( 'CJW_FBPP_PLUGIN_URL', plugin_dir_url( __FILE__ ) );
|
31 |
-
define( 'CJW_FBPP_PLUGIN_VER', '1.5.
|
32 |
|
33 |
//Add all the hooks and actions
|
34 |
add_shortcode( 'facebook-page-plugin', array( $this, 'facebook_page_plugin' ) );
|
@@ -116,7 +116,7 @@ class cameronjonesweb_facebook_page_plugin {
|
|
116 |
if(isset($a['href']) && !empty($a['href'])){
|
117 |
$a['language'] = str_replace("-", "_", $a['language']);
|
118 |
$return .= '<div class="cameronjonesweb_facebook_page_plugin" data-version="' . CJW_FBPP_PLUGIN_VER . '" id="' . preg_replace("/[^a-zA-Z]+/", "",substr(md5(rand()), 0, 15)) . '">';
|
119 |
-
$return .= '<div id="fb-root"></div><script>(function(d, s, id) {var js, fjs = d.getElementsByTagName(s)[0];if (d.getElementById(id)) return;js = d.createElement(s); js.id = id;js.src = "//connect.facebook.net/' . $a['language'] . '/sdk.js#xfbml=1&version=v2.
|
120 |
$return .= '<div class="fb-page" data-href="https://facebook.com/' . $a["href"] . '" ';
|
121 |
if(isset($a['width']) && !empty($a['width'])){
|
122 |
$return .= ' data-width="' . $a['width'] . '"';
|
1 |
<?php
|
2 |
/**
|
3 |
* Plugin Name: Facebook Page Plugin
|
4 |
+
* Plugin URI: https://cameronjonesweb.com.au/projects/facebook-page-plugin
|
5 |
* Description: It's time to upgrade from your old like box! Display the Facebook Page Plugin from the Graph API using a shortcode or widget. Now available in 95 different languages
|
6 |
+
* Version: 1.5.5
|
7 |
* Author: Cameron Jones
|
8 |
+
* Author URI: https://cameronjonesweb.com.au
|
9 |
* License: GPLv2
|
10 |
|
11 |
+
* Copyright 2015 Cameron Jones (email : plugins@cameronjonesweb.com.au)
|
12 |
|
13 |
This program is free software; you can redistribute it and/or modify
|
14 |
it under the terms of the GNU General Public License, version 2, as
|
28 |
|
29 |
define( 'CJW_FBPP_PLUGIN_DIR', plugin_dir_path( __FILE__ ) );
|
30 |
define( 'CJW_FBPP_PLUGIN_URL', plugin_dir_url( __FILE__ ) );
|
31 |
+
define( 'CJW_FBPP_PLUGIN_VER', '1.5.4' );
|
32 |
|
33 |
//Add all the hooks and actions
|
34 |
add_shortcode( 'facebook-page-plugin', array( $this, 'facebook_page_plugin' ) );
|
116 |
if(isset($a['href']) && !empty($a['href'])){
|
117 |
$a['language'] = str_replace("-", "_", $a['language']);
|
118 |
$return .= '<div class="cameronjonesweb_facebook_page_plugin" data-version="' . CJW_FBPP_PLUGIN_VER . '" id="' . preg_replace("/[^a-zA-Z]+/", "",substr(md5(rand()), 0, 15)) . '">';
|
119 |
+
$return .= '<div id="fb-root"></div><script>(function(d, s, id) {var js, fjs = d.getElementsByTagName(s)[0];if (d.getElementById(id)) return;js = d.createElement(s); js.id = id;js.src = "//connect.facebook.net/' . $a['language'] . '/sdk.js#xfbml=1&version=v2.5&appId=846690882110183";fjs.parentNode.insertBefore(js, fjs); }(document, \'script\', \'facebook-jssdk\'));</script>';
|
120 |
$return .= '<div class="fb-page" data-href="https://facebook.com/' . $a["href"] . '" ';
|
121 |
if(isset($a['width']) && !empty($a['width'])){
|
122 |
$return .= ' data-width="' . $a['width'] . '"';
|
readme.txt
CHANGED
@@ -1,88 +1,37 @@
|
|
1 |
=== Facebook Page Plugin ===
|
2 |
Contributors: cameronjonesweb
|
3 |
-
Tags:
|
4 |
-
Donate link: https://www.
|
5 |
Requires at least: 4.0
|
6 |
-
Tested up to: 4.3
|
7 |
-
Stable tag: 1.
|
8 |
License: GPLv2
|
9 |
License URI: http://www.gnu.org/licenses/old-licenses/gpl-2.0.html
|
10 |
|
11 |
It's time to upgrade from your old like box! Display the Facebook Page Plugin from the Graph API using a shortcode or widget.
|
12 |
|
13 |
-
== Description ==
|
14 |
-
As of June 23rd 2015, Facebook **has now deprecated many of their old social plugins**, including Activity Feed, Facepile, Like Box and Recommendations. As such, many WordPress plugins that utilise these social plugins will soon stop working. This plugin instead uses the Graph API v2.3 to guarantee your WordPress site continues to have full Facebook support.
|
15 |
|
16 |
-
|
|
|
17 |
|
18 |
-
|
19 |
|
20 |
-
|
21 |
|
22 |
-
|
23 |
|
24 |
-
*
|
25 |
|
26 |
* Uses your site language by default, but you can display your Facebook page in all 95 languages that Facebook supports, including English, Spanish, Arabic, German, French, Russian and many more
|
27 |
|
28 |
-
|
29 |
-
|
30 |
-
== Installation ==
|
31 |
-
|
32 |
-
= From your WordPress dashboard =
|
33 |
-
|
34 |
-
1. Click `Add New` from the plugins page in your wordpress site
|
35 |
-
2. Search for `Facebook Page Plugin`
|
36 |
-
3. Click on install
|
37 |
|
38 |
-
= Alternatively from wordpress.org =
|
39 |
-
|
40 |
-
1. Download the latest version of Facebook Page Plugin
|
41 |
-
2. Extract the files
|
42 |
-
3. Upload the entire `facebook-page-feed-graph-api` folder to the `/wp-content/plugins/` directory.
|
43 |
-
|
44 |
-
4. Activate the plugin through the 'Plugins' menu in WordPress.
|
45 |
|
46 |
== Frequently Asked Questions ==
|
|
|
47 |
= What happened to "Show Posts"? =
|
48 |
The latest version of the API has removed show posts and replaced it with `tabs` which is more dynamic. To show just the posts, your tabs value should be "timeline". To hide the posts, `tabs` should be empty (shortcode) or select "none" (widget). If you're using the shortcode, remember that by default it shows the timeline so you must set it as either an empty or false value to hide posts ie `tabs=""` or `tabs="false"`. If the posts option is already being used it will be converted to tabs.
|
49 |
|
50 |
-
= How do I use the plugin? =
|
51 |
-
As of version 1.2.0, a custom widget has been included. If you wish to display your Facebook Page Plugin in a widget area it is recommended that you use the widget. Simply drag and drop the widget into the widget area and fill out the form.
|
52 |
-
|
53 |
-
If you require a shortcode, it is recommended that you use the shortcode generator on your site dashboard. Simply fill in the relevant information and then copy the generated shortcode and paste in the post or widget area where you want the plugin to appear.
|
54 |
-
|
55 |
-
The Facebook Page Plugin uses a shortcode to insert the page feed. You set your settings within the shortcode.
|
56 |
-
`[facebook-page-plugin setting="value"]`
|
57 |
-
Available settings:
|
58 |
-
|
59 |
-
`href` (URL path that comes after facebook.com/)
|
60 |
-
|
61 |
-
`width` (number, in pixels, between 180 and 500, default 340)
|
62 |
-
|
63 |
-
`height` (number, in pixels, minimum 70, default 500)
|
64 |
-
|
65 |
-
`cover` (true/false, show page cover photo, default true)
|
66 |
-
|
67 |
-
`facepile` (true/false, show facepile, default true)
|
68 |
-
|
69 |
-
`tabs` (timeline,messages or a combination of both, display page posts and/or private messages between the page and the logged in user viewing the page, default timeline)
|
70 |
-
|
71 |
-
`cta` (true/false, hide custom call to action if applicable, default false)
|
72 |
-
|
73 |
-
`small` (true/false, display small header (must be true for height to be lower than 130px), default false)
|
74 |
-
|
75 |
-
`adapt` (true/false, force plugin to be responsive, default true)
|
76 |
-
|
77 |
-
`language` (languageCode_countryCode eg: en_US, language of the plugin, default site language)
|
78 |
-
|
79 |
-
* Deprecated Settings *
|
80 |
-
|
81 |
-
`posts` (true/false) - posts has been replaced by tabs as of 1.4.0. There is a fallback in place to convert it to tabs
|
82 |
-
|
83 |
-
Example: `[facebook-page-plugin href="facebook" width="300" height="500" cover="true" facepile="true" tabs="timeline" adapt="true"]`
|
84 |
-
This will display a Facebook page feed that loads in the page `facebook.com/facebook` that is 300px wide but adapts to it's container, 500px high, displaying the page's cover photo, facepile and recent posts in the same language as the site. See the screenshots tab for a demonstration of how it will appear
|
85 |
-
|
86 |
= What languages are available? =
|
87 |
As of version 1.2.0, the plugin is available in all languages provided by Facebook ( full list availabe [here](https://www.facebook.com/translations/FacebookLocales.xml) ). By default it uses the same language as the site, but alternatively you can specify the language in the shortcode. The dashboard widget is currently only available in English but is multilingual ready.
|
88 |
|
@@ -99,118 +48,148 @@ By default the plugin will display a link to your page while the page plugin loa
|
|
99 |
= I can't get the Facepile to work! =
|
100 |
Chances are your plugin isn't tall enough to display the facepile properly. The facepile requires the plugin to have a minimum height of 214 pixels, or 154 pixel if using the small header.
|
101 |
|
|
|
102 |
== Screenshots ==
|
103 |
-
1.
|
104 |
-
2.
|
105 |
-
3. The
|
|
|
106 |
|
107 |
== Changelog ==
|
108 |
|
109 |
-
= 1.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
110 |
* Fixed bug where plugin would rerender during scroll on mobile devices
|
111 |
|
112 |
-
= 1.5.1 =
|
113 |
* Fixed bug where plugin wouldn't rerender
|
114 |
* Fixed bug with languages XML file not loading on installs where the admin is not wp-admin
|
115 |
|
116 |
-
= 1.5.0 =
|
117 |
* Migrated to object oriented
|
118 |
* Fixed languages XML file being blocked by iThemes Security
|
119 |
-
* Added option for switching between HTML5/XHTML
|
120 |
* Fixed HTML issue with dashboard widget
|
121 |
* Added script that makes the plugin fully responsive
|
122 |
|
123 |
-
= 1.4.2 =
|
124 |
* Fixing shortcode not being updated when tabs change in the shortcode generator
|
125 |
* Removing link text parameter and option when `Show Link` is false
|
126 |
|
127 |
-
= 1.4.1 =
|
128 |
* Fixing shortcode generator using posts instead of tabs
|
129 |
* Verifying compatibility with 4.3.1
|
130 |
|
131 |
-
= 1.4.0 =
|
132 |
* Options to remove and customise the page link that displays while the plugin loads
|
133 |
* Fixed `undefined index` error when adding a new instance of the plugin in the customizer
|
134 |
* Updated all admin text to be multi-lingual compatible
|
135 |
* Updated `posts` option to `tabs`
|
136 |
* Updated screenshots and example
|
137 |
|
138 |
-
= 1.3.4 =
|
139 |
* Fixed typo in widget
|
140 |
* Fixed labels in widget
|
141 |
* Changed languages to load from a local file instead of Facebook's Locales XML file. This fixes the issue where approximately 40 languages were supported by Facebook but not for the page plugin, and also users working locally without internet access are now able to change the language from default.
|
142 |
* Re-introduced App ID, while it should not be needed it appears that removing it has affected some sites.
|
143 |
|
144 |
-
= 1.3.3 =
|
145 |
* Direct access security update
|
146 |
* Verifying compatibility with WP 4.2.4 and WP 4.3
|
147 |
* Fixing bug where some options in the widget would revert to the default instead of false
|
148 |
|
149 |
-
= 1.3.2 =
|
150 |
* WP 4.2.3 Compatibility
|
151 |
* Upgrading to Graph API 2.4
|
152 |
|
153 |
-
= 1.3.0 =
|
154 |
* Added hide-cta, small-header and adapt-container-width settings
|
155 |
* Adjusted min height and width
|
156 |
|
157 |
-
= 1.2.5 =
|
158 |
* Fixed close icon on notice
|
159 |
|
160 |
-
= 1.2.4 =
|
161 |
* Fixed readme
|
162 |
|
163 |
-
= 1.2.3 =
|
164 |
* Fixed bug where the admin dashboard and widgets pages would break if the WordPress installation is running on localhost and there is no internet connection
|
165 |
|
166 |
-
= 1.2.2 =
|
167 |
* Fixed posts option for widget
|
168 |
|
169 |
-
= 1.2.1 =
|
170 |
* Fixed readme bug
|
171 |
|
172 |
-
= 1.2.0 =
|
173 |
* Added multilingual support. Language can be specified in the shortcode, otherwise it is retrievd from the site settings.
|
174 |
* Added a shortcode generator dashboard widget to allow easier creation of the shortcode
|
175 |
* Added a custom widget
|
176 |
|
177 |
-
= 1.1.1 =
|
178 |
* Fixed height bug
|
179 |
|
180 |
-
= 1.1.0 =
|
181 |
* Added filter to allow calling of shortcodes in the text widget
|
182 |
|
183 |
-
= 1.0.3 =
|
184 |
* Fixing screenshot issue
|
185 |
|
186 |
-
= 1.0.1 =
|
187 |
* Cleaning up readme file
|
188 |
|
189 |
-
= 1.0 =
|
190 |
* Initial release
|
191 |
|
192 |
-
== Upgrade Notice ==
|
193 |
|
194 |
-
|
195 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
196 |
|
197 |
-
|
198 |
-
|
|
|
|
|
199 |
|
200 |
-
= 1.3.0 =
|
201 |
-
This version adds new settings. Please update for the best possible experience.
|
202 |
|
203 |
-
|
204 |
-
This version fixes a bug where the admin dashboard and widgets pages would break if the WordPress installation is running on localhost and there is no internet connection. While not imperative to most sites it is recommended that you update if you work on a localhost or virtual machine
|
205 |
|
206 |
-
|
207 |
-
This version addresses a fix for the posts option not working in the widget. Please update immediately.
|
208 |
|
209 |
-
|
210 |
-
This version includes multilingual support, a custom widget and a shortcode generator on the admin dashboard. It is highly recommended that you update.
|
211 |
|
212 |
-
|
213 |
-
Fixed height bug where height would only ever be the same value as width. Update immediately.
|
214 |
|
215 |
-
|
216 |
-
Added filter to allow calling of shortcodes in the text widget
|
1 |
=== Facebook Page Plugin ===
|
2 |
Contributors: cameronjonesweb
|
3 |
+
Tags: like box,facebook like box,facebook page plugin, facebook feed, facebook page
|
4 |
+
Donate link: https://www.patreon.com/cameronjonesweb
|
5 |
Requires at least: 4.0
|
6 |
+
Tested up to: 4.7.3
|
7 |
+
Stable tag: 1.6.0
|
8 |
License: GPLv2
|
9 |
License URI: http://www.gnu.org/licenses/old-licenses/gpl-2.0.html
|
10 |
|
11 |
It's time to upgrade from your old like box! Display the Facebook Page Plugin from the Graph API using a shortcode or widget.
|
12 |
|
|
|
|
|
13 |
|
14 |
+
== Description ==
|
15 |
+
Seamlessly add a Facebook Page to your WordPress website with the Facebook Page Plugin! Trusted by more than 20,000 WordPress websites worldwide, the Facebook Page Plugin is the simplest way to add a Facebook page to your website.
|
16 |
|
17 |
+
You can add your Facebook page to any widget area with the custom Facebook Page Plugin widget, with live preview available in the Customizer.
|
18 |
|
19 |
+
The plugin can be used to add your Facebook page to any post, page or text widget by using the `[facebook-page-plugin]` shortcode to display the plugin wherever you like, as often as you like.
|
20 |
|
21 |
+
Other features include:
|
22 |
|
23 |
+
* A shortcode generator on the admin dashboard for easy generating of the shortcode
|
24 |
|
25 |
* Uses your site language by default, but you can display your Facebook page in all 95 languages that Facebook supports, including English, Spanish, Arabic, German, French, Russian and many more
|
26 |
|
27 |
+
With more than 20,000 installs and nearly 50 5-star rating, the Facebook Page Plugin is one of the most popular social media plugins for WordPress.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
28 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
29 |
|
30 |
== Frequently Asked Questions ==
|
31 |
+
|
32 |
= What happened to "Show Posts"? =
|
33 |
The latest version of the API has removed show posts and replaced it with `tabs` which is more dynamic. To show just the posts, your tabs value should be "timeline". To hide the posts, `tabs` should be empty (shortcode) or select "none" (widget). If you're using the shortcode, remember that by default it shows the timeline so you must set it as either an empty or false value to hide posts ie `tabs=""` or `tabs="false"`. If the posts option is already being used it will be converted to tabs.
|
34 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
35 |
= What languages are available? =
|
36 |
As of version 1.2.0, the plugin is available in all languages provided by Facebook ( full list availabe [here](https://www.facebook.com/translations/FacebookLocales.xml) ). By default it uses the same language as the site, but alternatively you can specify the language in the shortcode. The dashboard widget is currently only available in English but is multilingual ready.
|
37 |
|
48 |
= I can't get the Facepile to work! =
|
49 |
Chances are your plugin isn't tall enough to display the facepile properly. The facepile requires the plugin to have a minimum height of 214 pixels, or 154 pixel if using the small header.
|
50 |
|
51 |
+
|
52 |
== Screenshots ==
|
53 |
+
1. The Facebook Page Plugin widget in use with the Twenty Sixteen theme
|
54 |
+
2. Easy-to-use widget form with the new options available in 1.6
|
55 |
+
3. The shortcode generator dashboard widget
|
56 |
+
|
57 |
|
58 |
== Changelog ==
|
59 |
|
60 |
+
= 1.6.0 - 02/04/17 =
|
61 |
+
* New landing page with FAQs to help with onboarding of new users
|
62 |
+
* Removal of the admin notice review nag
|
63 |
+
* Localisation of SDK
|
64 |
+
* Added `events` option to the widget and shortcode generator
|
65 |
+
* Changed `tabs` setting to checkboxes instead of a dropdown
|
66 |
+
|
67 |
+
= 1.5.3 - 25/01/16 =
|
68 |
+
* Fixed bug where share button would return `App Not Setup` error
|
69 |
+
|
70 |
+
= 1.5.2 - 01/12/15 =
|
71 |
* Fixed bug where plugin would rerender during scroll on mobile devices
|
72 |
|
73 |
+
= 1.5.1 - 29/11/15 =
|
74 |
* Fixed bug where plugin wouldn't rerender
|
75 |
* Fixed bug with languages XML file not loading on installs where the admin is not wp-admin
|
76 |
|
77 |
+
= 1.5.0 - 23/11/15 =
|
78 |
* Migrated to object oriented
|
79 |
* Fixed languages XML file being blocked by iThemes Security
|
|
|
80 |
* Fixed HTML issue with dashboard widget
|
81 |
* Added script that makes the plugin fully responsive
|
82 |
|
83 |
+
= 1.4.2 - 23/09/15 =
|
84 |
* Fixing shortcode not being updated when tabs change in the shortcode generator
|
85 |
* Removing link text parameter and option when `Show Link` is false
|
86 |
|
87 |
+
= 1.4.1 - 22/09/15 =
|
88 |
* Fixing shortcode generator using posts instead of tabs
|
89 |
* Verifying compatibility with 4.3.1
|
90 |
|
91 |
+
= 1.4.0 - 03/09/15 =
|
92 |
* Options to remove and customise the page link that displays while the plugin loads
|
93 |
* Fixed `undefined index` error when adding a new instance of the plugin in the customizer
|
94 |
* Updated all admin text to be multi-lingual compatible
|
95 |
* Updated `posts` option to `tabs`
|
96 |
* Updated screenshots and example
|
97 |
|
98 |
+
= 1.3.4 - 13/08/15 =
|
99 |
* Fixed typo in widget
|
100 |
* Fixed labels in widget
|
101 |
* Changed languages to load from a local file instead of Facebook's Locales XML file. This fixes the issue where approximately 40 languages were supported by Facebook but not for the page plugin, and also users working locally without internet access are now able to change the language from default.
|
102 |
* Re-introduced App ID, while it should not be needed it appears that removing it has affected some sites.
|
103 |
|
104 |
+
= 1.3.3 - 11/08/15 =
|
105 |
* Direct access security update
|
106 |
* Verifying compatibility with WP 4.2.4 and WP 4.3
|
107 |
* Fixing bug where some options in the widget would revert to the default instead of false
|
108 |
|
109 |
+
= 1.3.2 - 25/07/15 =
|
110 |
* WP 4.2.3 Compatibility
|
111 |
* Upgrading to Graph API 2.4
|
112 |
|
113 |
+
= 1.3.0 - 02/07/15 =
|
114 |
* Added hide-cta, small-header and adapt-container-width settings
|
115 |
* Adjusted min height and width
|
116 |
|
117 |
+
= 1.2.5 - 06/06/15 =
|
118 |
* Fixed close icon on notice
|
119 |
|
120 |
+
= 1.2.4 - 05/06/15 =
|
121 |
* Fixed readme
|
122 |
|
123 |
+
= 1.2.3 - 04/06/15 =
|
124 |
* Fixed bug where the admin dashboard and widgets pages would break if the WordPress installation is running on localhost and there is no internet connection
|
125 |
|
126 |
+
= 1.2.2 - 27/05/15 =
|
127 |
* Fixed posts option for widget
|
128 |
|
129 |
+
= 1.2.1 - 27/05/15 =
|
130 |
* Fixed readme bug
|
131 |
|
132 |
+
= 1.2.0 - 26/05/15 =
|
133 |
* Added multilingual support. Language can be specified in the shortcode, otherwise it is retrievd from the site settings.
|
134 |
* Added a shortcode generator dashboard widget to allow easier creation of the shortcode
|
135 |
* Added a custom widget
|
136 |
|
137 |
+
= 1.1.1 - 14/05/15 =
|
138 |
* Fixed height bug
|
139 |
|
140 |
+
= 1.1.0 - 10/05/15 =
|
141 |
* Added filter to allow calling of shortcodes in the text widget
|
142 |
|
143 |
+
= 1.0.3 - 28/04/15 =
|
144 |
* Fixing screenshot issue
|
145 |
|
146 |
+
= 1.0.1 - 28/04/15 =
|
147 |
* Cleaning up readme file
|
148 |
|
149 |
+
= 1.0 - 25/04/15 =
|
150 |
* Initial release
|
151 |
|
|
|
152 |
|
153 |
+
== Plugin Settings ==
|
154 |
+
|
155 |
+
The Facebook Page Plugin uses a shortcode to insert the page feed. You set your settings within the shortcode.
|
156 |
+
`[facebook-page-plugin setting="value"]`
|
157 |
+
Available settings:
|
158 |
+
|
159 |
+
`href` (URL path that comes after facebook.com/)
|
160 |
+
|
161 |
+
`width` (number, in pixels, between 180 and 500, default 340)
|
162 |
+
|
163 |
+
`height` (number, in pixels, minimum 70, default 500)
|
164 |
+
|
165 |
+
`cover` (true/false, show page cover photo, default true)
|
166 |
+
|
167 |
+
`facepile` (true/false, show facepile, default true)
|
168 |
+
|
169 |
+
`tabs` (any combination of [posts, messages, events], default timeline)
|
170 |
+
|
171 |
+
`cta` (true/false, hide custom call to action if applicable, default false)
|
172 |
+
|
173 |
+
`small` (true/false, display small header (must be true for height to be lower than 130px), default false)
|
174 |
+
|
175 |
+
`adapt` (true/false, force plugin to be responsive, default true)
|
176 |
+
|
177 |
+
`language` (languageCode_countryCode eg: en_US, language of the plugin, default site language)
|
178 |
+
|
179 |
+
* Deprecated Settings *
|
180 |
|
181 |
+
`posts` (true/false) - posts has been replaced by tabs as of 1.4.0. There is a fallback in place to convert it to tabs
|
182 |
+
|
183 |
+
Example: `[facebook-page-plugin href="facebook" width="300" height="500" cover="true" facepile="true" tabs="timeline" adapt="true"]`
|
184 |
+
This will display a Facebook page feed that loads in the page `facebook.com/facebook` that is 300px wide but adapts to it's container, 500px high, displaying the page's cover photo, facepile and recent posts in the same language as the site. See the screenshots tab for a demonstration of how it will appear
|
185 |
|
|
|
|
|
186 |
|
187 |
+
== Filter Reference ==
|
|
|
188 |
|
189 |
+
`facebook_page_plugin_dashboard_widget_capability`
|
|
|
190 |
|
191 |
+
Changes who can see the shortcode generator on the dashboard. Default: `edit_posts`
|
|
|
192 |
|
193 |
+
`facebook_page_plugin_app_id`
|
|
|
194 |
|
195 |
+
Changes the Facebook App ID.
|
|