{"id":46941,"date":"2009-03-03T16:27:58","date_gmt":"2009-03-03T16:27:58","guid":{"rendered":"https:\/\/wordpress.org\/plugins-wp\/simple-twitter-link\/"},"modified":"2009-12-14T13:38:03","modified_gmt":"2009-12-14T13:38:03","slug":"simple-twitter-link","status":"closed","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/simple-twitter-link\/","author":307954,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.6","stable_tag":"1.6","tested":"3.0.5","requires":"2.0.0","requires_php":"","requires_plugins":"","header_name":"Simple Twitter Link","header_author":"David Artiss","header_description":"","assets_banners_color":"","last_updated":"2009-12-14 13:38:03","external_support_url":"","external_repository_url":"","donate_link":"http:\/\/artiss.co.uk\/donate","header_plugin_uri":"http:\/\/www.artiss.co.uk\/simple-twitter-link","header_author_uri":"http:\/\/www.artiss.co.uk","rating":0,"author_block_rating":0,"active_installs":30,"downloads":6742,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog","other_notes"],"tags":[],"upgrade_notice":[],"ratings":{"1":0,"2":0,"3":0,"4":0,"5":0},"assets_icons":[],"assets_banners":[],"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0","1.1","1.2","1.3","1.4","1.5","1.6"],"block_files":[],"assets_screenshots":[],"screenshots":[],"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[537,409,159],"plugin_category":[],"plugin_contributors":[78579],"plugin_business_model":[],"class_list":["post-46941","plugin","type-plugin","status-closed","hentry","plugin_tags-link","plugin_tags-status","plugin_tags-twitter","plugin_contributors-dartiss","plugin_committers-dartiss"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/s.w.org\/plugins\/geopattern-icon\/simple-twitter-link.svg","icon_2x":false,"generated":true},"screenshots":[],"raw_content":"\n

From version 1.5 you must now install the Simple URL Shortener<\/a> plugin for the URL shortening to work in this plugin<\/strong><\/p>\n\n

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).<\/p>\n\n

Simple Twitter Link simply returns a URL - this URL is a link to Twitter with your post\/page URL within it. Here's an example...<\/p>\n\n

<a href=\"<?php simple_twitter_link(''); ?>\">Send to Twitter<\/a>\n<\/code><\/pre>\n\n
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 the URL of the page\/post that you just came from.<\/p>\n\n
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 a parameter. %url%<\/code> must be specified within the sentence, as this tells Simple Twitter Link where you want the URL to go.<\/p>\n\n
So, another example...<\/p>\n\n
<a href=\"<?php simple_twitter_link('%url% is an excellent read'); ?>\">Send to Twitter<\/a>\n<\/code><\/pre>\n\n
In this case the line \"xxx is an excellent read\" (again, where xxx is the URL of your page\/post) will be passed to Twitter.<\/p>\n\n
If you don't pass a parameter or miss out the %url% tag the default text will be used.<\/p>\n\n
The following is an example of how it could be used, with a function_exists<\/code> check so that it doesn't cause problems if the plugin is not active...<\/p>\n\n
<?php if (function_exists('simple_twitter_link')) : ?>\n<a href=\"<?php simple_twitter_link(''); ?>\">Send to Twitter<\/a>\n<?php endif; ?>\n<\/code><\/pre>\n\n
You can also use an addition tag, %title%<\/code>, which will show the post\/page title in the Twitter text.<\/p>\n\n
If you have the Simple URL Shortener plugin installed, you can also use a number of additional tags which will allow the URL to be shortened. Simple specify the name of the shortening service withing percentage signs within the Twitter text (this text will then be removed from the resultant output to Twitter). So, here is a further example...<\/p>\n\n
<a href=\"<?php simple_twitter_link('%tr.im%Currently reading a blog post called \"%title%\" - %url%'); ?>\">Send to Twitter<\/a>\n<\/code><\/pre>\n\n
This uses both the new %title% tag and also uses the tr.im shortening service to shorten the URL.<\/p>\n\n
By default, the URL of the current post\/page is used. If, however, you specify a URL as a second parameter then this will be used instead (useful if you wish to add a generic Twitter link to your sidebar, for instance). An example would be...<\/p>\n\n
<a href=\"<?php simple_twitter_link('%tr.im%Currently reading a blog post called \"%title%\" - %url%','http:\/\/www.artiss.co.uk'); ?>\">Send to Twitter<\/a>\n<\/code><\/pre>\n\n
From version 1.6 onwards you can also specify a number of further options via an optional third parameter. Each option is seperated by an ampersand and the following are valid...<\/p>\n\n
cache=<\/strong> : Use this to turn off caching by specifying cache=no<\/code><\/p>\n\n
apikey=<\/strong>, login=<\/strong>, password=<\/strong> : These allow optional URL shortening options to be specified (see the documentation for Simple URL Shortener for further details)<\/p>\n\n
For example,<\/p>\n\n
<a href=\"<?php simple_twitter_link('%bit.ly+key%Currently reading a blog post called \"%title%\" - %url%','','login=test&apikey=insertapikeyhere&cache=no'); ?>\">Send to Twitter<\/a>\n<\/code><\/pre>\n\n
In this case you'd need to specify your own login and apikey for this to work.<\/p>\n\n
There is an excellent article on how to use this plugin at Blogging With Success<\/a>.<\/p>\n\n\n
    \n
  1. Upload the entire simple-twitter-link<\/code> folder to your wp-content\/plugins\/<\/code> directory.<\/li>\n
  2. Activate the plugin through the 'Plugins' menu in WordPress.<\/li>\n
  3. There is no options screen - configuration is done in your code.<\/li>\n<\/ol>\n\n\n
    \n
    I get the error \u201ccannot yet handle MBCS in html_entity_decode\u201d<\/dt>\n
    This is a known bug in PHP 4<\/a>.<\/p>\n\n
    If other solutions do not work don\u2019t request the \u201ctitle\u201d option in this plugin, as it is this that will trigger it.<\/p><\/dd>\n
    How can I get help or request possible changes<\/dt>\n
    Feel free to report any problems, or suggestions for enhancements, to me either via my contact form<\/a> or by the plugins homepage<\/a>.<\/p><\/dd>\n\n<\/dl>\n\n\n
    1.0<\/h4>\n\n