Date: Fri, 10 Sep 2010 13:46:13 +0000
Mime-Version: 1.0 (Produced by PhpWiki 1.4.0RC1)
X-Rcs-Id: $Id: Help%2FLinkIcons 7682 2010-09-10 12:03:36Z vargenau $
Content-Type: application/x-phpwiki;
  pagename=Help%2FLinkIcons;
  flags=PAGE_LOCKED%2CEXTERNAL_PAGE;
  markup=2;
  charset=UTF-8
Content-Transfer-Encoding: binary

**~LinkIcons** are an optional feature of ~PhpWiki. When activated,
icons will be displayed in front of URLs to indicate the type of link.

| {{/themes/default/images/http.png}}      | http link
| {{/themes/default/images/url.png}}       | generic internet link
| {{/themes/default/images/interwiki.png}} | Interwiki link
| {{/themes/default/images/https.png}}     | https link
| {{/themes/default/images/mailto.png}}    | mailto link
| {{/themes/default/images/ftp.png}}       | ftp link

**Note**: Some of the default icons use the alpha channel feature of
the [[http://www.libpng.org/pub/png/png-sitemap.html|PNG]] image format
for smooth rendering on any page color or textured background. Older
browsers may not display all the images properly.

== Examples ==

The following examples will display with the above link icons only if
the administrator has enabled this feature.

=== ~InterWiki links ===

* ~InterWiki link [[PhpWiki:InterWiki]]
* A named ~InterWiki [[Wiki:WhyWikiWorks|read WhyWikiWorks at c2]].

=== URLs ===

* Email address [[mailto:phpwiki-talk@lists.sourceforge.net|PhpWiki-talk mailing list]]
* Normal http link [[http://phpwiki.sourceforge.net/phpwiki/|PhpWiki's Home Page]]
* Secure http link [[https://phpwiki.sourceforge.net/phpwiki/|PhpWiki's Home Page]]
* File transfer ftp://ftp.sourceforge.net/

//A generic icon is shown for other less common link types.//

* news://nntp.news.com
* gopher://gopher.caltech.cmu.edu

~LinkIcons will only display when the URL protocol is one which ~PhpWiki
is allowed to link to. The following examples won't show any icons and
~PhpWiki won't automatically provide double-clickable links either,
unless the administrator adds them:

* bogus://oedipus.nostradamus.com
* bolo://lgm.cheshire.org

<noinclude>
----
[[PhpWikiDocumentation]]
</noinclude>
