import mtweb.0.4.1

[mtweb] / web / libs / tiny_mce / plugins / tinybrowser / readme.txt

TinyBrowser 1.41 - A TinyMCE file browser (C) 2008  Bryn Jones\r
(author website - http://www.lunarvis.com)\r
\r
    This program is free software: you can redistribute it and/or modify\r
    it under the terms of the GNU General Public License as published by\r
    the Free Software Foundation, either version 3 of the License, or\r
    (at your option) any later version.\r
\r
    This program is distributed in the hope that it will be useful,\r
    but WITHOUT ANY WARRANTY; without even the implied warranty of\r
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the\r
    GNU General Public License for more details.\r
\r
    You should have received a copy of the GNU General Public License\r
    along with this program.  If not, see <http://www.gnu.org/licenses/>.\r
\r
\r
TinyBrowser Features:\r
=====================\r
\r
- Integrates as a custom file browser within TinyMCE for image, media and 'all'\r
  file types, or can work in stand-alone mode\r
\r
- Adobe Flash based file uploader, supporting multiple file selection and upload\r
  with file type and size filtering (permission based)\r
\r
- Browse files with a list view or as thumbnails (images only), with optional\r
  pagination\r
\r
- List view has image thumbnail on hover\r
\r
- File display order customisable e.g. by name, type, size, date\r
\r
- Find function to filter results by search string \r
\r
- Display detailed file information such as type, size and dimensions (images\r
  only)\r
\r
- File deletion facility (permission based)\r
\r
- File edit facility (permission based) - rename, resize and rotate (last two\r
  images only)\r
  \r
- Folder browsing and creation\r
\r
- File storage location user definable for each file type\r
\r
- Optional session control\r
\r
- Multi-lingual support with language definition files\r
\r
- Many user definable settings, all from central configuration file\r
\r
\r
TinyBrowser Background\r
======================\r
\r
I created TinyBrowser as I couldn't find the right TinyMCE file browser for my\r
needs, particularly the ability to select and upload multiple files in an easy\r
way.\r
\r
\r
Version Notes\r
=============\r
\r
TinyBrowser 1.41 - released 05/05/2009\r
--------------------------------------\r
New Features:\r
Added folder argument to tinyBrowserPopUp function, so that a sub-folder can be\r
selected when using TinyBrowser in standalone mode.\r
Added error logging - errors are output to error.log in tinybrowser directory.\r
Added Spanish, Croatian, Slovakian, Latvian, Czech, Italian, Hungarian, Swedish\r
and Russian language files (thanks to all who contributed).\r
\r
Changes:\r
Prohibited files are no longer browseable (if the paths defined contained files\r
of this type).\r
Only defined file extensions of a file type are browseable and editable.\r
Changed stripos function to strpos to ensure PHP4 compatability.\r
Updated createfolder function to work recursively with PHP4.\r
Remember current folder after upload.\r
Changed filename clean regex to be less strict.\r
\r
Bug Fixes:\r
Fixed transparency support for gif and png (thanks to Dirk Bohl).\r
Added 'no-cache' meta tag to ensure latest page is served by web browser.\r
Added another fix for no style issue with TinyMCE integration.\r
Security fix for browse type when set to non-existant value.\r
Security fix for malicious setting of folder get variable to relative values.\r
\r
TinyBrowser 1.40 - released N/A\r
--------------------------------------\r
New Features:\r
Added multiple folder support with a separate Folders tab to allow folder\r
creation, renaming and deletion.\r
Added Move action to Edit tab, to allow moving of files between folders.\r
Added Danish language file.\r
Added 'delayprocess' to config file - this can be set if server response is\r
delayed, preventing uploaded files being processed correctly.\r
Added width and height config values for the TinyBrowser pop up window size.\r
Added 'cleanfilename' flag to config file, to remove disallowed characters\r
from filenames on upload (set to true by default).\r
  \r
Changes:\r
Added recursive flag to createfolder function, to allow TinyBrowser to \r
create full upload path.\r
Changed default window size to 770px x 480px.\r
Minor code optimisation.\r
Prohibited files are now not browseable (if the paths defined contained files of\r
this type).\r
Now only defined file extensions of a file type are browseable and editable.\r
Changed stripos function call to strpos to ensure PHP4 compatability.\r
Updated createfolder function to work recursively with PHP4.\r
Remember current folder after upload.\r
\r
Bug Fixes:\r
Fixed minor bug causing elementid to be lost after file upload in\r
stand-alone mode.\r
Fixed stand-alone javascript selectURL function bug that prevented \r
TinyBrowser window close on selection. \r
Fixed bug in Flash upload that prevented folder permission error reporting.\r
Fixed bug in image resize and rotate functions that converted all types\r
to jpeg.\r
\r
TinyBrowser 1.33 - released 23/09/2008\r
--------------------------------------\r
New Features:\r
Added German, Finnish, Traditional and Simplified Chinese language files.\r
Added session control workaround for upload_file.php (called by Flash).\r
\r
Changes:\r
Flash uploader has been modified to display the file type and also to fix\r
strange progress bar behaviour when uploading multiple files. As the\r
upload process is not concurrent, I have removed the individual progress\r
bars and replaced them with one (progress is still per file however).\r
When the Upload button is pressed all the buttons now disappear.\r
\r
Bug Fixes:\r
Fixed minor bug that affected css layout after file upload.\r
Fixed bug introduced in 1.32 that prevented automatic image resize on\r
upload.\r
Added 'HTTP/1.1 200' response to upload_file.php script, to address\r
Flash bug in some Mac setups.\r
Added check for valid images in Browse and Edit tabs - non-image files\r
are still listed but error producing image properties code is bypassed.\r
        \r
\r
TinyBrowser 1.32 - released 17/09/2008\r
--------------------------------------\r
New Features:\r
None.\r
\r
Changes:\r
The upload path is now passed to the Flash upload widget, for better\r
compatibility with Firefox and Opera when you set your paths using session\r
variables (this is due to a Flash bug that loses session data).\r
Files are no longer uploaded to a temporary directory, so there's now no\r
folder creation during the upload process. Instead, file name extensions\r
are suffixed with an underscore until processed. (This renders them\r
useless until verification).\r
The thumbs directory has been changed to '_thumbs'.\r
\r
Bug Fixes:\r
Fixed security hole - previously, it was possible to directly\r
submit files to the upload_file.php script. Due to the Flash session bug,\r
normal session control does not work. Instead, a hash string check has been\r
added to the upload_file.php script and the installation instructions\r
amended.\r
   \r
TinyBrowser 1.31 - released 16/09/2008\r
--------------------------------------\r
New Features:\r
None.\r
\r
Changes:\r
Added prohibited files logic to the file_upload.php script (previously\r
located only in file_process.php script).\r
Changed duplicate file handling behaviour - TinyBrowser now discards\r
files with the same name.\r
\r
Bug Fixes:\r
None.\r
\r
TinyBrowser 1.30 - released 12/09/2008\r
--------------------------------------\r
New Features:\r
'Stand-alone' mode, for use without TinyMCE.\r
Optional and configurable pagination, to break results down into pages.\r
New configuration option, $tinybrowser['link'], allows the passback link to\r
be different to the upload path.\r
Added automatic creation of upload directories (with definable chmod for Unix\r
servers).\r
Added alert messages for errors and actions.\r
Multi-lingual support - credit to Francis Rebouças \r
(francisreboucas[at]gmail[dot]com) for idea, design, implementation and \r
Portugese language file.\r
Experimental support for FCKeditor.\r
\r
Changes:\r
Rationalised TinyBrowser file and folder names and structure (brought in line\r
with TinyMCE plugin specification).\r
Revised documentation.\r
After file upload user is now directed back to upload tab instead of the\r
browse tab.\r
   \r
Bug Fixes:\r
Fixed security hole - prohibited file extensions not obeyed due to error in\r
inherited code. \r
Fixed small issue with edit / delete permissions (not consistently hiding\r
edit tab).\r
\r
TinyBrowser 1.20 - released 20/08/2008\r
--------------------------------------\r
New Features:\r
Added thumbnail on hover for detail view (images only). Note: not working in\r
IE6.\r
Added Edit tab - allows file rename, resize and rotate (last two for images\r
only). Also moved delete action to here.\r
Added configurable automatic image resize on upload.\r
\r
Changes:\r
Moved file thumbnail generation to upload process.\r
Changed table css to match Flash upload.\r
Improved thumbnail view layout.\r
Removed the form select elements for sort by and type, and made the table\r
column headers clickable.\r
\r
Bug Fixes:\r
Changed default $tinymce['docroot'] value to\r
rtrim($_SERVER['DOCUMENT_ROOT'],'/') - this fixes an issue with server setups\r
that return a value with a '/' suffix.\r
Removed .htaccess file after various bug reports - doesn't appear to be\r
required for majority of server setups.\r
Fixed silly bug with thumbnail urls that could prevent generation and viewing\r
under some server setups.\r
Fixed various other minor bugs and tidied code.\r
\r
TinyBrowser 1.10 \r
----------------\r
Adjusted layout of file upload.\r
Added facility to limit permitted file upload size (separate values for each\r
file type).\r
Amended installation instructions for clarity.\r
Tested as working in Opera 9.\r
\r
TinyBrowser 1.00\r
----------------\r
Tested in Firefox 2 and 3, Internet Explorer 6 and 7 and Safari 3.\r
Requires Adobe Flash Player 9.\r
\r
\r
Requirements\r
============\r
\r
Adobe Flash Player 8 +\r
PHP enabled server\r
\r
Supported browsers:\r
Internet Explorer 6 +\r
Firefox 2 +\r
Safari 3 +\r
Opera 9 +\r
Google Chrome\r
\r
\r
Language Definition Files\r
=========================\r
\r
English (en)\r
Chinese Simplified (zh-cn)\r
Chinese Traditional (zh-tw)\r
Croatian (hr)\r
Czech (cs)\r
Danish (da)\r
Dutch (nl)\r
Finnish (fi)\r
French (fr)\r
German (de)\r
Hungarian (hu)\r
Italian (it)\r
Latvian (lv)\r
Polish (pl)\r
Portuguese (pt)\r
Russian (ru)\r
Slovak (sk)\r
Spanish (es)\r
Swedish (sv)\r
\r
\r
\r
Known Issues\r
============\r
\r
None.\r
\r
\r
Troubleshooting\r
===============\r
\r
If you receive a 403, 406 or 412 status error on uploading files, please create\r
an .htaccess file in your tinybrowser directory with the following contents:\r
\r
SecFilterEngine Off\r
SecFilterScanPOST Off\r
\r
If you use Linux and the Squid proxy, you need to add a "ignore_expect_100 on"\r
flag to the squid config file to avoid a 417 status error.\r
\r
\r
TinyBrowser Installation Method 1\r
=================================\r
\r
The standard TinyBrowser installation, this integrates TinyBrowser as a custom\r
file browseer with TinyMCE.\r
\r
1) Copy the tinybrowser folder and contents to your TinyMCE plugins directory.\r
\r
2) Place the following javascript link after the link to TinyMCE (tiny_mce.js):\r
\r
   <script type="text/javascript"\r
   src="/tiny_mce/plugins/tinybrowser/tb_tinymce.js.php"></script>\r
\r
   ***NOTE:*** The above link assumes TinyMCE is installed in your website root\r
   directory, you will need to amend the link to your specific setup!\r
\r
3) Add this line to your TinyMCE init:\r
\r
   file_browser_callback : "tinyBrowser"\r
\r
4) Edit the TinyBrowser configuration file (config_tinybrowser.php). The most\r
   important settings are the file paths (these will be automatically created on\r
   your server by TinyBrowser if they do not exist) and also the 'obfuscate'\r
   property, which should be set to a random value.\r
\r
   ***NOTE:*** If your server is Unix-based. you may wish to modify the \r
   $tinybrowser['unixpermissions'] config value, which decides permissions.\r
\r
5) All done! Now you will see a browse button in the TinyMCE dialog windows for\r
   plugins like image, media and link - just click this button and TinyBrowser\r
   will appear.\r
\r
\r
TinyBrowser Installation Method 2\r
=================================\r
\r
This installation allows TinyBrowser to be used in 'stand-alone' mode, for\r
integration with any web application.\r
\r
1) Copy the tinybrowser folder and contents to your server.\r
\r
2) Place the following javascript link within the <head> tag on the page you\r
   require TinyBrowser:\r
\r
   <script language="javascript" type="text/javascript"\r
   src="/tinybrowser/tb_standalone.js.php"></script>\r
\r
   ***NOTE:*** The above link assumes TinyBrowser is installed in your website\r
   root directory, you will need to amend the link to your specific setup!\r
\r
3) Edit the TinyBrowser configuration file (config_tinybrowser.php). The most\r
   important settings are the file paths (these will be automatically created on\r
   your server by TinyBrowser if they do not exist) and also the 'obfuscate'\r
   property, which should be set to a random value.\r
\r
   ***NOTE:*** If your server is Unix-based. you may wish to modify the\r
   $tinybrowser['unixpermissions'] config value, which decides permissions.\r
\r
4) To launch TinyBrowser use the following javascript function:\r
\r
   tinyBrowserPopUp('type','elementid');\r
\r
   'type' can contain 'image', 'media' or 'file' - corresponding to the type of\r
   file you want TinyBrowser to manage.\r
\r
   'elementid' is the id of the page element you want populate with the file url\r
   TinyBrowser returns - this is generally a form text input. If you want to\r
   immediately display the image then create an <img> tag with the same element\r
   id, only suffixed with img - e.g. elementidimg.\r
\r
   \r
TinyBrowser Installation Method 3\r
=================================\r
\r
This installation method integrates TinyBrowser as a custom file browser with\r
FCKeditor.\r
\r
1) Copy the tinybrowser folder and contents to your server.\r
\r
2) Edit your fckconfig.js file as follows (replace existing lines).\r
\r
   To enable TinyBrowser for files:\r
   FCKConfig.LinkBrowserURL = '/yourtinybrowserurl/tinybrowser.php?type=file';\r
\r
   To enable TinyBrowser for images:\r
   FCKConfig.ImageBrowserURL = '/yourtinybrowserurl/tinybrowser.php?type=image';\r
\r
   To enable TinyBrowser for Flash:\r
   FCKConfig.FlashBrowserURL = '/yourtinybrowserurl/tinybrowser.php?type=media';\r
\r
   If you wish to disable the default FCKeditor file uploads (recommended), set\r
   the following:\r
   FCKConfig.LinkUpload = false;\r
   FCKConfig.ImageUpload = false;\r
   FCKConfig.FlashUpload = false;\r
\r
3) Edit the TinyBrowser configuration file (config_tinybrowser.php).\r
\r
   Change the $tinybrowser['integration'] line:\r
   $tinybrowser['integration'] = 'fckeditor';\r
\r
   The other most important settings are the file paths (these will be\r
   automatically created on your server by TinyBrowser if they do not exist) and\r
   the 'obfuscate' property, which should be set to a random value.\r
\r
   ***NOTE:*** If your server is Unix-based. you may wish to modify the\r
   $tinybrowser['unixpermissions'] config value, which decides permissions.\r
\r
4) All done! Now when you click the Browse Server button in the FCKeditor dialog\r
   windows for image, Flash and link, TinyBrowser will appear instead of the\r
   standard FCKeditor file browser.\r
\r
\r
Contact\r
=======\r
\r
Please notify me by email bryn[at]lunarvis[dot]com if you notice any bugs or\r
have ideas for new features.\r
\r
-----------------------------\r
File Last Modified 05/05/2009