DOCman (Downloadbereich, Dokumentenverwaltung)

Die Idee von DOCman² ist es, Dateien mit einer Beschreibung und einer Lizenz zu verknüpfen und dann unterschiedlichen Benutzergruppen zum Download anzubieten.

DOCman bietet Ihnen die folgenden Features:

• Sie können beliebige Dokumente in beliebig vielen Kategorien und Unterkategorien schachteln.
• Sie können die Dateien auf dem eigenen oder einem entfernten Server ablegen.
• Dokumente lassen sich per Zugriffsberechtigung zu schützen.
• Sie können beliebig viele Benutzergruppen anlegen, um den Zugriff auf die Dokumente zu regeln.
• Sie können umfangreiche Downloadstatistiken erheben.
• DOCman hat ein eigenes Suchsystem. Dokumente können über den Dateinamen oder ihre Beschreibungen durchsucht werden. Durch ein zusätzliches Plugin wird die Suche ins Joomla!-System integriert.
• Der echte Pfad zu den Dokumenten wird niemals angezeigt.
• Es gibt verschiedene Templates zur Anpassung an die Website.
• Online finden Sie eine wachsende Dokumentation in Form eines Wikis³.

12.2.1 Installation

Die Installation erfolgt genau wie beim Forum (Kapitel 12.1.1, Seite 221). Laden Sie die Datei com_docman_1.4.0rc3.zip von der CD und installieren Sie das Paket über den Menüpunkt Erweiterungen Installieren/Deinstallieren (Abbildung 12.15).

Abbildung 12.15: DOCman Installation

Unter dem DOCman-Logo finden Sie einen Button, um Beispieldaten zu installieren. Klicken Sie ruhig darauf. DOCman installiert dann

• eine Beispieldatei,
• eine Beschreibung zu dieser Datei,
• eine Kategorie, in die die Beschreibung zugeordnet wird,
• eine Benutzergruppe und
• eine Beispiellizenz.

Nach Installation der Beispieldaten ist DOCman sofort einsatzbereit.

12.2.2 Konfiguration

DOCman gehört zu den Komponenten, die das Menükonzept von Joomla! 1.5 voll unterstützen (Abbildung 12.16).

Abbildung 12.16: DOCman Control Center

Die einzelnen Menüpunkte finden sich in der Zeile unter dem Logo wieder. Im DOCman Control Center finden Sie ebenfalls Icons zum schnellen Zugriff und im rechten Bereich eine Informationsübersicht.

Wenn Sie auf den Link configuration klicken, sehen Sie die umfangreichen Möglichkeiten von DOCman – leider noch komplett in englischer Sprache.

12.2.3 Sprache

Auch für DOCman gibt es natürlich Sprachpakete für die deutsche Sprache. Entpacken Sie die Datei german_docman_v1.4.0rc3.zip. Auch hier müssen Sie manuell tätig werden und können nicht den Installer von Joomla! benutzen. Kopieren Sie die Dateien german.backend.php, german.common.php, german.doclink.php, german.frontend.php, german.module.php aus dem Verzeichnis

[Sprachpaket]german_docman_v1.4.0rc3\language

in das Verzeichnis (Abbildung 12.17)

[PfadZuJoomla]administrator\components\com_docman\language

und die Datei german.php aus dem Verzeichnis

[Sprachpaket]german_docman_v1.4.0rc3\themes\language

in das Verzeichnis (Abbildung 12.18)

[PfadZuJoomla]components\com_docman\themes\default\language

Abbildung 12.17: Sprachdateien im Administrationsbereich

Abbildung 12.18: Sprachdateien für das Frontend

Im Administrationsbereich und auf der Website spricht Ihr DOCman jetzt Deutsch (Abbildung 12.19).

Sie können alle Parameter zunächst bei den Standardwerten belassen. Sie sehen allerdings schon an der Menge der Einstellungsmöglichkeiten, dass DOCman mittlerweile wirklich mächtig geworden ist, wenn es um das Anbieten von Dokumenten geht. Werfen Sie einen Blick in die einzelnen Bereiche der Konfiguration.

• Home – ist das Control Center, also die Übersichtsseite.
• Files – hier laden Sie die Dateien hoch, die Sie zum Download anbieten wollen.
• Documents – hier erstellen Sie eine Beschreibung und ordnen sie der Datei zu. Sie legen hier auch fest, wer darauf zugreifen darf und unter welcher Lizenz der Download steht.
• Categories – hier verwalten Sie die Kategorien, in die Sie Ihre Dokumente einordnen werden.
• Groups – hier erstellen und verwalten Sie Benutzergruppen.
• Licenses – hier erstellen und verwalten Sie die Lizenbedingungen. Sie können beliebig viele Lizenzen verwalten.
• Statistics – hier sehen Sie die Downloadstatistisk (wie oft wurde welcher Download geladen?).
• Download Logs – hier können Sie sich die Log-Dateien herunterladen.
• Configuration – die Grundkonfiguration von DOCman.
• Themes – DOCman hat die Möglichkeit, eigene Themes zu verwalten. Auf der Projektwebsite können Sie zusätzlich Themes herunterladen und dann hier für das Frontend auswählen.
• Credits – hier finden Sie das Changelog ab dem Jahr 2004.

Abbildung 12.19: DOCman Konfiguration

12.2.4 Auf der Website einbinden

Die Verfahrenweise ist genau wie beim Fireboard Forum (siehe Kapitel 12.1.1, Seite 221). Sie möchten einen Link zu Ihren Dokumenten im Joomla! 1.5 Buch-Menü haben. Also müssen Sie unter Menü Joomla! 1.5 Buch einen neuen Eintrag erstellen. Im Menüeintragstyp wählen Sie DOCman aus (Abbildung 12.20) und landen dann in der Bearbeitungsmaske (Abbildung 12.21).

Abbildung 12.20: Menülink für DOCman einrichten

Abbildung 12.21: Menülink Bearbeitung

Hier legen Sie noch Menülink-Titel und -Alias fest. Sie können auch direkt eine bestimmte Kategorie von Dokumenten anspringen. Geben Sie dazu die Kategorie ID in den Parametern ein. Sie finden diese ID in der Administration von DOCman im Kategorienbereich.

Nach einem Klick auf das Icon Speichern und einem Neuladen Ihrer Website haben Sie ein professionelles Download-Verzeichnis auf Ihrer Website (Abbildung 12.22).

Abbildung 12.22: DOCman auf der Website

Wenn jemand auf den Button Download klickt, wird die Lizenz für diesen Downlad angezeigt. Sie muss bestätigt werden, und danach startet der Download (Abbildung 12.23).

Abbildung 12.23: Lizenzabfrage

12.2.5 Inhalt bereitstellen

Neue Dateien und Beschreibungen zum Download können Sie über den Administrationsbereich oder über das Frontend einstellen. Wenn Sie sich beispielsweise auf Ihrer Website mit dem admin-Benutzer einloggen, sehen Sie im oberen Bereich ein Icon und einen Link Neues Dokument vorschlagen (Abbildung 12.23). In drei Schritten werden Dokumente hochgeladen.

Im ersten Schritt müssen Sie entscheiden, von wo das Dokument kommen soll. Von Ihrem eigenen PC, von einem anderen Server, oder soll es »nur« ein Link auf ein vorhandenes Dokument sein (Abbildung 12.24)?

Abbildung 12.24: Dokument vorschlagen – Schritt 1

Ich habe die Variante Datei von lokalem Rechner hochladen ausgewählt und lade die Zip- Datei der Komponente hoch (Abbildung 12.25).

Abbildung 12.25: Dokument vorschlagen – Schritt 2

Abbildung 12.26: Dokument vorschlagen – Schritt 3

Nach dem erfolgreichen Upload befinde ich mich in Schritt 3 und muss jetzt eine Beschreibung, die Zugriffsrechte, die Kategorie und die Lizenz auswählen. Durch einen Klick auf den grünen Haken im oberen Bereich wird der neue Download gespeichert und sofort freigeschaltet. Die Freischaltung erfolgt sofort, weil ich ja mit dem Benutzer admin arbeite. Dieser Benutzer sieht auch erheblich mehr Buttons (Optionen) im Frontend als der normale Benutzer (Abbildung 12.27). Normalerweise müssen Sie Dokumente im Administrationsbereich explizit freischalten (Abbildung 12.28).

Abbildung 12.27: Der neue Download auf der Website

Abbildung 12.28: Freischaltung von Dokumenten

12.2.6 Such-Plugin

Um die Dokumente in die Joomla!-interne Suche einzubauen, müssen Sie noch ein zusätzliches Plugin installieren. Hier benutzen Sie wieder den Installer unter Erweiterungen Installieren/Deinstallieren. Laden Sie die Datei bot_docman_search_ 1.4.0rc2.zip von der CD und installieren Sie sie über den Installer.

Unter Erweiterungen Plugins finden Sie jetzt das DOCman-Such-Plugin, das Sie noch aktivieren müssen (Abbildung 12.29).

Abbildung 12.29: DOCman Such-Plugin

Wenn Sie nun über das normale Suchfeld der Website nach dem neuen, eben gerade eingetragenen Dokument suchen, wird es Ihnen mit der Kategorie in der Trefferliste angezeigt (Abbildung 12.30).

Abbildung 12.30: Suche nach Dokumenten

12.2.7 Zusatzmodule

Wenn man viele Downloads anbietet, möchte man oft auf der Website die am meisten heruntergeladenen Dokumente anzeigen. Dazu benötigt man Module. Lassen Sie uns ein Modul installieren, das die am meisten heruntergeladenen Dokumente anzeigt. Installieren Sie die Datei mod_docman_mostdown_1.4.0rc2.zip über den Installer und aktivieren Sie sie unter Erweiterungen Module (Abbildung 12.31).

Abbildung 12.31: DOCman Modul

Das Modul ist standardmäßig links angeordnet. Sie können es über die Bearbeiten- Funktion an beliebiger Stelle positionieren und natürlich den Titel ändern. In den Parametern können Sie noch die Menge der Einträge festlegen und ob das Icon und die Anzahl angezeigt werden sollen. Standardmäßig sieht das Modul auf der Website aus wie in Abbildung 12.32.

Abbildung 12.32: Modul auf der Website