Platon Technologies
not logged in Login Registration
EnglishSlovak
open source software development celebrating 10 years of open source development! Thursday, October 15, 2026
[BACK] [TXT][DIR] Up to [Platon] / phpWebFileManager / doc

Diff for phpWebFileManager/doc/README between version 1.3 and 1.4

version 1.3, 2002/04/21 23:37:22 version 1.4, 2002/07/01 09:03:45
Line 1 
Line 1 
   
 phpWebFileManager  phpWebFileManager
   
 file management PHP script designed for including into large projects  file management PHP script designed for including into large projects
   
 Ondrej 'Nepto' Jombik  Ondrej 'Nepto' Jombik
   
    Copyright © 2001, 2002 by Ondrej 'Nepto' Jombik  Copyright © 2001, 2002 by Platon software development group
      _________________________________________________________________  
   -------------------------------------------------------------------------------
   
   Table of Contents
   1. Introduction
   
       Overview
       Features
       Requirements
       Supported clients
   
   2. Usage
   
       Installation
       Configuration
   
           Original variables property
           Other properties
           File upload
           PostNuke compatibility
   
       Running
       Security notes
   
    Table of Contents  3. Other information
    1. Introduction  
   
         Overview  
         Features  
         Requirements  
         Supported clients  
   
    2. Usage  
   
         Installation  
         Configuration  
   
               Original variables property  
               Other properties  
               File upload  
               PostNuke compatibility  
   
         Running  
         Security notes  
   
    3. Other information  
   
         License  
         Request to users  
         Author and homepage  
         Version history  
      _________________________________________________________________  
   
       License
       Request to users
       Author and homepage
       Version history
   
   -------------------------------------------------------------------------------
   
 Chapter 1. Introduction  Chapter 1. Introduction
   
 Overview  Overview
   
    phpWebFileManager is file management PHP tool. It is designed for   phpWebFileManager is file management PHP tool. It is designed for including in
    including in large projects using appropriate PHP mechanisms (in  large projects using appropriate PHP mechanisms (in example include() or
    example include() or similar function).  similar function).
      _________________________________________________________________  
   -------------------------------------------------------------------------------
   
 Features  Features
   
      * secure directory browsing    * secure directory browsing
      * directory creating, renaming and removing  
      * file creating, uploading, renaming, deleting and viewing    * directory creating, renaming and removing
      * huge configuration ability to allow/deny appropriate actions  
      * PostNuke Rogue add-on compatibility    * file creating, uploading, renaming, deleting and viewing
      * multilanguage support  
      _________________________________________________________________  
   
     * huge configuration ability to allow/deny appropriate actions
   
     * PostNuke Rogue add-on compatibility
   
     * multilanguage support
   
   -------------------------------------------------------------------------------
   
 Requirements  Requirements
   
    phpWebFileManager requires PHP interpreter without any special   phpWebFileManager requires PHP interpreter without any special modules. It is
    modules. It is developed with with PHP 4.10.0. Although I haven't  developed with with PHP 4.10.0. Although I haven't tested it, it should work
    tested it, it should work also with another versions of PHP, even PHP  also with another versions of PHP, even PHP 3.x.x. Please notice me about
    3.x.x. Please notice me about particular compatibility capabilities.  particular compatibility capabilities.
      _________________________________________________________________  
   -------------------------------------------------------------------------------
   
 Supported clients  Supported clients
   
    Netscape Navigator, Opera, Mozilla, Konqueror, Microsoft Internet   Netscape Navigator, Opera, Mozilla, Konqueror, Microsoft Internet Explorer,
    Explorer, Lynx, Links and all others HTML compliant clients are  Lynx, Links and all others HTML compliant clients are supported. Nor Javascript
    supported. Nor Javascript nor other forms of client side scripting are  nor other forms of client side scripting are used.
    used.  
      _________________________________________________________________  -------------------------------------------------------------------------------
   
 Chapter 2. Usage  Chapter 2. Usage
   
 Installation  Installation
   
    Unpack archive to some directory, which could be accessed from Web.   Unpack archive to some directory, which could be accessed from Web.
   
    Change mode of created phpWebFileManager directory so it can be   Change mode of created phpWebFileManager directory so it can be accessed from
    accessed from Web. Command  Web. Command
   
    chmod -R u=rwX,g-rwx,o=rX phpWebFileManager/  chmod -R u=rwX,g-rwx,o=rX phpWebFileManager/
   
    will do the job. Installation is done.   will do the job. Installation is done.
      _________________________________________________________________  
   -------------------------------------------------------------------------------
   
 Configuration  Configuration
   
    Configuration variables are located in config.inc.php file.   Configuration variables are located in config.inc.php file.
      _________________________________________________________________  
   -------------------------------------------------------------------------------
   
 Original variables property  Original variables property
   
    Determine if you want to use phpWebFileManager as a standalone Web   Determine if you want to use phpWebFileManager as a standalone Web application
    application or you want to include it in some bigger project.  or you want to include it in some bigger project.
   
     *   If you want to use it as an standalone application, edit the config file
       and ignore $phpWebFileManager_ORIGINAL_VARIABLES variable.
   
      * If you want to use it as an standalone application, edit the    *   If you want to use as a part of some bigger project, edit the config file
        config file and ignore $phpWebFileManager_ORIGINAL_VARIABLES      with focusing on $phpWebFileManager_ORIGINAL_VARIABLES. phpWebFileManager
        variable.      provides itself a lot of actions such as confirm of deletion file and
      * If you want to use as a part of some bigger project, edit the      others. $phpWebFileManager_ORIGINAL_VARIABLES are variables, which will
        config file with focusing on      phpWebFileManager keep, so each page reload will be processed in right way
        $phpWebFileManager_ORIGINAL_VARIABLES. phpWebFileManager provides      by others components of your PHP script.
        itself a lot of actions such as confirm of deletion file and  
        others. $phpWebFileManager_ORIGINAL_VARIABLES are variables, which        If $phpWebFileManager_ORIGINAL_VARIABLES is not a constant, you can
        will phpWebFileManager keep, so each page reload will be processed      comment it out in config file and always set it in your main program to the
        in right way by others components of your PHP script.      right value before doing command which will include phpWebFileManager.php
        If $phpWebFileManager_ORIGINAL_VARIABLES is not a constant, you      file.
        can comment it out in config file and always set it in your main  
        program to the right value before doing command which will include  
        phpWebFileManager.php file.  
      _________________________________________________________________  
   
   -------------------------------------------------------------------------------
   
 Other properties  Other properties
   
    Than edit others variables in config file. More information about   Than edit others variables in config file. More information about every
    every specific variable are described in config.inc.php file.  specific variable are described in config.inc.php file.
      _________________________________________________________________  
   -------------------------------------------------------------------------------
   
 File upload  File upload
   
    If you want to provide file uploading, you must create world writeable   If you want to provide file uploading, you must create world writeable
    directory. Imagine that it is directory upload/, so than run command  directory. Imagine that it is directory upload/, so than run command
   
    chmod o+w upload/  chmod o+w upload/
   
    to make it world writeable.   to make it world writeable.
      _________________________________________________________________  
   -------------------------------------------------------------------------------
   
 PostNuke compatibility  PostNuke compatibility
   
    Since version 0.2.2 phpWebFileManager has an ability to act as a   Since version 0.2.2 phpWebFileManager has an ability to act as a PostNuke
    PostNuke Rogue module (add-on).  Rogue module (add-on).
   
    Simply copy the directory into modules/ subdirectory of your PostNuke   Simply copy the directory into modules/ subdirectory of your PostNuke
    installation. Than log into administration and in subsection Modules  installation. Than log into administration and in subsection Modules regenerate
    regenerate module list. You can than initialize and activate  module list. You can than initialize and activate phpWebFileManager module and
    phpWebFileManager module and if you like, make it accessible through  if you like, make it accessible through some block and so on.
    some block and so on.  
    You might want also use some of security features of PostNuke. If you choose
    You might want also use some of security features of PostNuke. If you  to have phpWebFileManager menu entry visible only for trusted user with admin
    choose to have phpWebFileManager menu entry visible only for trusted  rights, go to the administration subsection Permissions and make appropriate
    user with admin rights, go to the administration subsection  changes.
    Permissions and make appropriate changes.  
    PostNuke specific configuration is overriden in init.inc.php file. Note, that
    PostNuke specific configuration is overriden in init.inc.php file.  currently none from allow/deny file management actions features are used. This
    Note, that currently none from allow/deny file management actions  will probably change soon, when someone from the PostNuke community help me
    features are used. This will probably change soon, when someone from  with setting up particular rights according to internal PostNuke user
    the PostNuke community help me with setting up particular rights  information.
    according to internal PostNuke user information.  
      _________________________________________________________________  -------------------------------------------------------------------------------
   
 Running  Running
   
    If you have edited config file and wanted phpWebFileManager as a   If you have edited config file and wanted phpWebFileManager as a standalone
    standalone application, try to access phpWebFileManager using some web  application, try to access phpWebFileManager using some web browser.
    browser.  
    If you want to run it as a part of some other web application, write include()
    If you want to run it as a part of some other web application, write  or require() command with path and filename to file phpWebFileManager.php on
    include() or require() command with path and filename to file  the place, where you want to have file manager.
    phpWebFileManager.php on the place, where you want to have file  
    manager.  -------------------------------------------------------------------------------
      _________________________________________________________________  
   
 Security notes  Security notes
   
    If you want to secure phpWebFileManager, put security stuff commands   If you want to secure phpWebFileManager, put security stuff commands or
    or include() command to security stuff script at the beginning of  include() command to security stuff script at the beginning of config file.
    config file. That file is loaded by init.inc.php at the beggining of  That file is loaded by init.inc.php at the beggining of script execution.
    script execution.  
      _________________________________________________________________  -------------------------------------------------------------------------------
   
 Chapter 3. Other information  Chapter 3. Other information
   
 License  License
   
    Copyright (c) 2001-2002 Ondrej Jombik <nepto@pobox.sk>   Developed by Ondrej Jombík <nepto@pobox.sk>, http://nepto.sk/.
   
    Copyright (c) 2001-2002 Platon software development group, http://
   www.platon.sk/
   
    This program is free software; you can redistribute it and/or modify it under
   the terms of the GNU General Public License as published by the Free Software
   Foundation; either version 2, or (at your option) any later version.
   
    This program 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 General Public License for more details.
   
    You should have received a copy of the GNU General Public License along with
   this program; if not, write to the Free Software Foundation, Inc., 59 Temple
   Place - Suite 330, Boston, MA 02111-1307, USA.
   
   -------------------------------------------------------------------------------
   
   Request to users
   
    I have an incomplete mastery of the English language, so please help correct
   the text of the documents and messages in this program. Comments, suggestions,
   bug reports and patches are always welcome. Please e-mail them to the following
   <platon@pobox.sk> e-mail address and write 'phpWebFileManager' keyword in the
   Subject line.
   
    Likewise, if you don't find in language/ subdirectory a translation into your
   language, you can make one. But firstly ask me, if that translation is not
   already made, because you could not have actual version of phpWebFileManager.
   
   -------------------------------------------------------------------------------
   
   Author and homepage
   
    Author is Ondrej Jombik <nepto@pobox.sk>, http://nepto.sk/.
   
    Feel free to e-mail me any bug reports, suggestions and question about this
   PHP script.
   
    The latest official release of phpWebFileManager is available from: http://
   www.platon.sk/projects/phpWebFileManager/
   
   -------------------------------------------------------------------------------
   
   Version history
   
   Current version is 0.2.2 and it was released in 21st April 2002.
   
   version 0.2.2, April 21, 2002
   
     * fixed PostNuke port, init.inc.php file created for initialization
   
    This program is free software; you can redistribute it and/or modify    * new subdirectory lib/ created for phpPlatonLib functions, url_utils.lib.php
    it under the terms of the GNU General Public License as published by      file removed
    the Free Software Foundation; either version 2, or (at your option)  
    any later version.  
   
    This program 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  
    General Public License for more details.  
   
    You should have received a copy of the GNU General Public License  
    along with this program; if not, write to the Free Software  
    Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307,  
    USA.  
      _________________________________________________________________  
   
 Request to users    * various documentation update, Ken Kizaki's PN-MODULE-HOWTO added to
       distribution
   
   Changes by Rastislav 'Rider' Rihak <rider@lonestar.sk>:
   
    I have an incomplete mastery of the English language, so please help    * PostNuke Rogue port
    correct the text of the documents and messages in this program.  
    Comments, suggestions, bug reports and patches are always welcome.  
    Please e-mail them to the following address.  
   
    Likewise, if you don't find in language/ subdirectory a translation  
    into your language, you can make one. But firstly ask me, if that  
    translation is not already made, because you could not have actual  
    version of phpWebFileManager.  
      _________________________________________________________________  
   
 Author and homepage    * new multilanguage support system
   
     * startup redirection file index.php removed
   
   version 0.2.1, March 25, 2002
   
    Author is Ondrej Jombik <nepto@pobox.sk>, http://nepto.sk/.    * ability to overide date format in config file
   
    Feel free to e-mail me any bug reports, suggestions and question about    * support for enable/disable icons displaying
    this PHP script.  
   
    The latest official release of phpWebFileManager is available from:    * all variables were uncommented in config file to prevent its initialization
    http://www.platon.sk/projects/phpWebFileManager/      from CGI environment
      _________________________________________________________________  
   
 Version history  Changes by Ken Kizaki <ken_kizaki@yahoo.co.jp> and Daniel Fernandez <
   funkyferdy@econophone.ch>:
   
    Current version is 0.2.2 and it was released in 21st April 2002.    * german translation
   
    version 0.2.2, April 21, 2002  Changes by Greg Baker <ggbaker@cs.sfu.ca>:
   
     * file size and last modification date support
   
      * fixed PostNuke port, init.inc.php file created for initialization    * date format in language translation files
      * new subdirectory lib/ created for phpPlatonLib functions,  
        url_utils.lib.php file removed  
      * various documentation update, Ken Kizaki's PN-MODULE-HOWTO added  
        to distribution  
   
    Changes by Rastislav 'Rider' Rihak <rider@lonestar.sk>:  
   
      * PostNuke Rogue port  version 0.2, February 21, 2002 (official release)
      * new multilanguage support system  
      * startup redirection file index.php removed    * several features have been implemented, phpWebFileManager seems to be
       stable now, although according to TODO list, new things will be added soon
    version 0.2.1, March 25, 2002  
   
      * ability to overide date format in config file  version 0.1.8, February 16, 2002
      * support for enable/disable icons displaying  
      * all variables were uncommented in config file to prevent its    * multilanguage support
        initialization from CGI environment  
   
    Changes by Ken Kizaki <ken_kizaki@yahoo.co.jp> and Daniel Fernandez  
    <funkyferdy@econophone.ch>:  
   
      * german translation    * english and slovak translation added
   
    Changes by Greg Baker <ggbaker@cs.sfu.ca>:  
   
      * file size and last modification date support    * ability to deny symbolic links following
      * date format in language translation files  
   
    version 0.2, February 21, 2002 (official release)  
   
      * several features have been implemented, phpWebFileManager seems to    * add striping slashes from CGI variables to properly handle directories with
        be stable now, although according to TODO list, new things will be      quotation characters
        added soon  
   
    version 0.1.8, February 16, 2002  
   
      * multilanguage support    * quoted value parameters of all input tag
      * english and slovak translation added  
      * ability to deny symbolic links following  
      * add striping slashes from CGI variables to properly handle  
        directories with quotation characters  
      * quoted value parameters of all input tag  
      * HTML validity improvements  
      * documentation changes  
   
    version 0.1.7, December 18, 2001  
   
      * added parameters into config file to specify background color of    * HTML validity improvements
        even and odd rows  
      * fm_ prefix for CGI variables to avoid variable name collisions in  
        large projects  
   
    version 0.1.6, October 24, 2001  
   
      * finally valid handling of all file and directory names (with    * documentation changes
        spaces, ampersands, quotes, etc) and also valid HTML references  
        (links) creating using appropriate functions urlencode() and  
        htmlentities()  
   
    version 0.1.5, October 1, 2001  
   
      * added $phpWebFileManager_LINKS_PREFIX parameter to build links for  version 0.1.7, December 18, 2001
        View feature; if it is not present HTML links are built in  
        standart way    * added parameters into config file to specify background color of even and
       odd rows
    version 0.1.4, September 26, 2001  
   
      * added ability to allow user to turn on/off View/Enter, Rename    * fm_ prefix for CGI variables to avoid variable name collisions in large
        Delete/Remove and Create/Upload functionality with focus on      projects
        security  
   
    version 0.1.3, August 23, 2001  
   
    Changes by Paul Grace <paulgrace@telstra.com>:  version 0.1.6, October 24, 2001
   
     * finally valid handling of all file and directory names (with spaces,
       ampersands, quotes, etc) and also valid HTML references (links) creating
       using appropriate functions urlencode() and htmlentities()
   
      * directories with spaces handling  version 0.1.5, October 1, 2001
      * alphabetical directory sorting  
     * added $phpWebFileManager_LINKS_PREFIX parameter to build links for View
    version 0.1.2, July 31, 2001      feature; if it is not present HTML links are built in standart way
   
      * documentation and TODO list update  version 0.1.4, September 26, 2001
   
    version 0.1.1, July 27, 2001    * added ability to allow user to turn on/off View/Enter, Rename Delete/Remove
       and Create/Upload functionality with focus on security
   
      * change relative redirect to absolute in index.php (RFC2068)  version 0.1.3, August 23, 2001
      * fixing file view  
   Changes by Paul Grace <paulgrace@telstra.com>:
    version 0.1, July 22, 2001 (official release)  
     * directories with spaces handling
   
     * alphabetical directory sorting
   
   version 0.1.2, July 31, 2001
   
     * documentation and TODO list update
   
   version 0.1.1, July 27, 2001
   
     * change relative redirect to absolute in index.php (RFC2068)
   
     * fixing file view
   
   version 0.1, July 22, 2001 (official release)
   
     * initial release
   
      * initial release  
Legend:
Removed from v.1.3  
changed lines
  Added in v.1.4
Platon Group <platon@platon.org> http://platon.org/
Copyright © 2002-2006 Platon Group
Site powered by Metafox CMS 		Go to Top