--- /dev/null
+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
\ No newline at end of file
projects / mw_pages / blobdiff