PHP Address 0.3 Autor: Chris Huebsch (chu@chu.in-chemnitz.de) Inhalt: ------- Bedienungshinweise Systemanforderungen Installationshinweise Allgemeine Hinweise: ==================== Das Programm ist auf "gutmuetige Nutzer" angewiesen. Es werden keine Korrektheitspruefungen ausgefuhert, sondern das, was der Nutzer sagt so hingenommen. Auch sollte nur mit den in der HTML-Seite zu sehenden Links navigiert werden. Bei einer Verwendung der vorwaerts- und rueckwaerts-Funktionen des Browsers kann nicht fuer Korrektheit garantiert werden. (Besonders nach Veraenderungen oder Loeschungen.) Hauptseite: =========== Suchen nach den angegebenen Elementen in AND-Verknuepfung. D.h. alle angegebenen Werte muessen im Datenbankeintrag enthalten sein. Es kann auch nur der Anfang, das Ende oder ein beliebiges Teilstueck des Eintrages angegeben werden. Unter "Sortiert nach" kann die Reihenfolge festgelegt werden, nach der die Ergebnisse aufgelistet werden. Suchergebnis: ============= Alle Eintraege, die der angemeldete Nutzer anzeigen kann und die den eingegebenen Kriterien entsprechen werden angezeigt. Ist der Nutzer dazu brerechtigt, kann er den Eintrage auch bearbeiten oder loeschen. Aufkleber führt zu einer weiteren Ansicht, die einige der Attribute in einer fuer einen Briefkopf geeigneten Form anzeigt. Alle auflisten: =============== Alle Eintraege, die der angemeldete Nutzer anzeigen kann werden in einer verkuerzten Form dargestellt. Mit einem Klick auf die Spaltenueberschriften kann man die Sortierreihenfolge bestimmen. Ein Klick auf den Nachnamen zeigt eine Detailansicht an. Klick auf die Mailadresse erstellt eine neue Mail und ein Klick auf die Webseite zeigt ebendiese an. Bei einem Klick auf den Klasseneintrag werden alle Eintraege dieser Klasse angezeigt. Hat der Nutzer die entsprechenden Rechte, so kann er den Eintrag auch bearbeiten oder löschen. Mit Aufkleber kann die Aufkleberansicht aktiviert werden. Loeschen: ========= Wenn die Loeschaktion bestaetigt wird, dann verschwindet der Eintrag aus der Datenbank. Neuer Eintrag & Eintrag aendern: ================================ Die meisten Felder sind selbsterklaerend. Jedoch gibt es einige wenige Anmerkungen: Klasse: Bezeichnet eine Gruppe von Adressen, deren Adressaten einer bestimmten Gruppe zugehoeren. Adresse: Die PLZ und der Ort sollten in den dazugehoerigen Feldern eingetragen sein und nicht hier. Email und Webseite sollten dem Standard entsprechen, damit diese dann in den Ansichten anklickbar sind. Standard bei emails ist: user@host.domain.land und bei Webseiten: http://host.domain.land/... Bei Anmerkung kann eine Notiz ueber gefuehrte Gespraeche, gesendete Post oder sonstige Zusatzinfos abgelegt werden. Das Feld kann bis zu 65000 Zeichen aufnehmen. Der Eigentuemer ist derjenige, der den Eintrag besitzt. Dieses Feld muss entweder leer sein oder ein gueltiges Nutzerkuerzel enthalten. Die Rechte geben an, was andere Nutzer mit dem Eintrag machen duerfen. * Publich bedeutet, dass jeder Nutzer den Eintrag aendern, loeschen und einsehen kann. * Protected bedeutet, dass nur der Eigentuemer den Eintrag aendern und loeschen kann. Einsehen duerfen diesen trotzdem alle Nutzer. * Private bedeutet, dass nur der Ersteller des Eintrages diesen auch sehen kann. Beim Aendern eines Eintrages ist natuerlich auch der Eigentuemer abaenderbar. Klassen verwalten: ================== In dem Texteingabefeld kann der Name einer neuen Klasse eingetragen werden, was mit einem Klick auf Eintragen bestaetigt wird. Ist kein Eintrag einer bestimmten Klasse in der Datenbank, so kann diese Klasse auch entfernt werden. Dazu klickt man einfach auf Loeschen. Es wird NICHT nachgefragt, sondern sofort das Loeschen ausgefuehrt. Systemanforderungen: ==================== Apache 1.3.x, mySql, php Der Apache sollte Authentifizierung unterstuetzen, wenn die Nutzerrechte verwendet werden sollen. MySql sollte auf dem gleichen Rechner wie der Webserver laufen. Installation: ============= 1. Datenbank anlegen: mysql < PHPAddress.sql fuer genauere Informationen, welche Tabellen erstellt werden, einfach in die Datei PHPAddress.sql schauen 2. Nutzer anlegen: Per mysql-Kommando oder mit Hilfe eines Tools einen Nutzer anlegen (z.B. "address_user"), der mindestens die Rechte SELECT, INSERT, UPDATE und DELETE fuer alle Tabellen der Adress-Datenbank besitzt. GRANT SELECT,INSERT,UPDATE,DELETE ON PHPAddress.* To address_user@localhost IDENTIFIED BY ""; Nutzerinformationen in globals.php eintragen. 3. PHP-Scripte an die entsprechende Stelle im Webserver kopieren cp -r PHPAddress $DOCUMENTROOT ggf. Verzeichnis umbenennen 4. .htacces-File erstellen z.B: DirectoryIndex index.php SSLRequireSSL AuthType Basic AuthName "Intern" require group users 5. Sprache anpassen (optional) Ist eine andere Standard-Sprachversion als englisch gewuenscht, so ist in globals.php eine andere Sprachendatei anzugeben. (z.B. require("german.php") in Zeile 6) Um eine Sprache aus der Auwahl auszuschliessen, so muss man lediglich in globals.php das Array $languages modifizieren. Wird eine Zeile gelöscht, so erscheint die Sprache nicht länger in der Auswahl. Uebersetzungen und Dank: ======================== (mma(.)aa.com.tr): Türkisch Tim Vandermeersch (): Bugreport Peer L. Plaut (): English überarbeitet Janne Huttunen (): Finnisch Martin Sitar (citron(.)internet.cz): Tschechisch Bryce Chidester : Spanisch Martin Werthmöller : Bugreport Thomas Wimmer : Mobilnummer, Längere Nummern, Landsuche, Spanisch in HTML Lionel Loew : French Holger Zscheyge : Russian Gabriele Pohl : Bugreport Valkai Jozsef : Hungarian Fung Sharon : Chinese Bastiaan Naber : Dutch Bruno Mentges de Carvalho : Brazilian Chris Wilkinson : Bugfixes in PHPAddress.sql + README.english Magnus B : Swedish Mauro Butruce : Italian Michal Niezbecki : Polish (.)==@ Bug Reports sind Willkommen Chris, 09.12.2001