0. Index	Version 0.3.4
================================
  1. Version History
  1b Known bugs
  2. Client - Minimum Requirements
  3. Server - Minimum Requirements
  4. Setting up PH Pexplorer
  4a php.ini
  5. index.php
  6. Languages
  7. Used scripts
  8. PDF-Thumbnails
  9. License
  A. Warning
  B. Language Lessons
  C. About


1. Version History
===================
  (Legend: +F -> Feature added; +B -> Bug fixed; G General)
  0.3.4:
      +B Ajax request for updates was blocked for clients browser by default 
  0.3.3:
      +F Check for updates while filebrowsing
       G admin can handle upload time out notification -> $f_info_cancel_upload
      +F Some new attribute and all of them sortable in detailed view
      +B Diashow did't work with IE 6 or lower.
  0.3.2:
      +B Inability to show timeup message while loading with english language
  0.3.1:
      +B Inability to create folders with french language-> thx to Florent
      +B Wrong shorthand symbol for spanish language: Couldn't recoginze
         spanish language
  0.30:
      +B PDF->Image feature improved. Should generate less duplicates within
         certain limitations
       G Message: call by reference... removed
  0.29:
      +B HTML-viewer should work now with PHP4 too.
       G HTML-viewer generally improved
      +F ffmpeg: Thumbnails of movie files possible if extension available
      +B Similar folders will no longer cascade both of them
       G GD:Invalid images no longer results in grey pics but transparent
         ones 
      +F Simple text viewer added
  0.28:
      +B Continued downloads will continue faster (especially huge files)
      +F HTML viewer added
      +F Hex viewer added
      +F Pic viewer with featured diashow added
  0.27:
      +B Security leak enables to delete any file fixed.
      +B Upload time exeed Popup Text is now visible.
         Time interval is fixed.
         Handling the answer to that messege correct.
      +B Background color of filemenu and detail's border can be change
      +B Used to don't show root folder if it didn't contain a subfolder 
      +B Running in mode reporting all errors made it impossible to
         authenticate (headers already sent)
  0.26:
       G Added a border to the folders tree
       G No preview pics while in clip mode
      +F Detail's view added
      +F spanish language file by Gerardo <- thx
      +F serbish language file by Sasa    <- thx
      +F Due to some requests a simple login has been added for apache
         webservers
      +B Redirecting after failed copying should work now.
      +B Renaming, moving, etc. names containing ' is now possible without
         resulting in an error message or leading - in name be4 '-sign
      +B Impossible menu action in folder containing ' in their paths
      +B Redirecting after unsuccesfull copy action.
      +F chmod-ing
  0.25:
      +B Security leak caused by malformed cookie fixed (discovered by
	     Kacper)
  0.24:
      +B Security leak fixed (thx to Jan)
      +B Now paths ending with "../" are possible
	   G Removed code from setting.php to setset.php
  0.23:
      +B Display bug (FF,IE) from filename in menu of fileview's removed
      +F Multithread and continued downloads possible
      +B Names with ' - bug removed (still can't unpack zips)
      +B Upload time limit message included
      +F Language recognition bug: if no prefered language send; removed
	  
	  
1b Known bugs
=================================	
  - Uploading files containing ' in their name will loose this sign
    and have to be renamed afterwards. (depends on php)
  - Only language supported by the php's filesystem are latin and
    western european letters. (depends on php)  
	  
2. Client - Minimum requirements
=================================
  - Javascript enabled and cookie accepting, modern Browser like:
    o Internet Explorer 5
    o Opera 6
    o Safari, Firefox, Konquerer


3. Server - Minimum requirements
=================================
  Minimum:     Webserver with PHP4 or higher
  Recommendet: PHP4 with GD and ffmpeg extensions installed
  Supported:   PDF to Image converter


4. Setting up PH Pexplorer
=================================
  Open 'explorer_settings.php' and make changes as you want. There is also a
  very simple login script that you can include by deleting the leading // in
  the	'explorer_settings.php'-file on line 74:
  include_once('pwdcheck.php');
  To add a user open 'pwdcheck.php' and add or modify users as given in the
  example. Between the entries there should be a komma and the entries
  themselves should be like:
				 'username' => 'password',
				 'username2' => 'password2',
				 'username3' => 'password3'


4a php.ini
=================================
  Depending on your configuration you've made in step 1, you 
  may have to configure your 'php.ini' file (as it is written 
  in 'explorer_settings.php') and restart your webserver.


5. index.php
=================================
  If you want PH Pexplorer to be the default page of this folder you can rename 
  the file 'explorer.php' to 'index.php'.


6. Languages
=================================
  PH Pexplorer offers multi-language support. To translate it to your favourite 
  language behave as follow:
   1. Go to "lng_fls/" select a file that contains a language you understand 
      like 'explorer_<language>.php'
   2. Copy this file and rename it to 'explorer_<new language>.php'
   3. Open it with your favourite editor and replace everything between 
      quotation marks. (Take care, some phrases are displayed in JavaScript 
      alert boxes)

  To test it:
   4. Delete the cookie and change your favourite language in your browser to 
      the edited one.
	    -- OR --
   5. Move all the other language files away from "lng_fls/", test it and move 
      the language files back.

  Final step:
   6. Send me a copy.


7. Used scripts
=================================
  For some php not compiled with gzcompress I used a script by Alexande Tedeschi
  To zip files I used a zip class by Denis O. Philippov from 
  http://www.atlant.ru .
  To extract zip files I used PhpZipLib from http://www.phpconcept.net .


8. PDF-Thumbnails
=================================
  To generate PDF thumbnails or clips I userd PDF2Image v2.0 running on Windows.
  Unfortunately that program is not free.
  By the way if you know a php script that is able to generate images or GD streams
  from pdf files please contact me.


9. License
=================================
  PH Pexplore is published under GNU/GPL license.
  This program is free and you can use it at no cost.
	
  HOWEVER, if you release a script, an application, a library or any kind of
  code including PH Pexplorer YOU MUST :
  - Release your work under GNU/GPL license (free software),
  - You must indicate in the documentation (or a readme file), that your work
    with PH Pexplore , and make a reference to the author and the web site 
    http://www.bluevirus.ch.vu


A. Warning
=================================
  This application and the associated files are non commercial, non professional
  work. It should not have unexpected results. However if any damage is caused
  by this software the author can not be held responsible.

  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. 

  The use of this software is at the risk of the user.


B. Language Lessons
=================================
  If you think my english, french or german is bad I have to say that I am
  always happy to be offered a language course ;-)


C. About
=================================
  PH Pexplorer is made by bluevirus design
  URL : www.bluevirus.ch.vu
  
  If you like my program and want to appreciate my work you are free to pay.