=== Artiss Facebook Link === Contributors: dartiss Donate link: http://artiss.co.uk/donate Tags: Facebook, link, share, social, Artiss Requires at least: 2.5 Tested up to: 3.1.2 Stable tag: 1.5 Artiss Facebook Link (formally Simple Facebook Link) will generate a URL that allows you to quickly and easily share a post or page on Facebook. == Description == Artiss Facebook link generates a link to Facebook allowing you to share post or page URLs. It can be used in 2 different ways - a function call within your theme or a short code. To use the function call (for example within a post loop) is as follows... ` Share on Facebook ` Calling `artiss_facebook_link` will return the appropriate Facebook URL for the current post/page URL. To use the shortcode you'd simple wrap `[facebook]` around any text that you wish to add the link to. For example... `[facebook]Share on Facebook[/facebook]` For further instructions on use please read the [Other Notes](http://wordpress.org/extend/plugins/simple-facebook-link/other_notes/ "Other Notes") section. **For help with this plugin, or simply to comment or get in touch, please read the appropriate section in "Other Notes" for details. This plugin, and all support, is supplied for free, but [donations](http://artiss.co.uk/donate "Donate") are always welcome.** == Further Parameters == The function call allows for 2 parameters to be specified. The first parameter is a list of options relating to shortening the URL (this is then used by Facebook). Please see the next section, URL Shortening, for further details. The second parameter is an optional URL, which you can use to override the default URL that will be shared. For example... `` This will share the URL http://www.artiss.co.uk on Facebook. The same can be done with the short code, using the URL parameter. For example... `[facebook url="http://www.artiss.co.uk"]Share on Facebook[/facebook]` == URL Shortening == To shorten URLs you must install the [Simple URL Shortener](http://wordpress.org/extend/plugins/simple-url-shortener/ "Simple URL Shortener") plugin. Once active, you can use the first parameter of Artiss Facebook Link to request the URL to be shortened. The following parameters are valid... **service=** : This is the name of the shortening service **apikey=**, **login=**, **password=**, **cache** : These allow optional URL shortening options to be specified (see the documentation for Simple URL Shortener for further details) These specified with a seperating ampersand, for example... `` The same parameter can be used with the short code. For instance... `[facebook url="http://www.artiss.co.uk" service="is.gd" cache="no"]Share on Facebook[/facebook]` Do you need to shorten URLs for Facebook? Personally I don't, as when trying to share the URL Facebook will attempt to retrieve titles, thumbnails, etc, and may struggle if the URL has been shortened. But, the option is there if you do wish to. == Licence == This WordPress plugin is licensed under the [GPLv2 (or later)](http://wordpress.org/about/gpl/ "GNU General Public License"). == Support == All of my plugins are supported via [my website](http://www.artiss.co.uk "Artiss.co.uk"). Please feel free to visit the site for plugin updates and development news - either visit the site regularly, follow [my news feed](http://www.artiss.co.uk/feed "RSS News Feed") or [follow me on Twitter](http://www.twitter.com/artiss_tech "Artiss.co.uk on Twitter") (@artiss_tech). For problems, suggestions or enhancements for this plugin, there is [a dedicated page](http://www.artiss.co.uk/facebook-link "Artiss Facebook Link") and [a forum](http://www.artiss.co.uk/forum "WordPress Plugins Forum"). The dedicated page will also list any known issues and planned enhancements. **This plugin, and all support, is supplied for free, but [donations](http://artiss.co.uk/donate "Donate") are always welcome.** == Installation == 1. Upload the entire `simple-facebook-link` folder to your wp-content/plugins/ directory. 2. Activate the plugin through the 'Plugins' menu in WordPress. 3. That's it, you're done - you just need to add the function call or short code! == Frequently Asked Questions == = Which version of PHP does this plugin work with? = It has been tested and been found valid from PHP 4 upwards. == Changelog == = 1.0 = * Initial release = 1.1 = * Added bit.ly to list of URL shortening services = 1.2 = * Fixed issue with ampersands (and probably other characters) in the blog title causing linking issues * Added su.pr as another URL shortening service = 1.3 = * Now using [Simple URL Shortener](http://wordpress.org/extend/plugins/simple-url-shortener/ "Simple URL Shortener") plugin to provide URL shortening * Added new parameter that allows overriding of passed URL * Blog title again corrected, using code from Simple Social Bookmarks plugin * Code tidied = 1.4 = * Added ability to send API keys, etc, when requesting shortened URLs = 1.5 = * Plugin renamed as part of new naming policy * Function name changed to match - old function name still usable * Updated code to new standards, including addition of PHPDoc * Added shortcode option * Re-written instructions == Upgrade Notice == = 1.4 = * Upgrade is you use shortened URLs and want to use API keys or logons = 1.5 = * Upgrade to add a short code option