FAQ - Script gaesteform

Transkript

1 FAQ - Script gaesteform 9. April 2009 Salvatore Spadaro 1

2 2 Inhaltsverzeichnis 1 Script - gaesteform Welchen Funktionumfang bietet das Script gaesteform und welche Technik steckt dahinter? Wie kann ich das Script meinen Bedürfnissen anpassen? Datei config.inc.php Welche Fehler können auftreten und wie kann ich diese beheben? Bei Aufruf des Scripts erhalte ich eine leere Seite, wo liegt der Fehler? Welche Dateirechte muss ich ggf. setzten? Der Anti-Spam-Code bleibt stehen Wie kann ich Einträge bearbeiten und löschen? In welche Datei werden die Gästebuch-Einträge geschrieben? Script einbinden An wen kann ich mich wenden, wenn ich Hilfestellungen benötige oder Feedback loswerden möchte?

3 3 1 Script - gaesteform Das Script GaesteForm ist ein Hyprid aus Gästebuch und Formmailer mit den wichtigsten Grundfunktionen, welches Sie über eine Konfigurationsdatei von einem Gästebuch in ein Formmailer oder umgekehrt umwandeln können. Mit ein wenig PHP- oder HTML-Kenntnissen können Sie es in Ihre Homepage einbinden. Bitte beachten Sie, dass sich das Script noch in der Beta-Phase bzw. in einem frühen Entwicklungsstadium befindet. In den ausgibigen Testes konnte ich zwar keine Fehler feststellen, jeodch sind diese nicht ausgeschlossen, da in so kurzer Zeit nicht alles getestet werden kann. 1.1 Welchen Funktionumfang bietet das Script gaesteform und welche Technik steckt dahinter? Bearbeiten und Löschen von Einträgen Spam-Schutz durch Ziffern-Abfrage (Captcha) lässt sich einfach in die bestehnde Homepage einbauen -Adressen in Einträgen werden verschlüsselt Benutzereingaben werden gefiltert optionale -Benachrichtigung bei neuen Einträgen -Adresse muss gültiges Format aufweisen Einträge können als RSS-2.0-Feed abonniert werden Formatierung über CSS Quelltext aus stnadartkonformem XHTML 1.0 strict und CSS das Script wurde in PHP5 entwickelt, eine Kompatibiltät zu PHP4 kann nicht garantiert werden! 1.2 Wie kann ich das Script meinen Bedürfnissen anpassen? Die Konfiguration erfolgt ausschließlich über die Datei config.inc.php, welche im Verzeichnis includes liegt, Sie können die Datei mit jedem ASCII-kompatiblen Editor bearbeiten. In der Konfigurationsdatei können Sie bspw. einstellen, ob eine Mailbenachrichting bei neuen Einträgen erfolgt, das Feld ein Pflichtfeld ist usw. Wenn Sie Einträge über die Datei bearbeiten.php editieren oder löschen möchten, müssen Sie in der Konfigurationsdatei erst ein neues Passwort eintragen. Durch die Kommentare sollte die Handhabung der Konfigurationsdatei klar sein Datei config.inc.php 1 <?php 2 / K O N F I G U R A T I O N / 3 / / Error Reporting s o l l t e im Produktivsystem auf 0 stehen 4 e r r o r r e p o r t i n g ( 1 ) ; 5 $formmailmodus = f a l s e ; / / t r u e : Kontaktformular f a l s e : Gaestebuch 6 / / Anzahl Eintraege pro Seite 7 $int itemsperpage = 10; 8 / / a l l e Variablen s o l l t e n v o r b e l e g t werden um Fremdmanipulation zu vermeiden 9 $adminuser = ; 10 $adminpwd = ;

4 11 / / Bearbeiten und L s c h e n von Eintraegen 12 / / Zugang zur bearbeiten. php 13 $adminuser = admin ; / / h i e r b i t t e Benutzernamen d e f i n i e r e n 14 $adminpwd = admin ; / / h i e r b i t t e Passwort d e f i n i e r e n 15 / / f a l s e : Mailadresse muss n i c h t angegeben werden 16 / / t r u e : Mailadresse muss angegeben werden / / Wird das Gaestebuch eingebunden? 19 $gbincludemodus = f a l s e ; / / Feldgroessen 22 $sizefield = 40; / / P f l i c h t f e l d e r 25 $fieldnamerequired= t r u e ; 26 $ f i e l d S t r e e t R e q u i r e d = f a l s e ; 27 $fieldpostcoderequired= f a l s e ; 28 $ f i e l d C i t y R e q u i r e d = f a l s e ; 29 $field required=true ; 30 $fieldphonerequired= f a l s e ; 31 $fieldfaxrequired= f a l s e ; 32 $fieldtextarearequired= f a l s e ; $ recipient = ; / / Mailadresse des Empfaengers 35 $ e m a i l N o t i f i e r = f a l s e ; / / Mailbenachrichtigung ein= t r u e aus= f a l s e i f ( t r u e ===$formmailmodus ) { 38 $ s i t e T i t l e = Kontaktformular ; 39 / / Optionen Mail Benachrichtigung bei Neu E i n t r a g 40 $arg formmailmodustitle = Form Mail ; 41 $arg formmailmodusfrom = ; 42 $arg formmailmodussubject = neue Anfrage ; 43 / / Felder ein / ausblenden 44 $fieldnamedisplay= t r u e ; 45 $ f i e l d S t r e e t D i s p l a y = t r u e ; 46 $fieldpostcodedisplay= t r u e ; 47 $ f i e l d C i t y D i s p l a y = t r u e ; 48 $ f i e l d E m a i l D i s p l a y = t r u e ; 49 $fieldphonedisplay= t r u e ; 50 $ f i e l d F a x D i s p l a y = t r u e ; 51 $ f i e l d T e x t a r e a D i s p l a y = t r u e ; 52 } else { 53 $ s i t e T i t l e = Gaestebuch ; 54 / / Optionen Mail Benachrichtigung bei Neu E i n t r a g 55 / / From und Subject 56 $headers= array ( From =>, Subject => neuer Gaestebucheintrag ) ; 57 / / Bodytext 58 $body text = Neuer Gaestebucheintrag auf. $ SERVER [ HTTP HOST ] ; 59 / / Felder ein / ausblenden 60 $fieldnamedisplay= t r u e ; 61 $ f i e l d S t r e e t D i s p l a y = f a l s e ; 62 $fieldpostcodedisplay= f a l s e ; 63 $ f i e l d C i t y D i s p l a y = f a l s e ; 64 $ f i e l d E m a i l D i s p l a y = t r u e ; 65 $fieldphonedisplay= f a l s e ; 66 $ f i e l d F a x D i s p l a y = f a l s e ; 67 $ f i e l d T e x t a r e a D i s p l a y = t r u e ; 68 4

5 69 } / / Timestamp f u e r Eintraege 72 $timestamp = time ( ) ; 73 $datum = date ( d.m. Y, $timestamp ) ; 74 $ u h r z e i t = date ( H: i, $timestamp ) ; 75 / / RSS Feed : I n f o s 76 $ a r g h e a d e r T i t l e = RSS Feed ; / / < t i t l e > 77 $arg headerlink = h t t p : / /. $ SERVER [ HTTP HOST ]. / gaesteform / ; / / <l i n k > 78 $arg headerdescr = ; / /<d e s c r i p t i o n > 79 $arg headerlanguage = de de ; / / <language> 80 $arg headercopyright = h t t p : / /. $ SERVER [ HTTP HOST ] ; / / <l i n k >; / / <copyright > 81 $arg headerurlimage = ; / /<image><u r l > 82 / / <item> 83 $ a r g i t e m T i t l e = ; / / < t i t l e > 84 $arg itemdescr = ; / / <d e s c r i p t i o n > 85 $arg itemlink = h t t p : / /. $ SERVER [ HTTP HOST ] ; / / <l i n k > 86 $arg itemauthor = ; / / <author> 87 $arg itempubdate = date ( D, j M Y H: i : s \G\M\T, time ( ) ) ; 88 / / </ item> / / Konstanten 91 define ( PATH SCRIPT, gaesteform / ) ; 92 #echo PATH SCRIPT :. PATH SCRIPT. < br / > ; define ( PATH SCRIPT INCLUDE, gaesteform / i n c l u d e / ) ; 95 #echo PATH SCRIPT INCLUDE :. PATH SCRIPT INCLUDE. < br / > ; define ( ABSOLUTE PATH INCLUDE,$ SERVER [ DOCUMENT ROOT ]. PATH SCRIPT INCLUDE ) ; 98 #echo ABSOLUTE PATH INCLUDE :. ABSOLUTE PATH INCLUDE. < br / > ; define ( ABSOLUTE PATH SCRIPT,$ SERVER [ DOCUMENT ROOT ]. PATH SCRIPT ) ; 101 #echo ABSOLUTE PATH SCRIPT :. ABSOLUTE PATH SCRIPT. < br / > ; define ( FILE SAVED ITEMS,ABSOLUTE PATH INCLUDE. g b e i n t r a g. i n c. php ) ; 104 #echo FILE SAVED ITEMS :. FILE SAVED ITEMS. < br / > ; define ( FILE RSS,ABSOLUTE PATH INCLUDE. postings. i n c. xml ) ; 107 #echo FILE RSS :. FILE RSS. < br / > ; define ( URL PATH INCLUDE, h t t p : / /. $ SERVER [ HTTP HOST ]. /. PATH SCRIPT INCLUDE ) ; 110 #echo URL PATH INCLUDE :. URL PATH INCLUDE. < br / > ; define ( URL PATH SCRIPT, h t t p : / /. $ SERVER [ HTTP HOST ]. /. PATH SCRIPT ) ; 113 #echo URL PATH SCRIPT :. URL PATH SCRIPT. < br / > ; define ( FILE KLAMMER AFFE,URL PATH INCLUDE. klammeraffe. i n c. php ) ; 116 #echo FILE KLAMMER AFFE :. FILE KLAMMER AFFE. < br / > ; / / At Zeichen vor Crawlern verstecken 119 / /<img src = i n c l u d e / klammeraffe. i n c. php a l t = klammeraffe ></img > ; 120 define ( STRING KLAMMER AFFE, <img src =. FILE KLAMMER AFFE. a l t = klammeraffe /> ) ; 121 #echo STRING KLAMMER AFFE :. STRING KLAMMER AFFE. < br / > ; 122?> 5

6 6 1.3 Welche Fehler können auftreten und wie kann ich diese beheben? Bei Aufruf des Scripts erhalte ich eine leere Seite, wo liegt der Fehler? Vermutlich ist das PHP Framework PEAR auf dem Server nicht installiert oder aktiviert, wenden Sie sich in diesem Falle bitte an Ihren Provider Welche Dateirechte muss ich ggf. setzten? Das Verzeichnis include muss volle Dateirechte haben, da das Script ansonsten nicht funktioniert. Im FTP-Programm müssen Sie also ggf. den Befehl chmod 777 auf das Verzeichnis anwenden Der Anti-Spam-Code bleibt stehen Löschen Sie die Datei newcaptcha.png, das Script legt die Datei dann automatisch wieder an.

7 7 1.4 Wie kann ich Einträge bearbeiten und löschen? Über die Datei bearbeiten.php können Sie, nach Eingabe Ihres in der Konfigurationsdatei definierten Passworts, Einträge bearbeiten und löschen. Bitte vergessen Sie nicht nach getaner Arbeit sich über den Link ABMELDEN auszuloggen. 1.5 In welche Datei werden die Gästebuch-Einträge geschrieben? Die Gästebuch-Einträge werden in der Datei gb eintrag.inc.php im Verzeichnis include abgelegt. 1.6 Script einbinden 1 / 2 M o e g l i c h k e i t 1 einbinden ber include Befehl ( Datei muss mit. php enden ) 3 / 4 <?php 5 i n c l u d e ( PFAD/ index. php ) ; 6?> 7 / / M o e g l i c h k e i t 2 iframe, Session muss h i e r n i c h t g e s t a r t e t werden 8 <iframe src= PFAD/ index. php width= 520px height= 620px s t y l e = border : none ; overflow x 1.7 An wen kann ich mich wenden, wenn ich Hilfestellungen benötige oder Feedback loswerden möchte? Die Seite ist die Hilfeseite für Kunden und Interessenten des Domain-Service-Providers Pearl Consulting & Communication GmbH, sollten Sie Fragen zum Script haben, wenden Sie sich bitte direkt an: Pearl Consulting Communication GmbH Pearlstraße 3 D Buggingen Internet: info[at]pearl-online.net