[doc 2.6] 6 : F.A.Q.



<< Ch 5 : AjaXplorer Plugins | Up | Ch 7 : Off-Topic Configurations >>

8.1 Where are the log files?

As admin, open the Settings repository. You probably see a Logs tab but nothing listed inside of it. If so, there is probably a write permission missing — the « logs » folder is created inside the « server » folder. Thus the /path/to/install/server/ folder should be writeable.

8.2 My file upload size is limited, how can I change this?

File upload size limit is not an AjaXplorer limitation, but a server configuration for PHP. If on a shared host, it is unlikely that you can access this configuration. If you are on your own server and can edit the PHP configuration file (php.ini), please have a look at the upload_max_filesize instruction on the PHP website.

8.3 I created a repository but cannot see it?

This often happens if you have created a repository but not granted access to this repository for each user. Logged in as admin, open the Settings window, Users Management tab, and give read/write access to the newly created repository to whichever user you want.

8.4 How do I create user-specific repositories accessible only to them?

As admin, open the Settings window, click Create Repository and in the Path form, use the AJXP_USER keyword to create a path that will be adapted to each user. For example, use the following configuration:

Repository Label : « My Files »
Driver : File System
Path : « AJXP_INSTALL_PATH/files/AJXP_USER »
Create : « Yes »
Recycle bin folder : « recycle_bin »

(Each user will have their own unique repository and the admin can view them when browsing the Default Repository packed with AjaXplorer.)

8.5 I want to develop my own extensions but the JavaScript and CSS files are unreadable?

Change the $JS_DEBUG variable to true in the file index.php at line 72. After doing so, AjaXplorer will load all JS files and CSS files separately, instead of the big compressed file used normally.

8.6 How to add a custom header/footer to the GUI ?

The following files located at your_install_path/client/html/ control the header/footer GUI:

    usertemplate_top.html
    usertemplate_bottom.html

To edit those files, uncomment it’s contents (remove <!– and –> marks) and add your own HTML code inside the div tags. Using those div tags is crucial for alignment in the GUI and resizing functionality. When finished editing, save the file and reload (F5) your browser — the changes should now appear.

8.7 I have a warning concerning the character encoding when I first start AjaXplorer. What should I do?

Most distribution don’t set the locale used by the server filesystem in webserver startup script or php.ini configuration file. While it’s ok for most php application, AjaXplorer must know what character encoding the filename use in order to display them correctly.

A usual safe value is UTF-8, as most Posix system use UTF-8 internally because it’s language independant.

If you don’t know what to put there, you should try this:

  • Put UTF-8 and check that files named with your language special character (like é for French) are displayed correctly. If it’s working, don’t change this anymore.
  • Else, if you have shell access to your server, type:
    • export | grep « LANG »
    • The output usually says « lang_Country.encoding » (for example en_US.UTF8)
    • The encoding part is what your should put (UTF-8).
  • If you don’t have a shell access, please check Wikipedia for your language most used character encoding (for example, in France it’s ISO8859-1), and try with this encoding.
  • If you are uploading your file by FTP, chance are high that the encoding you need is ISO8859-1 (as most FTP server use this encoding)
  • If none of the above works for you, please ask on AjaXplorer forum, and blame your distribution vendor.

AjaXplorer remote filesystems repositories tries to detect remote filesystem encoding, so you shouldn’t have to fix it for remote filesystems (ssh, ftp, remote access).

8.8 Everything is working fine except that my downloads are all corrupted! What can happen?

In some case, we have detected problems with the gzip encoding and some browsers. Since AjaXplorer 2.3.8, there is an option in the configuration file (server/conf/conf.php) that allow you to disable gzip encoding :

Replace the line :
define(‘GZIP_DOWNLOAD’, true);
By
define(‘GZIP_DOWNLOAD’, false);

This may solve the problem. If not, please contact us via the forum!

8.9 How can I filter some file extensions, both for display/download and for upload?

DISPLAY : If you are using the standard filesystem driver, there is  a specific configuration file that you can edit to limit some file extensions or folders to be displayed in AjaXplorer. Open the file server/conf/conf.fs.inc and edit the specific configuration variables :

  • SHOW_HIDDEN_FILES : value true or false
  • HIDE_EXTENSIONS : value 0 or an array of extensions to hide
  • HIDE_FILENAMES : value 0 or an array of file names to hide
  • HIDE_FOLDERS : value 0 or an array of folder names to hide

UPLOAD : For the upload part, it’s not done via configuration, but you can easily hack one file to suit your needs. Open the file client/html/flash_tpl.html at line 8 :
You can see :
>> $FlashVar = ‘&fileTypes=*.*&fileTypeDescription=All%20files&totalUploadSize=’.$confTotalSize.’ [.... end of line]

You can edit the « fileTypes » and « fileTypeDescription » variable using for instance the following syntax :

>> [...]&fileTypes=*.doc;*.jpg;*.gif&fileTypeDescription=My%20Type%20Description&[...]

Be aware of replacing the « space » by %20 in the description. Once you’ve made changes, clear your browser cache to be sure to see your changes happen.

8.10 How can I filter some file extensions, both for display/download and for upload?

DISPLAY : If you are using the standard filesystem driver, there is  a specific configuration file that you can edit to limit some file extensions or folders to be displayed in AjaXplorer. Open the file server/conf/conf.fs.inc and edit the specific configuration variables :

  • SHOW_HIDDEN_FILES : value true or false
  • HIDE_EXTENSIONS : value 0 or an array of extensions to hide
  • HIDE_FILENAMES : value 0 or an array of file names to hide
  • HIDE_FOLDERS : value 0 or an array of folder names to hide

UPLOAD : For the upload part, it’s not done via configuration, but you can easily hack one file to suit your needs. Open the file client/html/flash_tpl.html at line 8 :
You can see :
>> $FlashVar = ‘&fileTypes=*.*&fileTypeDescription=All%20files&totalUploadSize=’.$confTotalSize.’ [.... end of line]

You can edit the « fileTypes » and « fileTypeDescription » variable using for instance the following syntax :

>> [...]&fileTypes=*.doc;*.jpg;*.gif&fileTypeDescription=My%20Type%20Description&[...]

Be aware of replacing the « space » by %20 in the description. Once you’ve made changes, clear your browser cache to be sure to see your changes happen.

8.11 I’ve seen that there is a « Public link » option somewhere, but it never appears.. How do I enable this feature?

In the server/conf/conf.php file, there is a folder defined by PUBLIC_DOWNLOAD_FOLDER, that is by default pointing to YOUR_INSTALL_PATH/public. You have to create this folder and make it writeable by the server, to see the « Public URL » action appear in the GUI.
Of course, you can point to a different folder. By default, this will then generate a link with the current ajaxplorer URL followed by « /public/ » and the php file. But you can change this URL by editing the PUBLIC_DOWNLOAD_URL to whatever you want. That way, your ajaxplorer can be in a private zone, and create public links inside a public zone.

<< Ch 5 : AjaXplorer Plugins | Up | Ch 7 : Off-Topic Configurations >>


Fork me on GitHub