This manual is deprecated. Please visit https://groupoffice.readthedocs.io for the latest documentation.

Files

From Group-Office Groupware and CRM Documentation
Revision as of 23:43, 15 November 2012 by Rasos (Talk | contribs) (updated configuring GOTA on Ubuntu, as Sun Java is not available in repos and OpenJDK7 works nice)

Jump to: navigation, search

The file manager isn't just located in a module tab just like all the other modules, it's also available in many other modules so you can store files at contacts, companies, projects, events etc.

File manager in thumbnail view

Sharing folders

With the file manager you can easily share folders with other users. If you look at the tree structure you'll see:

  1. Personal files
    Your home directory with all the files and folders owned by you.
  2. Shared
    lists all the users that share folders with you. Please be aware that the shared folder is read only. You can't delete or create files directly under the shared folder. It just lists shared folders.
  3. Projects
    Access project files
  4. Contacts
    Access contact files
  5. Companies
    Access company files

To share a folder, right click on a folder in your personal files area and click at "Properties". Then check the "Activate sharing" option and go to the "Permissions" tab to add users and groups.

Note: If you want to create a folder that is accessible for everyone it's best to create folder under the Administrator's personal files called "Shared" for example and share that folder with group "Everyone".

Note: When sharing a folder, the other user might need to hit the refresh button or relogin to see it.

Notifications

In the folder properties screen you can enable notifications. You will receive an e-mail when someone uploads or deletes a file to this folder if you enable this. To open the folder properties dialog right click on any folder in the file manager.

Folder properties

Lock the grid display for folders

At the folder properties there's an option 'Apply the folder's display settings for everyone'. If you have setup custom fields for files you can change the enabled columns and column order for everyone that views that folder if you enable this option.

Uploading files

There are two ways to upload files. The "Small upload" option allows you to select one file at a time and is suitable for files up to 10MB (This differs per server configuration. The Default maximum on servers is actually 2MB but it can easily be raised to 10MB by your system administrator).

The "Big upload" option requires Java. It launches a new screen where you can upload complete folders and select multiple files.

Note: If you use Linux and the browser hangs please have a look at this page: https://bugs.launchpad.net/ubuntu/+source/sun-java6/+bug/288397

Editing files locally with the Group-Office Transfer Agent

If the Group-Office transfer agent is enabled you can easily edit documents locally. If you click on a text document for example, it will download the file and launch your text editor. When the file is edited it will automatically be sent back to Group-Office.

This feature is works on all operating systems including:

  1. Windows
  2. Mac
  3. Linux

Java is required. If you don't have it already you can get it free from http://java.com

Configuring GOTA on Ubuntu

Install OpenJDK-7 and configure Firefox to open JNLP files with /usr/lib/jvm/java-7-openjdk-amd64/bin/javaws . You can change this preference in firefox at Edit -> Preferences -> Applications. Search for JNLP or application/x-java-jnlp-file.

If you install Sun Java instead, webstart should be located in /usr/lib/jvm/java-6-sun/bin/javaws (or run in terminal a locate javaws). Some Linux distributions (like Ubuntu 10.11 Oneiric and above) do not offer Sun Java sun-java6-jre in their repositories anymore. You can install it e.g. from here: sudo add-apt-repository ppa:ferramroberto/java sudo apt-get update sudo apt-get install sun-java6-jre sun-java6-plugin

Configuring GOTA on Mac OS X

Make sure Java is installed. The Mac fails to open JNLP files automatically with Java Webstart, so when the browser asks you what to do with jnlp.php choose "Open with"->Other program and browse to:

System/Library/CoreServices/Java Web Start

Save as dialog

If you want the GOTA to ask if you want to save the file as ... or launch the default application you can add this line to config.php:

$config['gota_ask_save_as']=true;

File locking

When editing a file with GOTA, it will offer you to lock the file. In the notification area a balloon will be temporarily shown with the question to lock a file. When you click on the balloon the file will be locked. Each time you save the file GOTA will ask you to unlock the file. Locked files can only be unlocked by you or the administrator. Other users can not edit the file while you have locked it.

File templates

In the "New" menu from the main screen you can select "Manage templates" as administrator. Here you can add any file to use as templates for a new file. You can upload text documents with your company logo and signature in it or spreadsheet documents there for example. You can select those templates from the "New" menu and with the Group-Office Transfer Agent installed you can instantly edit those documents and save them online.

File-templates.png

Adding files with another program like FTP, Samba, NFS etc.

You can add files to Group-Office with an external program. Just add files to $config['file_storage_path'] defined in config.php (eg. /home/groupoffice). You'll have to make sure the webserver can write to the files so you have to change the owner to the apache user (eg. www-data) or you must make the world writable (777). Group-Office will import the new files into the database automtically. If the file structure is very large you should do this manually on the command line with:

php /path/to/group-office/modules/files/scripts/sync_filesystem.php

Otherwise Group-Office might hang a long time and timeout when doing the import.

You might also need to change the permissions of files created in Group-Office. Group-Office supports the following config options:

$config['file_create_mode']='0660';
$config['folder_create_mode']='0770';
$config['file_change_group']='groupoffice'; //Make sure the apache run user (www-data) belongs to the "groupoffice" group or you will get an error.

Access the files on your desktop with WebDAV

You can connect to the Group-Office files with WebDAV. Read more about it on the WebDAV page.