csvTool - Verwaltung von PlainText-Datenbanken

Installation und Konfiguration von csvTool

1. Allgemeines

1.1. Produktbeschreibung in Kürze

csvTool ist ein kleines Script, um beliebige PlainText-Datenbanken webbasiert zu verwalten. csvTool ist innert weniger Sekunden Einsatzbereit und benötigt kaum Konfigurationsanpssungen. Mit csvTool können Daten angesehen, editiert, gelöscht und neue Datensätze hinzugefügt werden. Deutsch, kostenlos.

1.2. Wozu eignet sich csvTool, wozu nicht?

csvTool ist als Administrationstool für beliebige kleine Plain-Text Datenbanken geeignet (getrennt durch ";", Tabulator oder ein anderes Kennzeichen), wo webbasiert Änderungen vorgenommen werden müssen. Klassisches Beispiel ist eine kleine Adresskartei, auf die mehrere Personen Zugriff haben sollen. Es können Datensätze editiert, gelöscht und neu hinzugefügt werden. csvTool benötigt nur sehr wenige Konfigurationseinstellungen: Pfad zur CSV-Datei, Trennzeichen innerhalb der Zeile und Titel - fertig (nebst ein paar Datenbankunabhängigen Einstellungen wie Pfad zu den Bildern und dem CSS-Stylesheet).

csvTool hat auch seine Einschränkungen: da es universell mit allen möglichen Datenquellen eingesetzt werden kann, ist es nicht möglich, Pflichtfelder zu definieren, Einfgaben zu prüfen (z.B. gültiges Datum, gültige Mailadresse). Ebenfalls steht die Datenbank jedem zur Verfügung, d.h. wer die URL kennt und sich allenfalls via .htaccess-Datei authentifiziert hat, hat vollständigen Zugriff auf die Datenbank. csvTool ist also in erster Linie für den Einsatz in einem eingeschränkten Benutzerbereich konzipiert und bietet kaum Schutz gegen mutwillige Löschaktionen.

1.3. Was kann csvTool?

1.4. Voraussetzungen

csvTool benötigt nur CGI-Unterstützung auf Ihrem Webserver. Bei Aktivierung der optionalen Mailbenachrichtung bei Änderungen wird sendmail benötigt.

1.5. Lizenzbestimmungen

Dieses Skript basiert auf den STANDARD-Lizenzbedinungen, die Sie unter http://www.cgicorner.ch/download/info.shtml oder in der Datei cgicorner.txt im ZIP-Archiv finden.

2. Installation und Konfiguration

2.1. Dateien kopieren und Berechtigungen setzen

Folgende Dateien müssen kopiert und mit den entsprechenden Berechtigungen versehen werden:

 cgi-bin - Verzeichnis, z.B. /cgi-bin/csvtool/
. chmod 755 (od. 777) Verzeichnis
csvtool.cgi chmod 755 Hauptscript
data.csv chmod 666 Daten-Datei (Name beliebig)
 images-Verzeichnis, z.B. /csvtool/images/
. chmod 755 (od. 777) Verzeichnis
style.css chmod 644 CSS-Stylesheet
*.gif chmod 644 Grafiken

2.2. Konfiguration

Die Konfiguration von csvTool erfolgt direkt im Script. Hier die Einstellungen
$dataFile Definiert den Standort der Datendatei (UNIX-Pfad). Wenn die Datei zum Download angeboten werden soll, muss sich diese Datei ggf. ausserhalb des cgi-bin Verzeichnisses befinden.
$dataFileB Legt den Browser-Pfad (Download-URL) zur Datendatei fest. Wird der Wert leer gelassen, bietet das Script die Datei nicht zum Download an.
$splitChar Definiert das Trennzeichen innerhalb eines Datensatzes, z.B. ";", "," oder "\t" (=Tabulator)
$title Titel der Datenbank (wird auf der Webseite angezeigt und erscheint als Betreff bei optionaler Mailbenachrichtigung)
$editGIF Browser-Pfad zum Editieren-GIF
$viewGIF Browser-Pfad zum Detailansicht-GIF
$delGIF Browser-Pfad zum Löschen-GIF
$css Browser-Pfad zum CSS-Stylesheet
$changeMail Mailadresse für optionale Mailbenachrichtigung: wird diese eingetragen, wird bei jedem neuen, editierten oder gelöschten Datensatz ein Mail mit den Details an diese Adresse gesendet.
$sendmail Pfad zu sendmail (nur bei Mailbenachrichtigung relevant)

2.3. Datendatei

Die Datendatei selber kann beinahe beliebig aufgebaut sein, trotzdem gibt es noch einige Einschränkunen/Funktionen:


Copyright © 2006 by Jürg Sommer, jsommer@cgicorner.ch
http://www.cgicorner.ch
Letzte Änderung: 23. April 2006