steffen: server/kolab-horde-fbview/kolab-horde-fbview/fbview/turba/docs CHANGES, NONE, 1.1 CREDITS, NONE, 1.1 INSTALL, NONE, 1.1 LDAP, NONE, 1.1 RELEASE_NOTES, NONE, 1.1 TODO, NONE, 1.1

cvs at intevation.de cvs at intevation.de
Mon Oct 31 12:43:38 CET 2005


Author: steffen

Update of /kolabrepository/server/kolab-horde-fbview/kolab-horde-fbview/fbview/turba/docs
In directory doto:/tmp/cvs-serv18388/kolab-horde-fbview/kolab-horde-fbview/fbview/turba/docs

Added Files:
	CHANGES CREDITS INSTALL LDAP RELEASE_NOTES TODO 
Log Message:
Fbview in separate package

--- NEW FILE: CHANGES ---
----
v2.0
----

[jan] Add access keys.
[cjh] Add Kolab drivers (Stuart Bingë <s.binge at codefusion.co.za>).
[cjh] The alphabetic pager now has an "All" option.


----------
v2.0-ALPHA
----------

[cjh] Show an alphabetic pager for browsing address books
      (Mike Bydalek <mbydalek at zivix.com>).
[cjh] Rename LDAP objects when their DN changes
      (Tarjei Huse <tarjei+a_lists.phpgw at nu.no>).
[cjh] Add exporting of VCards from the browse/search view
      (Mike Bydalek <mbydalek at zivix.com>).
[cjh] Initial IMSP driver (Michael Rubinsky <mike at theupstairsroom.com>).
[cjh] Use Horde_UI_Pager to page browse results
      (Joel Vandal <jvandal at infoteck.qc.ca>).
[cjh] Basic support for setting permissions on Turba sources
      (Joel Vandal <jvandal at infoteck.qc.ca>).
[cjh] Unify search and advanced search code to use a much more similar
      interface (Joel Vandal <jvandal at infoteck.qc.ca>).
[cjh] Javascript delete confirmation is now available as a preference
      ("W. David Betts" <david at populus.com>).
[cjh] Searching composite fields, and other complex generated
      searching, now works with the LDAP driver.
[cjh] Track addition, modification, and deletion of contacts
      with the Horde History:: API.
[cjh] Use arbitrary search support to include searching of composite
      fields.
[cjh] Turba_Drivers are now capable of arbitrary searches, including
      unlimited nested combinations of AND and OR searches.
[cjh] Add the ability to link fields in the backend into a composite
      field, which is not editable, but which displays the correct
      value.
[cjh] Add the ability to move or copy contacts to a separate
      addressbook.
[cjh] Display multiple email addresses more intelligently
      (John Dalbec <jpdalbec at ysu.edu>).
[cjh] Allow setting a limit on the number of queries returned by an
      LDAP search (Andrew Morgan <morgan at orst.edu>).
[cjh] Add edit/delete links in browse views.
[cjh] Preference for default directory for searches, etc.
      (Richard Heggs <Richard.Heggs at nottinghamcity.gov.uk>).
[cjh] Add support for listing/adding/retrieval of public keys
      (Michael M Slusarz <slusarz at bigworm.colorado.edu>).
[cjh] Use the new PrefsUI class.
[jon] Adapt to the new Horde::img() syntax.
[cjh] Use the new Notification system.
[jan] Remove the standard value for the language preference. The language to
      fall back to should be set Horde wide in lang.php instead.


------
v1.2.2
------

[jan] Add Galician translation (Rafael Varela Pet <srrafa at usc.es>, Guillermo
      Mendez <guille at usc.es>).


------
v1.2.1
------

[jan] Fix importing of vCard 2.1 data that contains commas (needs 
      Horde 2.2.4).
[jan] Make sorting order dependent of the name format (Sergey Zhukov
      <sergey at intellij.net>).
[jan] Add Arabic (Syria) translation (Platinum Development Team
      <devteam at platinum-sy.net>).
[jan] Add Macedonian translation (Stojan Pesov <ssp at eureka.com.mk>).
[jan] Add Romanian translation (Eugen Hoanca <eugenh at urban-grafx.ro>,
      Marius Dragulescu <mariusd at urban-grafx.ro>).
[cjh] Remove dependency on class not in Horde 2.x.


----
v1.2
----

[cjh] Use the 'objectclass' entry from LDAP sources instead of defaulting to
      'objectclass=*'.
[jan] Add Catalan translation (Angels Guimerà <angels.Guimera at uab.es>).
[jan] Add a preference for viewing names as Lastname, Firstname
      (Marc Jauvin <marc at register4less.com>).
[jan] Add Latvian translation (Kaspars Kapenieks <kaspars at rcc.lv>).
[cjh] Close several small XSS vulnerabilities
      (Mitja Kolsek <mitja.kolsek at acros.si>).
[cjh] Fix problems with cached search results from different backends.
[jan] If an LDAP directory is configured to use utf8 encoding,
      encode attributes when adding them to the directory (cjh).
[jan] Add Turba_List::remove() (cjh).
[jan] Add Turba_Object::fromvCard() (cjh).
[jan] Add a registry script for Turba (Michael Cochrane <mike at graftonhall.co.nz>).
[jan] Add distribution list support (Michael Cochrane <mike at graftonhall.co.nz>).
[jan] Add personal LDAP address book HOWTO and example (cjh).
[jan] Add generic add, delete, get, list API functions for specific fields (mms).
[jan] Add Turba::addParameter().
[jan] Add Lithuanian translation (Darius Matuliauskas <darius at lnk.lt>).
[cjh] Add a miniwindow interface that can be used in popups from other
      applications.
[cjh] Add preferences-based addressbook capability for small, private
      addressbooks.
[cjh] Make sure vCard email addresses are imported as just the email
      address, not as Personal Info <address at example.com>.
[cjh] Add Turba::getBareAddress() for converting
      Personal Info <address at example.com> into just address at example.com.
[jan] Add Bulgarian translation (Miroslav Pendev <pendev at hotmail.com>).
[cjh] Add links to MapQuest from address fields.
[jan] Pass contact name to compose link in display view.
[jan] Replace <?= with <?php echo to remove the short_open_tags requirement (cjh).
[jan] Fix preference for default view.
[jan] Add import/export filter for TSV, Mulberry and Pine (Liam Hoekenga
	  <liamr at umich.edu>).


----
v1.1
----

[jan] Add Hungarian translation (Laszlo L. Tornoci <torlasz at xenia.sote.hu>).
[jan] Add Norwegian Nynorsk translation (Per-Stian Vatne <psv at orsta.org>).
[jan] Add Slovenian translation (Jure Krasovic <jurek at rcc-irc.si>).
[jan] Add Japanese translation (B.J. Black <william.black at sun.com>).
[cjh] Add an optional parameter to set the LDAP protocol version.
[cjh] Close a potential problem with register_globals On and $js_onLoad.
[jan] Add Portugal Portugues translation (Nuno Loureiro <nuno at eth.pt>).
[cjh] Add a Browse interface for easily listing all contacts.
[cjh] Change some button inputs to submits and remove some javascript.
[cjh] Source-wide filters with LDAP are always AND-ed.
[cjh] Remove awkward To:, Cc:, Bcc: message composition interface and clean
      up UI.
[cjh] Delete empty attributes instead of just leaving them unchanged.
[cjh] Log SQL and LDAP queries at LOG_DEBUG.
[cjh] Don't generate LDAP searches with 'attr=**' in them for empty values
      (use attr=*).
[cjh] Say "Edit 'entry'" instead of just "entry" in the mouseover text for
      search results which are editable.
[cjh] Add a local LDAP directory example.
[cjh] Don't store objects in the search results session cache; a bit slower,
      but seems to be much more reliable.
[cjh] Vastly improve search results handling - store them in the session,
      don't add duplicate results, let people use the back button, etc.
[cjh] Fix the column select javascript.
[cjh] Add list mouseover effect (Ronnie Garcia <ronnie at mk2.net>).
[cjh] Fix results problem with advanced.php and old results.
[cjh] Patches to tweak the LDAP driver to handle things a bit more
      correctly (HiCkS <hicks at 666.hn.org>).
[cjh] Add and use TURBA_TEMPLATES constant.
[cjh] Use $registry->getParam() for all Registry information.
[jan] Add 'admin' entry to the sources hash to give write access on readonly
      addressbooks to certain logged in users.
[jon] Enable the "portability" option in the SQL driver.
[jan] Add preferences page and user preference to select the columns that shall
      be displayed in the search results.
[jan] Add Estonian translation (Toomas Aas <toomas.aas at raad.tartu.ee>).
[jan] Add Slovak translation (Leo Mrafko <leo at oel.sk>).
[jon] Enable the "portability" option in the SQL driver.
[jan] Add Ukrainian translation (Andriy Kopystyansky <anri at polynet.lviv.ua>).
[jan] Add Danish translation (Martin List-Petersen <martin at list-petersen.dk>).
[jan] Fix bug "This person is already in your addressbook.".


----
v1.0
----

[jan] Add Norwegian Bookmal translation (Oystein Steimler <oystein at rexta.net>).
[avsm] Add .htaccess files to deny access to data directories.
[jan] Add Finnish translation (Leena Heino <liinu at uta.fi>).
[cjh] Avoid adding duplicate entries through the add API method.


--------
v1.0-RC4
--------

[rich] Include rewritten and reorganized documentation.
[rich] License under Horde APL.
[cjh] Make email addresses clickable in displayed objects.
[bjn] Change 'en' and 'en_EN' locales to 'en_US' (default).
[cjh] Vastly improve error reporting when adding an object fails.
[jan] Add Brazilian Portuguese translation (Carlos Daniel Kibrit
      <kibrit at terra.com.br>).
[jan] Add Greek translation (Stefanos I. Dimitriou <sdimitri at teiath.gr>).
[jan] Add Swedish translation (Andreas Dahlén <andreas at dahlen.ws>).
[jan] Add Korean translation (J.I Kim <aporie at netian.com>).
[cjh] Remove duplicate entries from multiple sources from
      turbaExpandAddresses() results.
[cjh] Don't show the addressbook select widget on the search page if there's
      just one to search from.


------
v0.0.3
------

[cjh] Add an optional 'strict' configuration array definining fields which
      must always be matched exactly.
[jan] Add api function to get info about the fields.
[jan] Add source configuration to select which fields should be searchable by
      default.
[cjh] Allow OR searches.
[cjh] Pass full email addresses (with names) to messages being composed
      (Lars Nummedal <largs at nummedal.net>).
[jan] Add Polish translation.
[jan] Add mapping of date/time fields to the import feature.
[jan] Add support for date fields (e.g. birthdays).
[jan] turbaExpandAddresses() now returns all email addresses that belong
      to a contact.
[jan] Show the fields in edit and display view dynamically based on what's
      provided by the backend.
[jan] Add Italian translation (Giovanni Meneghetti <gmeneghetti at infvic.it>).
[jan] Add import/export ui based on the new Data class.
[cjh] Add Traditional Chinese translation (David Chang <david at thbuo.gov.tw>).
[cjh] Add Czech translation (pchytil at asp.ogi.edu).
[cjh] Add Russian translation (Ignat Ikryanov <ignat at ibd.ru>).
[cjh] Add $conf['menu']['apps'] support and a help link.
[cjh] Make incremental building up of search results works again in both
      search and advanced search.
[cjh] Add Alias to default fields (Marc Jauvin <marc at register4less.com>).
[cjh] Use the *url() functions more consistently to make sure that
      cookie-less sessions work.


------
v0.0.2
------

[cjh] Add some more error checking to the searching and LDAP driver.
[cjh] Add config/attributes.php to provide nice labels for directory
      attributes.
[cjh] Adding German translation from Jan Schneider <janmailing at gmx.de>.
[cjh] Allow LDAP Sources to define a filter always included in searches
      (rbarnett at neuromics.com).
[jon] Preserve the search parameters after a search is performed.
[jon] Allow the registry to handle Turba's configuration values.
[jon] HORDE_BASE is now defined in lib/base.php instead of config/conf.php.
[max] Adding source retrieval api function.
[cjh] Adding Dutch translation from Jan Kuipers <jrkuipers at lauwerscollege.nl>.
[jon] Adding French translation from Sam Przyswa <samp at arial-concept.com>.
[cjh] Add gettext infrastructure.
[cjh] Define the HORDE_BASE constant in config/conf.php, and use it when
      referring to any of Horde's files.
[cjh] Bring the advanced search page up to date, and add it to the menu.
[jon] Retired config/menu.txt in favor of config/menu.php.  This file follows
      a new format based on native PHP data structures.
[max] Expand api to allow adding addresses to an addressbook.
[cjh] Add the first api function (expanding addresses) for Turba in
      lib/api.php.
[cjh] Add and Delete now work for the LDAP driver.
[cjh] Fix wap contacts searching.
[cjh] Turba now uses Horde authentication instead of its own. This means
      that whatever auth method you are using for Horde will be used to
      authenticate to Turba, and in return you get single sign-on with any
      other apps using Horde authentication.
[cjh] Working addObject() and removeObject() SQL driver methods.
[cjh] Move Turba_Source::getMyObject() to Turba_Source::getObject(); nothing
      was using the old getObject() call anymore.
[cjh] If you set $params['bind_dn'] and $params['bind_password'] for an LDAP
      source, Turba will bind as the specified dn to the LDAP server,
      letting you add/edit entries.
[cjh] Update capatilization to match Horde/PEAR standards.
[cjh] register_globals = Off fixes.
[cmc] Add a display object page, fix a ldap bug with the dn, add
      a read function to the turba source class (Done by Christian
      M. Couder (cmc) <christian at alcove.fr>).
[cjh] Add an advanced search page contributed by Christian Couder
      <christian at alcove.fr>.
[cjh] Bring the WML templates up to date with recent changes.
[cjh] Make the LDAP server port configurable and make sure the parameter
      appears in the example sources.
[cjh] Implemented edit functionality for the SQL driver.
[cjh] Moved the filter() functionality (and supporting functions) into
      Turba_List, where it really belongs.
[cjh] We now actually use Turba_List, Turba_AbstractObject, Turba_ListView,
      and many other pieces of the class hierarchy that were previously only
      referenced in the object model.
[cjh] Clean up the sql Driver implementation a bit. Now, if the source is
      private, the __owner criteria must match the current user, instead of
      using __key. __key should uniquely identify each object, and shouldn't
      be what user that object belongs to.
[cjh] Reorganize the class hierarchy a bit - use Object instead of Contact,
      and a few other naming changes.
[cjh] Merged WAP functionality into search.php. If a WAP browser is
      detected, a slimmed-down wml interface will be used that only displays
      names and (callable) phone numbers.


------
v0.0.1
------

[cjh] Fix bug where searches with no results would tack on an empty row.
[cjh] Conversion to CSS.
[cjh] Cleanup, modernization.
[jon] Silence session_start warnings.
[jon] Use Horde::url() in place of the deprecated buildURL() function.
[cjh] Use new session model and $horde['session_name'].
[cjh] Fixed message sending javascript to work with multiple addresses.
[jon] Allow directory sources to be set 'read-only' (non-editable).
[jon] Added a 'public' flag to the $cfgSources entries.
[jon] Contact attributes are configurable via config/attributes.php.
[jon] Renamed the source configuration hash to $cfgSources (from just
      $sources).
[jon] Moved from config/ldap.php to config/sources.php.
[jon] Converted Chuck's existing class stubs into a PEAR-style lib/ tree.

--- NEW FILE: CREDITS ---
============================
|| Turba Development Team ||
============================

===============
Core Developers
===============

Chuck Hagenbuch <chuck at horde.org>
- original design work

Jon Parise <jon at csh.rit.edu>
- initial implementation work

Rich Lafferty <rich at horde.org>
- documentation

Jan Schneider <jan at horde.org>
- import/export routines
- stuff


============
Localization
============

Arabic (Syria)          Platinum Development Team <devteam at platinum-sy.net>
Brazilian Portuguese    Carlos Daniel Kibrit <kibrit at terra.com.br>
Bulgarian               Miroslav Pendev <pendev at hotmail.com>
Catalan                 Angels Guimerà <angels.Guimera at uab.es>
Chinese (Simplified)    WangHengWen <whw at my169.com>
Chinese (Traditional)   David Chang <david at thbuo.gov.tw>
Czech                   Pavel Chytil <pchytil at asp.ogi.edu>
Danish                  Martin List-Petersen <martin at list-petersen.dk>
Dutch                   Jan Kuipers <jrkuipers at lauwerscollege.nl>
Estonian                Toomas Aas <toomas.aas at raad.tartu.ee>
Finnish                 Leena Heino <liinu at uta.fi>
French                  Sam Przyswa <samp at arial-concept.com>
                        Ronnie Garcia <ronnie at mk2.net>
                        Benoit St-André <ben at benoitst-andre.net>
Galician                Rafael Varela <rafael.varela at usc.es>
                        Guillermo Mendez <guille at usc.es>
German                  Jan Schneider <jan at horde.org>
Greek                   Stefanos I. Dimitriou <support at teiath.gr>
                        Silligardos Xristoforos
                        Anagnostopoulos Apostolis
Hungarian               Laszlo L. Tornoci <torlasz at xenia.sote.hu>
Italian                 Giovanni Meneghetti <gmeneghetti at infvic.it>
Japanese                B.J. Black <william.black at sun.com>
                        Takeshi Morishima <tm at onepost.net>
Korean                  J.I Kim <aporie at netian.com>
Latvian                 Kaspars Kapenieks <kaspars at rcc.lv>
Lithuanian              Darius Matuliauskas <darius at lnk.lt>
                        Vilius Sumskas <vilius at lnk.lt>
Macedonian              Stojan Pesov <ssp at eureka.com.mk>
Norwegian Bokmaal       Oystein Steimler <oystein at rexta.net>
Norwegian Nynorsk       Per-Stian Vatne <psv at orsta.org>
Polish                  Piotr Roszatycki <dexter at debian.pl>
Portuguese              Nuno Loureiro <nuno at eth.pt>
                        Jose' Carlos <horde.i18n at abismo.org>
Romanian                Eugen Hoanca <eugenh at urban-grafx.ro>
                        Marius Dragulescu <mariusd at urban-grafx.ro>
Russian                 Ignat Ikryanov <ignat at ibd.ru>
                        Anton Nekhoroshih <anton at valuehost.ru>
                        Fedor A. Fetisov <faf at ssc.ru>
Slovak                  Leo Mrafko <leo at oel.sk>
                        Ivan Noris <noris at bgs.sk>
Slovenian               Jure Krasovic <jurek at rcc-irc.si>
Spanish                 Julian Jares <jjares at techie.com>
                        Raúl Alvarez Venegas <rav at tecoman.ucol.mx>
Swedish                 Andreas Dahlén <andreas at dahlen.ws>
Ukrainian               Andriy Kopystyansky <anri at polynet.lviv.ua>

$Horde: turba/docs/CREDITS,v 1.47 2004/03/30 17:35:04 jan Exp $

--- NEW FILE: INSTALL ---
==========================
|| INSTALLING Turba 2.0 ||
==========================

This document contains instructions for installing the Turba contact
manager on your system.

For information on the capabilities and features of Turba, see
the file README in the top-level directory of the Turba
distribution.


OBTAINING TURBA
---------------

Turba can be obtained from the Horde website and FTP server, at

   http://www.horde.org/turba/
   ftp://ftp.horde.org/pub/turba/

Bleeding-edge development versions of Turba are available via CVS; see
the file docs/HACKING in the Horde distribution for information on
accessing the Horde CVS repository.

[FIXME note on RPMs here]


PREREQUISITES
-------------

To function properly, Turba requires the following:

  1. A working Horde installation.

     Turba runs within the Horde Application Framework, a set of
     common tools for Web applications written in PHP. You must
     install Horde before installing Turba.

     The Horde Framework can be obtained from the Horde website and
     FTP server, at

        http://www.horde.org/horde/
        ftp://ftp.horde.org/pub/horde/

     Many of Turba's prerequisites are also Horde prerequisites.
     Be sure to have completed all of the steps in the INSTALL
     file for the Horde Framework before installing Turba.

The following are not required, but are strongly recommended:

  1. SQL and/or LDAP support in PHP.

     Turba can store its contacts entries in either an SQL or an
     LDAP database, and can query public (read-only) LDAP databases
     for contacts as well. Build PHP with whichever LDAP or SQL
     drivers you require; see the Horde INSTALL file for details.


INSTALLING TURBA
----------------

Turba is written in PHP, and must be installed in a web-accessible
directory. The precise location of this directory will differ from
system to system. Conventionally, Turba is installed directly underneath
Horde in the webserver's document tree.

Since Turba is written in PHP, there is no compilation necessary;
simply expand the distribution where you want it to reside and rename
the root directory of the distribution to whatever you wish to appear
in the URL. For example, with the Apache webserver's default document
root of '/usr/local/apache/htdocs', you would type:

   cd /usr/local/apache/htdocs/horde
   tar zxvf /path/to/turba-1.0.tar.gz
   mv turba-1.0 turba

and would then find Turba at the URL

   http://your-server/horde/turba/


CONFIGURING TURBA
-----------------

1. Configuring Horde for Turba

   a. Register the application

      In horde/config/registry.php, uncomment the stanza for Turba.
      Be sure to uncomment the ");" on the last line of the stanza.
      If you have changed the location of Turba relative to Horde,
      either in the URL or in the filesystem or both, you must
      update the 'fileroot' and 'webroot' settings to their correct
      values.

   b. Optional: Provide Turba access from IMP

      If you wish to have Turba appear in IMP's menubar, edit
      IMP's config/conf.php to set:

         $conf['menu']['apps'] = array('turba');

2. Creating databases

   The specific steps to create Turba databases depend
   on which database you've chosen to use.

   First, look in scripts/drivers/ to see if a script already
   exists for your database type (SQL or LDAP). If so, you should be
   able to simply execute that script as superuser in your
   database. (Note that executing the script as the "horde" user will
   probably fail when granting privileges.)

   If such a script does not exist, you'll need to build your own, using
   the file turba.sql as a starting point. If you need assistance in
   creating databases, you may wish to let us know on the Turba
   mailing list.

3. Configuring Turba.

   To configure Turba, change to the config/ directory of the
   installed distribution, and make copies of all of the configuration
   "dist" files without the "dist" suffix:

      cd config/
      for foo in *.dist; do cp $foo `basename $foo .dist`; done

   Documentation on the format and purpose of those files can be found in
   each file.   You may edit these files if you wish to customize Turba's
   appearance and behaviour.  With the exception of conf.* files  and the
   sources.php file (See below for information on these files) the defaults
   will be corrct for most sites.

   You must configure sources.php to list your data sources (both SQL and
   LDAP if necessary).

   You must then configure Turba via the Horde Configuration (Setup)
   module (part of Horde).  Login to Horde as a Horde Administrator.
   Use the Horde "Administration" menu item to get to the Administration
   page, then click on "Configuration" to get the configuration page.
   Select "Address Book" from the selection box of applications, and 
   click on on the "Configure" button.  Fill in or change any configuration
   values as needed.  When done click on "Generate Address Book Configuration"
   to generate the conf.php file.  If your web server doesn't have write
   permissions to the configuration directory or file, it will not be able
   to write the file, and will display the configuration file in the 
   browser window.  In this case, copy and paste the returned configuration
   information into the file turba/config/conf.php manually.

4. Securing Turba

   Some of Turba's configuration files contain passwords which local
   users could use to access your database. It is recommended to ensure
   that at least the Turba configuration files (in config/) are not
   readable to system users. There are .htaccess files restricting
   access to directories that do not need to be accessed directly;
   before relying on those, ensure that your webserver supports
   .htaccess and is configured to use them, and that the files in
   those directories are in fact inaccessible via the browser.

   An additional approach is to make Turba's configuration files
   owned by the user 'root' and by a group which only the webserver
   user belongs to, and then making them readable only to owner and
   group. For example, if your webserver runs as www.www, do as
   follows:

      chown root.www config/*
      chmod 0440 config/*

5. Testing Turba

   To verify that Turba is working correctly, attempt to look up
   a known existing and a known nonexisting entry in each of your
   data sources, and to create and then look up a new entry in
   each data source which allows users to create new entries.

   If appropriate, ensure that Turba appears in the IMP menu bar.


OBTAINING SUPPORT
-----------------

If you encounter problems with Turba, help is available!

The Horde Frequently Asked Questions List (FAQ), available on the Web
at

  http://www.horde.org/faq/

The Horde Project runs a number of mailing lists, for individual
applications and for issues relating to the project as a whole.
Information, archives, and subscription information can be found at

  http://www.horde.org/mail/

Lastly, Horde developers, contributors and users also make occasional
appearances on IRC, on the channel #horde on the freenode Network
(irc.freenode.net).

Please keep in mind that Turba is free software written by volunteers.
For information on reasonable support expectations, please read

  http://www.horde.org/support.php

Thanks for using Turba!

The Horde team
turba at lists.horde.org

$Horde: turba/docs/INSTALL,v 1.9 2003/06/04 01:23:46 chuck Exp $

--- NEW FILE: LDAP ---
Turba ldap personal addressbook HOWTO.

This HOWTO is a bare bones list of what has to be done to implement a
personal adressbook through ldap for turba.

The howto is based on a setup where both the addressbook and the users
are stored on the same LDAP server.

This is not comprehensive, but it notes how some users have
implemented personal LDAP address books.

1. Configure turba/config/sources.php.

Note that OpenLDAP and some other LDAP servers use UTF8 to encode its
data, so you should have encoding = 'utf8' set in the parameters for
your LDAP address book source.

There is an example of personal address books in
turba/config/sources.php.dist. You will have to modify it to to match
the fields, settings, and schema of your LDAP server, but it's a solid
place to start.


2. Patch your core.schema file in the /etc/openldap/schema directory.

This patch is located in turba/scripts/ldap/core.schema.patch.

NOTE: The patch adds the organizationName to the orgperson objectclass
and removes the MUST sn to the person oc.


3. Enforce ACL's to personal address books.

Add this to your LDAP ACL so users can only see their own address book:

Please note: this assumes that you store your users in the same LDAP
directory. If not, modify appropriately for your setup.

access to dn="ou=(.+), ou=personal_addressbook, dc=example, dc=com"
       by dn="uid=$1, dc=example, dc=com" write
       by * none

4. Make ou's for all of your users.

You'll also have to add this to the script you use to add users to
your LDAP directory.

turba/scripts/ldap/addou.pl is a starting point; you will need to edit
it to fit your needs. Copy both it and the addou shell script to
/home. Then run ./addou and all the different names of the catalogues
will be added to the ldap tree as new ou's to store addresses in. You
should probably delete any entries that do not belong there (for
instance, /home directories for mysql and other daemons created by
some distributions).


Entries for Calendaring information (free/busy, etc.) from RFC 2739:

attribute (1.2.840.113556.1.4.478
  NAME 'calCalURI'
  DESC 'Snapshot of users entire default calendar'
  EQUALITY caseIgnoreMatch
  SUBSTR caseIgnoreMatch
  SYNTAX 1.3.6.1.4.1.1466.115.121.1.26
 )

attribute (1.2.840.113556.1.4.479
  NAME 'calFBURL'
  DESC 'URI of the uses free and busy information'
  EQUALITY caseIgnoreMatch
  SUBSTR caseIgnoreMatch
  SYNTAX 1.3.6.1.4.1.1466.115.121.1.26
 )

attribute (1.2.840.113556.1.4.480
  NAME 'calCAPURI'
  DESC 'URI used to communicate with the users calendar'
  EQUALITY caseIgnoreMatch
  SUBSTR caseIgnoreMatch
  SYNTAX 1.3.6.1.4.1.1466.115.121.1.26
 )

attribute (1.2.840.113556.1.4.481
  NAME 'calCalAdrURI'
  DESC 'URI to which event requests should be sent for the user'
  EQUALITY caseIgnoreMatch
  SUBSTR caseIgnoreMatch
  SYNTAX 1.3.6.1.4.1.1466.115.121.1.26
 )

attribute (1.2.840.113556.1.4.482
  NAME 'calOtherCalURIs'
  DESC 'URIs to non-default calendars belonging to the user'
  EQUALITY caseIgnoreMatch
  SUBSTR caseIgnoreMatch
  SYNTAX 1.3.6.1.4.1.1466.115.121.1.26
 )

attribute (1.2.840.113556.1.4.483
  NAME 'calOtherFBURLs'
  DESC 'URIs to non-default free and busy information files'
  EQUALITY caseIgnoreMatch
  SUBSTR caseIgnoreMatch
  SYNTAX 1.3.6.1.4.1.1466.115.121.1.26
 )

attribute (1.2.840.113556.1.4.484
  NAME 'calOtherCAPURIs'
  DESC 'URIs for communicating with non-default calendars'
  EQUALITY caseIgnoreMatch
  SUBSTR caseIgnoreMatch
  SYNTAX 1.3.6.1.4.1.1466.115.121.1.26
 )

attribute (1.2.840.113556.1.4.485
  NAME 'calOtherCalAdrURIs'
  DESC 'Destinations for event requests to non-default calendars'
  EQUALITY caseIgnoreMatch
  SUBSTR caseIgnoreMatch
  SYNTAX 1.3.6.1.4.1.1466.115.121.1.26
 )

objectclass (1.2.840.113556.1.5.87
 NAME 'calEntry'
 DESC 'Calendering and Free Busy information'
 SUP top AUXILIARY
 MAY (calCalURI $ calFBURL $ calCAPURI $ calCalAdrURI $
      calOtherCalURIs $ calOtherFBURLs $ calOtherCAPURIs $
      calOtherCalAdrURIs
     )
 )

--- NEW FILE: RELEASE_NOTES ---
<?php
/**
 * Release focus. Possible values:
 * 0 - N/A
 * 1 - Initial freshmeat announcement
 * 2 - Documentation
 * 3 - Code cleanup
 * 4 - Minor feature enhancements
 * 5 - Major feature enhancements
 * 6 - Minor bugfixes
 * 7 - Major bugfixes
 * 8 - Minor security fixes
 * 9 - Major security fixes
 */
$this->notes['fm']['focus'] = 5;

/* Mailing list release notes. */
$this->notes['ml']['changes'] = <<<ML
The Horde Team is pleased to announce the first alpha release of the Turba
Contact Manager version 2.0.

Turba is the Horde contact management application. It is a production level
address book, and makes heavy use of the Horde framework to provide
integration with IMP and other Horde applications.

This is a preview version that should not be used on production
systems.  Some small parts are missing and there are still a few bugs,
some of which are listed below.  You should not use this preview
version over existing production data.

The API, configuration items, or features may change before the final
release, but we encourage widespread testing and feedback via the mailing
lists or our bug tracking system. Translations are not ready to be updated
yet, since some strings will change before the final release.

The major changes compared to the Turba 1.x versions are:
    * Copying and moving of contacts between different address books.
    * IMSP backend.
    * Optional delete confirmation.
    * Composite fields.
    * Allow search result limits for LDAP backends.

Known issues:
    * Documentation is not completely updated yet.
ML;

/* Freshmeat release notes. */
$this->notes['fm']['changes'] = <<<FM
Contacts can now be copied and moved between different address books.
IMSP backends are now supported.
Delete operations can now optionally be confirmed.
Composite fields have been added.
Search result limits can now be specified for LDAP backends.
FM;

$this->notes['name'] = 'Turba';
$this->notes['fm']['project'] = 'turba';
$this->notes['fm']['branch'] = 'FRAMEWORK_3';

--- NEW FILE: TODO ---
=================================
|| Turba Development TODO List ||
=================================

- Add feature to allow each user to set up their own fieldset, maybe
storing such records in an SQL attributes-type DB backend.

- Figure out how to sanely name Groups when using a composite 'name'
field.


$Horde: turba/docs/TODO,v 1.2 2004/04/01 21:42:14 chuck Exp $





More information about the commits mailing list