=== Simple Facebook Link === Contributors: dartiss Donate link: http://artiss.co.uk/donate Tags: Facebook, Link, Share Requires at least: 2.0.0 Tested up to: 2.9.2 Stable tag: 1.4 Simple Facebook Link displays a link allowing you to share posts and pages with Facebook users. == Description == **From version 1.3 you must now install the [Simple URL Shortener](http://wordpress.org/extend/plugins/simple-url-shortener/ "Simple URL Shortener") plugin for the URL shortening to work in this plugin** The code for Simple Facebook Link should be added to the bottom of appropriate post/page templates within your theme (and in the case of posts, within "the loop"). Simple Facebook Link simply returns a URL - this URL is a link to Facebook with your post/page URL and blog title within it. It can even use TinyURL and other URL shortening services to make the link passed to Facebook even more convenient. Here's an example. `Share on Facebook` This will display the text "Share on Facebook" on your page/post. However, when clicked on it will take you to Facebook, where it will have your blog post/page details and will give the current user an option to add a comment before sharing it with their Facebook community. In the case of this example, no parameters were passed and, hence, no URL shortening service was used. If, however, you'd like to use a such a service, simply add one as a parameter. A full list can be found in the documentation for the [Simple URL Shortener](http://wordpress.org/extend/plugins/simple-url-shortener/ "Simple URL Shortener") plugin. The following is an example of how it could be used, with a `function_exists` check so that it doesn't cause problems if the plugin is not active... `` `Share on Facebook` `` This also requests is.gd to be used to shorten the URL. From version 1.3, you can also specify a second parameter (which is optional and can be omitted), allowing you to override the URL. This is useful if you wish to add a Facebook link outside of "the loop". An example is... `Share on Facebook` This overrides the URL to the artiss.co.uk homepage and shortens it using the is.gd service. From version 1.4 you can use the first parameter to specify optional API key and logon details for the shortening service (if required). Each sub-parameter must be seperated by an ampersand and the service provider must also be identified. The following parameters are accepted... **service=** - This is the name of the shortening service **apikey=**, **login=**, **password=** : These allow optional URL shortening options to be specified (see the documentation for Simple URL Shortener for further details) So, to specify an API key, you might put... `Share on Facebook` == 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. There is no options screen - configuration is done in your code. == Frequently Asked Questions == = How can I get help or request possible changes = Feel free to report any problems, or suggestions for enhancements, to me either via [my contact form](http://www.artiss.co.uk/contact "Contact Me") or by [the plugins' homepage](http://www.artiss.co.uk/simple-facebook-link "Simple Facebook Link"). == 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 == Upgrade Notice == = 1.4 = * Upgrade is you use shortened URLs and want to use API keys or logons