1043 lines
37 KiB
PHP
1043 lines
37 KiB
PHP
<?php
|
|
/**
|
|
* Filelist Plugin: Lists files matching a given glob pattern.
|
|
*
|
|
* @license GPL 2 (http://www.gnu.org/licenses/gpl.html)
|
|
* @author Gina Haeussge <osd@foosel.net>
|
|
*/
|
|
|
|
if(!defined('DOKU_INC')) define('DOKU_INC',realpath(dirname(__FILE__).'/../../').'/');
|
|
if(!defined('DOKU_PLUGIN')) define('DOKU_PLUGIN',DOKU_INC.'lib/plugins/');
|
|
|
|
require_once(DOKU_PLUGIN.'syntax.php');
|
|
require_once(DOKU_INC.'inc/confutils.php');
|
|
require_once(DOKU_INC.'inc/pageutils.php');
|
|
|
|
define('DOKU_PLUGIN_FILELIST_NOMATCH', -1);
|
|
define('DOKU_PLUGIN_FILELIST_OUTSIDEJAIL', -2);
|
|
|
|
/**
|
|
* All DokuWiki plugins to extend the parser/rendering mechanism
|
|
* need to inherit from this class
|
|
*/
|
|
class syntax_plugin_filelist extends DokuWiki_Syntax_Plugin {
|
|
|
|
var $mediadir;
|
|
var $is_odt_export = false;
|
|
|
|
function __construct() {
|
|
global $conf;
|
|
$mediadir = $conf['mediadir'];
|
|
if (!$this->_path_is_absolute($mediadir)) {
|
|
$mediadir = DOKU_INC . '/' . $mediadir;
|
|
}
|
|
$this->mediadir = $this->_win_path_convert($this->_realpath($mediadir).'/');
|
|
}
|
|
|
|
function getType(){ return 'substition'; }
|
|
function getPType(){ return 'block'; }
|
|
function getSort(){ return 222; }
|
|
|
|
function connectTo($mode) {
|
|
$this->Lexer->addSpecialPattern('\{\{filename>.+?\}\}',$mode,'plugin_filelist');
|
|
$this->Lexer->addSpecialPattern('\{\{filelist>.+?\}\}',$mode,'plugin_filelist');
|
|
}
|
|
|
|
/**
|
|
* Handle the match
|
|
*/
|
|
function handle($match, $state, $pos, Doku_Handler $handler) {
|
|
|
|
// do not allow the syntax in comments
|
|
if (!$this->getConf('allow_in_comments') && isset($_REQUEST['comment']))
|
|
return false;
|
|
|
|
$match = substr($match, 2, -2);
|
|
list($type, $match) = explode('>', $match, 2);
|
|
list($pattern, $flags) = explode('&', $match, 2);
|
|
|
|
if ($type == 'filename') {
|
|
if (strpos($flags, '|') !== FALSE) {
|
|
list($flags, $title) = explode('\|', $flags);
|
|
} else {
|
|
$title = '';
|
|
}
|
|
}
|
|
|
|
// load default config options
|
|
$flags = $this->getConf('defaults').'&'.$flags;
|
|
|
|
$flags = explode('&', $flags);
|
|
$params = array(
|
|
'sort' => 'name',
|
|
'order' => 'asc',
|
|
'index' => 0,
|
|
'limit' => 0,
|
|
'offset' => 0,
|
|
'style' => 'list',
|
|
'tableheader' => 0,
|
|
'tableshowsize' => 0,
|
|
'tableshowdate' => 0,
|
|
'direct' => 0,
|
|
'recursive' => 0,
|
|
'titlefile' => '_title.txt',
|
|
'cache' => 0,
|
|
'randlinks' => 0,
|
|
'preview' => 0,
|
|
'previewsize' => 32,
|
|
'link' => 2,
|
|
'showsize' => 0,
|
|
'showdate' => 0,
|
|
'listsep' => '", "',
|
|
'onhover' => 0,
|
|
'ftp' => 0,
|
|
);
|
|
foreach($flags as $flag) {
|
|
list($name, $value) = explode('=', $flag);
|
|
$params[trim($name)] = trim($value);
|
|
}
|
|
|
|
// recursive filelistings are not supported for the filename command
|
|
if ($type == 'filename') {
|
|
$params['recursive'] = 0;
|
|
}
|
|
|
|
// Trim list separator
|
|
$params['listsep'] = trim($params['listsep'], '"');
|
|
|
|
return array($type, $pattern, $params, $title, $pos);
|
|
}
|
|
|
|
/**
|
|
* Create output
|
|
*/
|
|
function render($mode, Doku_Renderer $renderer, $data) {
|
|
global $conf;
|
|
|
|
list($type, $pattern, $params, $title, $pos) = $data;
|
|
|
|
if ($mode == 'odt') {
|
|
$this->is_odt_export = true;
|
|
}
|
|
|
|
// disable caching
|
|
$renderer->info['cache'] = (bool) $params['cache'];
|
|
if ($mode == 'xhtml' || $mode == 'odt') {
|
|
|
|
$result = $this->_create_filelist($pattern, $params);
|
|
if ($type == 'filename') {
|
|
$result = $this->_filter_out_directories($result);
|
|
}
|
|
|
|
// if we got nothing back, display a message
|
|
if ($result == DOKU_PLUGIN_FILELIST_NOMATCH) {
|
|
$renderer->cdata('[n/a: ' . $this->getLang('error_nomatch') . ']');
|
|
return true;
|
|
} else if ($result == DOKU_PLUGIN_FILELIST_OUTSIDEJAIL) {
|
|
$renderer->cdata('[n/a: ' . $this->getLang('error_outsidejail') . ']');
|
|
return true;
|
|
}
|
|
|
|
// if limit is set for a filelist, cut out the relevant slice from the files
|
|
if (($type == 'filelist') && ($params['limit'] != 0)) {
|
|
$result['files'] = array_slice($result['files'], $params['offset'], $params['limit']);
|
|
}
|
|
|
|
switch ($type) {
|
|
|
|
case 'filename':
|
|
|
|
$filename = $result['files'][$params['index']]['name'];
|
|
$filepath = $result['files'][$params['index']]['path'];
|
|
|
|
$this->_render_link($filename, $filepath, $result['basedir'], $result['webdir'], $params, $renderer);
|
|
return true;
|
|
|
|
case 'filelist':
|
|
if (count($result['files']) == 0)
|
|
break;
|
|
|
|
switch ($params['style']) {
|
|
case 'list':
|
|
case 'olist':
|
|
if (!$this->is_odt_export) {
|
|
$renderer->doc .= '<div class="filelist-plugin">'.DOKU_LF;
|
|
}
|
|
$this->_render_list($result, $params, $renderer);
|
|
if (!$this->is_odt_export) {
|
|
$renderer->doc .= '</div>'.DOKU_LF;
|
|
}
|
|
break;
|
|
|
|
case 'table':
|
|
if (!$this->is_odt_export) {
|
|
$renderer->doc .= '<div class="filelist-plugin">'.DOKU_LF;
|
|
}
|
|
$this->_render_table($result, $params, $pos, $renderer);
|
|
if (!$this->is_odt_export) {
|
|
$renderer->doc .= '</div>'.DOKU_LF;
|
|
}
|
|
break;
|
|
|
|
case 'page':
|
|
$this->_render_page($result, $params, $renderer);
|
|
break;
|
|
}
|
|
return true;
|
|
|
|
}
|
|
}
|
|
return false;
|
|
}
|
|
|
|
//~~ Render functions
|
|
|
|
/**
|
|
* Creates the downloadlink for the given filename, based on the given
|
|
* parameters, and adds it to the output of the renderer.
|
|
*
|
|
* @param $filename the name of the file
|
|
* @param $filepath the path of the file
|
|
* @param $basedir the basedir of the file
|
|
* @param $webdir the base URL of the file
|
|
* @param $params the parameters of the filelist command
|
|
* @param $renderer the renderer to use
|
|
* @return void
|
|
*/
|
|
function _render_link($filename, $filepath, $basedir, $webdir, $params, Doku_Renderer $renderer) {
|
|
global $conf;
|
|
|
|
//prepare for formating
|
|
$link['target'] = $conf['target']['extern'];
|
|
$link['style'] = '';
|
|
$link['pre'] = '';
|
|
$link['suf'] = '';
|
|
$link['more'] = '';
|
|
$link['url'] = $this->_get_link_url ($filepath, $basedir, $webdir, $params['randlinks'], $params['direct'], $params['ftp']);
|
|
|
|
$link['name'] = $filename;
|
|
$link['title'] = $renderer->_xmlEntities($link['url']);
|
|
if($conf['relnofollow']) $link['more'] .= ' rel="nofollow"';
|
|
|
|
if ($params['link']) {
|
|
switch ($params['link']) {
|
|
case 1:
|
|
// Link without background image
|
|
$link['class'] = 'media';
|
|
break;
|
|
default:
|
|
// Link with background image
|
|
list($ext,$mime) = mimetype(basename($filepath));
|
|
$link['class'] .= ' mediafile mf_'.$ext;
|
|
break;
|
|
}
|
|
|
|
//output formatted
|
|
if ( !$this->is_odt_export ) {
|
|
$renderer->doc .= $renderer->_formatLink($link);
|
|
} else {
|
|
$this->render_odt_link ($link, $renderer);
|
|
}
|
|
} else {
|
|
// No link, just plain text.
|
|
$renderer->cdata($filename);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Renders a link for odt mode.
|
|
*
|
|
* @param $link the link parameters
|
|
* @param $renderer the renderer to use
|
|
* @return void
|
|
*/
|
|
protected function render_odt_link ($link, Doku_Renderer $renderer) {
|
|
if ( method_exists ($renderer, 'getODTProperties') === true ) {
|
|
$properties = array ();
|
|
|
|
// Get CSS properties for ODT export.
|
|
$renderer->getODTProperties ($properties, 'a', $link['class'], NULL, 'screen');
|
|
|
|
// Insert image if present for that media class.
|
|
if ( empty($properties ['background-image']) === false ) {
|
|
$properties ['background-image'] =
|
|
$renderer->replaceURLPrefix ($properties ['background-image'], DOKU_INC);
|
|
$renderer->_odtAddImage ($properties ['background-image']);
|
|
}
|
|
}
|
|
|
|
// Render link.
|
|
$renderer->externallink($link['url'], $link['name']);
|
|
}
|
|
|
|
/**
|
|
* Renders a list.
|
|
*
|
|
* @param $result the filelist to render
|
|
* @param $params the parameters of the filelist call
|
|
* @param $renderer the renderer to use
|
|
* @return void
|
|
*/
|
|
function _render_list($result, $params, Doku_Renderer $renderer) {
|
|
$this->_render_list_items($result['files'], $result['basedir'], $result['webdir'], $params, $renderer);
|
|
}
|
|
|
|
/**
|
|
* Recursively renders a tree of files as list items.
|
|
*
|
|
* @param $files the files to render
|
|
* @param $basedir the basedir to use
|
|
* @param $webdir the webdir to use
|
|
* @param $params the parameters of the filelist call
|
|
* @param $renderer the renderer to use
|
|
* @param $level the level to render
|
|
* @return void
|
|
*/
|
|
function _render_list_items($files, $basedir, $webdir, $params, Doku_Renderer $renderer, $level = 1) {
|
|
global $conf;
|
|
|
|
if ($params['style'] == 'olist') {
|
|
$renderer->listo_open();
|
|
} else {
|
|
$renderer->listu_open();
|
|
}
|
|
|
|
foreach ($files as $file) {
|
|
if ($file['children'] !== false && $file['treesize'] > 0) {
|
|
// render the directory and its subtree
|
|
$renderer->listitem_open($level);
|
|
if ($this->is_odt_export) {
|
|
$renderer->p_open();
|
|
}
|
|
$renderer->cdata($file['name']);
|
|
$this->_render_list_items($file['children'], $basedir, $webdir, $params, $renderer, $level+1);
|
|
if ($this->is_odt_export) {
|
|
$renderer->p_close();
|
|
}
|
|
$renderer->listitem_close();
|
|
} else if ($file['children'] === false) {
|
|
// open list item
|
|
$renderer->listitem_open($level);
|
|
if ($this->is_odt_export) {
|
|
$renderer->p_open();
|
|
}
|
|
|
|
// render the preview image
|
|
if ($params['preview']) {
|
|
$this->_render_preview_image($file['path'], $basedir, $webdir, $params, $renderer);
|
|
}
|
|
|
|
// render the file link
|
|
$this->_render_link($file['name'], $file['path'], $basedir, $webdir, $params, $renderer);
|
|
|
|
// render filesize
|
|
if ($params['showsize']) {
|
|
$renderer->cdata($params['listsep'].$this->_size_readable($file['size'], 'PiB', 'bi', '%01.1f %s'));
|
|
}
|
|
|
|
// render lastmodified
|
|
if ($params['showdate']) {
|
|
$renderer->cdata($params['listsep'].strftime($conf['dformat'], $file['mtime']));
|
|
}
|
|
|
|
// close list item
|
|
if ($this->is_odt_export) {
|
|
$renderer->p_close();
|
|
}
|
|
$renderer->listitem_close();
|
|
|
|
} else {
|
|
// ignore empty directories
|
|
continue;
|
|
}
|
|
}
|
|
|
|
if ($params['style'] == 'olist') {
|
|
$renderer->listo_close();
|
|
} else {
|
|
$renderer->listu_close();
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Renders the files as a table, including details if configured that way.
|
|
*
|
|
* @param $result the filelist to render
|
|
* @param $params the parameters of the filelist call
|
|
* @param $renderer the renderer to use
|
|
* @return void
|
|
*/
|
|
function _render_table($result, $params, $pos, Doku_Renderer $renderer) {
|
|
global $conf;
|
|
|
|
if (!$this->is_odt_export) {
|
|
$renderer->table_open(NULL, NULL, $pos);
|
|
} else {
|
|
$columns = 1;
|
|
if ($params['tableshowsize'] || $params['showsize']) {
|
|
$columns++;
|
|
}
|
|
if ($params['tableshowdate'] || $params['showdate']) {
|
|
$columns++;
|
|
}
|
|
if ($params['preview']) {
|
|
$columns++;
|
|
}
|
|
$renderer->table_open($columns, NULL, $pos);
|
|
}
|
|
|
|
if ($params['tableheader']) {
|
|
if ($this->is_odt_export) {
|
|
$renderer->tablerow_open();
|
|
}
|
|
|
|
$renderer->tableheader_open();
|
|
$renderer->cdata($this->getLang('filename'));
|
|
$renderer->tableheader_close();
|
|
|
|
if ($params['tableshowsize'] || $params['showsize']) {
|
|
$renderer->tableheader_open();
|
|
$renderer->cdata($this->getLang('filesize'));
|
|
$renderer->tableheader_close();
|
|
}
|
|
|
|
if ($params['tableshowdate'] || $params['showdate']) {
|
|
$renderer->tableheader_open();
|
|
$renderer->cdata($this->getLang('lastmodified'));
|
|
$renderer->tableheader_close();
|
|
}
|
|
|
|
if ($params['preview']) {
|
|
$renderer->tableheader_open(1, 'center', 1);
|
|
switch ($params['preview']) {
|
|
case 1:
|
|
$renderer->cdata($this->getLang('preview').' / '.$this->getLang('filetype'));
|
|
break;
|
|
case 2:
|
|
$renderer->cdata($this->getLang('preview'));
|
|
break;
|
|
case 3:
|
|
$renderer->cdata($this->getLang('filetype'));
|
|
break;
|
|
}
|
|
$renderer->tableheader_close();
|
|
}
|
|
|
|
if ($this->is_odt_export) {
|
|
$renderer->tablerow_close();
|
|
}
|
|
}
|
|
|
|
foreach ($result['files'] as $file) {
|
|
$renderer->tablerow_open();
|
|
$renderer->tablecell_open();
|
|
$this->_render_link($file['name'], $file['path'], $result['basedir'], $result['webdir'], $params, $renderer);
|
|
$renderer->tablecell_close();
|
|
|
|
if ($params['tableshowsize'] || $params['showsize']) {
|
|
$renderer->tablecell_open(1, 'right');
|
|
$renderer->cdata($this->_size_readable($file['size'], 'PiB', 'bi', '%01.1f %s'));
|
|
$renderer->tablecell_close();
|
|
}
|
|
|
|
if ($params['tableshowdate'] || $params['showdate']) {
|
|
$renderer->tablecell_open();
|
|
$renderer->cdata(strftime($conf['dformat'], $file['mtime']));
|
|
$renderer->tablecell_close();
|
|
}
|
|
|
|
if ($params['preview']) {
|
|
$renderer->tablecell_open(1, 'center', 1);
|
|
|
|
$this->_render_preview_image($file['path'], $result['basedir'], $result['webdir'], $params, $renderer);
|
|
$renderer->tablecell_close();
|
|
}
|
|
|
|
$renderer->tablerow_close();
|
|
}
|
|
$renderer->table_close($pos);
|
|
}
|
|
|
|
/**
|
|
* Renders a page.
|
|
*
|
|
* @param $result the filelist to render
|
|
* @param $params the parameters of the filelist call
|
|
* @param $renderer the renderer to use
|
|
* @return void
|
|
*/
|
|
function _render_page($result, $params, Doku_Renderer $renderer) {
|
|
if ( method_exists ($renderer, 'getLastlevel') === false ) {
|
|
$class_vars = get_class_vars (get_class($renderer));
|
|
if ($class_vars ['lastlevel'] !== NULL) {
|
|
// Old releases before "hrun": $lastlevel is accessible
|
|
$lastlevel = $renderer->lastlevel + 1;
|
|
} else {
|
|
// Release "hrun" or newer without method 'getLastlevel()'.
|
|
// Lastlevel can't be determined. Workaroud: always use level 1.
|
|
$lastlevel = 1;
|
|
}
|
|
} else {
|
|
$lastlevel = $renderer->getLastlevel() + 1;
|
|
}
|
|
$this->_render_page_section($result['files'], $result['basedir'], $result['webdir'], $params, $renderer, $lastlevel);
|
|
}
|
|
|
|
/**
|
|
* Recursively renders a tree of files as page sections using headlines.
|
|
*
|
|
* @param $files the files to render
|
|
* @param $basedir the basedir to use
|
|
* @param $webdir the webdir to use
|
|
* @param $params the parameters of the filelist call
|
|
* @param $renderer the renderer to use
|
|
* @param $level the level to render
|
|
* @return void
|
|
*/
|
|
function _render_page_section($files, $basedir, $webdir, $params, Doku_Renderer $renderer, $level) {
|
|
$trees = array();
|
|
$leafs = array();
|
|
|
|
foreach ($files as $file) {
|
|
if ($file['children'] !== false) {
|
|
if ($file['treesize'] > 0) {
|
|
$trees[] = $file;
|
|
}
|
|
} else {
|
|
$leafs[] = $file;
|
|
}
|
|
}
|
|
|
|
$this->_render_list_items($leafs, $basedir, $webdir, $params, $renderer);
|
|
|
|
if ($level < 7) {
|
|
foreach ($trees as $tree) {
|
|
$renderer->header($tree['name'], $level, 0);
|
|
$renderer->section_open($level);
|
|
$this->_render_page_section($tree['children'], $basedir, $webdir, $params, $renderer, $level + 1);
|
|
$renderer->section_close();
|
|
}
|
|
} else {
|
|
$this->_render_list_items($trees, $basedir, $webdir, $params, $renderer);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Render a preview item for file $filepath.
|
|
*
|
|
* @param $filepath the file for which a preview image shall be rendered
|
|
* @param $basedir the basedir to use
|
|
* @param $webdir the webdir to use
|
|
* @param $params the parameters of the filelist call
|
|
* @param $renderer the renderer to use
|
|
* @return void
|
|
*/
|
|
protected function _render_preview_image ($filepath, $basedir, $webdir, $params, Doku_Renderer $renderer) {
|
|
$imagepath = $this->get_preview_image_path($filepath, $params);
|
|
if (!empty($imagepath)) {
|
|
$imgLink = $this->_get_link_url ($imagepath, $basedir, $webdir, 0, 1);
|
|
|
|
$previewsize = $params['previewsize'];
|
|
if ($previewsize == 0) {
|
|
$previewsize = 32;
|
|
}
|
|
$imgclass = '';
|
|
if ($params['onhover']) {
|
|
$imgclass = 'class="filelist_preview"';
|
|
}
|
|
|
|
if (!$this->is_odt_export) {
|
|
$renderer->doc .= '<img '.$imgclass.' style=" max-height: '.$previewsize.'px; max-width: '.$previewsize.'px;" src="'.$imgLink.'">';
|
|
} else {
|
|
list($width, $height) = $renderer->_odtGetImageSize ($imagepath, $previewsize, $previewsize);
|
|
$renderer->_odtAddImage ($imagepath, $width.'cm', $height.'cm');
|
|
}
|
|
}
|
|
}
|
|
|
|
//~~ Filelist functions
|
|
|
|
/**
|
|
* Creates the filelist based on the given glob-pattern and
|
|
* sorting and ordering parameters.
|
|
*
|
|
* @param $pattern the pattern
|
|
* @param $params the parameters of the filelist command
|
|
* @return a filelist data structure containing the found files and base-
|
|
* and webdir
|
|
*/
|
|
function _create_filelist($pattern, $params) {
|
|
global $conf;
|
|
global $ID;
|
|
|
|
$allowed_absolute_paths = explode(',', $this->getConf('allowed_absolute_paths'));
|
|
|
|
$result = array(
|
|
'files' => array(),
|
|
'basedir' => false,
|
|
'webdir' => false,
|
|
);
|
|
|
|
// we don't want to use $conf['media'] here as that path has symlinks resolved
|
|
if (!$params['direct']) {
|
|
// if media path is not absolute, precede it with the current namespace
|
|
if ($pattern[0] != ':') {
|
|
$pattern = ':'.getNS($ID) . ':' . $pattern;
|
|
}
|
|
// replace : with / and prepend mediadir
|
|
$pattern = $this->mediadir . str_replace(':', '/', $pattern);
|
|
} elseif($params['direct'] == 2){
|
|
// treat path as relative to first configured path
|
|
$pattern = $allowed_absolute_paths[0].'/'.$pattern;
|
|
} else {
|
|
// if path is not absolute, precede it with DOKU_INC
|
|
if (!$this->_path_is_absolute($pattern)) {
|
|
$pattern = DOKU_INC.$pattern;
|
|
}
|
|
}
|
|
// get the canonicalized basedir (without resolving symlinks)
|
|
$dir = $this->_realpath($this->_win_path_convert(dirname($pattern))).'/';
|
|
|
|
// if the directory does not exist, we of course have no matches
|
|
if (!$dir || !file_exists($dir)) {
|
|
return DOKU_PLUGIN_FILELIST_NOMATCH;
|
|
}
|
|
|
|
// match pattern aginst allowed paths
|
|
$web_paths = explode(',', $this->getConf('web_paths'));
|
|
$basedir = false;
|
|
$webdir = false;
|
|
if (count($allowed_absolute_paths) == count($web_paths)) {
|
|
for($i = 0; $i < count($allowed_absolute_paths); $i++) {
|
|
$abs_path = $this->_win_path_convert(trim($allowed_absolute_paths[$i]));
|
|
if (strstr($dir, $abs_path) == $dir) {
|
|
$basedir = $abs_path;
|
|
$webdir = trim($web_paths[$i]);
|
|
break;
|
|
}
|
|
}
|
|
}
|
|
|
|
// $basedir is false if $dir was not in one of the allowed paths
|
|
if ($basedir === false) {
|
|
return DOKU_PLUGIN_FILELIST_OUTSIDEJAIL;
|
|
}
|
|
|
|
// retrieve fileinformation
|
|
$result['basedir'] = $basedir;
|
|
$result['webdir'] = $webdir;
|
|
$result['files'] = $this->_crawl_files($this->_win_path_convert($pattern), $params);
|
|
if (!$result['files']) {
|
|
return DOKU_PLUGIN_FILELIST_NOMATCH;
|
|
}
|
|
|
|
// flatten filelist if the displaymode is table
|
|
if ($params['style'] == 'table') {
|
|
$result['files'] = $this->_flatten_filelist($result['files']);
|
|
}
|
|
|
|
// sort the list
|
|
$callback = false;
|
|
$reverseflag = false;
|
|
if ($params['sort'] == 'mtime') {
|
|
$callback = array($this, '_compare_mtimes');
|
|
if ($params['order'] == 'asc') $reverseflag = true;
|
|
} else if ($params['sort'] == 'ctime') {
|
|
$callback = array($this, '_compare_ctimes');
|
|
if ($params['order'] == 'asc') $reverseflag = true;
|
|
} else if ($params['sort'] == 'size') {
|
|
$callback = array($this, '_compare_sizes');
|
|
if ($params['order'] == 'desc') $reverseflag = true;
|
|
} else if ($params['sort'] == 'iname') {
|
|
$callback = array($this, '_compare_inames');
|
|
if ($params['order'] == 'desc') $reverseflag = true;
|
|
} else {
|
|
$callback = array($this, '_compare_names');
|
|
if ($params['order'] == 'desc') $reverseflag = true;
|
|
}
|
|
$this->_sort_filelist($result['files'], $callback, $reverseflag);
|
|
|
|
// return the list
|
|
if (count($result['files']) > 0)
|
|
return $result;
|
|
else
|
|
return DOKU_PLUGIN_FILELIST_NOMATCH;
|
|
}
|
|
|
|
/**
|
|
* Recursively sorts the given tree using the given callback. Optionally
|
|
* reverses the sorted tree before returning it.
|
|
*
|
|
* @param $files the files to sort
|
|
* @param $callback the callback function to use for comparison
|
|
* @param $reverse true if the result is to be reversed
|
|
* @return the sorted tree
|
|
*/
|
|
function _sort_filelist(&$files, $callback, $reverse) {
|
|
// sort subtrees
|
|
for ($i = 0; $i < count($files); $i++) {
|
|
if ($files[$i]['children'] !== false) {
|
|
$children = $files[$i]['children'];
|
|
$this->_sort_filelist($children, $callback, $reverse);
|
|
$files[$i]['children'] = $children;
|
|
}
|
|
}
|
|
|
|
// sort current tree
|
|
usort($files, $callback);
|
|
if ($reverse) {
|
|
$files = array_reverse($files);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Flattens the filelist by recursively walking through all subtrees and
|
|
* merging them with a prefix attached to the filenames.
|
|
*
|
|
* @param $files the tree to flatten
|
|
* @param $prefix the prefix to attach to all processed nodes
|
|
* @return a flattened representation of the tree
|
|
*/
|
|
function _flatten_filelist($files, $prefix = '') {
|
|
$result = array();
|
|
foreach ($files as $file) {
|
|
if ($file['children'] !== false) {
|
|
$result = array_merge($result, $this->_flatten_filelist($file['children'], $prefix . $file['name'] . '/'));
|
|
} else {
|
|
$file['name'] = $prefix . $file['name'];
|
|
$result[] = $file;
|
|
}
|
|
}
|
|
return $result;
|
|
}
|
|
|
|
/**
|
|
* Filters out directories and their subtrees from the result.
|
|
*
|
|
* @param $result the result to filter
|
|
* @return the result without any directories contained therein,
|
|
* DOKU_PLUGIN_FILELIST_NOMATCH if there are no files left or
|
|
* the given result if it was not an array (but an errorcode)
|
|
*/
|
|
function _filter_out_directories($result) {
|
|
if (!is_array($result)) {
|
|
return $result;
|
|
}
|
|
|
|
$filtered = array();
|
|
$files = $result['files'];
|
|
foreach ($files as $file) {
|
|
if ($file['children'] === false) {
|
|
$filtered[] = $file;
|
|
}
|
|
}
|
|
|
|
if (count($filtered) == 0) {
|
|
return DOKU_PLUGIN_FILELIST_NOMATCH;
|
|
} else {
|
|
$result['files'] = $filtered;
|
|
return $result;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Does a (recursive) crawl for finding files based on a given pattern.
|
|
* Based on a safe glob reimplementation using fnmatch and opendir.
|
|
*
|
|
* @param $pattern the pattern to match to
|
|
* @param params the parameters of the filelist call
|
|
* @return a hierarchical filelist or false if nothing could be found
|
|
*
|
|
* @see <http://www.php.net/manual/en/function.glob.php#71083>
|
|
*/
|
|
function _crawl_files($pattern, $params) {
|
|
$split = explode('/', $pattern);
|
|
$match = array_pop($split);
|
|
$path = implode('/', $split);
|
|
if (!is_dir($path)) {
|
|
return false;
|
|
}
|
|
|
|
$ext = explode(',',$this->getConf('extensions'));
|
|
$ext = array_map('trim',$ext);
|
|
$ext = array_map('preg_quote_cb',$ext);
|
|
$ext = join('|',$ext);
|
|
|
|
if (($dir = opendir($path)) !== false) {
|
|
$result = array();
|
|
while (($file = readdir($dir)) !== false) {
|
|
if ($file == '.' || $file == '..') {
|
|
// ignore . and ..
|
|
continue;
|
|
}
|
|
if ($file == $params['titlefile']) {
|
|
// ignore the title file
|
|
continue;
|
|
}
|
|
if ($file[0] == '.') {
|
|
// ignore hidden files
|
|
continue;
|
|
}
|
|
$filepath = $path . '/' . $file;
|
|
|
|
if ($this->_fnmatch($match, $file) || (is_dir($filepath) && $params['recursive'])) {
|
|
if(!is_dir($filepath) && !preg_match('/('.$ext.')$/i',$file)){
|
|
continue;
|
|
}
|
|
|
|
if (!$params['direct']) {
|
|
// exclude prohibited media files via ACLs
|
|
$mid = $this->_convert_mediapath($filepath);
|
|
$perm = auth_quickaclcheck($mid);
|
|
if ($perm < AUTH_READ) continue;
|
|
} else {
|
|
if (!is_readable($filepath)) continue;
|
|
}
|
|
|
|
$filename = $file;
|
|
if (is_dir($filepath)) {
|
|
$titlefile = $filepath . '/' . $params['titlefile'];
|
|
if (!$params['direct']) {
|
|
$mid = $this->_convert_mediapath($titlefile);
|
|
$perm = auth_quickaclcheck($mid);
|
|
if (is_readable($titlefile) && $perm >= AUTH_READ) {
|
|
$filename = io_readFile($titlefile, false);
|
|
}
|
|
} else {
|
|
if (is_readable($titlefile)) {
|
|
$filename = io_readFile($titlefile, false);
|
|
}
|
|
}
|
|
}
|
|
|
|
// prepare entry
|
|
if (!is_dir($filepath) || $params['recursive']) {
|
|
$entry = array(
|
|
'name' => $filename,
|
|
'path' => $filepath,
|
|
'mtime' => filemtime($filepath),
|
|
'ctime' => filectime($filepath),
|
|
'size' => filesize($filepath),
|
|
'children' => ((is_dir($filepath) && $params['recursive']) ? $this->_crawl_files($filepath . '/' . $match, $params) : false),
|
|
'treesize' => 0,
|
|
);
|
|
|
|
// calculate tree size
|
|
if ($entry['children'] !== false) {
|
|
foreach ($entry['children'] as $child) {
|
|
$entry['treesize'] += $child['treesize'];
|
|
}
|
|
} else {
|
|
$entry['treesize'] = 1;
|
|
}
|
|
|
|
// add entry to result
|
|
$result[] = $entry;
|
|
}
|
|
}
|
|
}
|
|
closedir($dir);
|
|
return $result;
|
|
} else {
|
|
return false;
|
|
}
|
|
}
|
|
|
|
//~~ Comparators
|
|
|
|
function _compare_names($a, $b) {
|
|
return strcmp($a['name'], $b['name']);
|
|
}
|
|
|
|
function _compare_inames($a, $b) {
|
|
return strcmp(strtolower($a['name']), strtolower($b['name']));
|
|
}
|
|
|
|
function _compare_ctimes($a, $b) {
|
|
if ($a['ctime'] == $b['ctime']) {
|
|
return 0;
|
|
}
|
|
return (($a['ctime'] < $b['ctime']) ? -1 : 1);
|
|
}
|
|
|
|
function _compare_mtimes($a, $b) {
|
|
if ($a['mtime'] == $b['mtime']) {
|
|
return 0;
|
|
}
|
|
return (($a['mtime'] < $b['mtime']) ? -1 : 1);
|
|
}
|
|
|
|
function _compare_sizes($a, $b) {
|
|
if ($a['size'] == $b['size']) {
|
|
return 0;
|
|
}
|
|
return (($a['size'] < $b['size']) ? -1 : 1);
|
|
}
|
|
|
|
//~~ Utility functions
|
|
|
|
/**
|
|
* Canonicalizes a given path. A bit like realpath, but without the resolving of symlinks.
|
|
*
|
|
* @author anonymous
|
|
* @see <http://www.php.net/manual/en/function.realpath.php#73563>
|
|
*/
|
|
function _realpath($path) {
|
|
$path=explode('/', $path);
|
|
$output=array();
|
|
for ($i=0; $i<sizeof($path); $i++) {
|
|
if ('.' == $path[$i]) continue;
|
|
if ('..' == $path[$i] && '..' != $output[sizeof($output) - 1]) {
|
|
array_pop($output);
|
|
continue;
|
|
}
|
|
array_push($output, $path[$i]);
|
|
}
|
|
return implode('/', $output);
|
|
}
|
|
|
|
/**
|
|
* Replacement for fnmatch() for windows systems.
|
|
*
|
|
* @author jk at ricochetsolutions dot com
|
|
* @see <http://www.php.net/manual/en/function.fnmatch.php#71725>
|
|
*/
|
|
function _fnmatch($pattern, $string) {
|
|
return preg_match("#^".strtr(preg_quote($pattern, '#'), array('\*' => '.*', '\?' => '.', '\[' => '[', '\]' => ']'))."$#i", $string);
|
|
}
|
|
|
|
/**
|
|
* Converts backslashs in paths to slashs.
|
|
*
|
|
* @param $path the path to convert
|
|
* @return the converted path
|
|
*/
|
|
function _win_path_convert($path) {
|
|
return str_replace('\\', '/', trim($path));
|
|
}
|
|
|
|
/**
|
|
* Return human readable sizes
|
|
*
|
|
* @author Aidan Lister <aidan@php.net>
|
|
* @version 1.3.0
|
|
* @link http://aidanlister.com/repos/v/function.size_readable.php
|
|
* @param int $size size in bytes
|
|
* @param string $max maximum unit
|
|
* @param string $system 'si' for SI, 'bi' for binary prefixes
|
|
* @param string $retstring return string format
|
|
*/
|
|
function _size_readable($size, $max = null, $system = 'si', $retstring = '%01.2f %s')
|
|
{
|
|
// Pick units
|
|
$systems['si']['prefix'] = array('B', 'K', 'MB', 'GB', 'TB', 'PB');
|
|
$systems['si']['size'] = 1000;
|
|
$systems['bi']['prefix'] = array('B', 'KiB', 'MiB', 'GiB', 'TiB', 'PiB');
|
|
$systems['bi']['size'] = 1024;
|
|
$sys = isset($systems[$system]) ? $systems[$system] : $systems['si'];
|
|
|
|
// Max unit to display
|
|
$depth = count($sys['prefix']) - 1;
|
|
if ($max && false !== $d = array_search($max, $sys['prefix'])) {
|
|
$depth = $d;
|
|
}
|
|
|
|
// Loop
|
|
$i = 0;
|
|
while ($size >= $sys['size'] && $i < $depth) {
|
|
$size /= $sys['size'];
|
|
$i++;
|
|
}
|
|
|
|
return sprintf($retstring, $size, $sys['prefix'][$i]);
|
|
}
|
|
|
|
/**
|
|
* Determines whether a given path is absolute or relative.
|
|
* On windows plattforms, it does so by checking whether the second character
|
|
* of the path is a :, on all other plattforms it checks for a / as the
|
|
* first character.
|
|
*
|
|
* @param $path the path to check
|
|
* @return true if path is absolute, false otherwise
|
|
*/
|
|
function _path_is_absolute($path) {
|
|
if (strtoupper(substr(PHP_OS, 0, 3)) === 'WIN') {
|
|
if ($path[1] == ':' || ($path[0] == '/' && $path[1] == '/')) {
|
|
return true;
|
|
}
|
|
return false;
|
|
} else {
|
|
return ($path[0] == '/');
|
|
}
|
|
}
|
|
|
|
function _convert_mediapath($path) {
|
|
$mid = str_replace('/', ':', substr($path, strlen($this->mediadir))); // strip media base dir
|
|
return ltrim($mid, ':'); // strip leading :
|
|
}
|
|
|
|
/**
|
|
* The function determines the preview image path for the given file
|
|
* depending on the file type and the 'preview' config option value:
|
|
* 1: Display file as preview image if itself is an image otherwise
|
|
* choose DokuWiki image corresponding to the file extension
|
|
* 2: Display file as preview image if itself is an image otherwise
|
|
* display no image
|
|
* 3. Display DokuWiki image corresponding to the file extension
|
|
*
|
|
* @param $filename the file to check
|
|
* @return string Image to use for preview image
|
|
*/
|
|
protected function get_preview_image_path ($filename, $params) {
|
|
list($ext,$mime) = mimetype(basename($filename));
|
|
$imagepath = '';
|
|
if (($params['preview'] == 1 || $params['preview'] == 2) &&
|
|
strncmp($mime, 'image', strlen('image')) == 0) {
|
|
// The file is an image. Return itself as the image path.
|
|
$imagepath = $filename;
|
|
}
|
|
if (($params['preview'] == 1 && empty($imagepath)) ||
|
|
$params['preview'] == 3 ) {
|
|
// No image. Return DokuWiki image for file extension.
|
|
if (!empty($ext)) {
|
|
$imagepath = DOKU_INC.'lib/images/fileicons/32x32/'.$ext.'.png';
|
|
} else {
|
|
$imagepath = DOKU_INC.'lib/images/fileicons/32x32/file.png';
|
|
}
|
|
}
|
|
return $imagepath;
|
|
}
|
|
|
|
/**
|
|
* Create URL for file $filepath.
|
|
*
|
|
* @param $filepath the file for which a preview image shall be rendered
|
|
* @param $basedir the basedir to use
|
|
* @param $webdir the webdir to use
|
|
* @param $params the parameters of the filelist call
|
|
* @return string the generated URL
|
|
*/
|
|
protected function _get_link_url ($filepath, $basedir, $webdir, $randlinks, $direct, $ftp=false) {
|
|
$urlparams = '';
|
|
if ($randlinks) {
|
|
$urlparams = '?'.time();
|
|
}
|
|
if (!$direct) {
|
|
$url = ml(':'.$this->_convert_mediapath($filepath)).$urlparams;
|
|
} else {
|
|
$url = $webdir.substr($filepath, strlen($basedir)).$urlparams;
|
|
if ($ftp)
|
|
{
|
|
$url = str_replace('\\','/', $url);
|
|
if (strpos($url, 'http') === false) {
|
|
$url = 'ftp:'.$url;
|
|
} else {
|
|
$url = str_replace('http','ftp', $url);
|
|
}
|
|
}
|
|
}
|
|
return $url;
|
|
}
|
|
}
|