====== uncmap Plugin ======
---- plugin ----
description: This plugin maps windows drive letter file names to UNC links.
author     : Dominik Eckelmann
email      : dokuwiki@cosmocode.de 
type       : syntax
lastupdate : 2016-07-06
compatible : Hrun
depends    : 
conflicts  : 
similar    : 
tags       : UNC, path, file name, drive letter
downloadurl: https://github.com/cosmocode/uncmap/zipball/master
bugtracker : https://github.com/cosmocode/uncmap/issues
sourcerepo : https://github.com/cosmocode/uncmap/
donationurl: 
----

===== Download and Installation =====
[[https://www.cosmocode.de/en/open-source/dokuwiki-plugins/|{{ http://cosmocode.de/static/img/dokuwiki/dwplugins.png?recache|A CosmoCode Plugin}}]]

Please use the the download link at the top for manual installation or use in the [[plugin:extension|Extension Manager]]. See [[:Plugins]] for more details on how to install plugins manually.

===== Configuration and Examples =====
In the configuration directory of the uncmap plugin (i.e. ''dokuwiki/lib/plugins/uncmap/conf'') is the a file ''mapping.php''. Add a line to this file for every windows drive letter and the server it should be mapped to.

For example:
<code>z     //server1/share</code>

Optionally you can add the local mountpoint of an fileserver to this line. Then dokuwiki will check if the file exists on this fileserver and color the link accordingly.
<code>z     //server1/share     /mnt/fileserver</code>

Further you can define a default fileserver in the config dialog. It will be used when no fileserver is defined for a given letter.

===== Usage/Syntax =====


<code>[[z:/path/to/file|File title]]</code>
With the above [[uncmap#Configuration and Examples|configuration]] the above link will point to 
<code>file:///server1/share/path/to/file</code>