#format wiki
#language en
#pragma section-numbers off
#acl IanRiley:read,write,delete,revert,admin All:read
#pragma supplementation-page on

<<TableOfContents>>

= SkypeLink =

== Background and rationale ==

Similar to the links MoinMoin provides for email using macro `<<mailto()>>`, it would be useful to have a macro for links to Skype.

== Description ==

!SkypeLink is a macro to insert a link to Skype. Without an argument, the macro will insert a icon link that simply shifts the focus to the Skype application. If a Skype username provided, the macro will insert a Skype icon and username as links to invoke a Skype call. Adding a prefix to the Skype username argument controls which type of link (icon and/or text) is inserted.

== Prerequisites ==

For the link to work, Skype must be installed on the client's machine.

For the macro to insert the Sykpe icon, skypeicon_16px.png must be installed in the folder `common` under in static html path specified by `url_prefix_static` in wikiconfig.py.

The icon image file be downloaded in https://cdn.dev.skype.com/upload/skype-button-assets.zip, or by saving the image displayed in the examples below. 

== Usage ==

=== <<SkypeLink(text)>> ===

{{{
Argument "text" is optional.

<<SkypeLink>> or <<SkypeLink()>> - icon link to shift focus to Skype.
 
<<SkypeLink(username)>> - icon + text link to call 'username'.
 
<<SkypeLink(prefix:username)>> - prefix to controls the type of link inserted.

prefix = icon - icon link only
prefix = user - text link of username only
prefix = both - both link types 
}}}

== Example ==

{{{
No argument - <<SkypeLink>>; <<SkypeLink()>>

Username only - <<SkypeLink(test123)>>

Suffix includeded -

Icon: <<SkypeLink(icon:test123)>>

User: <<SkypeLink(user:test123)>> 

Both: <<SkypeLink(both:test123)>>
}}}

No argument - <<SkypeLink>>; <<SkypeLink()>>

Username only - <<SkypeLink(test123)>>

Suffix includeded -

Icon: <<SkypeLink(icon:test123)>>

User: <<SkypeLink(user:test123)>> 

Both: <<SkypeLink(both:test123)>>

== Download & Release Notes ==
|| Download || Release Version || Moin Version || Release Notes ||
|| [[attachment:SkypeLink-1.0.py]] || 1.0 || 1.9.2  ||  ||

== Copyright ==

 . @copyright: 2011 Ian Riley <ian.riley@internode.edu.au>

== License ==

GNU GPL, see COPYING for details.

== Known issues and limitations ==

None

-----

 Hits:: <<Hits>>