kitDirList - Datenübertragungen und Aktivieren der Dokumentenverwaltung für KeepInTouch

Das unscheinbare Addon kitDirList kann wesentlich mehr, als Ihren Kunden Dateien in öffentlichen und geschützten Bereichen zum Download bereit zu stellen.

Ab Release 0.17 stehen einige Parameter mehr zur Verfügung um kitDirList mit erweiterten Fähigkeiten auszustatten und Ihnen und Ihren Kunden eine ganze Reihe von weiteren Funktionen zur Verfügung zu stellen.

Neu hinzugekommen sind die Parameter:

• wb_auto=true - schaltet die automatische Verwaltung von Benutzervereichnissen für angemeldetete WebsiteBaker Benutzer ein.
• kit_auto=true - schaltet die automatische Dokumentenverwaltung in Benutzerverzeichnissen für angemeldete KeepInTouch Kontakte ein.
• upload=true - dieser Parameter schaltet die Möglichkeit hinzu, Dateien auf den Webserver zu übertragen. Der Upload erfolgt in das Benutzerverzeichnis des jeweiligen Benutzer bzw. Kontakt oder in das freigegebene öffentliche oder geschützte Verzeichnis.
• mkdir=true - ermöglicht dem Benutzer/Kontakt innerhalb seines Verzeichnisses beliebige Verzeichnisse anzulegen. Dieser Parameter setzt automatisch auch recursive=true.
• unlink=true - erlaubt dem Benutzer bzw. Kontakt Dateien und Verzeichnisse zu löschen

Wenn Sie kitDirList das erste Mal mit dem Parameter wb_auto oder kit_auto aufrufen, legt kitDirList innerhalb des geschützten Bereich /media/kit_protected das Unterverzeichnis /contacts an. Für die eindeutige Kennzeichnung der Benutzerverzeichnisse verwendet kitDirList die E-Mail Adresse des WebsiteBaker Benutzer (bei Verwendung von wb_auto) bzw. die primäre E-Mail Adresse des jeweiligen KeepInTouch Kontakt.

Unterhalb von /media/kit_protected/contacts baut kitDirList eine Verzeichnisstruktur auf, die folgender Systematik folgt:

/a

/a/anfang@email.tld

/a/anfang@email.tld/user

/a/anfang@email.tld/admin

...

/z

/z/zulu@email.tld

/z/zulu@email.tld/user

/z/zulu@email.tld/admin

Es wird eine übergeordnete a-z Verzeichnisstruktur angelegt, damit bei steigender Zahl von Benutzern oder Kunden der Überblick erhalten bleibt. Für jeden Kontakt bzw. Kunden wird ein Verzeichnis angelegt, das nach der E-Mail Adresse benannt wird. Unterhalb dieses Verzeichnis befindet sich das Verzeichnis /user - auf dieses Verzeichnis erhält der User nach seiner Anmeldung einen direkten Zugriff. Der Kunde/Kontakt erhält niemals Zugriff auf übergeordnete Verzeichnisse oder gar auf das Verzeichnis /admin.

Für WebsiteBaker Administratoren wird kein eigenes Verzeichnis angelegt.

Das Verzeichnis /admin ist für den internen Gebrauch von KeepInTouch reserviert und wird zu einem späteren Zeitpunkt die Dokumentenverwaltung für die jeweiligen Kontakte aufnehmen. Die beiden Kundenverzeichnisse /user und /admin werden dann von KeepInTouch aus verwaltet werden und können Dokumente enthalten, die dem Kontakt zugänglich sind oder auch nicht zugänglich sind.

Die Systematik dieser Verzeichnisstruktur wird so auch dann zur Verfügung gestellt, wenn sie ausschließlich wb_auto verwenden und KeepInTouch nicht verwenden - auf diese Weise ist beliebiges Hin- und Herwechseln zwischen den verschiedenen Modi wb_auto und kit_auto möglich.

Als Administrator erhalten Sie Zugriff auf die gesamte Verzeichnisstruktur aller Benutzer bzw. Kontakte. Die Parameter upload=true, unlink=true und mkdir=true werden automatisch gesetzt, wenn Sie sich als Admin einloggen.

Wenn Sie mit kit_auto arbeiten, müssen Sie in KeepInTouch bei den Einstellungen einen oder mehrere Administratoren festlegen, damit Sie Zugriff auf die Verzeichnisstruktur haben.

Bei der Verwendung der Parameter wb_auto und kit_auto sind die folgenden Parameter ohne Wirkung und sollten nicht verwendet werden:

• media
• kit_intern
• kit_dist
• kit_news
• wb_group

Spielen Sie ein wenig mit den Parametern und Möglichkeiten herum um die Wirkung der verschiedenen Schalter kennenzulernen. Verwenden Sie hierbei ein Kundenkonto oder einen WebsiteBaker Benutzer ohne Administrator Rechte.

Beispiele:

[[kit_dirlist?kit_auto=true]]

Genügt für einen Lesezugriff (der Kontakt muss angemeldet sein)

[[kit_dirlist?kit_auto=true&upload=true]]

Der Kunde hat zusätzlich die Möglichkeit Daten in sein Verzeichnis zu übertragen

[[kit_dirlist?kit_auto=true&upload=true&unlink=true]]

Es dürfen Dateien und Verzeichnisse gelöscht werden.

[[kit_dirlist?kit_auto=true&upload=true&unlink=true&mkdir=true]]

Der Kontakt darf Verzeichnisse anlegen.

Wird eine Datei übertragen erhält der oder die Administratoren eine E-Mail Benachrichtigung.

Diese Dokumentation ist sicherlich noch unvollständig, bitte helfen Sie mit, kitDirList und die Dokumentation zu verbessern!

Â

Ralf Hertsch, 13.03.2011

Zurück zur Übersicht