File Permission Issues

This tutorial shows you how to handle permission issues within ZOO.

After installing ZOO your website stays blank, just because your Stylesheets and JavaScripts aren't loaded? This might because the webserver is unable to access these files. Make sure that you have set the right file permission to the following directories used by ZOO component.

  • /cache
  • /media/zoo
  • /components/com_zoo
  • /administrator/components/com_zoo
Permissions are inherited from the parent folder. If you set the specific ZOO folder (e.g. /media/zoo) and all sub files/folders to the correct permission but the whole Joomla media folder has lower permissions it will not work. Best way is to alter the permissions of the top level folder. Sometimes Joomlas root directory has too low permissions and you wonder why it is not working...
Always avoid 777 permissions. If your webserver has problems with the CHMOD 755, you can also try 775 and lastely 777 in this order.

Changing File Permissions

So how do you change the permissions for files and directories? Here are two step-by-step guides.

Using your FTP client

  1. Open your FTP client or if you don't have any download FileZilla and install it.
  2. Use your FTP client to login to your server and browse to your webroot directory.
  3. Right click on a directory which you want to change the permissions on and click File Permissions....
  4. The Change File Attributes dialog, let's you check the options as shown below or type a numeric value like 755. Make sure the Recurse into subdirectories option is checked. Then hit the OK button.
Permission Issue
Tip: After applying new permissions some FTP clients require the file view to be refreshed. Otherwise the old permissions will continue to show...
Using a FTP client may also change file ownership to the FTP user of the files/directories you changed the permissions on. This can cause problems on some webservers. To avoid this you can use a Joomla component like eXtplorer to update the permission through the Joomla administration.

Using the eXtplorer Joomla component

  1. Download eXtplorer file manager Joomla component and install it. It allows you to edit, delete, copy, rename, archive and unpack files/directories directly on your webserver.
  2. Login to your Joomla administration, go to the eXtplorer component and browse to the directory which you want to change the permissions on.
  3. Right click on the directory and choose Change Rights
  4. Check the options as shown below. Make sure the Recurse into subdirectories option is checked. Then hit the Save button.
Permission Issue

Documentation on Github

Help us out! If you are feeling that our documentation has errors or can be improved, fork it at Github and send us a pull request. Any contribution is much appreciated. Thank you!