====== smblink Plugin ====== ---- plugin ---- description: A replacement for DokuWiki's default Windows Share Link feature which supports Firefox author : enki email : enki1337@gmail.com type : syntax lastupdate : 2009-02-09 compatible : 2007-06-26 depends : conflicts : similar : tags : samba, smb, share, links, Firefox downloadurl: https://storage.googleapis.com/google-code-archive-downloads/v2/code.google.com/doku-smblink/smblink.zip ---- ===== Description ===== A replacement for DokuWiki's default Windows Share Link feature which supports Firefox. This plugin replaces the default action of Windows Share Links (WSL) to better support the Firefox browser. WSLs are still created the same way: [[\\Host\Share\Directory\File.ext]] And in Internet Explorer, links will still be the same: file:///\\Host\Share\Directory\File.ext But in Firefox, the link will run a JavaScript onclick which redirects to: smb://Host/Share/Directory/File.ext This, in itself, is pretty useless, but with a neat little script and registry fix (discussed [[http://www.lockergnome.com/awarberg/2007/12/04/firefox-file-links-take-2-url-protocol-handler/|here]] and available for download [[http://cmsb705.googlepages.com/url-handlers.zip|here]]) this will now make Firefox launch the smb: link in Internet Explorer, thus dealing with the file as if you were running IE. I know it's a hack, but that's life! ;) Oh yeah, if anyone can think of a better way to do this, I'd love to hear it! Further, I don't currently have a Linux box to test any of this, but I could pretty easily modify this to work for any smb: links as well (in fact that was my original plan, but I got lazy. ;) ) ===== Syntax ===== [[\\Host\Share\Path\to\file]] ===== Installation ===== - To install using plugin manager, paste the url [[http://doku-smblink.googlecode.com/files/smblink.zip]] into the **Download and install** field. - If you're using Firefox and Windows, download and install [[http://cmsb705.googlepages.com/url-handlers.zip|url-handlers.zip]] to properly handle the smb: protocol. - See issues below. ===== Change Log ===== * 2009-02-09 * Using the new samba link handler, as the old one is deprecated. * Cleaned up the code, added some fluffy comments. * The new handler doesn't show the black command window box. * 2007-07-09 * Added linux support * 2007-06-03 * Initial release ===== Issues ===== There's an annoying javascript alert box that always pops up. I can't seem to override this using the plugin API, so the only way to fix it is to comment it out of doku's source. The line is in lib/scripts/script.js: alert(LANG['nosmblinks']); Simply comment the line out: // alert(LANG['nosmblinks']); Obviously the warning will now not show up even if you don't have the smb url handler installed. :!: The sole purpose of the //checkWindowsShares// function is to loop through all the links in the page and add the annoying popup to every link to Windows shares in the page. I suggest commenting the call to the checkWindowsShares() function instead. Same end result but this saves at least 1 function call and 1 loop, every time a page is rendered. addInitEvent(function(){ checkWindowsShares(); }); Becomes: addInitEvent(function(){ //checkWindowsShares(); }); --- //Bering, 2009/12/02 12:43// I was rather hacking together such hack by disabling the JavaScript value of an alert, however this also requires change in core: --- dokuwiki/lib/scripts/script.js~ 2010-04-29 15:42:12.000000000 +0300 +++ dokuwiki/lib/scripts/script.js 2010-04-29 15:43:39.640053591 +0300 @@ -512,7 +512,7 @@ for(var i=0; i --- /dev/null 2008-11-04 20:33:38.146691408 +0200 +++ dokuwiki/lib/plugins/smblink/script.js 2010-04-29 15:45:59.670031225 +0300 @@ -0,0 +1,4 @@ +addInitEvent(function() { + // Reset warning as we now handle the links for all OS + LANG['nosmblinks'] = ''; +}); --- //[[glen@delfi.ee|Elan Ruusamäe]], 2010/04/29 15:48// ===== Discussion ===== If you've got any comments or questions, please feel free to add them here. You might consider also emailing me since I might not check back all that often. :) ==== Linux ==== Linux works fine with just %%smb://host/path/to/share%% (at least FF does - not tested in Konqueror but should work). So I hacked this around a bit to have it work in both Windows FF and Linux... > Great work! Integrated it! I would've done this, but I don't currently have access to a linux box :$ Thanks for the contribution! ~Enki ==== Windows 7 ==== The plugin doesn't work with Windows 7 Prof. german (64bit) and Firefox 3.6.3 (german). The errormessage is "Für die Dateierweiterung ".js" gibt es kein Skriptmodul." which means there is no module for .js-fileextension in wscript.exe in Windows 7 Professional - out of the box. ==== Firefox-Addon ==== If you don't want to install the smblink-hack, there is a Firefox Addon which allows to open links to local files: [[https://addons.mozilla.org/de/firefox/addon/locallink/|Localllink]]. With the Addon installed, you can right-click on links to windows shares and chose the option to open these links in a "local context". ==== spaces in file path==== Will there be support for linking to a file path that includes spaces? ===== Source Code ===== /lib/plugins/smblink/syntax.php */ // must be run within DokuWiki if(!defined('DOKU_INC')) die('meh.'); if(!defined('DOKU_PLUGIN')) define('DOKU_PLUGIN',DOKU_INC.'lib/plugins/'); require_once(DOKU_PLUGIN.'syntax.php'); /** * All DokuWiki plugins to extend the parser/rendering mechanism * need to inherit from this class */ class syntax_plugin_smblink extends DokuWiki_Syntax_Plugin { /** * return some info */ function getInfo(){ return array( 'author' => 'Enki', 'email' => 'enki1337@gmail.com', 'date' => '2009-02-09', 'name' => 'SMB Plugin', 'desc' => 'Makes filesystem links globally accessible, even through firefox.', 'url' => 'http://www.dokuwiki.org/plugin:smblink', ); } function getType(){ return 'substition'; } function getAllowedTypes() { return array(); } function getSort(){ return 295; } function connectTo($mode) { //Add the smblink pattern to the lexer. Pattern will match [[\ASDF]] //$this->Lexer->addSpecialPattern("\[\[(?i)smb://.+?\]\]",$mode,'plugin_smblink'); $this->Lexer->addSpecialPattern("\[\[\\\\.+?\]\]",$mode,'plugin_smblink'); } /** * Handle the match */ function handle($match, $state, $pos, &$handler){ //Break the link out of [[ ]] and split it into link and description if there is a '|' $link = preg_replace(array('/^\[\[/','/\]\]$/u'),'',$match); $link = preg_split('/\|/u',$link,2); return array($state, $link); } /** * Create output */ function render($mode, &$renderer, $data) { if ($mode != 'xhtml') return; global $conf, $lang; list($state, $matchdata) = $data; list($url, $name) = $matchdata; //If no name is given, use the last bit of the url if (strlen($name) == 0) { $urlbits = preg_split('/(\\\|\\/)/u',$url); $name = $urlbits[count($urlbits)-1]; } //simple setup $link['target'] = $conf['target']['windows']; $link['pre'] = ''; $link['suf'] = ''; $link['style'] = ''; $link['name'] = $renderer->_getLinkTitle($name, $url, $isImage); $link['title'] = $renderer->_xmlEntities($url); if ( !$isImage ) { $link['class'] = 'windows'; } else { $link['class'] = 'media'; } //Format the link for smb (Linux or Win-Firefox) //Just replace all \ with / to get something like smb://host/path/to/file $smburl='smb:' . str_replace('\\', '/', $url); //If we're using linux, then smb:// protocol works fine. if (strstr($_SERVER['HTTP_USER_AGENT'], 'Linux')) { $url = $smburl; } else { //If we're not on linux, we might be using IE, so... //Replace the \\ with the file:/// protocol and put the \\ back in $url = str_replace('\\\\', 'file:///\\\\', $url); //Use javascript to change the link in Firefox to the smb url. $link['more'] = 'onclick="if(document.all == null){' . "parent.location='".$smburl."';" . '}" ' . 'onkeypress="if(document.all == null){' . "parent.location='".$smburl."';" . '}"'; } $link['url'] = $url; //output formatted $renderer->doc .= $renderer->_formatLink($link); return; } } ?> ===== url-handlers ===== == Support Drive Letters == Extend the url-handlers to support driver letters. Modify the ''url_protocol_handler.js'' of the ''url-handlers.zip'' Original Code in the ''function handleUrl(rawUrl)'' // rescue some non-conformant URL's eg. // smb://server/share if(arg.substr(0,2) != "\\\\") arg = "\\\\" + arg Modified Code in the ''function handleUrl(rawUrl)'': if ( arg.substr( 1,1 ) == ":" ) { // support drive letters } else { // rescue some non-conformant URL's eg. // smb://server/share if(arg.substr(0,2) != "\\\\") arg = "\\\\" + arg } == Support deeper directory structures === A path like //myserver/share/deeper/still is handled badly as it links to //myserver/share only under ceratin circumstances. Here is a Bugfix: In line 79 replace arg = arg.replace("/", "\\") with arg = arg.replace(/\//g, "\\") Otherwise %%//%%myserver/share/deeper/still will be changed to %%\\%%myserver\share**/**share**/**deeper**/**still which the explorer can't open (look at the slashes).