[cvs] [Wiki] changed: FAQ/Admin/Config

Jan Schneider jan at horde.org
Mon Sep 17 15:59:56 UTC 2007


jan  Mon, 17 Sep 2007 08:59:56 -0700

Modified page: http://wiki.horde.org/FAQ/Admin/Config
New Revision:  4.16
Change log:  More updates and removal of outdated Horde 2 stuff

@@ -6,8 +6,9 @@

 ++ General configuration

 +++ How can I have Horde in a different directory than /horde/ or configure
an application to run in a virtual host?
+
 There are usually two changes that people want to make as to how the URL to
a Horde component appears in the browser. If only offering one component --
say, IMP -- then one often wants to have a url of

 <code>
 http://webmail.example.com/
@@ -32,61 +33,65 @@
 </code>

 instead of the longer versions with the {{/horde/}} component.

-To make a single Horde component appear at the root directory of the
webserver, add aliases to your webserver's configuration file for the
{{/horde/}} directory, and make the {{/horde/componentname/}} the server's
document root, and restart your web server.
+To make a single Horde component appear at the root directory of the
webserver, add aliases to your webserver's configuration file for the
{{/horde/}} directory, make the {{/horde/componentname/}} the server's
document root, and restart your web server.

 For example, to make IMP appear at the root directory with Apache, add the
following to the {{httpd.conf}}:

 <code>
 Alias /horde/ /usr/local/apache/htdocs/horde/
-Alias /imp/   /usr/local/apache/htdocs/horde/imp/
 DocumentRoot  /usr/local/apache/htdocs/horde/imp
 </code>

 (substituting your own directory names for the defaults above). Then, make
sure links within Horde are correct as follows:

-**[IMP 3.x/4.x]:** Modify the {{$this->applications['imp']}} array in
{{horde/config/registry.php}} and change the value of the webroot as
follows:
+Modify the {{$this->applications['imp']}} array in
{{horde/config/registry.php}} and change the value of the webroot as
follows:

 <code type="php">
-'webroot' => '/imp',
+$this->applications['imp'] = array(
+    'fileroot' => dirname(__FILE__) . '/../imp',
+    'webroot' => '',
+    'icon' => '/graphics/imp.gif',
+    'name' => _("Mail"),
 </code>

-With the above settings, going to
-
-<code>
-http://yourserver.example.com/
-</code>
-
-will take the user right to the IMP login screen.
+With the above settings, going to {{http://yourserver.example.com/}} will
take the user right to the IMP login screen.

 In the case where one wants to run more than one Horde component but omit
the {{/horde/}} part of the URL, configure the webserver to treat the
{{/horde/}} directory as the root document directory, and add an alias to
make sure links into it still succeed. In Apache:

 <code>
-Alias /horde/ /usr/local/apache/htdocs/horde/
 DocumentRoot /usr/local/apache/htdocs/horde
 </code>

-(substituting directory names as appropriate).
+(substituting directory names as appropriate). Then, if the automatic
webroot detection doesn't work, make sure links within Horde are correct as
follows:

-**[Horde 2.x]:** For Horde 2.x and it's components, modify the file
{{/horde/config/registry.php}} in a similar way. At a minimum, you will need
to change the horde application stanza, changing the webroot entry from
{{'horde'}} to {{''}} (the empty string, not {{'/'}}).
+Modify the {{$this->applications['horde']}} array in
{{horde/config/registry.php}} and change the value of the webroot as
follows:

-Finally, modify the file {{horde/config/conf.php}} to change the cookie
path from {{'/horde'}} to {{'/'}} as in:
+<code type="php">
+$this->applications['horde'] = array(
+    'fileroot' => dirname(__FILE__) . '/..',
+    'webroot' => '',
+    'initial_page' => 'login.php',
+    'name' => _("Horde"),
+</code>
+
+Finally, change the Horde configuration in the {{General}} tab of the setup
interface (Horde 3.x), or modify the file {{horde/config/conf.php}} manually
to change the cookie path from {{'/horde'}} to {{'/'}} as in:

 <code type="php">
 $conf['cookie']['path'] = '/';
 </code>

 +++ How can I change the appearance?
-**[Horde 2.x]:** For Horde 2.x and its components, configure the settings
in {{/horde/config/html.php}} and in
{{/horde/componentname/config/html.php}}. The settings for various colours,
fonts, and styles are found within, with explanatory comments and variable
names.

-In Horde 2.x, you can add Horde modules to the bottom Horde navigation bar
by modifying {{/horde/config/registry.php}}. This is not as easy or flexible
as the Horde 1.x method above.
+See ((Doc/Dev/Layout)) and ((Doc/Dev/Themes)).

-You can modify most Horde 2.x components' navigation bars (at the top of
screen) by similarly modifying the {{/horde/componentname/config/menu.php}}
file. Follow the instructions in the comments found in the file. This
provides a very easy way to add links to the various Horde component
navigation menus.
+You can add Horde modules to the left navigation bar by modifying
{{/horde/config/registry.php}}.

-**[Horde 3.x]:** See ((Doc/Dev/Layout)) and ((Doc/Dev/Themes)).
+You can modify the components' navigation bars (at the top of screen) by
adding menu entries through the Setup Interface, or modifying the
{{/horde/componentname/config/menu.php}} files. Follow the instructions in
the comments found in the file. This provides a very easy way to add links
to the various Horde component navigation menus.

 +++ How can I change the phrases used for various features?
+
 You may wish to alter some of the text in an existing language -- to match
the terminology used locally, for instance.

 You change strings by changing them in the locale files for the desired
language(s). To change the US English translation, you will need to create a
new US English (en_US) locale, as one normally does not exist, and modify
the translations in that file. See the following FAQ entry for information
on creating a new locale file.

@@ -104,17 +109,20 @@

 Note: The following question may also be of help to you if you are changing
the locale files.

 +++ How can I provide another translation for Horde/IMP's messages?
+
 Horde uses GNU gettext for internationalization (i18n) and localization
(l10n). See {{horde/po/README}} and
{{[http://www.horde.org/horde/docs/?f=TRANSLATIONS.html
horde/docs/TRANSLATIONS]}} for more information.

 +++ How do I let users report problems directly from Horde?
+
 Horde comes with a problem-reporting form. You can control who sees it, and
what is done with problem reports, by going to the //Problem Reporting// tab
of the Horde Configuration tool.

 +++ Can I use PHP's safe_mode with Horde?
-PHP's safe_mode is not officially supported by Horde, although we work
around its restrictions wherever we can. Many have tried to use it, and have
reported various levels of success. To run in safe_mode you will need to
modify the PHP safe_mode settings. You may also have to change some code in
Horde or other Horde components in order to make things work properly. Some
of the known issues are not being able to set php maximum execution time,
problems with spell checking, not being able to use Sendmail (without
modifying the php safe_mode configuration), and problems with any sort of
file uploads (adding attachments in IMP, file uploads in gollem, etc).

-If you run the Apache web server with virtual hosts and with PHP's
safe_mode enabled by default, you can use the Apache PHP module
configuration command //php_admin_value// in your main Apache configuration
file to remove safe_mode for the Horde virtual host. For example:
+PHP's safe_mode is not officially supported by Horde, although we work
around its restrictions wherever we can. Many have tried to use it, and have
reported various levels of success. To run in safe_mode you will need to
modify the PHP safe_mode settings. You may also have to change some code in
Horde or other Horde components in order to make things work properly. Some
of the known issues are not being able to set php maximum execution time,
problems with spell checking, not being able to use Sendmail (without
modifying the php safe_mode configuration), and problems with any sort of
file uploads (adding attachments in IMP, file uploads in Gollem, etc).
+
+If you run the Apache web server with virtual hosts and with PHP's
safe_mode enabled by default, you can use the Apache PHP module
configuration command {{php_admin_value}} in your main Apache configuration
file to remove safe_mode for the Horde virtual host. For example:

 <code>
 <VirtualHost ...>
 ...
@@ -129,11 +137,11 @@
   ...
 </VirtualHost>
 </code>

-Remember to check mod_php5.c or similar if you are running PHP 5 or any
other version.
+Remember to test for module {{mod_php5.c} or similar if you are running PHP
5 or any other version.

-**[Horde 3.1.3]:** Horde+imp+turba, with safe_mode enabled, is working fine
with this apache configuration:
+It has been reported that Horde, IMP, and Turba, with safe_mode enabled,
are working fine with this apache configuration:

 <code>
 <Directory /path/to/horde>
 php_admin_value open_basedir
"/path/to/horde:/path/to/pear/lib/:/path/to/logfile/dir"
@@ -145,72 +153,79 @@
 </FilesMatch>
 </Directory>
 </code>

-With this configurtation, it is possible to import an X509 private key, to
sign and crypt mails, to add attachment files, to set languages (if po files
are compiled). The $conf['tmpdir'] must be set to /path/to/horde/tmp in the
horde conf.php file. It is use for upload (imp attachments) and to generate
'horde_smime' temporary files when you are signing and/or crypting mails. A
special configuration is set for the smime.php file so it can run the
openssl command to encrypt and decrypt the private key when it is imported
in the database. To enable the private key importation, /var/tmp must be
added to the the open_basedir list (why?).
+With this configuration, it is possible to import private keys, to sign and
encrypt mails, to add attachment files, and to set languages. The
{{$conf['tmpdir']}} setting must be set to {{/path/to/horde/tmp}} in the
Horde setup. It is used for uploads (IMP attachments) and to generate
temporary files when you are signing and/or encrypting mails. A special
configuration is set for the {{smime.php}} file so it can run the openssl
command to encrypt and decrypt the private key when it is imported in the
database. To enable the private key import, {{/var/tmp}} must be added to
the the {{open_basedir}} list (why?).

 This configuration has been tested with a direct access to the SMTP server
(no local sendmail).

-There is no warranty that everything works fine but the most important
features (like sending, receiving, attaching files, signing, crypting) are
OK.
+There is no warranty that everything works fine but the most important
features (like sending, receiving, attaching files, signing, encrypting) are
working fine.

 +++ How can I add a graphic or banner to every page?
+
 You can add content to the top of every page in a Horde component by adding
appropriate code to the file {{templates/common-header.inc}} for that
component. You can add content to the bottom of every page in all Horde
components by adding appropriate code to the file
{{horde/templates/common-footer.inc}}.

 +++ Why do old preference values overrule newly locked preference values?
+
 Any user preferences already set and stored in the preference storage
container will overrule any newly locked preferences that may be set by the
administrator. This is because the administrator may want to lock a
preference, but create a different value for some users. The administrator
controls the preferences container, so we trust the preferences container.

 Thus if users select and save their own values for an unlocked preference,
and then the administrator decides to lock that preference value, any
previously set user values would overrule the new locked value set by the
administrator.

-Therefore, if when locking a preference for which users have already set
values you wish that all users conform to the new locked setting, you must
empty out the stored preference values in the preference storage container
for all users. Horde 3.x includes a script in
{{horde/scripts/remove_prefs.php}} to aid in doing this. In Horde 3.2 and
above, this script is in the administrator tools package
(http://pear.horde.org/index.php?package=admintools).
+Therefore, if when locking a preference for which users have already set
values you wish that all users conform to the new locked setting, you must
empty out the stored preference values in the preference storage container
for all users. Horde includes a script in {{horde/scripts/remove_prefs.php}}
to aid in doing this. In Horde 3.2 and above, this script is in the
administrator tools package
(http://pear.horde.org/index.php?package=admintools).

 +++ How do I deactivate the username/password saving feature at the login
screen?
+
 This is a function of some web browsers called //!AutoComplete//. It can be
disabled in the browser or via the html code on the server. Horde does not
currently disable this via HTML code as the method for doing so is not XHTML
1.0 compliant.

 This is best done by disabling the feature in your web browser. How to do
this depends on your browser. See the documentation for your browser for
information on how to accomplish this.

-Some browsers let you selectively erase your !AutoComplete data. How to do
this would vary depending on your browser. For example, in Microsoft's
Internet Explorer you can use the following sequence to erase all your
stored !AutoComplete data: From the menu bar at the top of your browser,
choose: Tools -> Internet Options -> Content Tab -> !AutoComplete Button ->
Clear Forms.
+Some browsers let you selectively erase your !AutoComplete data. How to do
this would vary depending on your browser. For example, in Microsoft's
Internet Explorer you can use the following sequence to erase all your
stored !AutoComplete data: From the menu bar at the top of your browser,
choose: {{Tools -> Internet Options -> Content Tab -> !AutoComplete Button
-> Clear Forms}}.

 You can also selectively delete individual items. For example, in Internet
Explorer, while the cursor is in a form element, put in at least one letter
so that the !AutoComplete responses are made visible. Using your arrow keys,
scroll down to highlight the response you want to erase. Push the //Delete//
key on your keyboard.

 If you wish to disable this for your site, you can do so by modifying the
HTML code. This may make upgrading your installation more difficult, so
think twice about this before doing it.

-You can edit the source code for the login form and add autocomplete="off"
to the form to disable autocomplete for all fields in the form. For example:
+You can edit the source code for the login form and add
{{autocomplete="off"}} to the form to disable !AutoComplete for all fields
in the form. For example:

 <code>
 <form method="post" action="/path" autocomplete="off">
 </code>

-You can also use the attribute in individual form fields to disable
autocomplete only for that field. For example:
+You can also use the attribute in individual form fields to disable
!AutoComplete only for that field. For example:

 <code>
 Password: <input type="password" name="pass" autocomplete="off" />
 </code>

-You can also disable it in a form, and then enable it for certain fields in
a form, or vice versa, by using the above techniques and setting the
//autocomplete// attribute to "on" or "off" where desired.
+You can also disable it in a form, and then enable it for certain fields in
a form, or vice versa, by using the above techniques and setting the
{{autocomplete}} attribute to "on" or "off" where desired.

 +++ I've just installed Horde, how do I log in or create users?
-**[Horde 2.0]:** Horde is very flexible in how it can authenticate users,
allowing for many different types of authentication. Because of this, there
is no single answer for how you authenticate users; the answer will depend
on your particular setup and needs.
+
+Horde is very flexible in how it can authenticate users, allowing for many
different types of authentication. Because of this, there is no single
answer for how you authenticate users; the answer will depend on your
particular setup and needs.

 In most cases, you will want to use an existing user database. If not, you
will need to create a new user database of some sort on your own.

-Once you know what type of user database you want to use, you must
configure Horde and possibly some other Horde applications (like IMP,
gollem, etc) to use that authentication source. For Horde, you do this in
the files {{horde/config/horde.php}} and {{horde/config/registry.php}}. If
you choose to use IMP to authenticate users (e.g. by having IMP log into the
IMAP or POP3 server) you must configure {{horde/imp/config/servers.php}}
appropriately also.
+Once you know what type of user database you want to use, you must
configure Horde and possibly some other Horde applications (like IMP,
gollem, etc) to use that authentication source. For Horde, you do this in
the {{Authentication}} tab of the setup interface. If you choose to use IMP
to authenticate users (e.g. by having IMP log into the IMAP or POP3 server)
you must configure {{horde/imp/config/servers.php}} appropriately also.

 Some special notes for some of the authentication methods are:

 * If using the sql backend with the {{horde_users}} table, the password
must be in md5() format (and not the !MySQL password() format, for example).
-* CVS HEAD versions provide a script
{{horde/scripts/sql/script.initial_horde_user.sql}} which will create an
initial admin user for sql authentication. This can be used to login and
configure the system. If you use this, be sure to change it as soon as
possible so it does not become a security risk.
+* {{horde/scripts/sql/script.initial_horde_user.sql}} is an SQL script
which will create an initial admin user for sql authentication. This can be
used to login and configure the system. If you use this, be sure to change
it as soon as possible so it does not become a security risk.
 * If using IMAP authentication, see the comments in
{{horde/imp/config/servers.php}} for options you may need to specify.

 +++ What are the default user name and password for the administrator?
-There are none. Since Horde supports a broad variety of different
authentication backends and you are free to choose any of them for your
Horde installation, the selected backend decides which are valid login
credentials. And we we didn't add an authentication independant backdoor to
Horde, for obvious reasons.
+
+There are none. Since Horde supports a broad variety of different
authentication backends and you are free to choose any of them for your
Horde installation, the selected backend decides which are valid login
credentials. And we didn't add an authentication independent backdoor to
Horde, for obvious reasons.
 Instead, you can turn any valid and authenticated user into an
administrator by adding his user name to the administrator list in Horde's
configuration. Make sure to use user names exactly like they are used inside
Horde, i.e. with or without a domain name, and considering any user name
hooks that you enabled.

 +++ How can I get back to the setup screen?
+
 You probably locked yourself out as an administrator because you properly
configured an authentication backend for Horde, but forgot to add yourself
as an administrator in the Horde configuration - see the paragraph above. If
you don't want to start from scratch by copying {{conf.php.dist}} to
{{conf.php}} again, you need to change the configuration file
{{horde/config/conf.php}} manually. Edit the {{$conf['auth']['admins']}}
setting and add your username, e.g. {{$conf['auth']['admins'] =
array('joe');}} or {{$conf['auth']['admins'] = array('joe at example.com');}}.
You can add several administrators using a comma separated list.

 ++ IMP configuration

 +++ Can a single IMP installation serve different virtual hosts?
+
 If you have your webserver set up to answer requests from multiple domains,
you can use those virtual hosts to ensure that mail is sent with the
appropriate From: header. In other words, when someone goes to

 <code>
 http://example.com/webmail/
@@ -226,8 +241,9 @@

 **[IMP 3.x]:** It is possible in IMP 3.x to use virtual hosts, but at this
time we have no instructions for doing so. You can check the IMP mailing
list archives for information.

 +++ How can I restrict what my users can do with IMP?
+
 **[IMP 2.2]:** There are a number of IMP features and functions which can
be disabled in imp's configuration file,
{{/horde/imp/config/defaults.php3}}.

 They are:

@@ -328,8 +344,9 @@

 When changing settings in {{/horde/imp/config/prefs.php}} you can set the
"value" field for a preference to set the default value of that preference.
If you want to force users to use that value, and not allow them to change
it, you must also set the "locked" field to //true//.

 +++ How can I configure IMP's maximum attachment size?
+
 You may need to make changes to any or all of the following settings:  PHP,
Apache, database, and Mail Transfer Agent.  Settings in each of these parts
may affect overall attachment size and you will likely want any value that
deals with size to be set to the same value of whatever maximum size you
want to support.

 By default, PHP limits uploaded files to 2 MB, and this limit applies to
attachments on messages sent from IMP. To change this value, edit the
following value in your {{php.ini}} (or, in PHP3, {{php3.ini}}):

@@ -353,8 +370,9 @@

 Finally, your MTA may impose size limits for the overall size of messages
that it will handle.  Check your MTA configuration to see if there are
settings to limit overall message size.

 +++ Can I add a custom header to mail sent from IMP?
+
 To add custom SMTP headers to mail sent from IMP, place the headers in
{{/horde/imp/config/header.txt}}. Make sure that your header is the last
line in the file! You can include PHP variables by enclosing them in percent
signs ("%"). One useful header is

 <code>
 X-Originating-IP: %REMOTE_ADDR%
@@ -364,18 +382,21 @@

 Note that these are //email headers//, not body text. If you want to add an
advertisement for your webmail service, or a similar announcement, to
outgoing mail, put it at the bottom of the message (which is the standard
location) by placing the text in {{/horde/imp/config/tailer.txt}}.

 +++ Where can I find foreign-language dictionaries for spellcheck?
+
 Oxford University's archive provides [ftp://sable.ox.ac.uk/pub/wordlists
wordlists] for the languages in IMP's spellcheck (and many more!), as does
the
[http://ficus-www.cs.ucla.edu/ficus-members/geoff/ispell-dictionaries.html
International ispell Home Page].

 +++ How do I access shared mail folders? Maildir folders? MH folders?
+
 All of the above are transparent to the IMAP protocol itself, and are thus
transparent to IMP. If you can tell your IMAP server to serve the type of
folders that you want to serve, then IMP can read them.

 Both Maildir and shared folders are supported by
[http://www.inter7.com/courierimap/ Courier-IMAP], although it does not
support standard mbox format mailboxes. MH folders are supported by
[http://www.washington.edu/imap/ UW-IMAP].

 Note that you can not use folders with POP3 as the POP3 protocol does not
contain any support for folders. If you want to use folders then you must
configure IMP to use IMAP rather than POP3 access.

 +++ Can IMP show attachments or html inline?
+
 IMP is //capable// of showing certain attachments inline (i.e., in the
message body, rather than appearing in a new window on request), but in some
cases it risks exposing the user to a security problem in the browser: by
enabling inline HTML, any javascript (!ActiveX, Java, etc.) in the
attachment will be executed by the browser. //Enabling inline HTML
attachments is strongly discouraged//.

 Of course, this will only work for elements that could be part of a regular
HTML page. In particular, images //cannot// be part of in a regular HTML
page (they have to be a separate file with an <IMG> tag to include them in
an HTML page), and can thus not be inlined.

@@ -387,18 +408,21 @@
 $mime_drivers['imp']['html']['inline'] = true;
 </code>

 +++ How can I use LDAP for IMP's contact list?
+
 For LDAP searches to work in IMP, LDAP support must have been compiled into
PHP.

 **[IMP 3+]:** IMP 3.x no longer has a built-in address book, but instead
uses the Horde module Turba for an address book. See the Turba faq section
for information on configuring Turba for LDAP support. You must have Turba
installed and working before you configure IMP to use it for address books.

 To configure IMP to use one or more Turba directories, you modify the file
{{horde/imp/config/prefs.php}} to set the value of the
{{$_prefs['search_sources']}} array. The 'value' field of this array needs
to be set to a tab delimited set of Turba directory sources. IMP will then
use these sources for directory lookups.

 +++ How can I let users change their password through IMP?
+
 **[IMP 3+]:** Since version 3.x IMP does not include support for changing
passwords. You can download a seperate Horde module called
[http://www.horde.org/passwd/ Passwd] to add this functionality.

 +++ How can I let users open new accounts through IMP?
+
 **[IMP 2.2]:** There is rudimentary account-signup functionality built into
Horde 1.2 (IMP 2.2), which will allow users to fill out a form to request an
account, and then send the collected data to a specified email address. To
enable it, set the following in {{horde/config/horde.php3}}:

 <code type="php">
 $default->signup = true;
@@ -409,8 +433,9 @@

 **[IMP 3.x]:** This functionality is not available in Horde 2.x or IMP 3.x
at this time.

 +++ How can I remove maintenance functions in IMP?
+
 **[IMP 3.0]:** You need to disable each maintenance function individually.
You can do so by editing the file {{horde/imp/config/prefs.php}}. You need
to locate the stanzas for rename_sentmail_monthly, delete_sentmail_monthly,
delete_sentmail_monthly_keep, purge_trash, purge_trash_interval, and
purge_trash_keep.

 For each stanza, set the 'value' field to 0 (zero) and the 'locked' field
to true.

@@ -418,28 +443,34 @@

 To prevent maintenance functions completely (so even individual users can
not enable it for themselves), simply edit {{horde/imp/config/prefs.php}},
locate the stanza for {{$_prefs['do_maintenance']}}, and set the 'value'
field to 0 (zero) and the 'locked' field to true.

 +++ Why doesn't the Options button show up in IMP?
+
 **[IMP 3.x]:** In order for the **Options** button to show up, you need to
make sure you have created a preferences storage container. This means you
must have either a database or LDAP backend in place and configured. For
more information see the file
{{[http://www.horde.org/horde/docs/?f=INSTALL.html horde/docs/INSTALL]}}.

 You will also have to configure Horde to use the preferences container.
This is done in the //Preference System Settings// section of the file
{{horde/config/horde.php}}.

 +++ Can IMP be used with SMTP authentication?
+
 **[IMP 3.x]:** Horde and IMP can support SMTP authentication, but only if
the SMTP server take the same authentication credentials as the POP/IMAP
server (which would generally be the case). Simply edit
{{horde/config/horde.php}} as per the comments in that file, e.g.

 <code type="php">
 $conf['mailer']['params']['auth'] = true;
 </code>

 +++ How can I remove or change the text appended to each email sent through
IMP?
+
 **[IMP 3.x]:** IMP automatically appends the content of the file
{{horde/imp/config/trailer.txt}} to each email it sends. You can disable
this by setting the configuration option {{$conf['msg']['append_trailer']}}
to false in your {{horde/imp/config/conf.php}} file. If enabled, you can
change the message by simply editing the contents of
{{horde/imp/config/trailer.txt}} to suit your needs. Please note that this
is a text file, and should not contain html or php code but only normal
text.

 ++ Turba Configuration

 +++ How do I migrate my IMP 2.x contacts to Turba?
+
 Use the script {{imp/scripts/imp2turba.pl}} from IMP 3.x (requires perl
with appropriate sql support).

 +++ How can I use LDAP for IMP's contact list?
+
 You need to modify {{horde/turba/config/sources.php}} to specify your ldap
server and its attributes. The documentation in the file is pretty complete,
and there are some examples using public ldap directories.

 +++ How do I enable shared address books?
+
 **[Turba 2.1]:** You can enable shared address book support for a source
that supports this (currently SQL sources only) by adding 'use_shares' =>
true to the source's stanza in sources.php.  This allows users to create and
delete new address books as well as manage permissions on the address books
that they own.  Permissions for shared address books should be set through
the My Address Books interface in Turba and **not** through the
administration interface.


More information about the cvs mailing list