Disclaimer added 2014-10-03: I have not updated Tweet This since 2011-07-05 and lost interest in maintaining it. It has outstanding bugs and probably doesn’t even work work properly anymore due to changes to the Twitter API.
Download Tweet This 1.8.3 [0.8MB .zip]
Popular Twitter plugin inserts “Tweet This” links so your readers can share posts with one click. Can automatically tweet new posts via OAuth. Allows you to publish and schedule tweets from a new “Write Tweet” page. Supports 10 URL shorteners including Bit.ly, Su.pr, and TinyURL. Includes options for 20 social networks including Facebook, Bebo, and MySpace. Includes the Wickett Twitter Widget for your sidebar and many other options.
1.8.3: 2011-07-05: Small update to fix compatibility with WordPress 3.2.
Upgrading from 1.8.2 to 1.8.3
1. Upload the new /tweet-this/ folder over the old folder in your plugins folder.
2. Tweet This 1.8.3 is installed.
General Information
Tweeting a post on Twitter takes up a lot of space, because URLs quickly eat up your 140 characters. While your readers might copy the permalink, go to Bit.ly or TinyURL, shorten and copy the new URL, go to Twitter, and paste it into the status box, this plugin merges all that into one step.
This plugin makes short URLs like http:/example.com/?p=1234, then displays a link to Twitter for each post, with an optional icon (20 choices). This is done automatically for each post as needed. You can choose a URL shortener including Adjix.com, B2l.me, Bit.ly, Is.gd, Metamark.net, SnipURL.com, Su.pr, TinyURL.com, and Tweetburner.com. Each shortened URL is cached as a custom field in the postmeta table to keep load times fast. The cached records are updated or deleted as needed when you edit a post’s permalink, delete a post, change your site’s permalink structure, or change URL services. In WP 3.0 or later, Tweet This hooks the short URLs into the get_shortlink filter.
This plugin can also tweet new blog posts automatically, if you provide your Twitter credentials in the options. Then a “Send to Twitter” checkbox appears when writing a new post, along with a text box so you can change the tweet text for that specific blog post. As of 1.7, OAuth is used.
Unlike Tweetmeme, ShareThis, and other Twitter plugins, Tweet This inserts links without JavaScript, iFrames, or third-party dependencies. An example: http://twitter.com/home/?status=Example+Post+http://example.com/?p=1234
Copyright 2008 – 2011 Richard X. Thripp (email: richardxthripp@thripp.com)
Released under Version 2 of the GNU General Public License as published by
the Free Software Foundation, or, at your option, any later version.
Tweet This Version History
Tweet This Blogs
Tweet This Icons
Tweet This Wiki on Thripp.org
Tweet This on WordPress.org
Tweet This Installation
Before you begin, please make sure your server has PHP 5 and Curl enabled. While you can use Tweet This on PHP 4, all OAuth functions require PHP 5. Tweet This requires WordPress 1.5 minimum, with the following exceptions:
1. Importing exported options requires WP 2.0.
2. Automatic tweeting requires WP 2.7.
3. The Twitter Updates widget requires WP 2.8.
4. Adding short URLs to the get_shortlink filter requires WP 3.0.
5. Moving the Tweet This box around the Write Post page requires WP 3.0.
If you are installing Tweet This for the first time, follow these steps:
1. Upload the `tweet-this` folder to `/wp-content/plugins/`.
2. If you’re using WordPress MU and want this plugin active for all blogs, move `tweet-this.php` to `/wp-content/mu-plugins/` at this point.
3. Else, activate the plugin through the ‘Plugins’ menu in WordPress.
4. Tweet This icons should automatically appear on every post and page! Go to Settings > Tweet This to change settings and set up auto-tweets.
5. Optionally, delete readme.txt and the screenshots folder to save space.
Tweet This Donations
If you like Tweet This, consider donating $5.00, $10.00, or a larger amount via PayPal. As of Feb. 22, 2010, I have received $94 in donations since the initial release of Tweet This in Sept. 2008.
2011-02-22: $25.00 from Canopus Research Inc.
2011-02-17: $10.00 from Berend de Meyer.
2011-01-20: $5.00 from Nigel Boulton.
2010-10-27: $2.00 from JJ Soule.
2010-10-24: $10.00 from Linda C.
2010-10-20: $10.00 from Gareth Davies
2010-10-08: $1.00 from Tache Madalin
2010-10-01: $5.00 from Marcos Ramos
2010-09-20: $10.00 from Linda Worthington
2010-09-18: $1.00 from James Magary
2010-09-15: $10.00 from Miter Saw Reviews
2010-09-15: $5.00 from Kinoshita Communications LLC
Tweet This Screenshots

1. Tweet This options page: all sections closed.

2. Tweet This options page: all sections opened.

3. The Write Tweet page, having just published a tweet.

4. A post with Tweet This links; Twitter Web API and Share API.

5. Publishing a tweet alongside a new post.

6. The Twitter Updates widget included with Tweet This.
You are an absolute genius Richard. I have just used the automated wordpress plugin system and this plugin has loaded like a dream.
The only thing is the other buttons don’t appear to be loading, digg, delicious and the rest I have selected, have I missed something?
Reading a few other blogs about ‘tweeting’ some of the codes that are provided allow the blogger to add their twitter identity @dihusky for example, I believe this is to assist in building followers.. is this in your system, and/or is it planned for the future?
Once all the buttons are loaded, should I de-activate ‘sociable’ or keep it for archived articles.
Can we have a button with the bird? It is such a well recognised symbol, probably more than the ‘T’ now-a-days.
Suberb job, and from someone who is going grey and cant code to save myself… thanks heaps.
Hugh
Thank you! We used to have the bird from Twitterrific, but the creator told me to remove it. Main reason I don’t have a bird icon now is that it would be too tall compared to the other icons, but it would work if every service had an alternate tall icon. If you can come up with a logo, send me an email (richardxthripp@thripp.com).
It’s in there. You just have to change “Tweet Text” in the options to “@dihusky [TITLE] [URL]”.
Make sure you also click “Insert Digg This,” etc… choosing the icon is not enough.
I haven’t used Sociable but it offers more social networking services so it’s up to you. Tweet This links (and all the other services you have enabled) will appear on your old articles too.
Cool plug-in. Wondering how to remove the ‘text’ that shows up after the icon? Would like to have just the icons showing without the actual text ‘Tweet This Post’ after it and not sure how to do that.
Thanks!
Just replace “Tweet This Post” with “[BLANK]” for the link text in the options. There used to be a note about this, but to make the options page smaller in v1.5 I moved it so the text pops up when you hover over “Link.” This didn’t work as many people overlooked it, so in the new v1.5.1 I added the explanation back.
Hi Rich,
This is fantastic manual as always. Before I start with twitter though what are pros and cons. Twitter is nofollow right, so there is absolutely no value for seO purposes. In terms of traffic generation by twitter directly is it at all significant?
Thanks a lot!
Yeah, Twitter adds nofollow tags to all links so this plugin will not help your SERPs directly. If someone makes a blog post having seen your tweet, that will help. I don’t know how much Twitter traffic this plugin generates, but look at this Twitter search. Almost all of those tweets were made through Tweet This.
Hi Richard…
Is there a way to add “tweet this” to pages that are php-based but not run on WordPress or Blogger?
Thanks.
No, Tweet This does not provide for that. You could set something up with a custom PHP function, but caching the shortened URLs is always an issue.
One service I will add to Th8.us in the future is an API that allows you to pass the page URL and title on to my server, which will then shorten your URL and send the user to Twitter in one click. This way you wouldn’t need to pre-fetch and cache the URLs. No other URL shorteners offer this (is.gd, TinyURL, bit.ly, etc.).
You could encourage people to get the “Tweet any page” bookmarklet. Just go to Th8.us and drag that link at the bottom of the page to your bookmarks toolbar. Then click it when you want to tweet a page.
This sounds like an awesome twitter plugin that will address a few of my issues. Can’t wait to give it a try.
Thanks
You’re welcome. New version today; some minor upgrades.
Pingback: 10 best Twitter plugins for wordpress blogs | Entertainment, marketing, and internet updates
Pingback: How to Add a Twitter Button to Your Blog: All Possible Options
Pingback: Twitter Tools (part 2 of 6): "Wordpress Plugins for your blog |
As a top Twitter business user, I was sent an advance copy of the Tweet Adder System for my review. This is by far the best Networking Tool I have used for Twitter!
Thank you!
hey i don’t want the twit this under my post how can i change where the tweet this link is located.
Go to Settings > Tweet This and uncheck “Insert Tweet This links.” Then add the tweet_this() function in your theme in the loop wherever you want the link to be added. Your settings for the link text and images will be taken into account.
Pingback: In with the New « Bad Robot Brain
Pingback: Digg Vs Twitter - Which is best? | The Blog For Entrepreneurs
Pingback: Twitter & Wordpress | Darlanne.com
Pingback: Twitter & Wordpress | Darlanne.com
Pingback: Integrate Twitter Buttons in Wordpress (with shortened URL) | cathycracks.com
Pingback: 10 Best Twitter Tools for Wordpress Blogs | Best Wordpress | rooteto.com - Ertuğrul SAĞLAM
Hi Richard,
Great plugin. I wanted to ask you if it was possible to remove the border parameter within image attribute?
For example (see the border=”0″):
Thanks again,
Mitul
P.s. I am using the PHP function:
v1.5 will let you customize the CSS, but for now you’ll have to remove it from the code. I added that because I get many complaints that the Tweet This icon has a border around it which is usually unwanted.
Thanks for the quick reply
Hi Richard,
I’m currently using Tweet This 1.5. Can you please confirm how you can remove the border parameter?
I’ve checked the tt-config.php file and the Menu and can see no option.
Thanks,
Mitul
Oops, I forgot to add it. Didn’t put it on my list. I just posted v1.5.1; now you can customize the CSS from the options menu (under “Advanced Options”). Let me know how it goes.
Thanks Richard.
It seems as though the border parameter is still present, even when the CSS to insert is:
a.[LINK_CLASS]{text-decoration:none;}
Also, I noted that the tt-config.php page is deleted when I upgraded to Version 1.5.1. All I can see now is tt-config-sample.php
If you use WP-Cache or WP Super Cache, make sure to clear the cache after changing the CSS settings. It works fine for me (though I’m not using a cache presently).
It could be that your FTP client deletes the old folder before uploading, instead of only overwriting the files that are present. I use WinSCP and upon uploading the new tweet-this folder over the old one, both tt-config.php (my customized file) and tt-config-sample.php (included in Tweet This v1.5.1) are in the directory. The only change to tt-config-sample.php is the version header, so you don’t have to worry about merging the changes.
Hi Richard,
I’ve cleared the cache, and also tried accessing the page from another browser, but the border=0 is still there.
Therefore, I checked the code on tweet-this.php, and it’s coming from line 709:
$img_alt . ‘” border=”0″ />‘;
Re: File Overwrite tt-config.php
I think this could be related to file permissions. As I upgraded the plugin using the WordPress Plugin Upgrade link.
Kind regards,
Mitul
Oh, wait, I forgot I put border=0 there too. My fault. Next version will fix that.
Okay, I removed that code in v1.5.2. The CSS that is inserted by default has been revised so it actually removes borders from the images (before it was flawed and did not). Since you want borders on your images, go to Settings > Tweet This > Advanced Options and change the CSS there.
Pingback: The Making of a Monsta … WordPress Theme | Jeremy Adam Davis
Hi Richard
I have an alignment problem. The small twitter link is in the middle of the paragraph and the other 7 icons are on the bottom. Sort of like this
T
X X X X X X X X
How can I change this??
I don’t know about that. If there are too many icons to fit on one line, and the alignment is set to left in the options (the default), as many icons as possible should be displayed on the first line, with the remaining going to the second line justified to the left. Try the different alignment options under Settings > Tweet This. Try removing the least important service to see if you can fit the icons all on one line.
If you can give me a screenshot or put it back up on your blog to see, that would help.
Thank you for your quick response. I have duplicated this error by unchecking the twitter option. When I do that, the plurk icon appears where the twitter icon was. Here are the screen shots.
http://www.acorg.com/top_tweet_this.jpg
http://www.acorg.com/bottom_tweet_this.jpg
http://www.acorg.com/blog_icons.jpg
I included a screen shot of the incorrectly formated icons as well as the tweet this settings page. I hope this helps. Mike
Hi Richard
I did a bit of digging myself. It seems that a ” “, a space, placed at the start of the that holds the icons does the trick. After adding it, the icons are on the same line. It still doesn’t make sense to me but it works. Could you let me know where in your code to add this space??
thanks Mike
Well that is strange. Many others have reported this problem, and I could never get to the bottom of it or reproduce it. You should be to add that space by changing line 683 in Tweet This v1.4.1 to this:
$content .= ‘ ‘ . get_tweet_this(‘twitter’) . ‘ ‘;
The bolded part is the new code.
Might this also work in 1.5.1? The problem I have is more the spacing above and below the image when I use the tweet_this() option.
I still haven’t figured that out. You can change the CSS under Advanced Options in the options page, but there’s nothing there that causes the spacing. It could be because of the links being enclosed in a paragraph tab. You can change that by renaming the tt-config-sample.php file to tt-config.php and changing TT_PREFIX and TT_SUFFIX in it. Good luck.
The code I referenced above is on line 797 in Tweet This v1.5.1, but it has changed so the bolded part is removed (there is no non-breaking space before the Twitter link now).
I added this in v.1.5.2, before the paragraph block that holds the Tweet This icons. Since I am unable to reproduce the problem myself (I think it affects certain themes only), I am unable to test the fix, but it does no harm even if it doesn’t work.
Thank you so much for writing this plug in. It’s wonderful! Quick question though: Is there a “Share on Facebook” option in the works?
It’s on the way. I did the coding today. Just have to make the images.
Hi, I tried to email you with some suggestions to tweet this, but the email bounced back. Can you confirm what your address is?
Ok, email to richardxthripp@gmail.com or post here then. My email is having problems…
For my readers I will post your email below:
Hi,
I’ve recently added tweet this to a wordpress theme I’m doing, and it works brilliantly, but I have a couple of suggetions (or rather, things that I’ve changed which you might want to consider…)
a) I didn’t want the Tweet this in the actual contents of the post. Instead I wanted them in a seperate section (visually) in the same place I have my X comments link. To acheive this without changing the tweet this code, I’ve disabled the tweetthis displaying using the post meta data, output my content, and then below where I do want the tweet this links I enable it again and manually call insert_tweet_this().
Could there be a setting where the tweet system all works as it currently does, (hidden on pages etc where the options specify) but has to be manually inserted? (using the Insert_tweet_this function)
b) manual display of the Tweets about this post. Like above, I want to place it somewhere else and call it manually in my theme.
c) html… To enable me to arrange the links, icons etc all in line with other things on my page, I’ve had to change the tweet this code to remove nbsp;’s,
‘s and spaces between links and text. Instead I’ve converted it to an unordered list (UL) and have each icon and text in a list item (LI). This makes it much easier to display them next to each other, underneath each other, align them, align them with other objects, manually space the icons etc etc with CSS.
d) facebook integration perhaps? I’m aware thats quite a bit different format to sharing the posts though…
I’m just a little aware of hacking the code and then having to spend a bit of time putting my changes back in (thankfully SVN makes that a little easier
whenever you release a new version.
Just some suggestions on an otherwise fine plugin, with some good customisation int he settings already
Thank you for writing the plugin!
– Graham
– http://www.grahamreeves.com/
– http://www.tootlegames.com/
And my reply:
a) You can do this already; just uncheck “Insert Tweet This links” in settings (and all the other services).
b) This can be done too, by unchecking “Display “Tweets about this post” list below Tweet This links (buggy)” and echoing the tt_twitter_rss function. Unfortunately, you’re stuck with line breaks instead of an unordered list.
c) This is a good idea, may be a bit hard to implement, but I’ve put it on the list for v1.5. For now, you could disable auto-insertion in settings and add something like this to your theme:
<?php
echo ‘<ul><li> ‘;
tweet_this(‘twitter’);
echo ‘</li><li> ‘;
tweet_this(‘plurk’);
echo ‘</li><li> ‘;
tweet_this(‘buzz’);
echo ‘</li><li> ‘;
tweet_this(‘delicious’);
echo ‘</li><li> ‘;
tweet_this(‘digg)’;
echo ‘</li><li> ‘;
tweet_this(‘ping’);
echo ‘</li><li> ‘;
tweet_this(‘reddit’);
echo ‘</li><li> ‘;
tweet_this(‘su’);
echo ‘</li></ul>’;
?>
Of course, you do not need to include all the services.
d) On this list for v1.4.1… this is fine to add, but by v1.5 I want all the non-Twitter services in add-on module.
I hope I’ve helped.
Richard
The first I need said greeting for you about this good job Richard.
I was tried your plugin and make my blog become nice looking after combination with your plugin Richard. Actually when I found your plugin and trying the first very easy to use but I wondering how to placed manually.
I searched how to do it and finally found your comment discussed about what I need here http://richardxthripp.thripp.com/tweet-this#comment-49586.
Then I tried code above at two my blog are http://www.dtechgadget.com/ and http://www.ucellphonez.com/ it work, I’m happy my problem finally resolved.
Many thanks Richard and hope you have nice, God bless you.
My Best Regards,
Richard, I just reinstalled your wordpress plugin Tweet-This and I am wondering how do you get all the different little icons to show up at the bottom of a post? I just have the one Tweet-This Icon now showing.
It’s under Settings > Tweet This… check the boxes for the different services.
Thanks Richard for the quick reply to help needed.
I went back yesterday and looked again and figured it out. Just didn’t see the little check boxes the first time I was too focused on looking at the check boxes next to the icon images.
By the way, love the moss draped oak above. I used to see more oaks like this in Louisiana but now seeing moss on oaks is a rare treat. I do have some moss growing on a couple of my small yard trees now. Picked it off the ground from under an old oak tree down the road from me. Love oaks and moss!
Thanks! That was at DeLeon springs which is thirty miles from Daytona Beach… we have a lot of trees like that around though.
Pingback: SEO 101: Twitter Twips, uh, Tips for Tweeps
Pingback: Blogging Tips: SOB's Top 5 Wordpress Plug-in Alternatives: Reduce Server Load & Site Loading Time by Strictly Online Biz Inc.
Pingback: Guide to Twitter - The Ultimate Guide for Everything Twitter | Webdesigner Depot
Pingback: Plugin Killer Series for WordPress: The End | Bin-Blog
Would it be possible to have an option to turn all of the links generated by this plugin into “nofollow” links? Who wants search engines to care about the links that we put there only for humans and their social networks?
Next version I will add this option.
Pingback: Annual Redesign Time | Randa Clay Design
Pingback: Chris Fernando Dot Net » Blog Archive » Best Twitter Tools for Wordpress Blogs
Pingback: Ryan M. Minnick » How the heck do I get that ReTweet button anyway?
I tried installing Tweet This on my blogsite, and it messed up the homepage. All other pages were fine, but it only showed first two and a half blog posts and the background jpg didn’t show up either. All went back to normal after uninstalling it. Is there an incompatibility with latest version of WordPress? Help!
Adam
There were problems with the default URL shortening service that should be fixed now.
I have a question about the images (buttons) you’ve created. What is the license for them? Am I allowed to use them in another context?
Thanks for information.
Go ahead and use them for whatever you want.
Hi Richard,
I’m sorry to say that I’ve had to take your plug-in off our blogs because it caused serious intermittent loading problems, and rendered wordpress admin functions unusable. No server errors, but page loading either very slow (minutes) or usually never finished. A minute later, accessible. Especially bad over the last three days. We are hosted at pair networks in the US. Is this something to do with Th8.us being overloaded, or something else? Access varied between countries, US best followed by UK and the Australia (where we’re based) and Hong Kong.
Regards,
Tony
Yeah, Th8.us was the issue. Try it again now; I’ve got Th8.us back online and it is stable now because I removed hit counters and URL lists.
Hi Richard.
Thanks for the great plugin. I use the Elegant Grunge Modified theme, which frames all photos, and I’m having trouble using your plugin because it creates a large square frame around all the icons. Right now I have disabled all of my frames so that I can use your plugin, but it is possible for me to continue to have frames around my photographs while disabling frames around the Tweet This icons. To do this, I need the name of the image class for all of the Tweet This icons. Is there such a thing? If so, I would really appreciate you telling me exactly what it is.
Thanks,
Constantine
Image class is “nothumb”. Future versions will allow you to set this manually.
Aliasing seems to be broken. The url trimmer seems to work, and generates a url like this: http://fkd3d.th8.us
But following that link just goes to that link–not the aliased url– and gives this message:
No WPMU site defined on this host. If you are the owner of this site, please check Debugging WPMU for further assistance.
I like the plug-in–and wonder if something is broken on my end–but think it is something on th8.us that isn’t working.
Am I wrong?
Ugg… why does that happen? It did this once before. I figured it out. I distilled the httpd.conf Apache configuration file before, but it must’ve been regenerated and it updated it wrongly to use thripp.com’s .htaccess file (even though th8.us is in a separate cPanel account). Terrible behavior. I’ve fixed it for good this time. Sorry for the trouble.
Richard,
How can I add a hashtag to this:
[TITLE] [URL]
Am I able to put for example #happiness on that same line?
Thanks much!
S.
I figured it out from other comments!
I am using %23happiness.
[TITLE] [URL] %23happiness
This works great.
Thanks, Richard!
S.
Cool, I’ll have to add a replacement for pound signs.
Hi!
Thanks for the plugin. Very useful. I don’t seem to be able to use # or ” characters in the tweet text. I need those characters. Any way to use them?
Thank you.
I tried to edit the code but I can’t use the character # in the tweet. I want the tweet made by Tweet this to always end with a hashtag (a word that starts with a #) so I really need this. Any idea how to do it?
Thanks.
I solved the problem. Replaced # with %23 (url enconding).
Thanks, I’ll add a replacement for that in v1.4. I thought the urlencode function did that.
I’ve been testing this plugin on my new layout (on a different domain in a test folder) but it keeps crashing the database and I have to FTP in and change the name (to deactivate it) before I can get it to work again.
It seems when I use my own URL instead of an URL shortener this doesn’t happen. However that gives me long URL’s. So I was looking into a way to make it better.
Using this plugin (http://wordpress.org/extend/plugins/link-shortcut/) we can make our own short URL’s which redirect (with a 302, but we can change that to a 301 for better SEO) to the longer URL’s.
However now I have to manually create the shortlink in this plugin and insert it in tweet this. It would be awesome if you could combine this plugin with yours so we can get full control over the short URLs and have all the linkjuice pointing to our own domain.
You can use local URLs for this. The slowdown was due to Th8.us being overloaded but this is fixed. Th8.us, is.gd, TinyURL… these services all use 301 redirects.
Pingback: 10 usefull Twitter Plugins for your Wordpress Blog | O2S Media
Pingback: Give Twitter Users What They Want and Make It Yours
Richard,
I added a facebook link to your plugin, if interested send me an email and I’ll shoot you the code!
Regards,
E.
Hi Esteban, I’m looking to add a Fbook link as well. Is there any possibility that you could email me at ashmita.maharaj[at]gmail?
Sure, go ahead and post code here or email to richardxthripp@thripp.com.
One problem is that if the permalink has a space in it (e.g. 2009/04/the website/), it will give errors with respect to fopen on line 29/30.
This can be fixed by adding in the function: function tt_read_file($url) {
$url = str_replace(‘ ‘, “%20”,$url);
Hope this helps.
Okay thanks. I thought I was using urlencode. Fortunately most people do not use spaces.
Pingback: » The Twitter Toll Box JJMacey Dot Net / Blog: Run Lixux, Run Open Source - Run Free!
Pingback: Twitter, Tweet This Plugin For Wordpress | Network Marketing Blog For Network Marketing
Pingback: Wordpress plugins | Houston Search Engine Marketing and Optimization Services
Pingback: Angels Picks » Blog Archive » 99 Essential Twitter Tools And Applications
Well i will try this plug ins to my newly site itsladieschoice.com, and this wordpress plug in twitter will help me a lot and my readers too. Thanks for sharing this.
You’re welcome Darlyn.
Pingback: New Twitter Plug-Ins and Hacks Introduced for WordPress
Pingback: Supermaw » Blog Archive » So, why don’t you Tweet This?
Nice plugin. However whats *really* missing is ‘open in a new window’ option.
Yes I will add that soon.
Hi, I set this up and totally love it. I want to disable the automatic insertion of the button and move it to a different part of my page. I know I can do it by inserting the function into the desired location, but I’m wondering if there’s a way to do it with the Stumble This function too.
Also, is there a way to do it with a button instead of the small 16X16 pic and text?
Thanks!
Try this function:
tweet_this(’su’, ‘[TITLE] [URL]‘, ‘[BLANK]‘, ‘Share on StumbleUpon [[URL]]’, ‘tt-su-micro4.png’, ‘su’, ‘tt-image’, ‘Post to StumbleUpon’);
Full details are available in readme.