=== WP Tweet Button ===
Contributors: 0xTC
Tags: tweet button, retweet, tweet, WP Tweet Button, advanced, twitter, tweeting, social media, button, SEO, share, integration, b2l.me, bit.ly, cli.gs, sl.ly, snipr, su.pr, tinyurl, analytics, google analytics, campaign, campaign tracking
Requires at least: 2.7.2
Tested up to: 3.0.1
Stable tag: trunk
Donate link: https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=6331357

== Description ==

This plugin easily and fully implements Twitter's own *[Tweet Button](http://twitter.com/tweetbutton "Twitter Tweet Button")* on your blog or site. The tweet button can be positioned as you please and can be styled to your delight in the settings page. You can configure individual messages for your posts, use the title of your entry or a default message for tweets.

= Features =

* Custom recommendations per post entry for relevancy.
* Option for tweeting the entry title, page title, blog name or a custom text.
* Each post can have custom tweet texts.
* Custom text for tweets can be made using tags (`%POSTTITLE%`, `%BLOGTITLE%`).
* Tweet Button can be positioned at the top, bottom or both.
* Tweet Button can be align right, left, center (or none).
* Tweet Button can be excluded from bottom of posts on front page.
* Can be set to be positioned by the `[tweetbutton]` shortcode.
* Can be set to be positioned manually.
* Styling options for the `div` that surrounds the button.
* Can be set to vertical, horizontal or no counter.
* Option to switch between '{text} {link} via {@user}' and 'RT {@user} {text} {link}' formats.
* Referral can be turned off by removing the username.
* Authors can configure their own Twitter accounts on their profile pages. (WP3.x only)
* Tweet button language can be set to Twitter's supported languages.
* Tweet Button can be generated manually using the `tweetbutton();` function.
* Supports Wordpress 3 shortener functions.
* Initial URL shrinking with 3rd party services (*[b2l.me](http://b2l.me/ "b2l.me"), [bit.ly](http://bit.ly "Bit.ly"), [cli.gs](http://cli.gs "cli.gs"), [sl.ly](http://sl.ly "sl.ly"), [snipr](http://snipr.com "snipr.com"), [su.pr](http://su.pr "su.pr"), [tinyurl](http://tinyurl.com "tinyurl")*)
* Initial URL shrinking with the *[Twitter Friendly Links](http://wordpress.org/extend/plugins/twitter-friendly-links/ "Twitter Friendly Links")* Plugin.
* Initial URL shrinking with the *[YOURLS: WordPress to Twitter](http://wordpress.org/extend/plugins/yourls-wordpress-to-twitter/ "YOURLS: WordPress to Twitter")* Plugin.
* [WPTouch](http://wordpress.org/extend/plugins/wptouch/ "WP Touch") Support.
* counturl support for consistent url counts across URL shorteners.
* Supports adding a `rel` attribute (SEO).
* Hooks for 3rd party developers.
* Supports option to output in data tags.
* Includes caching controls for WP Super Cache and W3 Total Cache.
* Google Analytics support for campaign tracking.

= Support =

This plugin features a help section but you may also find the [FAQ](http://wordpress.org/extend/plugins/wp-tweet-button/faq/ "WP Tweet Button FAQ") or WP [Tweet Button](http://0xtc.com/2010/08/13/twitters-tweet-button-for-wordpress.xhtml "Tweet Button")'s page useful.

== Installation ==

Follow the steps below to install the plugin.

1. Upload the WP-Tweet-Button directory to the `/wp-content/plugins/` directory
2. Activate the plugin through the `Plugins` menu in WordPress
3. Go to Settings/WP Tweet Button to configure the button. Add your Twitter account.

== Frequently Asked Questions ==

= How do I add post titles or blog title in custom tweet texts? =

You can use the `%POSTTITLE%` and `%BLOGTITLE%` tags to do this. These tags valid in the WP Tweet Button general configuration and in your posts' Tweet Button settings.

Example:

* `New blog entry: %POSTTITLE% #cats` 

"#cats" in this example is a tag that's relevent to your blog.

= How do I create custom recommendations for each separate post/page? =

Simply edit your post and set your recommended user in the Tweet Button options box.

= How do manually create the Tweet Button in my template code? =

To create the Tweet Button manually, call the `tweetbutton();` function.

Examples:

* `echo tweetbutton();`
* `$myCustomPlaceForSocialMedia .= tweetbutton();`

Examples:

* `echo tweetbutton($post);`
* `$myCustomPlaceForSocialMedia .= tweetbutton($post);`

= Plugin doesn't work for some reason. How I contact the author? =

You can either leave a comment on the [plugin's page](http://0xtc.com/2010/08/13/twitters-tweet-button-for-wordpress.xhtml "WP Tweet Button"), or contact the author on twitter (*[@TCorp](http://twitter.com/tcorp/ "TCorp on Twitter")*). 

== Screenshots ==

1. WP Tweet Button displayed on a post
2. WP Tweet Button will discreetly add tweet option controls to your posts and page.
3. WP Tweet Button controls in posts and page.
4. WP Tweet Button settings page.
5. WP Tweet Button help sections.
6. WP Tweet Button Advanced settings includes Google Analytics Campaign Tracking.
7. Twitter Tweet dialog.
8. Users can follow you and a recommended user after their tweet is sent.

== Changelog ==

= 1.9.3 =
* Google Analytics support for campaigns.
* Added more placement options (archives, search, excerpts).
* Option to exclude button from the bottom of posts on front page when before and after is selected.
* Templating related bug fixes.
* Users can set custom hook priority for advanced positioning.

= 1.9.2 =
* test builds classified as 1.9.2

= 1.9.1 =
* Saves options in an array (fewer DB requests)
* Resolves quotes bug.
* Option to add rel for SEO.
* Better RSS support.
* Better templating support.
* Added hooks for developers: `wp_tweet_button_long_url`, `wp_tweet_button_url`, `wp_tweet_button`
* Supports output in data tags.
* only supporting manual placement inside the loop.
* built-in alignment.
* Caching options for WP Super Cache and W3 Total Cache.

= 1.8.2 =

* More discreet controls for post/page edit screens.
* Added support to disable button for mobile browsing using [WPTouch](http://wordpress.org/extend/plugins/wptouch/ "WP Touch")
* counturl support added for consistent url counts across URL shorteners

= 1.8.1 =

* Object oriented codebase
* Removed need for JSON library (Resolves issues with some hosts)
* Button on posts is a switchable option.
* Uses newer bit.ly API.
* Uses simplified su.pr API.
* Supports excerpt compatibility for poorly written templates.

= 1.7.x =
* Minor plugin confict resolved.
* Fixed incompatibility bug for WP2.8 users.
* Fixed bit.ly save bug.
* Added support for Wordpress 3 shortener functions.
* Authors can configure their own Twitter accounts on their profile pages.
* Added referral formatting options.
* Added support for optional URL shrinking services:  b2l.me, bit.ly, cli.gs, sl.ly, snipr.com, su.pr, tinyarro.ws, tinyurl.com
* Added support for the [Twitter Friendly Links](http://wordpress.org/extend/plugins/twitter-friendly-links/ "Twitter Friendly Links") Plugin
* Added support for the [YOURLS: WordPress to Twitter](http://wordpress.org/extend/plugins/yourls-wordpress-to-twitter/ "YOURLS: WordPress to Twitter") Plugin
* using wp_register_script for widgets.js

= 1.6.x =
* Custom tweet text bug fix
* Option for each blog post to have its own custom tweet text.
* Custom tweet texts can include tags like `%POSTTITLE%` and `%BLOGTITLE%`

= 1.5.0 =
* Option box in posts included for easy configuration of Tweet Button per post.
* Option box includes optional disabling of tweet button per post.
* Option box includes recommended user and description.

= 1.4.x =
* RSS feed option
* No more default CSS
* Internationalization
* Fixed manual content missing bug.
* Added better control of tweet text.
* Cosmetic changes.

= 1.2.0 =

* Added support for recommendations.
* Added support for custom recommendations for each post (Read FAQ).

= 1.1.x =

* Cosmetic changes to the settings screen.
* Tweet Button Language enabled

= 1.0.0 =

* First build