egroupware/filemanager/inc/class.filemanager_hooks.inc.php

<?php
/**
 * eGroupWare - Hooks for admin, preferences and sidebox-menus
 *
 * @link http://www.egroupware.org
 * @author Ralf Becker <RalfBecker-AT-outdoor-training.de>
 * @package filemanager
 * @license http://opensource.org/licenses/gpl-license.php GPL - GNU General Public License
 * @version $Id: class.filemanager_hooks.inc.php 25002 2008-03-03 12:16:11Z ralfbecker $ 
 */

/**
 * Class containing admin, preferences and sidebox-menus (used as hooks)
 */
class filemanager_hooks
{
	static $appname = 'filemanager';
	static $foldercount = 1;
	static function sidebox_menu($args)
	{
		$location = is_array($args) ? $args['location'] : $args;
		$basepath = '/';
		$rootpath = '/home';
		$homepath = '/home/'.$GLOBALS['egw_info']['user']['account_lid'];
		//echo "<p>admin_prefs_sidebox_hooks::all_hooks(".print_r($args,True).") appname='$appname', location='$location'</p>\n";
		$config = config::read(self::$appname);
		if (!empty($config['max_folderlinks'])) self::$foldercount = (int)$config['max_folderlinks'];
		$file_prefs    = &$GLOBALS['egw_info']['user']['preferences'][self::$appname];
		if ($location == 'sidebox_menu')
		{
			$title = $GLOBALS['egw_info']['apps'][self::$appname]['title'] . ' '. lang('Menu');
			$file = Array(
				'Home' => $GLOBALS['egw']->link('/index.php',array('menuaction'=>self::$appname.'.filemanager_ui.index','path'=>$homepath)),
				'Root' => $GLOBALS['egw']->link('/index.php',array('menuaction'=>self::$appname.'.filemanager_ui.index','path'=>$rootpath)),
				# not sure if we want to offer a link to the base directory for default, this way i do that as preference
				#'Base' => $GLOBALS['egw']->link('/index.php',array('menuaction'=>self::$appname.'.filemanager_ui.index','path'=>$basepath)),
			);
			if (!empty($file_prefs['showbase']) && $file_prefs['showbase']=='yes') $file['Base']= $GLOBALS['egw']->link('/index.php',array('menuaction'=>self::$appname.'.filemanager_ui.index','path'=>$basepath));
			if (!empty($file_prefs['startfolder'])) $file['Startfolder']= $GLOBALS['egw']->link('/index.php',array('menuaction'=>self::$appname.'.filemanager_ui.index','path'=>$file_prefs['startfolder']));
			for ($i=1; $i<=self::$foldercount;$i++) {
				if (!empty($file_prefs['folderlink'.$i])) {
					$foldername = array_pop(explode("/",$file_prefs['folderlink'.$i]));
					$file['Link '.$i.($foldername?": ($foldername)":'(Base)')]= $GLOBALS['egw']->link('/index.php',array(
						'menuaction'=>self::$appname.'.filemanager_ui.index',
						'path'=>$file_prefs['folderlink'.$i]));
				}
			}
			display_sidebox(self::$appname,$title,$file);
		}
		self::preferences(self::$appname);
		if ($GLOBALS['egw_info']['user']['apps']['admin']) self::admin(self::$appname);
	}

	/**
	 * Entries for filemanagers's admin menu
	 */
	static function admin($location = 'admin')
	{
        $file = Array(
            'Site Configuration' => $GLOBALS['egw']->link('/index.php','menuaction=admin.uiconfig.index&appname='.self::$appname),
        );
		if ($location == 'admin') {
        	display_section(self::$appname,$file);
		} else {
			display_sidebox(self::$appname,lang('Admin'),$file);
		}
	}
	
	static function preferences($location = 'preferences') 
	{
		$file = array(
			'Preferences' => $GLOBALS['egw']->link('/index.php','menuaction=preferences.uisettings.index&appname='.self::$appname),
		);
		if ($location == 'preferences') 
		{
			display_section(self::$appname,$file);
		} else {
			display_sidebox(self::$appname,lang('Preferences'),$file);
		}
	}

	static function settings()
	{
		$config = config::read(self::$appname);
		if (!empty($config['max_folderlinks'])) self::$foldercount = (int)$config['max_folderlinks'];

		$upload_boxes = array(
			'1'  => '1',
			'5'  => '5',
			'10' => '10',
			'20' => '20',
			'30' => '30'
		);
		$yes_no = array(
			'no'	=> lang('No'),
			'yes' => lang('Yes')
		);
	
        $GLOBALS['settings'] = array(
			'showbase'	=> array(
				'type'		=> 'select',
				'name'		=> 'showbase',
				'values'	=> $yes_no,
				'label' 	=> lang('Show link to filemanagers basedirectory (/) in side box menu?'),
				'help'		=> lang('Default behavior is NO. The link will not be shown, but you are still able to navigate to this location, 
								or configure this paricular location as startfolder or folderlink.'),
				'xmlrpc'	=> True,
				'amin'		=> False
			),
			'alwayssortfolderstotop'	=> array(
				'type'		=> 'select',
				'name'		=> 'alwayssortfolderstotop',
				'values'	=> $yes_no,
				'label' 	=> lang('Sort folders always to the top?'),
				'help'		=> lang('Default behavior is NO. If you set this to YES, folders will always appear at the top of the list, 
								no matter what you sort by. It will slow your mustang down as well.'),
				'xmlrpc'	=> True,
				'amin'		=> False
			),
			'startfolder'	=> array(
				'type'		=> 'input',
				'name'		=> 'startfolder',
				'size'		=> 80,
				'default'	=> '',
				'label' 	=> lang('Enter the complete VFS path to specify your desired start folder.'),
				'help'		=> lang('If you leave this empty, the path does not exist or the user does not have permission to access the specified folder,
								 the users startfolder will default to the users home folder.'),
				'xmlrpc'	=> True,
				'amin'		=> False
			),
#            'show_upload_boxes' => array(
#                'type'   => 'select',
#                'label'  => 'Default number of upload fields to show',
#                'name'   => 'show_upload_boxes',
#                'values' => $upload_boxes,
#                'help'   => 'How many upload slots should be available for uploading files? (The boxes are displayed at the bottom of the file listing)',
#                'xmlrpc' => True,
#                'admin'  => False
#            ),
		);
		for ($i=1;$i<=self::$foldercount;$i++) {
			$GLOBALS['settings']['folderlink'.$i]	= array(
				'type'		=> 'input',
				'name'		=> 'folderlink'.$i,
				'size'		=> 80,
				'default'	=> '',
				'label' 	=> lang('Enter the complete VFS path to specify a fast access link to a folder').' ('.$i.').',
				'help'		=> lang('If you leave this empty, the path does not exist or the user does not have permission to access the specified folder,
								 the link will lead the user to the start folder or users home folder (if the startfolder is either not configured, or
								 not available to the user).'),
				'xmlrpc'	=> True,
				'amin'		=> False
			);
		}

		return true;
	}
}