egroupware_official/filemanager/inc/class.filemanager_select.inc.php
Ralf Becker 3c18478f86 - more docu for file selection dialog
- added mime type filter
- added more user friendly mime type names:
  application/pdf --> PDF file (application/pdf)
2009-04-17 06:28:19 +00:00

198 lines
6.1 KiB
PHP

<?php
/**
* eGroupWare - Filemanager - select file to open or save dialog
*
* @link http://www.egroupware.org
* @package filemanager
* @author Ralf Becker <RalfBecker-AT-outdoor-training.de>
* @copyright (c) 2009 by Ralf Becker <RalfBecker-AT-outdoor-training.de>
* @license http://opensource.org/licenses/gpl-license.php GPL - GNU General Public License
* @version $Id$
*/
/**
* Select file to open or save dialog
*
* This dialog can be called from applications to open or store files from the VFS.
*
* There are the following ($_GET) parameters:
* - menuaction=filemanager.filemanager_select.select (required)
* - mode=(open|open-multiple|saveas|select-dir) (required)
* - method=app.class.method (required callback, gets called with id and selected file(s))
* - id=... (optional parameter passed to callback)
* - path=... (optional start path in VFS)
* - mime=... (optional mime-type to limit display to given type)
* - label=... (optional label for submit button, default "Open")
*
* The application calls this method in a popup with size: 640x580 px
* After the user selected one or more files (depending on the mode parameter), the "method" callback gets
* called on server (!) side. Parameters are the id plus the selected files as 1. and 2. parameter.
* The callback returns javascript to eg. update it's UI AND (!) to close the current popup ("window.close();").
*/
class filemanager_select
{
/**
* Methods callable via menuaction
*
* @var array
*/
var $public_functions = array(
'select' => true,
);
/**
* Constructor
*
*/
function __construct()
{
// strip slashes from _GET parameters, if someone still has magic_quotes_gpc on
if (get_magic_quotes_gpc() && $_GET)
{
$_GET = etemplate::array_stripslashes($_GET);
}
}
/**
* File selector
*
* @param array $content
*/
function select(array $content=null)
{
if (!is_array($content))
{
$content = array();
$content['mode'] = $_GET['mode'];
if (!in_array($content['mode'],array('open','open-multiple','saveas','select-dir')))
{
throw new egw_exception_wrong_parameter("Wrong or unset required mode parameter!");
}
$content['path'] = $_GET['path'];
if (!isset($content['path']) && ($content['path'] = egw_session::appsession('select_path','filemanger')) === false ||
!egw_vfs::is_dir($content['path']))
{
$content['path'] = filemanager_ui::get_home_dir();
}
$content['method'] = $_GET['method'];
$content['id'] = $_GET['id'];
$content['label'] = isset($_GET['label']) ? $_GET['label'] : lang('Open');
if (($content['options-mime'] = isset($_GET['mime'])))
{
$content['options-mime'] = array();
foreach((array)$_GET['mime'] as $key => $value)
{
if (is_numeric($key))
{
$content['options-mime'][$value] = lang('%1 files',strtoupper(mime_magic::mime2ext($value))).' ('.$value.')';
}
else
{
$content['options-mime'][$key] = lang('%1 files',strtoupper($value)).' ('.$key.')';
}
}
list($content['mime']) = each($content['options-mime']);
}
}
else
{
//_debug_array($content); die('Stop');
if ($content['button']) list($button) = each($content['button']);
switch($button)
{
case 'up':
if ($content['path'] != '/') $content['path'] = egw_vfs::dirname($content['path']);
break;
case 'home':
$content['path'] = filemanager_ui::get_home_dir();
break;
case 'ok':
switch($content['mode'])
{
case 'open-multiple':
foreach((array)$content['dir']['selected'] as $name)
{
$files[] = egw_vfs::concat($content['path'],$name);
}
break;
case 'select-dir':
$files = $content['path'];
break;
default:
$files = egw_vfs::concat($content['path'],$content['name']);
break;
}
$js = ExecMethod2($content['method'],$content['id'],$files);
echo "<html>\n<head>\n<script type='text/javascript'>\n$js\n</script>\n</head>\n</html>\n";
$GLOBALS['egw']->common->egw_exit();
}
}
if (!($d = egw_vfs::opendir($content['path'])))
{
$content['msg'] = lang("Can't open directory %1!",$content['path']);
}
else
{
$n = 0;
$content['dir'] = array('mode' => $content['mode']);
while (($name = readdir($d)))
{
$path = egw_vfs::concat($content['path'],$name);
$is_dir = egw_vfs::is_dir($path);
if ($content['mime'] && !$is_dir && egw_vfs::mime_content_type($path) != $content['mime'])
{
continue; // does not match mime-filter --> ignore
}
$content['dir'][$n] = array(
'name' => $name,
'path' => $path,
'onclick' => $is_dir ? "return select_goto('".addslashes($path)."');" :
($content['mode'] != 'open-multiple' ? "return select_show('".addslashes($name)."');" :
"return select_toggle('".addslashes($name)."');"),
);
if ($is_dir && $content['mode'] == 'open-multiple')
{
$readonlys['selected['.$name.']'] = true;
}
++$n;
}
closedir($d);
}
$content['name'] = '';
$content['js'] = '<script type="text/javascript">
function select_goto(to)
{
path = document.getElementById("exec[path]");
path.value = to;
path.form.submit();
return false;
}
function select_show(file)
{
name = document.getElementById("exec[name]");
name.value = file;
return false;
}
function select_toggle(file)
{
checkbox = document.getElementById("exec[dir][selected]["+file+"]");
if (checkbox) checkbox.checked = !checkbox.checked;
return false;
}
</script>
';
//_debug_array($content);
//_debug_array($readonlys);
egw_session::appsession('select_path','filemanger',$content['path']);
$tpl = new etemplate('filemanager.select');
$tpl->exec('filemanager.filemanager_select.select',$content,$sel_options,$readonlys,array(
'mode' => $content['mode'],
'method' => $content['method'],
'id' => $content['id'],
'label' => $content['label'],
'mime' => $content['mime'],
'options-mime' => $content['options-mime'],
),2);
}
}