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

Simple Twitter Link displays a link allowing Twitter users to update their status with a link back to your post or page.

== Description ==

The code for Simple Twitter 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 Twitter Link simply returns a URL - this URL is a link to Twitter with your post/page URL within it. It even uses TinyURL to make the link passed to Twitter even more convenient.

Ok, this may not be making sense yet, so here's an example.

`<a href="<?php simple_twitter_link(''); ?>">Send to Twitter</a>`

This will display the text "Send to Twitter" on your page/post. However, when clicked on it will take you to your Twitter account and pre-fill in the status with "I'm currently reading xxx", where xxx will be a TinyURL address of the page/post that you just came from.

I hope that makes more sense.

In the case of this example, no parameters were passed and, hence, a default sentence was passed to Twitter. If, however, you'd like to define your own Twitter text, then you simply pass this as the only parameter. `%url%` must be specified within the sentence, as this tells Simple Twitter Link where you want the TinyURL address to go.

So, another example...

`<a href="<?php simple_twitter_link('%url% is an excellent read'); ?>">Send to Twitter</a>`

In this case the line "xxx is an excellent read" (again, where xxx is the TinyURL address of your page/post) will be passed to Twitter.

If you don't pass a parameter or miss out the %url% tag the default text will be used.

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_twitter_link')) : ?>`
`<a href="<?php simple_twitter_link(''); ?>">Send to Twitter</a>`
`<?php endif; ?>`

From version 1.1 you can also use an addition tag, `%title%`, which will show the post/page title in the Twitter text.

From version 1.2 you can also use a number of additional tags which will override the default TinyURL for shortening URLs. Simply include one of the following...

`%is.gd%`
`%snipr%`
`%tr.im%`

If there are any others that you'd like to see added, please let me know.

This text will then be removed from the resultant output to Twitter. So, here is a further example...

`<a href="<?php simple_twitter_link('%tr.im%Currently reading a blog post called "%title%" - %url%'); ?>">Send to Twitter</a>`

This uses both the new %title% tag and also overrides the shortening service to the one provided by tr.im.

== Installation ==

1. Upload the entire simple-twitter-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-twitter-link

== Changelog ==  
  
= 1.0 =
* Initial release

= 1.1 =
* There is an additional template tag, `%title%`, which will show the post/page title in the Twitter text

= 1.2 =
* Additional tags added to override the URL shortening service (defaults to TinyURL) - `%is.gd%`, `%snipr%`, `%tr.im%`.