Manual phpGB 1.0.x
Welkom bij de Manual van phpGB. In deze Manual kun je vinden hoe een en ander werkt en hoe je eventuele problemen op kunt lossen. Je kunt menu aan de linkerkant gebruiken om te navigeren. Mocht je onderwerpen missen waarvan je wel vindt dat die besproken moet worden, schroom dan niet om ons een mailtje te sturen,
[email protected].
Voor meer vragen en probleemoplossingen kun je ook terecht op ons forum. Veel plezier met phpGB! Deze Manual is geschreven voor phpGB versie 1.0.x . De oudere manuals van voorgaande versies (als deze er zijn) zijn hieronder te vinden in PDF formaat.
Het kan voorkomen dat je gastenboek een foutmelding geeft bovenaan de pagina. Deze foutmelding ziet er dan uit als: Er is een fout opgetreden; Foutcode = 1 Raadpleeg de documentatie hierover op www.phpgb.net!
Deze Foutmeldingen hebben allemaal een eigen code. De codes staan hieronder met een eventuele oplossing voor het probleem. In principe hebben al deze foutmeldingen betrekking op de database. Maar dat zul je wel zien bij de uitleg van de code en de mogelijke oplossing.
Normaal gesproken komt de database met een eigen foutmelding, maar uit veiligheidsoverwegingen hebben we besloten om zelf een code te genereren waarbij de details van de server niet naar voren komen. In principe geldt voor alle foutcodes dat er een fout in een databasequerie is opgetreden. Meest voor de handliggende oplossing voor alle foutcodes is dat er gekeken moet worden naar de databaseprefix die bij het installeren is opgegeven. Download het bestand configuratie.php met je FTPClient en open het bestand met een Editor. Kijk of de prefix voor je databasetabellen juist is. De prefix is een herkenningsreeks voor de phpGB databasetabellen zodat je in je database deze tabellen kunt onderscheiden van de andere tabellen. Standaard staat deze ingesteld op phpgb_ zodat alle databasetabellen van phpGB beginnen met phpgb_ . Kijk na of alle tabellen in de database van phpgb beginnen met de prefix die in configuratie.php staat. Een tweede oorzaak is dat er met het installeren iets is misgegaan met het aanmaken van de databasetabel. In dit geval heb je een foutmelding gekregen tijdens het installeren. Kijk in dit geval bij installatie voor de te volgen procedure. Mocht je deze fout krijgen na verloop van tijd, dan heeft zich misschien een databaseprobleem voor gedaan. Repareer in dat geval de tabel. Meer informatie over het repareren van een tabel kun je vinden op het forum.
Foutcode 1: Deze foutcode heeft te maken de databasequerie die de configuratiegegevens ophaalt van het gastenboek.
Foutcode 1a: De querie voor het ophalen van de configuratiegegevens is goed gegaan, maar er treed een fout op bij het ophalen van de gegevens. Mocht je deze foutcode krijgen, post deze dan op het forum. Zet erbij onder welke omstandigheden je de foutmelding krijgt (OS, PHP versie, MySQL versie etc.).
Foutcode 2: Deze foutcode heeft te maken de databasequerie die kijkt of het IP-adres van de gebruiker overeenkomt met een IP-adres dat volgens de database geweerd moet worden.
Foutcode 5:
Copyright © 2004 www.phpgb.nl phpGB is sponsored by Je Mening.nl and powered by phpGB
Manual phpGB 1.0.x
Deze foutcode heeft te maken de databasequerie die de berichten ophaalt van het gastenboek.
Foutcode 10: Deze foutcode heeft te maken met het bepalen van het totaal aantal berichten. Dit wordt gebruikt voor de pagina bepaling.
Foutcode 12: Als er iets is misgegaan met het toevoegen van een bericht krijg je foutcode 12.
Foutcode 15: Als de beheerder een bericht bewerkt dan wordt er voor de zekerheid gecontroleerd of het bericht bestaat. Deze foutcode heeft te maken met de databasequerie die die controle uitvoert, er is iets misgegaan met de databaseopdracht.
Foutcode 16: Als de beheerder commentaar toevoegt bij een bericht dan wordt er voor de zekerheid gecontroleerd of het bericht bestaat. Deze foutcode heeft te maken met de databasequerie die die controle uitvoert, er is iets misgegaan met de databaseopdracht.
Foutcode 17: Als de beheerder een bericht wilt verwijderen dan wordt er voor de zekerheid gecontroleerd of het bericht bestaat. Deze foutcode heeft te maken met de databasequerie die die controle uitvoert, er is iets misgegaan met de databaseopdracht.
Foutcode 21: Deze code hoort bij foutcode 15. Er is iets misgegaan bij het controleren of het bericht, dat geupdate moet worden, bestaat (mysql_num_row) .
Foutcode 22: Deze code hoort bij foutcode 16. Er is iets misgegaan bij het controleren of het bericht, dat becommentarieerd moet worden, bestaat (mysql_num_row) .
Foutcode 23: Deze code hoort bij foutcode 17. Er is iets misgegaan bij het controleren of het bericht, dat verwijderd moet worden, bestaat (mysql_num_row) .
Foutcode 30: Er zit een fout in de querie die de instellingen bijwerkt zonder passwordverandering.
Foutcode 31: Er zit een fout in de querie die de instellingen bijwerkt met passwordverandering.
Foutcode 32: Na het updaten van de instellingen worden de configuratiewaarden opnieuw ingelezen om een accuraat beeld te krijgen. Als deze foutcode ontstaat is er iets misgegaan bij het opnieuw verkrijgen van de nieuwe configuratiewaarden waarbij er geen nieuw password is ingesteld.
Foutcode 33: Na het updaten van de instellingen worden de configuratiewaarden opnieuw ingelezen om een accuraat beeld te krijgen. Als deze foutcode ontstaat is er iets misgegaan bij het opnieuw verkrijgen van de nieuwe configuratiewaarden waarbij er wel een nieuw password is ingesteld.
Foutcode 40: Als de beheerder een IP-adres wilt toevoegen wordt er eerst gecontroleerd of het IP-adres al in de database staat. Deze foutcode heeft te maken met de databaseopdracht die dit controleert.
Foutcode 41: Als een geband IP-adres weer toegang mag krijgen wordt er eerste gecontroleerd of het IP-adres wel in
Copyright © 2004 www.phpgb.nl phpGB is sponsored by Je Mening.nl and powered by phpGB
Manual phpGB 1.0.x
de database staat. Als er iets misgaat met deze controle krijg je deze foutcode.
Foutcode 43: Deze foutcode heeft te maken de databasequerie die de ip-adressen ophaalt van het gastenboek.
Het installeren van phpGB begint met het downloaden van het ZIP pakket waarin alle bestanden staan die nodig zijn voor phpGB. Dit ZIP bestand kun je vinden bij downloads. Je kunt het bestand openen met o.a. WinZip. Als alles goed gaat worden alle bestanden en mappen uitgepakt en in een directory, genaamd phpgb, gezet. Er zit ook een leesmij_phpgb.txt bestand bij waar de installatie procedure nogmaals staat beschreven.
Upload alle bestanden en mappen naar je server toe en zorg ervoor dat je de mapstructuur behoudt zoals die is gemaakt bij het uitpakken van het ZIP bestand. Voor de installatie is het nodig om het bestand configuratie.php schrijfrechten te geven. Voor de Unix-systemen (Linux) betekent dit dat je het bestand CHMOD 777 moet geven. Als je niet zelf host kun je dat met je FTP-Client doen. Op Windowssystemen moet je read-only uit vinken. Als je zelf host op windows doe je dat met je rechtermuisknop, dan eigenschappen (of properties) en read-only uit vinken.
Als je alle bestanden geupload hebt en je hebt configuratie.php schrijfrechten gegeven, ga dan naar met je browser (Internet Explorer, Netscape, Mozilla, Opera etc.) naar het bestand install_phpgb.php in de desbetreffende map. Als je het gastenboek in de map phpgb hebt laten staan is het dus: http://www.jouw_site.nl/phpgb/install_phpgb.php
Je krijgt dan een aantal velden te zien die ingevuld dienen te worden. Bij Loginnaam moet je de loginnaam (userid) invullen die je wilt gaan gebruiken voor de beheerder. Bij de passwords moet je twee keer hetzelfde password invullen. De tweede keer is ter controle. Daaronder moeten de databasegegevens worden ingevuld. Als het goed is heb je van je Internet Service Provider (ISP) hiervoor gegevens gekregen of instructies om deze gegevens zelf aan te maken. Als je dit niet hebt, neem dan contact op met je ISP en vraag ernaar! Als je zelf een server hebt met een MySQL database heb je waarschijnlijk genoeg verstand van zaken om dit in te vullen.
De tabellenprefix staat standaard op phpgb_. Deze prefix is niets meer dan een herkenningsmechaniek voor de databasetabellen. Dit kun je dus gewoon laten staan op phpgb_. Mocht je meerdere gastenboeken gaan hosten op dezelfde database dan moet je wel bij de volgende gastenboeken een andere prefix nemen om foutmeldingen te voorkomen.
Het laatste veld dat ingevuld moet worden is het gastenboekURL. Vul hier de URL, inclusief de map waarin het gastenboek staat, in en sluit dit af met een slash /. Als je zelf een windowsserver hebt gebruik dan het volledige pad, bijvoorbeeld c:\mijn documenten\phpgb\ en sluit af met een backslash \. Dit is noodzakelijk om foutmeldingen te voorkomen.
Als alle velden juist zijn ingevuld, klik dan op de knop Installeer. Als alles goed is gegaan zijn de databasetabellen aangemaakt en zijn de juiste gegevens al ingevoerd. Het installatieproces probeert, nadat alles goed is gegaan, het bestand configuratie.php de schrijfrechten weer te ontnemen. Als dit niet is gelukt krijg je daarvan een melding. De installatie is dan wel gelukt, maar je moet het bestand zelf de schrijfrechten ontnemen. Op Windows moet je read-only aanvinken, op Unix-systemen (Linux) moet je het bestand CHMOD 755 geven.
Fout Oplossing Tijdens de installatie kun je een aantal foutmeldingen krijgen doordat de instructies niet goed gelezen zijn of doordat de instructies misschien niet duidelijk genoeg zijn uitgelegd. Je krijgt een foutmelding als je geen Loginnaam hebt ingevuld. Ook als je de passwoorden leeg hebt gelaten en/of wanneer de twee Copyright © 2004 www.phpgb.nl phpGB is sponsored by Je Mening.nl and powered by phpGB
Manual phpGB 1.0.x
passwords niet overeen komen krijg je een foutmelding. Op dat moment is er nog niets aangemaakt in de database. Je kunt dus opnieuw een Loginnaam invoeren en twee keer het password.
Vervolgens worden de gegevens voor de databaseverbinding gecheckt. Dit gebeurt door middel van een verbinding die wordt gemaakt met de databaseserver. Als deze verbinding niet tot stand kan komen zijn de databasegegevens niet goed. Je krijgt dan ook een foutmelding. Als deze gegevens wel goed zijn wordt er gekeken of de database zelf gevonden kan worden. Als dit niet het geval is krijg je hierover een foutmelding. Mocht je deze foutmeldingen krijgen dan kun je alles weer gewoon opnieuw invullen met de juiste gegevens. Er is nog niets in de database aangemaakt, immers, er kon geen verbinding worden gemaakt. Als er wel verbinding is gemaakt met de databaseserver en de database is gevonden wordt geprobeerd om een aantal tabellen aan te maken en gegevens in die tabellen te voeren. Als dit niet lukt doordat de gegevens van de gebruiker geen schrijfrechten naar de database heeft, dan krijg je een foutmelding. Zorg er in dat geval voor dat je de juiste rechten hebt om naar de database toe te schrijven. Raadpleeg desnoods je ISP voor deze gegevens. Bij de foutmelding krijg je te zien welke tabellen zijn aangemaakt en welke niet. Verwijder de aangemaakte tabellen als ze niet allemaal zijn aangemaakt en voer de installatie opnieuw uit met de juiste gegevens. Hetzelfde geldt voor het invoegen van de gegevens.
Wanneer de databasetabellen zijn aangemaakt en de gegevens zijn ingevoegd, gaat de installatieprocedure proberen om het bestand configuratie.php te beschrijven met de door jou ingevoerde gegevens voor de databaseverbinding, de tabelprefix en het gastenboek URL. Als het bestand schrijfrechten heeft, moet er geen probleem zijn. Mocht het bestand geen schrijfrechten hebben dan probeert de installatieprocedure deze te geven. Mocht dit niet lukken dan zul je handmatig de configuratie aan moeten passen. Daarover verderop meer.
Bij het succesvol schrijven naar het configuratiebestand wordt geprobeerd om het bestand te ontdoen van de schrijfrechten. Als dit niet lukt komt er een melding. De installatie is verder helemaal gelukt en in principe kun je verder met je gastenboek. Ontneem voor de zekerheid de schrijfrechten van het bestand. Als je een foutmelding hebt gekregen bij het schrijven naar het configuratiebestand moet je deze handmatig invoeren zodat je gewoon aan de slag kan met je gastenboek. Open daartoe het bestand configuratie.php met een Editor (Kladblok, Textpad, WordPad etc.). Je krijgt dan onderstaande structuur te zien:
// //Hieronder worden de variabelen beschreven die nodig zijn voor de databaseconnectie. // $db_server = 'DBSERVER'; $db_usernaam = 'DBUSERNAAM'; $db_password = 'DBPASSWORD'; $db_naam = 'DBNAAM';
//DataBase-Host (ip-adres of servernaam) //UserNaam om in te loggen op je Database //Password om in te loggen op je Database //DataBase die je gebruikt voor het gastenboek
// //Hieronder staan de gegevens van het gastenboek // $db_prefix = 'DBPREFIX'; //De prefix voor je databasetabellen $sGastenBoekURL = 'GBURL'; //De url en de map waarin de bestanden van het gastenboek staan. Let op! er moet een slash / aan het eind!!
Vervang DBSERVER met de naam of ip-adres van je databasehost. Hetzelfde geldt voor de overige gegevens, DBUSERNAAM, DBPASSWORD, DBNAAM, DBPREFIX, GBURL. Upload het bestand vervolgens naar de server waar het gastenboek op draait en je kunt aan de slag met je gastenboek.
Hopelijk heb je iets gehad aan deze installatieprocedure en probleemoplossing. Zo niet, stel je vraag Copyright © 2004 www.phpgb.nl phpGB is sponsored by Je Mening.nl and powered by phpGB
Manual phpGB 1.0.x
en/of probleem dan op het forum. Veel plezier met phpGB!
Om een bericht te plaatsen in het gastenboek moet je klikken op de regel Klik hier om een bericht achter te laten. Je wordt doorgestuurd naar het formulier waar je het bericht kunt plaatsen. Vul alle velden in. Het is verplicht om een naam en een geldig e-mail adres in te vullen, hier wordt op gecontroleerd. Ook moet je een bericht plaatsen, daar is het gastenboek immers voor.
Je kunt gebruik maken van een beperkt aantal BB-codes (een alternatief HTML, webtaal) waarmee je eenvoudige dingen zoals een e-mail adres, een url, een quote, vette letters, schuine letters en onderstreepte letters kunt maken. Afhankelijk van de beheerder kan BB-code uit- en ingeschakeld zijn. Smilies kunnen ook uit- en ingeschakeld zijn. Als ze zijn ingeschakeld zie je zie bij het posten van het bericht. Klik op de smilie van je keus, en de smiliecode verschijnt in het tekstvlak. Druk op de knop Bericht toevoegen om het bericht naar het gastenboek te verzenden.
Het Berichten Beheer is de eerste pagina in het Beheerders paneel. Hier kun je de tekst van geposte berichten aanpassen, commentaar geven op berichten en berichten verwijderen. Bovenaan de pagina kun je navigeren tussen de beheerder pagina's door.
Naast de berichten en eventueel eerder geplaatst commentaar, krijgt de beheerder ook altijd het e-mail adres te zien. Het IP-adres van de poster wordt ook getoond aan de beheerder. Om een bericht te wijzigen kun je de tekst die in het grote invulveld aan de rechterkant bewerken. Dit is in principe bedoeld voor tekst die doorgaans niet op een gastenboek thuis hoort. De beheerder heeft hiermee een belangrijke tool in handen omdat de beheerder feitelijk berichten geheel kan veranderen en daarmee mensen in discrediet zou kunnen brengen.
Aangeraden wordt dan ook om de commentaar functie te gebruiken. Eerder geplaatst commentaar kan gewijzigd worden in het zelfde invulvuld. Dit is het kleinere invulveld aan de rechterkant. Op het gastenboek zelf komt een aparte tabel met het commentaar te staan.
Om een bericht in zijn geheel te verwijderen hoef je alleen maar op de knop Verwijder Bericht te klikken. Er wordt dan een pop-up getoond als het goed is met de vraag of je het bericht ook daadwerkelijk wilt verwijderen. Klik op Ok als je het bericht definitief wilt verwijderen of klik op Annuleer als het niet de bedoeling was.
Bij de Algemene Instellingen kun je zowel de instellingen van het gastenboek aanpassen alsmede het password van de beheerder. Ook de lay-out van het gastenboek kan aangepast worden. Denk hierbij aan de kleuren en de lettertypes. Bovenaan de pagina kun je navigeren tussen de beheerder pagina's door. Hieronder worden alle velden van de Algemene Instellingen besproken. Niet alle velden zijn verplicht, maar sommige kun je beter niet leeglaten! Lees hieronder meer...
Copyright © 2004 www.phpgb.nl phpGB is sponsored by Je Mening.nl and powered by phpGB
Manual phpGB 1.0.x
Als eerste krijg je het UserID van de beheerder te zien. Dit kun je niet aanpassen. Wil je dit wel aanpassen dan zul je zelf een verandering in de databasetabel moeten maken.
Om je Password te veranderen moet je je nieuwe password 2 keer invullen. De tweede keer is ter controle. Het password wordt versleuteld en vervolgens in de database gezet. Als je de velden leeg laat verander je het password niet. Je hoeft dus niet je huidige password in te vullen om veranderingen te maken.
Bij Naam kun je je eigen naam invullen. Deze krijg je alleen te zien als je als beheerder bent ingelogd. Je wordt dan 'begroet' bovenaan de pagina. Het E-mail adres is het adres waar een eventuele waarschuwing heen moet als er een nieuw bericht is geplaatst. Zorg er daarom voor dat dit een geldig e-mail adres is!
Bij Website Titel kun je de titel van je eigen website opgeven. Deze titel komt op het gastenboek zelf naar voren, maar ook in de pagina titel, de balk bovenaan het venster.
Als je bovenaan het gastenboek een link wilt hebben naar je eigen website, vul dan bij Eigen Website URL de URL van je eigen website in. Als je het vakje leeglaat verschijnt er geen link op het gastenboek.
Tijdens het installeren moest je de URL opgeven waar het gastenboek zou komen te staan. Bij Gastenboek URL kun je zien of dat klopt. Dit moet in orde zijn omdat o.a. e-mails de URL van het gastenboek bevatten. Mocht de URL niet goed zijn, dan kun je dit in het configuratiebestand configuratie.php nog aanpassen.
Als je gewaarschuwd wilt worden wanneer er een bericht is geplaatst moet je E-mail waarschuwing op ja zetten. Als je dit gedaan hebt wordt er gecontroleerd of je een geldig e-mail adres hebt ingevuld. Is dit niet het geval dan krijg je een foutmelding. Klik op ja bij Smilies Toestaan om de smilies te activeren. Als je dit toestaat dan zijn er smilies te zien bij het toevoegen van een bericht en in de berichten zelf. Als je dit niet toestaat zijn er geen smilies te zien bij de berichten, alleen de zogenaamde smiliecodes.
Het smilie verhaal geldt ook voor de BB-code. BB-code is een alternatief voor HTML. HTML is website taal waarmee websites worden gemaakt. De mensen van phpBB hebben daar een hele mooie uitleg gemaakt die te lezen is op het forum. De BB-codes die op het gastenboek te gebruiken zijn, zijn: vet, schuin, onderstreept, e-mail adres, url en quote. Bij de Mods kun je vinden hoe je zelf BB-codes kunt toevoegen.
Stel het aantal Berichten per pagina in door hier een getal neer te zetten. Als je geen getal invult of het veld leeg laat of een nul invult krijg je een foutmelding. Je moet dus een getal invullen groter dan nul. De Welkomsttekst is de tekst die je bovenaan het gasten te zien krijgt. Je kunt hier gebruik maken van HTML en niet van BB-code. Omdat je gebruik kunt maken van HTML bestaat de kans dat je ook e.e.a. aan je instellingen kunt verpesten. Werk daarom alleen met HTML als je zeker weet wat je doet! Als hier te veel klachten over komen dan verwerken we in de volgende versie alleen BB-code.
De lay-out van het gastenboek kun je in beperkte mate via de Algemene Instellingen bewerken. In principe kun je alle kleuren bewerken en een achtergrond-image plaatsen. Onderaan kun je het adres van een logo invullen. LET OP! Dit gastenboek maakt gebruik van Hexidecimale kleurwaardes! Iedere kleur heeft een kleurcode. Het gastenboek werkt dus niet met termen als darkgreen
Fout Oplossing Ondanks het feit dat alles uitvoerig is getest, is het niet ondenkbaar dat er iets mis zou kunnen gaan met de kleurinstellingen waardoor je een gedeelte van het gastenboek niet meer kunt zien. Of nog erger, je ziet een hele zwarte pagina waarin geen tekst meer te onderscheiden is. Als je niet meer bij de
Copyright © 2004 www.phpgb.nl phpGB is sponsored by Je Mening.nl and powered by phpGB
Manual phpGB 1.0.x
instellingen kunt komen doordat de kleurcodes je hele pagina in de war gooien is er nog 1 alternatief dat je kunt gebruiken om toch weer bij je instellingen te komen.
Download het bestand header.php met je FTP client en open het met je Editor. Zoek daarin de regel: define('P_EXTERNE_SHEET', false); En vervang deze regel door: define('P_EXTERNE_SHEET', true); Eigenlijk vervang je het woord false door het woord true. Door dit te doen geef je de pagina opdracht om gebruik te maken van een extern stylesheet waarin de standaard waarden staan gedefinieerd. Je kunt nu weer bij de instellingen om daar weer alles in orde te maken. Als je je eigen instellingen weer in orde hebt gemaakt, zet dan de regel hierboven weer op false anders blijft het externe stylesheet in gebruik.
Bij de beheer van de IP-adressen kun je een IP-adres weren van het gastenboek, ook kun je IPadressen die geweerd worden weer toegang geven tot het gastenboek. Om achter het IP-adres van een bezoeker te komen, moet je bij GB-Beheer kijken. Daar staat bij ieder gepost bericht het IP-adres van de persoon die het gepost heeft. Kopieer dit IP-adres en plak het in het veld bij de IP-Ban. Klik vervolgens op Toevoegen en je zult zien dat het IP-adres aan de rechterkant staat.
Als je een IP-adres weer toegang wilt geven tot het gastenboek nadat het geband was, hoef je het IPadres alleen maar aan te vinken en op Verwijderen te klikken en het IP-adres wordt uit de IP-ban verwijderd.
Een IP-ban is niet helemaal waterdicht. Personen kunnen vanaf andere computers (met een ander IPadres) gewoon weer bij het gastenboek. Daarnaast leveren verschillende Internet Providers een dynamisch IP-adres bij hun pakketten waardoor iedere abbonnee om de zoveel tijd een ander IP-adres krijgt. Ook het gebruik van Internet Routers en andere mechanieken kunnen voorkomen dat de IP-ban 100% waterdicht is. Mocht een bepaald persoon zich dermate gedragen dat je z'n gedrag als hinderlijk of beledigend kan beschouwen, neem dan contact op met je eigen Internet Provider. Vertel ze van je klacht en geef het IP-adres door waaronder de persoon op dat moment gepost heeft. Op die manier zal de persoon naar alle waarschijnlijkheid worden aangesproken op z'n gedrag door een officiele instantie.
Copyright © 2004 www.phpgb.nl phpGB is sponsored by Je Mening.nl and powered by phpGB