Congratulations on purchasing the File Transfer Module!
1. Easy to launch It's very simple to launch it, just login 123FlashChat Admin Panel-> Module Settings-> File Transfer and check "Enable File Transfer". And additionally, the user privileges can be configured here, You will see six checkboxes to allow the admin, moderator, speaker, registered user or guest to transfer file or not.
2. HTTP server VS. PHP mode?
Since the module involves a server to store the files, and 123FlashChat has an internal HTTP server, no extra configuration is needed, unless snappier performance is expected to deal with multiple concurrent file transfer requests or to achieve faster speed, and in that case PHP mode will be recommended.
3. Advanced settings for HTTP server mode
(1) Change upload filesize limit
By default the filesize limit is 1M, to change it,
please open
<123flashchat server install directory>/server/etc/fcserver.xml find
<http-server port="35555" maxUpLoadSize="5120" enable="On" documentRoot="..\client" ip="*">
<file-allow-access></file-allow-access>
</http-server>
modify maxUpLoad Size, 5120 indicates 5120KB= 5MB, (this is a global setting which also constrains the Image Transfer module and the Upload/Webcam Avatar module, so it's quite big.) Edit max upload file size, the unit is KB.
Note, there is a similar setting in Admin Panel-> Module Settings-> File Transfer, and the max filesize there will be subject to the value in fcserver.xml.
(2) Limit file extension Login Admin Panel-> Module Settings-> File Transfer
Edit the file extensions,
For example, *.mp3, *.jpg, which means only mp3 and jpg can be transferred.
"*" or "*.*" indicates all types are allowed, however it's not recommended to stop virus from speading.
(3) Enhance performance You will need to do the following configuration. (i)
Open
<123flashchat server install directory>/server/etc/fcserver.xml
Find
<http-listen-workers>5</http-listen-workers>
Change it to a suitable value between 20 and 50.
Find
<http-message-handle-workers>10</http-message-handle-workers>
Change it to a suitable value between 20 and 50. (ii)
If you're using a Linux/Unix server, adjust the memory allocation for the server as follows:
cd <123flashchat installation directory>/server
vi fcserver.vmoptions At the last line of this file, there is a symbol "#", remove it and adjust the value followed by the Xmx, then save it.
./fcserver stop
./fcserver start Note
(i) Please ensure there's a file "crossdomain.xml" under "documentRoot" in fcserver.xml.
(ii) The uploaded files are saved in <123flashchat server installe directory>/server/filetransfer, for the security reason, this folder can't be changed or moved. And this folder should be readable and writeable.
(iii) Login admin panel-> Module Settings-> File Transfer, the Upload URL and Download URL must be left blank if you're using 123FlashChat HTTP server method.
(iv) Please restart chat server if you've edited the fcserver.xml.
4. PHP method The PHP mode is recommended if a chat room with busy traffic is involved, to achieve faster speed and better performance. (1) Configurations Open "config.php" in the file transfer module package and configure it: - MAX_ALLOW_FILE_SIZE: the max upload file size (unit: bytes)
- FILE_PATH: the upload file path. It's not supposed to be under the Apache or IIS document root path, Because for the security reason, the uploaded files should never be accessed from a HTTP URL directly. Please also ensure that the upload file path is readable and writeable by Apache or your webserver
- ALLOW_FILE_EXTS: the supported file extension types, e.g., $ALLOW_FILE_EXTS = ".jpeg,.jpg". Leave it blank to tolerate all kinds of file extension types.
- $ALLOW_FILE_MIMES: the supported file extension types, e.g., $$ALLOW_FILE_EXTS = ".jpeg,.jpg"; Leave it blank to tolerate all kinds of file extension type. (2) Copy PHP files and crossdomain.xml Copy all the PHP files in the filetransfer package to some folder under web server directory, because they will be needed to be accessed from the HTTP address.
Copy the crossdomain.xml in the filetransfer package to the document root folder of the file transfer HTTP address. (3) Configure Admin Panel Login 123 Flash Chat Admin Panel ->Module Settings->File Transfer Panel, i) Find: Upload URL, configure it to the HTTP URL which directs to uploadFile.php, ii) Find: Download URL, configure it to the HTTP URL which points to downloadFile.php. (4) Edit PHP.ini Find the option 'file_uploads', change the value to 'On'. Find the option 'upload_max_filesize', change the value to the same with 'MAX_ALLOW_FILE_SIZE' in config.php. Then restart Apache or your webserver. |
