Im »phpGroupWare Installation and security HOWTO« (free-source.com/files/phpgw-howto.html) steht:

»Before we start installing, we’ll get the latest patches from the phpgroupware stable CVS tree. The package you downloaded will already have the CVS directories in it to tell the cvs client what to do. This step is optional but highly recommended. Run the following command anytime you want to get the latest patches from the stable cvs tree.

$cd phpgroupware
$cvs -z6 update -dP > cvs.log

You will likely get a warning about a missing .cvspass file, this is normal and harmless. You will then see cvs go through every directory looking for files to update. This will also create a cvs.log file showing you what files updated. It is recommended you review this log to check for errors after each update.«

Der Key ist: 2969zyOT7594uUYi.

Er darf nun öffentlich weitergegeben werden da das Modul seit 1.1.2004 public domain ist.

Schritt für Schritt:

1. Download aus dem SVN Directory: joomlacode.org/gf/project/docman/scmsvn/ . Hier die Version 87 aus vom 2007-05-07. Befehl zum Download: svn checkout --username anonymous http://joomlacode.org/svn/docman
2. Man packe das Verzeichnis docman/docman/trunk zu einem ZIP-Archiv zusammen und installiere dieses als Komponente in Joomla 1.5.
3. Beim Installationsprozess tritt folgende Fehlermeldung in zweifacher Wiederholung auf:

   * JInstaller::install: SQL error. DB function failed with error number 1136
   Column count doesn't match value count at row 1

   SQL=INSERT INTO `mansorg_modules` VALUES ('', 'Latest docs', '', 2, 'dmcpanel', 0, '0000-00-00 00:00:00', 1, 'mod_docman_latest', 0, 99, 1, '', 2, 1)

   Das entsprechende SQL-Statement steht in docman/docman/trunk/docman.xml, außerdem weitere Statements die mit »INSERT INTO `#__modules`« beginnen und wohl auch korrigiert werden müssen. Das Problem: während DOCman davon ausgeht dass die Tabelle 15 Spalten hat sind es in Joomla 1.5 16 Spalten. In Mambo 4.5.2 / Joomla 1.0 sind die 15 Spalten in Reihenfolge:

   `id`
   `title`
   `content`
   `ordering`
   `position`
   `checked_out`
   `checked_out_time`
   `published`
   `module`
   `numnews`
   `access`
   `showtitle`
   `params`
   `iscore`
   `client_id`

   In Joomla 1.5 kommt als 16. Spalte am Ende “control” hinzu. Eine Lösung die für beide Versionen funktioniert ist, vollständige INSERT-Statements zu verwenden. Diese haben die Form:

   1. INSERT INTO `mansorgs_modules` (
   2.   `id`, `title`, `content`, `ordering`, `position`, `checked_out`,
   3.   `checked_out_time`, `published`, `module`, `numnews`, `access`,
   4.   `showtitle`, `params`, `iscore`, `client_id`)
   5. VALUES ([…]);

   Also muss man die oben gezeigte Klammer mit den 15 Spaltennamen in alle »INSERT INTO `#__modules`« Statements in docman/docman/trunk/docman.xml einfügen.

4. Die Installation gelingt jetzt. Greift man dann aber auf den Menüpunkt »DOCMan -> Home« zu so erscheint die Fehlermeldung »fatal error: Call to a member function getCfg() on a non-object in [...]/administrator/components/com_docman/includes/docman.html.php on line 76«. Ein »grep -r -n -C 1 "\$_DOCMAN" * | less« in docman/docman/trunk zeigt wo das betreffende »non-object« angelegt wird:

   admin.docman.php:20:$_DOCMAN = new dmMainFrame(_DM_TYPE_ADMIN);

   Das Problem liegt genau dort: man füge in der Zeile davor ein »global $_DOCMAN;«. Denn sonst ist $_DOCMAN keine globale Variable, wird doch admin.docman.php von Joomla innerhalb (!) einer Funktion inkludiert. Damit ist dann $_DOCMAN nur auf derselben Quellcodeebene erreichbar: es ist eine lokale Variable einer Funktion die in weiteren inkludierten Dateien sichtbar ist, aber nicht in darin definierten Funktionen selbst wenn diese »global $_DOCMAN« einsetzen.

5. Der GET-Parameter »section« wird noch nicht korrekt beachtet. Es fehlt: in der Datei admin.docman.php im Abschnitt »// retrieve some expected url (or form) arguments« die Zeile »$section = mosGetParam($_REQUEST, 'section', '0');«.
6. Die Toolbar im Backend wird nicht dargestellt. Es fehlt: »global $section;« vor
   »$section = mosGetParam($_REQUEST, 'section', '0');« in admin.docman.php. Grund wie bei $_DOCMAN. Leider wird die Toolbar so noch ganz zu Beginn der Seite dargestellt.
7. Problem im Frontend:

   Fatal error: Call to a member function getCfg() on a non-object
   in [...]/administrator/components/com_docman/classes/DOCMAN_user.class.php
   on line 269

   Behebung: man füge in com_docman/docman.php ein »global $_DOCMAN;« und »global $_DMUSER;«.

8. Problem im Frontend:

   Catchable fatal error: Object of class Savant2_Error
   could not be converted to string
   in [...]/components/com_docman/themes/default/templates/page_docbrowse.tpl.php
   on line 45

   Behebung: in administrator/components/com_docman/classes/DOCMAN_theme.class.php füge man vor der ersten Verwendung von $savant_path ein:

   global $savant_path; // Joomla includes this code within a function, so first use of $savant_path
   // makes it a local variable if we do not declare it global here

9. Problem im Frontend: ein veralteter Wert des Itemid-Parameters wird als GET-Parameter verwendet
10. Problem im Frontend: Icons werden nicht dargestellt, vermutlich ein Problem mit Pfaden das aus fehlender global-Deklaration einer Datei-globalen Variable basiert.