Struggeling to get your site more social with the Facebook plugins? Stop struggeling and use the Facebook Tools module for ExpressionEngine. With this module you can add easily Facebook plugins to your site in an eyewink. It supports both HTML5 and XFBML. All Facebook Events are registerd to Google Analytics if possible; eg subscribe`s.
Supported plugins
Comments, Follow, Like Box, Like Button, Recommendations Box, Send, fb:name, fb:profile-pic
Make sure your system meets the minimum requirements:
For every paid addon you need to validate your license in order to activate the module.
On a local environment, like *.dev *.local *.localhost *.test the license is valid for testing and building a new or existing sites.
For every other domain, you need to have a valid license.
Once installed, you will asked to enter your license key. When you entered a valid license you can hit the "Save license" button. This will start validating your license and will redirect you to addons.reinos.nl to login into your account. You can also register a new account in this process.
Once logged in, you are asked to use your current account or to login with another one.
Using the current logged in account, the server will check all info related to your license and once valid, it will redirect you back to your site where you see either a success message or an error message.
This module is using a license field to check if the license for the module is valid or not. On addons.reinos.nl you can check your license and add your valid domains.
In the Module CP you can enter then your license
When you enter a wrong license, the module will not work and it shows you an warning
Sometimes it happens that the license system says you have an invalid license. When this happens, make sure you have entered your domain url in your account, next to your license on addons.reinos.nl.
If this will not fix your license problem, please contact us on https://addons.reinos.nl/support
First of all you have to add the {exp:fb_tools:init} method in the <head> of the page.
This method will add all necessary javascript and css to you page to get the plugin fully working.
See here the tags that the init function can accept.
After weve added theinitmethod to the
we can start adding the Facebook plugins.
This can be done by putting{exp:fb_tools:plugin_name}` in your page.
Also make sure you setup a facebook developer account and add your api number in the settings cp.
{exp:fb_tools:init
lang="en_US"
}Below are the Tag Parameters. Those parameters can be used in the tag described above.
the language code. e.g. en_US or nl_NL, Default to en_US
lang=""Must the user auth with the app?
auth_app="no"To add some default tekst or loading icon before the app is loaded, use the default_text="". This parameter is available in every plugin
{exp:fb_tools:comments}Below are the Tag Parameters. Those parameters can be used in the tag described above.
the URL for this Comments plugin. News feed stories on Facebook will link to this URL. Defaults to the current url.
href=""the width of the plugin in pixels. Minimum recommended width: 400px.
width="500px"the number of comments to show by default. Default: 10. Minimum: 1
num_posts="10"the color scheme for the button. Options: 'light', 'dark'
colorscheme="light"The order to use when displaying comments. Can be "social", "reverse_time", or "time". The different order types are explained
order_by="social"{exp:fb_tools:follow}Below are the Tag Parameters. Those parameters can be used in the tag described above.
the URL for this Comments plugin. News feed stories on Facebook will link to this URL. Defaults to the current url.
href=""layout - there are three options.
layout=""specifies whether to display profile photos below the button (standard layout only)
show_faces=""the font to display in the plugin. Options: 'arial', 'lucida grande', 'segoe ui', 'tahoma', 'trebuchet ms', 'verdana'
colorscheme=""the width of the plugin.
width="300"{exp:fb_tools:like_box}Below are the Tag Parameters. Those parameters can be used in the tag described above.
the URL for this Comments plugin. News feed stories on Facebook will link to this URL. Defaults to the current url.
href=""the width of the plugin.
width="300"the height of the plugin in pixels. The default height varies based on number of faces to display, and whether the stream is displayed. With the stream displayed, and 10 faces the default height is 556px. With no faces, and no stream the default height is 63px.
height=""specifies whether to display profile photos below the button (standard layout only)
show_faces=""specifies whether to display a stream of the latest posts from the Page's wall
stream=""specifies whether to display the Facebook header at the top of the plugin.
header=""the border color of the plugin.
border_color=""for Places, specifies whether the stream contains posts from the Place's wall or just checkins from friends. Default value: false.
force_wall=""{exp:fb_tools:like_button}Below are the Tag Parameters. Those parameters can be used in the tag described above.
the URL for this Comments plugin. News feed stories on Facebook will link to this URL. Defaults to the current url.
href=""specifies whether to include a Send button with the Like button. This only works with the XFBML version.
send=""layout - there are three options. Default to standaard
layout=""specifies whether to display profile photos below the button (standard layout only)
show_faces=""the width of the Like button.
width=""the verb to display on the button. Options: 'like', 'recommend'
action=""the font to display in the button. Options: 'arial', 'lucida grande', 'segoe ui', 'tahoma', 'trebuchet ms', 'verdana'
font=""a label for tracking referrals; must be less than 50 characters and can contain alphanumeric characters and some punctuation (currently +/=-.:_). The ref attribute causes two parameters to be added to the referrer URL when a user clicks a link from a stream story about a Like action:
ref=""{exp:fb_tools:send}Below are the Tag Parameters. Those parameters can be used in the tag described above.
the URL for this Comments plugin. News feed stories on Facebook will link to this URL. Defaults to the current url.
href=""the font to display in the button. Options: 'arial', 'lucida grande', 'segoe ui', 'tahoma', 'trebuchet ms', 'verdana'
font=""a label for tracking referrals; must be less than 50 characters and can contain alphanumeric characters and some punctuation (currently +/=-.:_). The ref attribute causes two parameters to be added to the referrer URL when a user clicks a link from a stream story about a Like action:
ref=""{exp:fb_tools:recommendation_bar}Below are the Tag Parameters. Those parameters can be used in the tag described above.
the URL for this Comments plugin. News feed stories on Facebook will link to this URL. Defaults to the current url.
href=""a label for tracking referrals; must be less than 50 characters and can contain alphanumeric characters and some punctuation (currently +/=-.:_). The ref attribute causes two parameters to be added to the referrer URL when a user clicks a link from a stream story about a Like action:
ref=""trigger - when the plugin expands. Note that this parameter is evaluated in addition to the read_time parameter. Default is when a user scrolls past the
trigger=""The number of seconds before the plugin will expand. Default is 30 seconds. Minimum is 10 seconds.
read_time=""The verb to display on the button. Options: 'like', 'recommend'
action=""the side of the screen where the plugin will be displayed. This will automatically adjust based on the language, or can be set explicitly. Options: 'left', 'right'
side=""a comma separated list of domains to show recommendations for. The default is the domain of the href parameter.
site=""the number of recommendations to display. By default, this value is 2 and the maximum value is 5.
num_recommendations=""a limit on recommendation and creation time of articles that are surfaced in the plugins, the default is 0 (we don’t take age into account). Otherwise the valid values are 1-180, which specifies the number of days.
max_age=""{exp:fb_tools:recommendation_box}Below are the Tag Parameters. Those parameters can be used in the tag described above.
a label for tracking referrals; must be less than 50 characters and can contain alphanumeric characters and some punctuation (currently +/=-.:_). The ref attribute causes two parameters to be added to the referrer URL when a user clicks a link from a stream story about a Like action:
ref=""a limit on recommendation and creation time of articles that are surfaced in the plugins, the default is 0 (we don’t take age into account). Otherwise the valid values are 1-180, which specifies the number of days.
max_age=""a comma separated list of domains to show recommendations for. The default is the domain of the href parameter.
site=""a comma separated list of actions to show activities for.
action=""the width of the plugin in pixels. Default width: 300px.
width=""the height of the plugin in pixels. Default height: 300px.
height=""specifies whether to show the Facebook header. Default to yes
header=""the font to display in the plugin. Options: 'arial', 'lucida grande', 'segoe ui', 'tahoma', 'trebuchet ms', 'verdana'
font=""the border color of the plugin.
border_color=""This specifies the context in which content links are opened. By default all links within the plugin will open a new window. If you want the content links to open in the same window, you can set this parameter to _top or _parent. Links to Facebook URLs will always open in a new window.
linktarget=""{exp:fb_tools:get_name}Below are the Tag Parameters. Those parameters can be used in the tag described above.
The ID of the user or Page whose name you want to show. Alternately, you can use profileowner only on a user's profile; you can use loggedinuser only on canvas pages.
uid=""Show only the user's first name. Default value is no
firstnameonly=""Link to the user's profile. Default value is yes
linked=""Show only the user's last name. Default value is no
lastnameonly=""Capitalize the text if useyou is true and loggedinuser is uid. Default value is yes
capitalize=""The Facebook ID of the subject of the sentence where this name is the object of the verb of the sentence. Will use the reflexive when appropriate. When subjectid is used, uid is considered to be the object and uid's name is produced.
subjectid=""Make the user's name possessive (e.g. Joe's instead of Joe). Default value is no.
possessive=""Use yourself if useyou is yes. Default value is no.
reflexive=""Displays the primary educational network for the uid, if applicable. Other networks do not show. Default value is no.
shownetwork=""Use you if uid matches the logged in user. Default value is yes.
useyou=""Alternate text to display if the logged in user cannot access the user specified. To specify an empty string instead of the default, use ifcantsee="". Default value is Facebook User
ifcantsee=""{exp:fb_tools:get_profile_pic}Below are the Tag Parameters. Those parameters can be used in the tag described above.
The ID of the user or Page whose name you want to show. Alternately, you can use profileowner only on a user's profile; you can use loggedinuser only on canvas pages.
uid=""The size of the image to display. Default value is thumb. Other valid values are thumb (t) (50px wide), small (s) (100px wide), normal (n) (200px wide), and square (q) (50px by 50px). Or, you can specify width and height settings instead, as described below.
size=""Make the image a link to the user's profile. Default value is yes
linked=""(For use with Facebook Connect only.) When set to true, it returns the Facebook favicon image, which gets overlaid on top of the user's profile picture on a site.
facebook_logo=""Specifies the desired width, in pixels, of the image (like an img tag).
width=""Specifies the desired height, in pixels, of the image (like an img tag).
height=""Get the total comments
{exp:fb_tools:comment_count}Below are the Tag Parameters. Those parameters can be used in the tag described above.
The url
href=""{exp:fb_tools:share}Below are the Tag Parameters. Those parameters can be used in the tag described above.
the URL for this Comments plugin. News feed stories on Facebook will link to this URL. Default to the current url.
href=""The width of the plugin in pixels. Minimum recommended width: 400px. Default to 500
width=""Selects one of the different layouts that are available for the plugin. Can be one of "box_count", "button_count", "button", "link", "icon_link", or "icon". default: icon_link
layout=""