INSTALLATIE
-------------------------------------------------------------------------

Installatie is eenvoudig als je MySQL en PHP kent. Maar zonder die kennis hoef je 
je geen zorgen te maken, ik zal je stap voor stap begeleiden. Voor alle duidelijkheid: 
de regels die beginnen met '%>' zijn commando's voor een telnet/ssh/shell sessie 
(als je niet weet wat dat is, dan heb je die mogelijkheid waarschijnlijk niet). Als 
je geen shell toegang hebt - geen probleem. Zolang je maar over MySQL en PHP beschikt, 
kun je phpAbook installeren. Ik behandel beide gevallen: met en zonder shell.


MET SHELL TOEGANG
-------------------------------------------------------------------------

1.	Pak de bestanden uit (al gebeurd, als je dit leest).

2.	Navigeer naar de 'SQL' directory

	%> cd SQL
	
3.	Daar vind je drie bestanden: ab_records.sql, ab_auth_user.sql en
	update_ab_records.sql . Als je een oude versie gaat upgraden (ouder dan v0.7.1b), 
	dan hoef je alleen maar het update bestand met mysql uit te voeren. Bij een nieuwe 
	installatie heb je het update bestand helemaal niet nodig.
	
	UPGRADE
	---------------------------------------------------------------------
	Type het volgende na de shell cursor:
	
	%> mysql -u <username> -p <database> < update_ab_records.sql
	waarbij <username> jouw mysql username is, en <database> de database waartoe je 
	toegang hebt.
	
	Er zal nu gevraagd worden naar je mysql wachtwoord... en daarna ben je klaar!
	
	EERSTE INSTALLATIE
	---------------------------------------------------------------------
	Type het volgende na de shell cursor:
	
	%> mysql -u <username> -p <database> < ab_records.sql
	waarbij <username> jouw mysql username is, en <database> de database waartoe je 
	toegang  hebt.
	
	Er zal nu gevraagd worden naar je mysql wachtwoord... vul het in.
	
	%> mysql -u <username> -p <database> < ab_auth_user.sql
	
	Er zal opnieuw naar je wachtwoord gevraagd worden.
	
	Als je geen foutmeldingen hebt gekregen, is deze stap klaar en kun je naar 
	stap 4. Als je wel foutmeldingen kreeg, controleer dan je username en wachtwoord 
	en probeer het opnieuw. Als je echt zeker weet dat je naam en wachtwoord 
	goed hebt ingevuld, dan voert het hier wat ver om alle mogelijkheden op te 
	noemen. Stuur me een e-mail met de foutmeldingen en ik zal proberen je te helpen.
	
4.	Wijzig het bestand config.inc.php in de 'include' directory. Er wordt duidelijk
	aangegeven wat je moet veranderen.
	
	En dan ben je klaar. Je kunt de 'phpAbook-[versie]' directory nog een andere naam 
	geven... Euh, je kunt zelfs het index.php bestand een andere naam geven (al is 
	dat niet aan te raden).
	
5.	-- BELANGRIJK --- BELANGRIJK --- BELANGRIJK --- BELANGRIJK --- BELANGRIJK --
	Dit is belangrijk want na installatie kun je inloggen in je nieuwe Abook met 
	de default naam en wachtwoord:
	
	Naam: admin
	Wachtwoord: phpAbookadmin
	
	Het wachtwoord IS case sensitive, dus het moet precies zoals hierboven ingevoerd 
	worden. Eenmaal ingelogd is het ABSOLUUT AAN TE RADEN OM HET WACHTWOORD TE 
	WIJZIGEN. Of nog beter: maak meteen een nieuwe beheerder aan met een andere naam 
	en wachtwoord. Iedereen kent immers de default gegevens... tenzij je geen 
	rekening wilt houden met andermans privacy, maar dan zou je dit programma 
	volgens mij niet moeten gebruiken.
	
	Dat is alles... veel succes!
	

ZONDER SHELL TOEGANG
-------------------------------------------------------------------------

Heb je geen shell toegang, dan is niet alles verloren (al vind ik het wel jammer 
voor je). Geen probleem dus, maar... het betekent wel meer werk. Je hebt een tweede 
PHP programma nodig voor de MySQL opdrachten om tabellen te maken. Ik kan je 
hiervoor phpMyAdmin van harte aanbevelen. Heb je dat al? Mooi, dan hoef je het niet 
meer te installeren. Anders kun je het hier downloaden:

http://phpmyadmin.sourceforge.net

Ik ga hier niet hun installatiehandleiding herkauwen, lees de documentatie maar 
(maak je geen zorgen, het valt best mee). Als de installatie is gelukt en 
het werkt, kunnen we verder gaan met de Abook installatie.

In het linkerframe van phpMyAdmin staat een tekstveld genaamd "Run SQL 
query/queries..." Net daaronder staat "Or location of the textfile:" met een 
"browse' button.

Klik op die button en selecteer het ab_records.sql bestand op je harddisk.

Klik op de 'Go' button. Het duurt ongeveer twee seconden om het bestand naar de 
server te uploaden. Als het goed is, is dan je adressentabel klaar en staat hij in 
het linkerframe.

Doe hetzelfde met het ab_auth_user.sql bestand.

Dat is alles! Beide tabellen moeten nu in het linkerframe staan. Vervolg nu met stap 4 
(hierboven) en pas het config bestand aan.

-------------------------------------------------------------------------
Heb je problemen met de installatie, kijk dan eerst op de phpAbook website en in het 
forum... wellicht staat daar de oplossing voor jouw probleem. Anders kun je me een 
e-mail sturen met de foutmeldingen, dan probeer ik je te helpen.

Bedankt voor je belangstelling voor phpAbook, en veel plezier ermee.
- randy sesser
- randy@randys.org
- http://www.randys.org/phpAbook
