File Source for FileSelect.class.php

<?php
/**
* For including this file you have to define the constant "CLASSPATH".
* Because every include in the framework depends on the CLASSPATH definition.
* The CLASSPATH means the relative path to the folder that contains the
* framework GilliGan.
*
* @package forms
* @subpackage items
*/
if ( !defined( "CLASSPATH" ) )
{
echo "<h3>You have to define the constant CLASSPATH!</h3>\n";
echo "Example: define( 'CLASSPATH', '../path/to/classes/' );\n";
exit();
}
/**
*
*/
require_once( CLASSPATH."filesystem/FilesystemToolkit.class.php" );
/**
*
*/
require_once( CLASSPATH."forms/items/HTMLSelect.class.php" );
/**
* A class to generate select fields to choose a file on the filesystem.
*
* @package forms
* @subpackage items
* @version 0.1.4
* @author Daniel PlÃ¼cken <daniel@debakel.net>
* @license http://www.gnu.org/copyleft/lesser.html
* GNU Lesser General Public License
* @copyright Copyright (C) 2004 Daniel PlÃ¼cken <daniel@debakel.net>
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2.1 of the License.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General
* Public License along with this library; if not, write to the
* Free Software Foundation, Inc., 59 Temple Place, Suite 330,
* Boston, MA 02111-1307 USA
*/
class FileSelect extends HTMLSelect
{
/**
* @var string $dir
* @access private
*/
var $dir;
/**
* @var integer $outputKind
* @access private
*/
var $outputKind;
/**
* Constructor
*
* @version 1.4
* @since 0.1.0
* @author Daniel PlÃ¼cken <daniel@debakel.net>
* @access public
* @uses
* @param string $name Name of the select.
* @param string $dir The directory to read.
* @param string $selectedFile The selected file in the read directory.
* @param string $onChangeOrder The javascript order that should execute
* if the value of the select changes.
* @param integer $outputKind The defined integer code to manipulate
* the behaviour of the select, in the kind
* that only files will be show, only
* folder will be show or both, files
* and folder, will be display. See the uses
* part for more information.
*/
function FileSelect(
$name,
$dir,
$selectedFile = "",
$onChangeOrder = "",
$outputKind = FILEORFOLDER
)
{
$this->dir = $dir;
$this->SOKH( $outputKind );
if( !is_dir( $this->dir ) )
{
echo "<b>'".$this->dir."' is no directory.</b>\r\n";
// echo "You are here ".."\r\n";
}
else
{
$this->selectedValue = basename( $selectedFile );
$folder = opendir( $this->dir );
# Save folder and files each in separate arrays
while( $file = readdir( $folder ) )
{
if(
$file != "."
&& $file != ".."
)
{
if( is_dir( $this->dir.$file ) )
$tempDirArr[] = $file;
else
$tempFileArr[] = $file;
}
}
closedir( $folder );
if(
$this->outputKind == FOLDER
|| $this->outputKind == FILEORFOLDER
)
{
if( count( $tempDirArr ) > 1 )
sort( $tempDirArr );
for( $i = 0; $i < count( $tempDirArr ); $i++ )
$valueAndLabelArr[] = $tempDirArr[$i];
}
if(
$this->outputKind == FILE
|| $this->outputKind == FILEORFOLDER
)
{
if( count( $tempFileArr ) > 1 )
sort( $tempFileArr );
for( $i = 0; $i < count( $tempFileArr ); $i++ )
$valueAndLabelArr[] = $tempFileArr[$i];
}
# Setup the select
$this->HTMLSelect(
$name,
$valueAndLabelArr,
$valueAndLabelArr,
$this->selectedValue,
$onChangeOrder,
true
);
}
}
/**
* Returns a clone of this object.
*
* @version 1.2
* @since 0.1.2
* @author Daniel PlÃ¼cken <daniel@debakel.net>
* @access public
* @param string $newName
* @return object
*/
function getClone(
$newName,
$selectedValue
)
{
$newInstance = new FileSelect(
$newName,
$this->dir,
$selectedValue,
$this->onChangeOrder,
$this->outputKind
);
return $newInstance;
}
/**
* Returns the directory which content should be display by this select.
*
* @version 1.4
* @since 0.1.0
* @author Daniel PlÃ¼cken <daniel@debakel.net>
* @access public
* @return string
*/
function getDir()
{ return $this->dir; }
/**
* Returns the value of the kind of output ( FILE, FOLDER, FILEORFOLDER ).
*
* @version 1.4
* @since 0.1.0
* @author Daniel PlÃ¼cken <daniel@debakel.net>
* @access public
* @return integer
*/
function getOutputKind()
{ return $this->outputKind; }
/**
* Sets the directory which content should be display by this select.
*
* @version 1.4
* @since 0.1.0
* @author Daniel PlÃ¼cken <daniel@debakel.net>
* @access public
* @return string
*/
function setDir( $dir )
{
$this->dir = $dir;
$this->refresh();
}
/**
* Sets the value of the kind of output ( FILE, FOLDER, FILEORFOLDER ).
*
* @version 1.4
* @since 0.1.0
* @author Daniel PlÃ¼cken <daniel@debakel.net>
* @access public
* @return integer
*/
function setOutputKind( $int )
{
$this->SOKH( $int );
$this->refresh();
}
/**
* This method is importantly only for private use of the class, otherwise
* there it can cause side effects, because the object attributes will not
* be refresh.
*
* @version 1.1
* @since 0.1.2
* @author Daniel PlÃ¼cken <daniel@debakel.net>
* @param integer $int
* @access private
* @return void
*/
function SOKH( $int )
{
if( $int >= 0 && $int <= 2 )
$this->outputKind = $int;
else
$this->outputKind = FILEORFOLDER;
}
/**
* This method refreshes the new entries.
*
* @version 1.1
* @since 0.1.2
* @author Daniel PlÃ¼cken <daniel@debakel.net>
* @access public
* @return void
*/
function refresh()
{
$this->FileSelect(
$this->name,
$this->dir,
$this->outputKind
);
}
} // End of class FileSelect
?>

Source for file FileSelect.class.php