=== Simple Facebook Link ===
Contributors: dartiss
Donate link: http://tinyurl.com/bdc4uu
Tags: Facebook
Requires at least: 2.0.0
Tested up to: 2.8.5
Stable tag: 1.3

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.

`<a href="<?php simple_facebook_link(''); ?>">Share on Facebook</a>`

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...

`<?php if (function_exists('simple_facebook_link')) : ?>`
`<a href="<?php simple_facebook_link('is.gd'); ?>">Share on Facebook</a>`
`<?php endif; ?>`

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...

`<a href="<?php simple_facebook_link('is.gd','http://www.artiss.co.uk'); ?>">Share on Facebook</a>`

This overrides the URL to the artiss.co.uk homepage and shortens it using the is.gd service.

== 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 or by the plugins homepage at http://www.artiss.co.uk/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