WordPress.org

Facebook Share

To use the function call (for example within a post loop) you would do the following...

<a href="<?php artiss_facebook_link(); ?>">Share on Facebook</a>

This will return a URL to allow the current post/page URL and title to be shared on Facebook.

Three, optional, parameters can be specified - the first one is now redundant, the second is a replacement URL and third is a title. For example...

<a href="<?php artiss_facebook_link( '', 'http://www.artiss.co.uk', 'Welcome to Artiss.co.uk' ); ?>">Share on Facebook</a>

The shortcode, [facebook], has 4 optional parameters...

• url - If you wish to override the URL
• title - If you wish to override the title
• target - The link target
• rel - The link rel

For example...

[facebook url="http://www.artiss.co.uk" title="Welcome to Artiss.co.uk" rel="nofollow" target="_new"]Share on Facebook[/facebook]

Google+ Share

To use the function call (for example within a post loop) you would do the following...

<a href="<?php artiss_google_link(); ?>">Share on Google+</a>

This will return a URL to allow the current post/page URL and title to be shared on Google+.

An optional parameter can be specified - a replacement URL. For example...

<a href="<?php artiss_google_link( 'http://www.artiss.co.uk' ); ?>">Share on Google+</a>

The shortcode, [google], has 3 optional parameters...

• url - If you wish to override the URL
• target - The link target
• rel - The link rel

For example...

[google url="http://www.artiss.co.uk" rel="nofollow" target="_new"]Share on Google+[/google]

Twitter Share

To use the function call (for example within a post loop) you would do the following...

<a href="<?php artiss_twitter_link(); ?>">Share on Twitter</a>

This will return a URL to allow the current post/page URL and title to be shared on Facebook with a default status.

Four, optional, parameters can be specified. These are...

• The Twitter status message - see below for details
• Your own URL, if you don't wish the current one to be used
• A list of options - see below for more information
• Your own title, if you don't wish the current one to be used

The Twitter status message can contain a number of tags - %url%, %title% and the shortening service that you wish to use (see the next section for further details). These will be replaced with the appropriate text before the status message is sent to Twitter.

For example...

<a href="<?php artiss_twitter_link( '%tinyurl%Currently reading a blog post called "%title%" - %url%', 'http://www.artiss.co.uk', '', 'Welcome to Artiss.co.uk' ); ?>">Share on Twitter</a>

The 1st parameter is the Twitter status - %title% and %url% will be replaced, as appropriate. %tinyurl% indicates the URL shortening service to be used and will be omitted in the resulting status.

The 3rd parameter, as mentioned above, is a list of options mainly relating to URL shortening. Each of these are seperated by an ampersand and are all optional...

• cache= - How long to cache the output, in hours. The default is 24. Specify as No to not cache at all
• apikey= - Enables you to pass an API key (if required) to the URL shortening service - see Artiss URL Shortener notes for details
• login= - Enables you to pass a login (if required) to the URL shortening service - see Artiss URL Shortener notes for details
• password= - Enables you to pass an password (if required) to the URL shortening service - see Artiss URL Shortener notes for details

For example...

<a href="<?php artiss_twitter_link( '%tinyurl%Currently reading a blog post called "%title%" - %url%', 'http://www.artiss.co.uk', 'cache=4&login=test', 'Welcome to Artiss.co.uk' ); ?>">Share on Twitter</a>

This overrides the caching to 4 hours and passes a login of test to the URL shortening service of tinyurl.

The shortcode, [twitter], has 9 optional parameters...

• url - If you wish to override the URL
• title - If you wish to override the title
• target - The link target
• rel - The link rel
• text - The status text. Use the tags, as specified above
• cache - How long to cache the output, in hours. The default is 24. Specify as No to not cache at all
• apikey - Enables you to pass an API key (if required) to the URL shortening service - see Artiss URL Shortener notes for details
• login - Enables you to pass a login (if required) to the URL shortening service - see Artiss URL Shortener notes for details
• password - Enables you to pass an password (if required) to the URL shortening service - see Artiss URL Shortener notes for details

For example...

[twitter text="%tinyurl%Currently reading a blog post called %title% - %url%" url="http://www.artiss.co.uk" title="Welcome to Artiss.co.uk" rel="nofollow" target="_new" cache="4"]Share on Twitter[/twitter]

Licence

This WordPress plugin is licensed under the GPLv2 (or later).

Support

All of my plugins are supported via my website.

Please feel free to visit the site for plugin updates and development news - either visit the site regularly or follow me on Twitter (@artiss_tech).

For problems, suggestions or enhancements for this plugin, there is a dedicated page and a forum. The dedicated page will also list any known issues and planned enhancements.

This plugin, and all support, is supplied for free, but donations are always welcome.