# phpGroupWare FAQ

Dan
Kuykendall
Brandon
Neill
$Revision: 1.1.1.1 $, $Date: 2002/01/05

Frequently Asked questions related to phpGroupWare

## General

Is it phpGroupWare, PHPGroupWare, PHP Groupware, etc?

Its phpGroupWare, not any of the others. Only the G and the W should be in caps, its also 1 word, not 2. Sometimes for short we call it phpGW, again, the G and the W are in caps.

I didn't find my question here, where can I ask?

Many of the developers are on the openprojects irc network (irc.openprojects.net) in the #phpgroupware channel. You can also check the mailing lists and archives at phpGroupware - Mailing Lists

How do I add new questions to this list?

Email me at brandonne@colorado.dyndns.org or submit them in Tracker on the phpGroupWare site and assign them to brandonne.

## Installation

Installation Questions

Will phpGroupWare work with Windows?

Yes, there are several people who are using it. Thanks Vincent Larchet vinz@users.sourceforge.net for patching anything we do that breaks phpGroupWare on NT.

Will phpGroupWare work with PHP4/PHP3?

Yes, it runs on both PHP3 and PHP4

Will phpGroupWare work with SSL

Yes, since there are no references to http:// or https:// (unless you put them in the header) there shoudn't be any problems with it.

I am having problems installing on PostgreSQL 6.x.

phpGroupware is being developed with version 7.x. I tried installing it on 6.x and ran into several problems. Unless you plan on toying around with it, you're better of with 7.x.

## Administration

Deselecting an application for a user doesn't seem to restrict their access to that application

A user gains access to an application one of two ways, being given access directly, or by belonging to a group that has access. In order to deny a user access to an application, it must be removed from both the users account, and all the users groups.

## Applications

## Email

The mail preferences are not updated from the interface "mail preferences"

If you are referring to setting the password when using custom email preferences, this is actually a security feature. We do not send the password back to the user as it would still be sent back in plain text. Even though it is displayed with asterisks, it would be in plain text if you view the source html for the page. What we do is check to see if the user entered a value in that field. If so, we take the new password the user enters and encrypt it and save it into the database. This provides for maximum security of user passwords.

I'm composing mail, what do I put in the "To" and/or "CC" boxes

The easiest was is to follow these examples, pay close attention to the spaces, do not add spaces you do not see here: johndoe@example.com johndoe@example.com,jane@example.com,tarzan@example.com "John Doe" <johndoe@example.com> "John Doe" <johndoe@example.com>,"Jane" <jane@example.com> johndoe@example.com,"Jane" <jane@example.com>,tarzan@example.com

My IMAP server logs show many login attempts with garbage usernames, why?

At this time we know this happens when you enter "localhost" for your POP/IMAP mail server hostname or IP address. For now the solution would be to try the actual IP or the machine name (resolvable via DNS, hosts, or other means) for your IMAP email server.

Error message when adding large signature files

The max number of characters for a sig file is 8140. Extremely large sig files are not recommnded anyway, Usenet recommends sig files of 1-5 lines in length, 3 being preferred.

I can not attach files to an email, I get errors about "unlink"

There are two possible causes for this problem, the first and least likely is the web server temp directory, check your webserver configuration for this. The second is the temp directory which phpGroupWare uses. To check this, follow these steps:

>     - go to http://your.server/phpgroupware/setup  (the phpgroupware initial setup page)
>     - login to "Setup/Config Admin Log"
>     - in "Step 2 - Configuration" click "Edit Current Configuration"
>     - under "Path Information" see the box labeled "Enter full path for temporary files: Examples: /tmp, C:\TEMP"
>     - Make sure that directory listed has permissions thar are at least 0700 and the owner is nobody.nobody (note: this assumes your webserver runs as user nobody, adjust for your installation)
>     - The other directory to check is the temporary directory that your web server typically uses, but the information listed above is by far the most common config issue with email attachments.

## File Manager

File Manager not working

To use the filemanager app:

>     (from phpgroupware home)
>     # mkdir files
>     # mkdir files/groups
>     # mkdir files/users
>     # chown -R nobody.nobody files (note: this assumes your webserver runs as user nobody, adjust for your installation)
>     # chmod -R 770 files

Make sure you have the correct FULL path in setup (ie. /home/httpd/phpgroupware/files)

## Forum

index.php not loaded automatically by apache

Sometimes /forum/index.php is not loaded automatically by apache, this appears to be a bug in apache 1.3.13mdk. If you have the same problem just add /index.php in lines 49, 57 and 82 of preference_category.php.

## Development

Why don't you just use the session class from phplib? Why not use cookies to hold the sessionid?

I personally don't like using cookies for something like this. However, the session management is currently being abstracted for the applications. This means that switching to cookies will be possible for those that are interested.