SimpleViewer Plugin

Flash is not available anymore in browsers.

External requirements: This plugin requires the following additional components that must be installed separately:

• cache (Used for xml generation for simpleviewer)

Search and install the plugin using the Extension Manager. Refer to Plugins on how to install plugins manually.

This plugin actually can be made working with Angua. It is a beautiful alternative to the gallery-plugin. Gallery currently has problems within Angua. It kind of works but it hangs up my browser when using keyboard-shortcuts in lightbox-mode to browse through the pictures. May be due to the switch of the java-script library. But Simple Viewer can be an even better alternative, depending on the context. Harald Ronge 2012/09/10 08:37

1. Install cache as described
2. Install the Simple Viewer plugin with the extension manager. It will install as “TTy32-sviewer-68eac18”, rename this folder in “/lib/plugins” to “sviewer” with FTP
3. Within /lib/plugins/sviewer create a new sub-directory /lib/plugins/sviewer/simpleviewer
4. get the viewer here http://www.simpleviewer.net/downloads/simpleviewer.zip and unpack on your local computer.
5. copy simpleviewer.js, swfobject.js and simpleviewer.swf to /lib/plugins/sviewer/simpleviewer

Voilá!

All directories mentioned here may change in the future, so if anybody notices this please change this description accordingly so it stays valid! If you prefer other locations in your plugin-folder change

  $this->swfLoc      = DOKU_BASE.'lib/plugins/sviewer/simpleviewer/simpleviewer.swf';
  $this->swfJsPath   = DOKU_BASE.'lib/plugins/sviewer/simpleviewer/simpleviewer.js';
  

in /lib/plugins/sviewer/syntax.php to your liking.

See the plugin in action here. Broken!

This plugin takes input images from a given namespace or a list of given images. It then generates a XML file which the simpleviewer SWF uses to show the gallery.

Almost all simpleviewer attributes can be defined for a gallery. If you do not specify these, then default values are taken from the Configuration Page.

The plugin in its most simplest form (use root namespace):

<sviewer>
{{:}}
</sviewer>

Custom simpleviewer attributes:

<sviewer 900 700 left modern A165FF 000000 30 bottom 2 1 true false 800 600 1 "Test Gallery">
{{:image1.jpg}}
{{:image2.jpg}}
</sviewer>

<sviewer width height align galleryStyle textColor frameColor frameWidth thumbPosition thumbColumns thumbRows showOpenButton showFullscreenButton maxImageWidth maxImageHeight captionMode "Title">
{{namespace or images}}
</sviewer>

Attributes explained (also written in the configuration page):

The original plugin was made by Ikuo Obataya (see his AutoViewer plugin here). Thanks for your effort Ikuo!

I modified his plugin to work with SimpleViewer.

Syntax.php modifications

• SWFobject javascript removed, used <object> and <embed> tags instead.
• Modified RegEx to take additional attributes.
• Modified $xml render to work with simpleviewer.
• Modified default.php, metadata.php and settings.php accordingly.
• Thumbnails are not generated, the original images are used instead.

• 2011-04-15
  • Initial release

• 2011-04-18
  • RegEx fix for lowercase and uppercase attributes
  • Added feature for caption mode

• If you have issues regarding caching for the xml, add this to the top of your dokuwiki page:

  ~~NOCACHE~~

• Installation: please install the cache plugin first, otherwise you constantly get the message “sviewer plugin requires cache plugin.”. I will fix this soon.
• Attributes within the sviewer tags have to be lowercase otherwise the default attributes are taken. I will fix this soon. Fixed.

• Option to configure image captions via syntax (now the caption is always set to the namespace the image is located in). Added feature.
• Add functionality to omit certain parameters (and thus taking default values)

• It is recommended to add an option to let show/hide “simple viewer” logo (link) at the bottom of page! I think the support link is enough to be displayed on local menu (right click ) — atronoush 2011/06/18 08:37
  • Hi atronoush, unfortunately this is not possible for the free version of simpleviewer, you have to purchase simpleviewer pro. Or do you mean to add this option for a simpleviewer pro installation?

If you encounter any problems post them here in the Discussion heading please, or contact me, i will respond as soon as possible :)

OK. Question 1 : The gallery plugin has a possibility to go to the full sized picture. sviewer is nicer to look at, but I do not find any way to get the original image. Its name is written in the lower left part of the box, but it isn't a link, and there's no link or action in the right-click menu of sviewer. I checked that $conf['showOpenButton'] = $conf['showFullscreenButton']= 1, so I'd expect to have a way to get to the full sized picture. — Werner Flamme 2012/09/10 14:27

Looks good, Install was without problems, Thanks!

• I think it would be better to use named attributes (like <sviewer thumbRows='3'>). That makes it easier to overload only some attributes.
• Request: it would be great to use wildcards in a filename to select a subset of a namspace (gallery has this).
• Buglet: the first character is missing in the image caption names

Hans Elbers 2012/09/13 —

sviewer has an annoying feature: it creates a media-directory that is accessible by @ALL for reading. While this can do little harm (I guess) this directory shows up in the directory-tree of the media-manager. To hide this for naive users you could put the following code in /inc/media.php

/**
 * Build a tree outline of available media namespaces
 *
 * @author Andreas Gohr <andi@splitbrain.org>
 */
function media_nstree($ns){
    global $conf;
    global $lang;
 
    // currently selected namespace
    $ns  = cleanID($ns);
    if(empty($ns)){
        global $ID;
        $ns = dirname(str_replace(':','/',$ID));
        if($ns == '.') $ns ='';
    }
    $ns  = utf8_encodeFN(str_replace(':','/',$ns));
 
    $data = array();
    search($data,$conf['mediadir'],'search_index',array('ns' => $ns, 'nofiles' => true));
 
//inserted Harald Ronge
//prevent sviewer to be displayed by the media manager
//proposal: conf string fo media-manager to to hide directories
    if(!auth_isadmin()){
        for ($index = 0; $index < count($data); $index++){
            if ($data[$index]['id'] == 'sviewer') {
                unset($data[$index]);
                continue;
            }
        }
        $data = array_values($data);
    }
//end inserted
 
    // wrap a list with the root level around the other namespaces
    array_unshift($data, array('level' => 0, 'id' => '', 'open' =>'true',
                               'label' => '['.$lang['mediaroot'].']'));
 
    echo html_buildlist($data,'idx','media_nstree_item','media_nstree_li');
}

Harald Ronge 2012/09/29

I would like to have the images sorted by their filename.

The following changes (insert two lines with sort()) in syntax.php will do that for me:

....
          }else{
            // get file path
            $paths[] = $path;
            $urls[]  = $mlink;
          }

          sort($paths);
          sort($urls);
         
          $fsz = count($paths);
          for($j=0;$j<$fsz;$j++){
            $path = $paths[$j];
....

_{Joe 2012-10-21}