{"id":22399,"date":"2013-03-10T19:23:08","date_gmt":"2013-03-10T19:23:08","guid":{"rendered":"https:\/\/wordpress.org\/plugins-wp\/facebook-friends-inviter\/"},"modified":"2013-03-23T15:22:28","modified_gmt":"2013-03-23T15:22:28","slug":"facebook-friends-inviter","status":"closed","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/facebook-friends-inviter\/","author":11406610,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.0.5","stable_tag":"1.0.5","tested":"3.5.2","requires":"3.0","requires_php":"","requires_plugins":"","header_name":"Facebook Friends Inviter","header_author":"Lee Hodson","header_description":"","assets_banners_color":"","last_updated":"2013-03-23 15:22:28","external_support_url":"","external_repository_url":"","donate_link":"https:\/\/www.paypal.com\/cgi-bin\/webscr?cmd=_donations&business=lee@wpservicemasters.com&currency_code=USD&amount=&item_name=Donation%20to%20JournalXtra&return=http:\/\/journalxtra.com\/thank-you\/&notify_url=&cbt=Thank%20you%20for%20your%20donation,%20it%20is%20greatly%20appreciated&page_style=","header_plugin_uri":"http:\/\/journalxtra.com\/websiteadvice\/wordpress\/plugins-wordpress\/wordpress-invite-facebook-friends-button-plugin-5405\/","header_author_uri":"http:\/\/vizred.com\/","rating":4.4,"author_block_rating":0,"active_installs":20,"downloads":12292,"num_ratings":0,"support_threads":1,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":[],"upgrade_notice":{"":"<p>*<\/p>"},"ratings":{"1":"1","2":0,"3":0,"4":0,"5":"6"},"assets_icons":[],"assets_banners":[],"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.2","1.0.3","1.0.4","1.0.5"],"block_files":[],"assets_screenshots":{"screenshot-4.jpg":{"filename":"screenshot-4.jpg","revision":"1566936","resolution":"4","location":"plugin"},"screenshot-2.jpg":{"filename":"screenshot-2.jpg","revision":"1566936","resolution":"2","location":"plugin"},"screenshot-3.jpg":{"filename":"screenshot-3.jpg","revision":"1566936","resolution":"3","location":"plugin"},"screenshot-1.jpg":{"filename":"screenshot-1.jpg","revision":"1566936","resolution":"1","location":"plugin"}},"screenshots":{"1":"widget settings","2":"button appearance","3":"facebook invite popup","4":"facebook app creation"}},"plugin_section":[],"plugin_tags":[157,5283,9776,28501,175],"plugin_category":[],"plugin_contributors":[83804],"plugin_business_model":[],"class_list":["post-22399","plugin","type-plugin","status-closed","hentry","plugin_tags-facebook","plugin_tags-fb","plugin_tags-invite","plugin_tags-inviter","plugin_tags-links","plugin_contributors-leehodson","plugin_committers-leehodson"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/s.w.org\/plugins\/geopattern-icon\/facebook-friends-inviter.svg","icon_2x":false,"generated":true},"screenshots":[{"src":"https:\/\/ps.w.org\/facebook-friends-inviter\/trunk\/screenshot-1.jpg?rev=1566936","caption":"widget settings"},{"src":"https:\/\/ps.w.org\/facebook-friends-inviter\/trunk\/screenshot-2.jpg?rev=1566936","caption":"button appearance"},{"src":"https:\/\/ps.w.org\/facebook-friends-inviter\/trunk\/screenshot-3.jpg?rev=1566936","caption":"facebook invite popup"},{"src":"https:\/\/ps.w.org\/facebook-friends-inviter\/trunk\/screenshot-4.jpg?rev=1566936","caption":"facebook app creation"}],"raw_content":"<!--section=description-->\n<p>Add an Invite Facebook Friends button to any WordPress website with the Facebook Friends Inviter Plugin.<\/p>\n\n<p>This WordPress plugin adds customizable text links and customizable graphic buttons that are visible to anyone who visits your WordPress site. Buttons can be added using widgets and shortcodes.<\/p>\n\n<p><strong>Features<\/strong><\/p>\n\n<ul>\n<li>Facebook Requests Graphic Button<\/li>\n<li>Facebook Requests Link Button<\/li>\n<li>Seamless friend requests selector<\/li>\n<li>FB Friends request widgets - as many widgets as you want to use<\/li>\n<li>FB Friend inviter shortcodes - as many shortcodes as you want to use<\/li>\n<li>Customizable link text<\/li>\n<li>Customizable button<\/li>\n<li>Put the button or text link anywhere within your site<\/li>\n<li>Set button\/text width<\/li>\n<li>Set button\/text alignment<\/li>\n<\/ul>\n\n<p>This plugin is free. It is standalone so no need to install other plugins to make it work.<\/p>\n\n<p>You could use the Facebook request code in raw format within your site but why do that when you can use a plugin that makes the process easier, quicker and tidier!<\/p>\n\n<p><em>The easiest way to get your visitors to bring their Facebook friends to your party<\/em><\/p>\n\n<p><strong>The Widget<\/strong><\/p>\n\n<p>The widget can be placed in any widget area. Put it in a sidebar, in your header, in your footer... Put it wherever you have a widget area.<\/p>\n\n<p>Display your button using custom text or a custom button. Can't think of a button image to use? Use the default settings.<\/p>\n\n<p><strong>The widget has 10 settings<\/strong><\/p>\n\n<ul>\n<li>Widget Title<\/li>\n<li>Show Title<\/li>\n<li>Dialogue Box Title<\/li>\n<li>Message<\/li>\n<li>App ID<\/li>\n<li>Button Text<\/li>\n<li>Button Image<\/li>\n<li>Force Image Use<\/li>\n<li>Button Width<\/li>\n<li>Alignment<\/li>\n<\/ul>\n\n<p><em>Widget Title<\/em> is the title of the widget.<\/p>\n\n<p><em>Show Title<\/em> determines whether the widget title shows at all.<\/p>\n\n<p><em>Dialogue Box Title<\/em> sets the title of the Facebook friends selector popup box.<\/p>\n\n<p><em>Message<\/em> is the message shown in the Facebook friends selector popup box.<\/p>\n\n<p><em>App ID<\/em> is your Facebook App ID. Instructions for getting an app ID are shown below.<\/p>\n\n<p><em>Button Text<\/em> is the text used for your FB invite link. Leave as blank to show the default button image.<\/p>\n\n<p><em>Button Image<\/em> is for a custom button image URL. The default button is used if no URL is stated.<\/p>\n\n<p><em>Force button use?<\/em> Forces a button image to be used even if anchor text for a text link is stated in the Button text field.<\/p>\n\n<p><em>Button Width<\/em> lets you specify the pixel\/percentage width of the button image and button text.<\/p>\n\n<p><em>Alignment<\/em> lets you choose whether the button should be left, center or right aligned.<\/p>\n\n<p><a href=\"http:\/\/journalxtra.com\/websiteadvice\/wordpress\/plugins-wordpress\/wordpress-invite-facebook-friends-button-plugin-5405\/\">DEMO<\/a><\/p>\n\n<p><strong>The Shortcode<\/strong><\/p>\n\n<p>The [fib] shortcode lets you place a button anywhere in your site where a shortcode can be used. It has two attributes:<\/p>\n\n<ul>\n<li>title<\/li>\n<li>message<\/li>\n<li>text<\/li>\n<li>image<\/li>\n<li>appid<\/li>\n<li>width<\/li>\n<li>align<\/li>\n<\/ul>\n\n<p><em>title=\"\"<\/em> sets the title of the Facebook friends selector popup box.<\/p>\n\n<p><em>message=\"\"<\/em> sets the message shown in the Facebook friends selector popup box.<\/p>\n\n<p><em>text=\"\"<\/em> is the text used as your 'invite friends' link. Leave empty to display the default inviter button.<\/p>\n\n<p><em>image=\"\"<\/em> lets you specify an alternate button image. text=\"\" overrides any image setting.<\/p>\n\n<p><em>appid=\"\"<\/em> is your Facebook App ID (instructions above).<\/p>\n\n<p><em>width=\"\"<\/em> lets you specify the button width. You must add the unit of measure e.g px or %.<\/p>\n\n<p><em>align=\"\"<\/em> let you choose button alignment. Options are <em>left<\/em>, <em>center<\/em> and <em>right<\/em>. The default value is 'center'.<\/p>\n\n<p>Only two attributes need to be set for the button to work: <em>message<\/em> and <em>appid<\/em>. For example,<\/p>\n\n<p>[fib message=\"Learn exciting new stuff at example.com!\" appid=\"123456789\"]<\/p>\n\n<p>The shortcode used with all attributes could look like:<\/p>\n\n<p>[fib title=\"Invite friends to join\" message=\"Learn exciting new stuff at example.com!\" text=\"Click to invite friends\" image=\"http:\/\/example.com\" appid=\"123456789\" width=\"100%\" align=\"center\"]<\/p>\n\n<p>Both the <em>title<\/em> and <em>message<\/em> attributes default to 'Invite Friends'.<\/p>\n\n<p>The <em>text<\/em> attribute overrides the <em>image<\/em> attribute.<\/p>\n\n<h4>How to get your Facebook AppID<\/h4>\n\n<p>You need a Facebook App ID to be able to use the inviter plugin. Just follow these steps to make your app.<\/p>\n\n<ul>\n<li>Go to <a href=\"https:\/\/developers.facebook.com\/apps\/\">Facebook Developers<\/a><\/li>\n<li>Create a developers account if you do not already have one<\/li>\n<li>Click <em>Apps<\/em> in the top menu<\/li>\n<li>Click <em>Create New App<\/em> at the top right of the page, below the main menu<\/li>\n<li>Give your app a <em>Display Name<\/em> and <em>Namespace<\/em>. These can be the same. By doing this you are effectively naming your app within Facebook and giving it a URL<\/li>\n<li>Add a contact email<\/li>\n<li>Type in the domain name of the site that this plugin is installed in. Leave out the http:\/\/www bit. Enter the domain name only e.g example.com. Do not use a trailing slash<\/li>\n<li>Disable sandbox mode (we're not testing, are we?)<\/li>\n<li>Under <em>Website with Facebook Login,<\/em> enter the domain of the site that hosts this plugin. This time enter the protocol and the subdomain name if required e.g http:\/\/example.com\/ or http:\/\/www.example.com\/. Best way to get the proper domain is to go to the site's homepage and copy the URL from the browser address bar. Use a trailing slash<\/li>\n<li>Save changes<\/li>\n<li>Copy the App ID from the top of the <em>Basic<\/em> settings page<\/li>\n<li>You can set an avatar image from the <em>Basic<\/em> settings page by clicking <em>edit<\/em> when hovering over the default app avatar image. You add further details about your app from the <em>App Details<\/em> page<\/li>\n<li>Use the <em>App ID<\/em> in the FacebookInviter widget's settings or us it in the shortcode's appid=\"\" attribute.<\/li>\n<\/ul>\n\n<h3>Contact<\/h3>\n\n<p><a href=\"http:\/\/journalxtra.com\/\">General support<\/a>\n<a href=\"http:\/\/vizred.com\/\">Commercial support<\/a>\n<a href=\"https:\/\/www.paypal.com\/cgi-bin\/webscr?cmd=_donations&amp;business=lee@wpservicemasters.com&amp;currency_code=USD&amp;amount=&amp;item_name=Donation%20to%20JournalXtra&amp;return=http:\/\/journalxtra.com\/thank-you\/&amp;notify_url=&amp;cbt=Thank%20you%20for%20your%20donation,%20it%20is%20greatly%20appreciated&amp;page_style=WPSM\">Donate<\/a><\/p>\n\n<h3>Supported Languages<\/h3>\n\n<ul>\n<li>English<\/li>\n<\/ul>\n\n<!--section=installation-->\n<ol>\n<li>Use the WordPress <em>Add New Plugins<\/em> menu otherwise...<\/li>\n<li>Download the zip file from WordPress.org.<\/li>\n<li>Upload the <em>FacebookInviter<\/em> file to <em>\/wp-content\/plugins\/<\/em>.\n1, Extract the zip file.<\/li>\n<li>Activate the plugin through the WordPress <em>plugins<\/em> page.<\/li>\n<li>See <em>Appearance &gt; Widgets<\/em> to place the <em>Facebook Inviter Widget<\/em> in a widget area.<\/li>\n<li>Use the [fib] shortcode to place a Facebook friends inviter button anywhere a widget can't be used.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<p><em>How can I use single quotes in the Facebook PopUp Box?<\/em>\nYou can't. Swap them for double quotes instead.<\/p>\n\n<!--section=changelog-->\n<p>1.0.5<\/p>\n\n<ul>\n<li>Bug fix: 32 bit servers were unable to use numbers greater than 2147483647. Added different method of checking numerical input.<\/li>\n<\/ul>\n\n<p>1.0.4<\/p>\n\n<ul>\n<li>Replaced esc_html() with htmlspecialchars()<\/li>\n<li>Prefixed variables used by the shortcode's code with 'sc' to help eliminate conflict between the widget and the shortcode<\/li>\n<li>Prefixed the function() used within the shortcode's code with 'SC' to help eliminate conflict between the widget and the shortcode (precautionary action)<\/li>\n<li>Converted screenshots to jpegs from PNGs in hope they display better in the plugin's details in the WP repo.<\/li>\n<\/ul>\n\n<p>1.0.3<\/p>\n\n<ul>\n<li>Fixed missing comma in shortcode code.<\/li>\n<li>Changed esc_attr to esc_html() on save with html_entity_decode() on display in the widget code.<\/li>\n<li>Thank you wordpress.org users christonphero and funmi omoba for pointing out my oversight.<\/li>\n<\/ul>\n\n<p>1.0.2<\/p>\n\n<ul>\n<li>Minor change: original upload had been placed into a subdirectory within SVN \/Trunk. Corrected this.<\/li>\n<li>Corrected screenshots.<\/li>\n<\/ul>\n\n<p>1.0.1<\/p>\n\n<ul>\n<li>First public release.<\/li>\n<\/ul>","raw_excerpt":"Add Facebook friends inviter buttons using widgets and shortcodes. Visitors click the button then select Facebook friends to bring to your site.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/22399","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=22399"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/leehodson"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=22399"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=22399"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=22399"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=22399"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=22399"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=22399"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}