uCloud v2.1.1

Securely Manage, Preview & Share Your Files


Thank you for purchasing uCloud. If you have any questions that are beyond the scope of this help file, please feel free to log a support request via our support portal. Thanks so much!

uCloud is a fully featured, quick and secure file manager.

It's been built for users and businesses who which to quickly organise, manage and share their files via a web browser.

You can upload large files (>5GB) with built in file chunking, manage files into folders, set folder/file passwords and/or access permissions, preview a huge amount of files directly within the browser, resize images, setup multiple users, expand using multiple file server storage and manage everything via the feature rich admin area.

uCloud has been designed to be easy to install, the config file and database is automatically created during the installation wizard. You simply need a web hosting account and one free MySQL database (no programming knowledge is required).

If you have any issues with installation or even after you've started using the script, please leave a comment via CodeCanyon and we will get back to you as soon as possible.

uCloud has been built using our own internal framework that is extremely robust and efficient. We've been using it on all our scripts at MFScripts for over 7 years! It's well tested by over 4,200 users.

Whenever we release a new version of uCloud you'll be notified via the script admin area of the new release. If you're still within your support period you can download it free of charge via CodeCanyon.

Please note: If you modify the code and upgrade may overwrite your own code changes. You should make note of any changes you make so you can easily re-apply them if needed.

These are the primary features of uCloud:

We have our own support portal that includes a support ticket system, knowledge base and forums, please register via our forum for full access.

Note: You will need to be have a valid license & within your support period to access the ticketing system. You have lifetime access to the support forum and knowledge base included within your purchase.

uCloud is written in PHP7.0 and uses a MySQL5 database. uCloud is a "Web Application" that must be installed on a Web Server.

You must install uCloud on a web host that supports PHP7.0, MySQL5 and Apache or Nginx.

You may also install uCloud on your personal computer by using one of the many options (i.e google WAMPserver or XAMPP), this is not covered in this document.

The full system requirements can be found below.

Installation Wizard

We've built an installation wizard into the script to make it really easily to get started. 

  1. Download the zip file from CodeCanyon.
  2. Extract the contents into a folder on your computer.
  3. Using a FTP client (such as FileZilla), upload the extracted contents to your web host. Note: You can install uCloud as the main site, in a sub-folder on your existing web hosting or setup a new subdomain.
  4. While it's uploading you can create the database. Login via your web host control panel (such as cPanel) and create an empty database.
  5. Setup a new MySQL user and ensure you assign it to your new database with all privileges. Note your new MySQL username, database and password for later.
  6. Once the FTP upload has completed, via your web browser go to: 

  1. Follow the steps shown in the install wizard. Enter your MySQL details when prompted and the database will be automatically installed.
  2. Setup the cron tasks, links provided within the installer, or here - https://support.mfscripts.com/public/kb_view/26/ every 5 minutes (more info below in the CRON section).
  3. Done - Enjoy!

If you have any issues with the installation, please see the troubleshooting section of this document.

File & Folder Permissions

During the uCloud install 1 file and 4 folders will need write permissions. Ensure the following have CHMOD 755 (or 777 depending on what your web host allows)

The cron tasks enable uCloud to send emails, tidy data (and other tasks) in the background. Please ensure these are setup as they are required by the script.

There are a number of ways to set these up. The best method is to use a Linux Cron style setup on the server itself. This will be the most reliable method. Although you can use one of the many free web cron services, these often only work once every 10-15 minutes, meaning that crons will take longer between runs.

Linux Crons

  1. Type crontab -e in your linux command line.
  2. Type in the following:
0 0 * * * php /path/to/your/install/app/tasks/auto_prune.cron.php >> /dev/null 2>&1
0 0 * * * php /path/to/your/install/app/tasks/create_internal_notifications.cron.php >> /dev/null 2>&1
0 * * * * php /path/to/your/install/app/tasks/delete_redundant_files.cron.php >> /dev/null 2>&1
0 0 * * * php /path/to/your/install/app/tasks/downgrade_accounts.cron.php >> /dev/null 2>&1
*/5 * * * * php /path/to/your/install/app/tasks/process_file_queue.cron.php >> /dev/null 2>&1
0 1 * * * php /path/to/your/install/app/tasks/create_email_notifications.cron.php >> /dev/null 2>&1
  1. Save
  2. crontab -l should now list the cron process

If you do not have access to the command line you might have access to the web hosting control panel that should allow this. Otherwise talk with your webhost.

Upgrading is fairly straight forward. Use the following guide to upgrade your existing install to a new release.

IMPORTANT: If you're upgrading from prior 2.x, please see the "Upgrade from v1.x" guidance on the /install page.

  1. Download the latest version of the uCloud zip file
  2. Backup your MySQL database, any /files/ and the _config.inc.php file.
  3. Backup any custom code or changes you have made (these may be overwritten).
  4. Unzip the newly downloaded zip file onto your local computer.
  5. Upload these folders & contents to your install - /app, /plugins & /themes.
  6. Within your hosting control panel, load phpMyAdmin and select your new database. In the right-hand section click on 'import'. Attach the the relevant sql patches from the directory `/install/resources/upgrade_sql_statements/` and submit the form. Choose all the patches between your current script version number and the latest, ensuring you do them in version number order. If there are none, you can ignore this step.
  7. Purge the application cache - you can do this via the script admin area, in site configuration.
  8. Done - Enjoy the upgrade!

The website settings can be found via the admin area. To access:

  1. Login via the /admin url using your site admin credentials.
  2. On the top menu hover over 'Configuration', then click on 'Site Settings'.
  3. You'll see a screen similar to the following:

  1. All the settings are categoried on the left-hand side. By clicking on any of these it will filter the view on the main part of the page.
  2. To edit, click 'edit' on any of the values.
  3. Any changes are immediately reflected on the site.

uCloud supports any number of languages. All the text content is routed through the translations module and can be translated.

Add New Language

  1. Login to the admin area.
  2. Via the Configuration menu, click Translations.
  3. Click the 'Add Language' button.
  4. Set the language name, Text Direction (only LTR) supported for now and the flag.
  5. Once added click on 'manage translations' and you'll see each text entry that you can edit.
  6. You can also export & import translations on the same screen if you'd prefer to edit them offline.
  7. To set as the main site language click the 'Default' checkbox on the 'Manage Languages' screen.

Note: You may need to logout and back in to see the new language take affect.

Translate Text Content

  1. Load the 'languages' page within the admin area.

  1. Click 'manage translations' and search for the text you'd like to translation.
  2. Once you've found it, click 'edit'.
  3. Click 'update' once you're done. The translation will be immediately available on your site.

You can create your own themes within uCloud so future updates to the theme part of the script don't overwrite any custom changes.

1) Create a new directory named your theme in /themes/. Lowercase alphanumeric and underscores only. i.e.

/themes/yourtheme/

2) Copy the contents of /themes/cloudable/ into /themes/yourtheme/

3) In /themes/yourtheme/_theme_config.inc.php replace the parameters:

$themeConfig['theme_name'] = 'uCloud Theme'; // the name of the theme
$themeConfig['folder_name'] = 'cloudable'; // the folder name you just created
$themeConfig['theme_description'] = 'uCloud Main Theme'; // theme description shown in the admin area
$themeConfig['author_name'] = 'uCloud'; // your name

4) Rename /themes/yourtheme/themeCloudable.class.php to /themes/yourtheme/themeNewtheme.class.php, ensuring you make the first letter of the theme name uppercase and the rest lowercase.

5) Open /themes/yourtheme/themeNewtheme.class.php and change line 3 from:

class themecloudable extends Theme

to

class themenewtheme extends Theme

6) You should now be able to enable the theme via your script admin area. The admin area thumbnail can be found in:

/themes/yourtheme/thumb_preview.png

 

Your server configuration can have a significant impact on the performance of uCloud. Below are some of the server settings we'd recommend using. It assumes you have at least a VPS server with root access and understand what you're doing!

Apache

- Enable XSendFile to take load away from PHP - https://support.mfscripts.com/public/kb_view/1/

- Enable X-Accel-Redirect to take load away from PHP - https://support.mfscripts.com/public/kb_view/2/

- Amend /etc/nginx/nginx.conf

http { 
    #... 
    fastcgi_read_timeout 300;
    #... 
}

Restart Nginx after any changes.

PHP

- Amend the following values in your global php.ini file:

memory_limit = 512M
upload_max_filesize = 500M
post_max_size = 500M
max_execution_time = 180
max_input_time = 180

Restart your webserver to apply the changes.

PHP-FPM (if using Nginx)

- Amend /etc/php5/fpm/pool.d/www.conf

request_terminate_timeout = 300
pm.max_children = 50

Source for max_children - http://myshell.co.uk/blog/2012/07/adjusting-child-processes-for-php-fpm-nginx/

PHP Fast CGI

- If you're using FastCGI with PHP/Apache ensure you allow for any timeouts on large downloads, by default they will close connections after 5 minutes so you may get partially completed downloads. In your Apache config file add the following:

<IfModule mod_fcgid.c>
FcgidBusyTimeout 43200
</IfModule>

If you're using WHM/cPanel you can add this to /usr/local/apache/conf/includes/post_virtualhost_global.conf

Save and restart Apache.

MySQL

1) Enable query cache.

Edit my.cnf file (sometimes in /etc/mysql/my.cnf)

nano /etc/mysql/my.cnf

Add or uncomment the following lines:

query_cache_size = 268435456
query_cache_type = 1
query_cache_limit = 1048576

Restart MySQL. (this command will be different depending on your OS)

service mysql restart

2) Increase max connections in MySQL. In your my.cnf file, add or amend the following:

max_connections = 600

Save and restart MySQL. You may need to adjust this value depending on your traffic levels and server resources available.

Other

Problem

After installing the script none of the html links are working and neither are the generated file download urls. 

Fix (Apache)

This is generally one of the following issues: 

RewriteBase /

Replace with: 

RewriteBase /yoursubfolder/
<Directory /var/www/>
	AllowOverride All
</Directory>

Fix (Nginx)

This is generally one of the following issues: 

root /usr/share/nginx/html;
sudo service nginx restart
 

How to reset the admin password if you've forgotten it

Problem

You've forgotten the admin password to your installation

Fix

1) Try the forgot password form on yoursite.com/forgot_password.html

2) If you can't remember the email address or it's invalid, you can reset it directly via the database.

- Login via your MySQL client such as phpMyAdmin.
- Execute the following sql on your database, replace ADMIN_USER with your admin username (usually 'admin') and NEW_PASSWORD with your new password.

UPDATE users SET password = MD5('NEW_PASSWORD') WHERE username='ADMIN_USER';

For example:

UPDATE users SET password = MD5('myp455w0rd') WHERE username='admin';
 

Emails are not being sent when a user registers on the site or when the contact form is submitted

Problem

When a user registers on the site they see the confirmation screen however they never receive an email with their password in it.

Fix

This is due to a number of reasons, try each of the following in order:

1) Test a registration yourself and ensure the email isn't being sent to a spam folder. If it is being spammed or if AOL/Hotmail accounts are not receiving emails, ensure you have SPF records setup for your domain. Your host or system admin can enable this.

2) There are 2 methods the script uses to send email, PHP and SMTP. The default is PHP. Sometimes web hosts block PHP from sending to stop spam scripts from running so although PHP attempts to send the email, it doesn't actually go anywhere. If this is the case switch to SMTP sending via the admin area, site settings. (below)

smtp_screen.png

Set the options as shown above but replace with your own SMTP email settings. Your web host will be able to confirm these.

3) If the above doesn't work you can test SMTP sending for any errors. To test:

  • Via FTP edit /admin/_test_scripts/test_email.php and replace the email address (you@youremail.com) with your own.
  • Re-upload the file to your website.
  • Login to your /admin/ area.
  • Then in the browser load this url maually - http://yoursite.com/admin/_test_scripts/test_email...
  • An email will be attempted to the email address you entered. Any errors will be shown on screen. A common error is that the sending email address can not be used via that SMTP server so you may need to change the sending email address or ask your web host to allow it.

Note: Sometimes not all debug messages are captured and outputted in the test_email.php script above. You can increase the debug level by temporarily editing the code. In coreFunctions.class.php find $mail->SMTPDebug = 1; and replace with $mail->SMTPDebug = 2; Save, reupload and test again for more detailed information.

 

Version 2.0 (20/08/2020)

- Support for uploading additional files without reloading the browser.
- Complete core rewrite:
--- New MVC script framework.
--- Separation of business logic (PHP) and views.
--- Custom page url routing.
--- Friendly urls throughout main site and admin area.
--- Twig templating engine - True separation of PHP logic and views.
--- Javascript translations moved to external JS file rather than embedded in the page source.
--- Application cache for increased performance - Routing Cache & Twig Template Cache.
--- New MVC structure for both plugins and themes.
--- Controllers and templates and be overridden at plugin and theme level.
--- Added support for transparent pngs on avatars.
--- Friendlier urls on direct file links. (removal of view.php)
--- Moved towards object based data updates (ORM).
--- New terms & privacy pages.
--- Admin test tools.
- Backblaze cloud file storage support.
- New media player for videos and audio type files.
--- Includes playback speed control, chromecast support and audio visualisation.
- Social login plugin upgrade, including refreshing guidance.
- Improved Sharing Functionality:
--- Share files aswell as folders now.
--- Select multiple files/folders to share at once, rather than folder only level.
--- Admin manage sharing pages.
--- Globally shared folders - admin can set folders to be accessed by all accounts.
--- Moved shared folders/files into dedicated left navigation item.
--- Email notification added on internal sharing.
- Added option to set keywords and description on files.
--- Keywords displayed on file details view, linked to search.
--- Search feature now includes keywords and description.
- Improvements to drop & drop uploads directly into file manager without loading the uploader popup.
- Site setting option to use local sessions rather than database based sessions.
- Site settings to control min/max length of account usernames.
- Site setting to enable download tokens to be limited by IP address.
- Minor formatting changes to file details page, including adding a back button.
- Added sharing page and trash page links on mobile view.
- Enabled 'enter' key submission on add/edit file/folder popups.
- Minor fix to avoid reloading page if upload completes when viewing file details.
- Minor fix to script update notification checker.

Release notes: This release is a major upgrade to the codebase. To upgrade existing installs,
please see the "Upgrade from v1.x" tab in the /install/ folder.

Version 1.5 (01/04/2018)

- Replacement of mcrypt functions with OpenSSL for PHP7.2+.
- API changes - New admin only endpoints:
--- /account/create
--- /account/edit
--- /account/delete
--- /package/listing
- Added optional CDN support for image previews and thumbnails. (via file server management)
- Added optional captcha to user login screen.
- Added optional captcha to admin login screen.
- Big changes to how the delete file process works within the code:
--- All deletes are now scheduled within the file action queue, including FTP, S3 and Flysystem adapters.
--- Better management of file server paths - stored against the file server in the admin area.
--- Removal of ajax calls to remote storage server on delete, significant performance improvement.
- User file manager changes:
--- Added folder ordering.
--- Added select folder option, support for multiple as per files.
--- Added multi folder delete & drag and drop to move.
--- Added empty trash button to trash toolbar.
--- Hold ctrl+click to select folders.
--- Direct file link option for all files.
- Admin area changes:
--- Moved "Max File Uploads Per Day" into account packages.
--- Moved "Accepted Upload File Types" into account packages.
--- Moved "Blocked Upload File Types" into account packages.
--- Added option to auto clear trash items older than x days in account packages.
- Better feedback on login failures for the admin area.
- Better handling of core FTP storage when passive mode is enabled.
- Improvements to how the account avatar is loaded to avoid restrictions on certain servers.
- Fix to Amazon S3 storage configuration issue.
- File server option to download over different protocol compared with main site.
- Moved the local storage path from _config.inc.php into the file server admin.
- All database tables changed to 'InnoDB' & 'utf8mb4_general_ci' to allow for MySQL clustering support.

Release Notes: There are database changes within this release. See /install/resources/upgrade_sql_statements/v1.4.2 - v1.5.sql.

Version 1.4 (24/06/2017)

- Flysystem integration. Core script initial support for file storage on:
--- SFTP
--- Amazon S3
--- Rackspace Cloud Files
--- FTP (via Flysystem, possible future replacement of core FTP storage)
- File Upload API:
--- Account Operations: Get account info, get account package info (max upload size, account limits etc).
--- File Operations: Upload, Download, Get info, Edit meta data, Delete, Move, Copy.
--- Folder Operations: Create, List (Files and Folders), Get info, Edit meta data, Delete, Move.
- Admin Area:
--- Admin area interface rewrite so it's now using Bootstrap 3.
--- Bulk import tool. Within the admin area bulk import files into an account from on a folder on your server.
--- Added user avatar to manage users page.
--- Added option to remove or set avatar on add/edit user.
--- Fix to add/edit user password setting. Now uses the global password rules.
- Better support for prepared arguments in the database layer.
- Fix to search widget not always displaying the correct file results.
- Fix to ordering of files in file manager.
- Updated social login plugin - Fixed Facebook not working due to API changes.
- Facebook login - removed the request for date or birth, town and about me, in permissions.
- Added additional database indexes to improve performance.
- Fixed session notice in later versions of PHP - session_write_close(): Failed to write session data (user).
- Fixed SMTP sending issues caused by debug being enabled within email sending library.
- Fixed issue with folder zip download not being fully recursive.

Release Notes: There are database changes within this release. See /install/resources/upgrade_sql_statements/v1.3.4 - v1.4.sql.

Version 1.3 (14/10/2016)

- Internally shared folders. Share any folder with other registered users and enable them to view, upload and download files.
- Added support for default albums on new account creation/registration. Can be set via the admin, site settings.
- Improvements to stats logging performance and sync between the stats count and file.visits value.
- Admin Area:
--- Added option to bulk remove files by copying and pasting a list of urls.
--- Fix to add/edit user password setting. Now uses the global password rules.
- Fixed admin area 12 months new files chart.
- Improvement to ipToCountry checking for larger IP ranges.
- Better support for prepared arguments in the database layer.
- Various improvements and minor bug fixes.

NOTE: There are database changes in this release. See \install\resources\upgrade_sql_statements\v1.2.3 - v1.3.sql

Version 1.2 (18/03/2016)

- PHP7 support.
- Login with your Facebook, Twitter or Google+ Account (optional setting via admin).
- User registration page and relating admin settings:
--- Whether to enable or disable the registration form.
--- Whether to display the captcha on the site registration form.
--- Block email address domains from registering. Comma separated list of domains.
--- Block usernames from the registration page.
- Automatic language translations via Google Translate API. Translate the entire site content to another language by clicking a button. Note: Requires a Google API key. Menually edited translations can be marked as 'locked' so they're not overwritten.
- Added support for username and password protected http & ftp urls. In the format ftp://user:pass@host.com/filename.txt.
- Improved session handling and how regularly the sessions are cleared from the database.
- Reduced the amount of data stored in each session for bettter performance, from (up to) 65k to just over 1k.
- Updated IP to Country data and added admin script to update the data as needed. (see the top of /core/includes/ip2Country.class.php)
- Improved right 'next page' arrow positioning when viewing files. Allows for easier scrolling of documents.
- Allowed for files to be dragged into folder icons on the main view.
- Added menu down arrow on folder icons.
- Admin Area:
--- Added option in admin to block the same file from being re-uploaded. Optional on file remove and automatic after removal on abuse reports.
--- Added admin "impersonate user" option, so admin users can login as any other user account.
--- Added new admin page for backing up the database and codebase. Functionality also built in preparation for automatic upgrades at a later date.
--- Admin option to set blocked keywords within the filename on file uploads.
--- Added option to temporarily disable file uploads globally via the admin area, site settings. Uploads will still function for admin accounts.
--- Added option to temporarily disable file downloads globally via the admin area, site settings. Downloads will still function for admin accounts.
- Fixed issue with file move between external file servers.
- Various other UI fixes and improvements.

NOTE: There are database changes in this release. See \install\resources\upgrade_sql_statements\v1.1 - v1.2.sql

Version 1.1 (01/21/2016)

- Added watermarking of images by folder option. Upload a png watermark, set the position and padding. This can then be enabled by folder. Use this to share 'proof' copies of images to customers without giving the user full access to the image.
- Added an option to hide or show the download button when sharing folders.
- Automatic language translations via Google Translate API. Translate the entire site content to another language by clicking a button. Note: Requires a Google API key.
- Added admin, theme settings option to add custom CSS code. This is kept between upgrades of the code.
- Added admin, theme settings option to set the logo on the publicly shared pages.
- Support for previewing animated gifs.
- Added 'download all images' as zip file option when folder is shared.
- Fix to hide OG image if file is set as private or requires a password.
- Reduced the maximum size of portrait images when previewing, better fit for common screen resolutions.
- Improved UI layout on mobile preview of images.
- Other minor updates and improvements.

NOTE: There is database changes in this release. See /install/resources/upgrade_sql_statements/v1.0 - v1.1.sql

Version 1.0 (01/07/2016)

- Initial release.

 

 

License

This program was developed by MFScripts Ltd and is copyrighted.

THIS SOFTWARE AND THE ACCOMPANYING FILES ARE PROVIDED "AS IS" AND WITHOUT WARRANTIES OF ANY KIND WHETHER EXPRESSED OR IMPLIED.

In no event shall the author or MFScripts Ltd be held liable for any damages whatsoever, including without limitation, damages for loss of business profits, business interruption, loss of business information, or any other loss arising from the use or inability to use the software.

Your purchase of uCloud allows you to install a SINGLE (one) copy of uCloud on ONE server. You may not resell, distribute or rent uCloud.

Credits

MFScripts Ltd

3rd Party Code

A number of MIT, LGPL and other copyrighted libraries and resources have been used in this program. These copyrights remain the property of their owners.

Some of these libraries include:

If we have missed anything please let us know!

We've spent the past 4 months building uCloud, plus years building and tuning the core framework however there's still lots more we can do. If you have any comments on how we can improve the script further feel free to post on our RFCs via the MFScripts forum or on CodeCanyon.

Thanks again for your continued support!

Adam Wilson & Simon Nooranvary - MFScripts.com

http://codecanyon.net/user/mfscriptsltd