====== RDP Link Plugin ======

---- plugin ----
description: Enables you to create links that automagically generate and open Remote Desktop Connection configurations
author     : Justin Shepard
email      : jshepard@cyberdynamic.net
type       : syntax
lastupdate : 2016-01-22
compatible :
depends    :
conflicts  :
similar    :
tags       : rdp, links
downloadurl: http://github.com/justinshepard/rdplink/zipball/master
bugtracker : https://github.com/justinshepard/rdplink/issues
sourcerepo : https://github.com/justinshepard/rdplink
----

===== Background =====

After using and falling in love with DokuWiki and it's elegant simplicity and extensibility, I found myself wanting to be able to create links in my Wiki pages that I could click on and immediately Remote Desktop into a server. There wasn't anything out there (that I could find), so I created this plugin.

===== Installation =====

This plugin is now hosted at GitHub, code has been removed from this page (but still available in "Old Revisions"):

[[https://github.com/justinshepard/rdplink]]

Feel free to submit pull requests for bugfixes or enhancements and I'll do my best to get them vetted and merged quickly. --Justin

===== Syntax =====

<code>
{rdplink:SERVERNAME|TITLE}
{rdplink:SERVERNAME}
</code>

  * SERVERNAME is the IP or DNS address of the server you want to connect to.
  * TITLE is the "pretty name" of the link. If none is specified, the server name will be used.

Additional you can enter the usercredentials (or just part of them) too:
<code>
{rdplink:SERVERNAME&domain=MYDOMAIN&username=MYUSERNAME&password=PASSSTRING|TITLE}
</code>
PASSSTRING must be pre-encrypted (if you create your own Windows Program, use AES via Microsoft crypt32.dll), or use one like [[http://www.remkoweijnen.nl/blog/2007/10/18/how-rdp-passwords-are-encrypted|Remko's RDP PW Encrypter]]

There is a password encryption utility included in the plugin package, along with source code for the command-line version.

===== Known Issues =====

If you find that the <?=...?> lines don't parse for you, change them to <?php ... ?> and it should work.


===== Suggestions for Improvement =====

----

== from Alex Bailey - alex[dot]bailey[at]interfacia[dot] co.uk ==
I had to alter the last 2 lines as follows to make it work otherwise the server name was not inserted into the RDP file content. The blank line before "domain" was necessary and I think this parameter is not used anyway. I've never written any PHP before but I had a good guess at fixing it!

<code php>
full address:s:<?php echo $_GET['server']?>

domain:s:<?php echo $_GET['domain']?>
</code>

----

== from [[gut.kevin@gmail.com]] ==
Some Remote Desktop clients need a file with Windows Line Breaks, so instead of
<code php>
<?php echo $_GET['server'] . "\n"?>
</code>
use
<code php>
<?php echo $_GET['server'] . "\r\n"?>
</code>
for all fields and it should work.

----

== Blank page on save ==

If you get a blank page on save (coupled with an error in the logs similar to:)\\
\\
Cannot modify header information - headers already sent by (output started at /lib/plugins/rdplink/syntax.php:1) in /inc/common.php on line 1825\\
\\
Edit syntax.php and remove the spaces on line 1 prior to <?php