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