jsFAQ ist eine kleine FAQ-Datenbank für die eigene Homepage. Mit jsFAQ können mehrere Produkte verwaltet werden. Die FAQ-Einträge können in mehrere Bereiche unterteilt werden. Am Anfang der Seite kann ein Inhaltsverzeichnis angezeigt werden. Die gesamte Verwaltung erfolgt via Web. Unix/(Windows), deutsch, kostenlos.
Die Informationsseite zum Script inkl. Downloadmöglichkeit und Online-Demo finden Sie hier!
jsFAQ ist eine FAQ-Datenbank für die eigene Homepage mit folgenden Funktionen:
Nebst einem Webserver mit Perl/CGI Unterstützung wird nichts weiteres vorausgesetzt.
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.
Folgende Dateien müssen kopiert und mit den entsprechenden Berechtigungen versehen werden:
|
|
Anmerkung: Die mit (*) gekennzeichneten Dateien befinden sich nicht im ZIP-Archiv und werden erst im Betrieb erstellt.
Je nach Konfiguration des Webservers werden keine Bilder aus dem cgi-bin Verzeichnis angezeigt. Deshalb wird empfohlen, die Bilder in ein Verzeichnis ausserhalb von cgi-bin zu kopieren und die entsprechenden Bildpfade im Adminbereich anzupassen. Die Standard-Konfiguration des Scripts geht davon aus, dass Bilder im cgi-bin Verzeichnis angezeigt werden können und auch dort abgespeichert sind. Bei einer Änderung der Installations-Verzeichnisse ist zwingend eine Anpassung im Adminbereich notwendig.
jsfaq.cgi benötigt Schreibzugriff auf das Script-Verzeichnis. Dazu ist - je nach Konfiguration des Webservers - ein chmod 777 für das Verzeichnis notwendig. Möglicherweise meldet das Script nach dem chmod 777 jedoch einen "Internal Server Error". Zuerst sollte also immer chmod 755 versucht werden.
Um das Script aufzurufen, stehen folgende URLs zur Verfügung:
| /cgi-bin/jsfaq/jsfaq.cgi?product=meinbereich | FAQ für "meinbereich" |
| /cgi-bin/jsfaq/jsfaq.cgi?action=admin | Administrationsbereich (Passwortgeschützt) |
Die Konfiguration erfolgt zum grössten Teil via Web. Die URL für den Administrationsbereich lautet: http://www.meinserver.ch/cgi-bin/jsfaq/jsfaq.cgi?action=admin
Beim ersten Login lautet der Benutzername admin, kein Passwort. Aus Sicherheitsgrünen sollten Sie schnellstmöglich ein Passwort setzen. Wählen Sie dazu im Adminbereich den Link "Login-Daten ändern".
Zu diesem Zeitpunkt werden - je nach Installationspfaden - möglicherweise noch keine Bilder angezeigt, dies hat aber nichts weiter zu bedeuten...
In diesem Abschnitt können Sie die Pfade zu Bildern und Templates konfigurieren:
| Daten-Datei (temporär) | Datendatei mit Session-IDs für den Adminbereich |
| Error-Datei | Fehler-Protokoll der fehlerhaften Loginversuche |
| Copyright | Copyright-Hinweise im Adminbereich |
| CSS für Adminbereich | CSS-Stylesheet für Adminbereich |
| Bilder-Verzeichnis | Browser-Pfad zum Verzeichnis, in dem die Bilder gespeichert sind (mit abschliessendem /) |
| diverse Bilder | Dateiname diverser Bilder, relativ zum Bilderverzeichnis |
| FAQ Template | HTML-Template für FAQ-Bereich (UNIX-Pfad) |
| Datei "Allgemeine Fragen" | FAQ-Datei für allgemeine Fragen, welche bei jedem Produkt angezeigt werden. |
In diesem Bereich können die einzelnen FAQs konfiguriert werden. Für jedes Produkt sind folgende Einstellungen notwendig:
| Name | Produkt-Name. Muss der URL übergeben werden und sollte keine Leer- und Sonderzeichen beinhalten |
| Dateiname | Dateiname der Daten-Datei (UNIX-Pfad) |
| Beschreibung | Titel des Produkts (kann in Template angezeigt werden) |
In diesem Menü können die einzelnen Inserate editiert oder gelöscht werden.
Jeder Schreibzugriff auf eine Datei wird mit einer betriebssystem-unabhängigen Dateisperre versehen. Diese Dateisperre sollte in der Regel wieder aufgehoben werden, kann aber in Ausnahmefällen (z.B. Script-Absturz) erhalten bleiben.
In der Regel kann die Datei wieder via Adminoberfläche entsperrt werden. Falls dies nicht geht, muss die entsprechende lock-Datei gelöscht werden (Beispiel: Lock-Datei für config.pl heisst config.pl.lock).
Der Online Versions-Check ist eine einfache Möglichkeit, zu überprüfen, ob die eingesetzte Version noch aktuell ist.
Um den Versions-Check zu starten, muss man auf den Link bei der Versions-Nummer unten rechts klicken. Danach wird eine Verbindung mit dem Server von cgicorner.ch hergestellt. Dazu ist eine Internet-Verbindung notwendig.
Es wird nur die Versionsnummer sowie das letzte Änderungsdatum an den Server von cgicorner.ch übermittelt. cgicorner.ch garantiert, dass keine weiteren Konfigurationseinstellungen oder Benutzerdaten gesendet werden. Der Browser übermittelt möglicherweise noch den Referer, der mögliche Informationen über den Einsatzort liefert. Wenn Sie dies nicht möchten, installieren Sie eine Personal-Firewall, welcher die Referer-Informationen blockiert oder kopieren Sie den Link in die Zwischenablage und fügen Sie ihn manuell in die Browser-Adressleiste ein.
Ein Template kann vereinfacht wie folgt dargestellt werden:
<html>
<body>
<h1>FAQ für <!--productname--></h1>
<!--index_title-->
<h2><!--title--></h2>
<!--/index_title-->
<!--index_link-->
<a href="#FAQ_<!--count-->"><!--question--></a><br />
<!--/index_link-->
<!--showIndex-->
<table border="0" width="100%">
<!--content_title-->
<tr><td> </td></tr>
<tr><td><h2><!--title--></h2></td></tr>
<!--/content_title-->
<!--content_question-->
<tr><td class="blue" valign="top"><a name="FAQ_<!--count-->"></a><!--question--></td></tr>
<!--/content_question-->
<!--content_answer-->
<tr><td class="grey"><!--answer--></td></tr>
<tr><td> </td></tr>
<!--/content_answer-->
<!--showFAQ-->
</table>
</body>
</html>
Im allgemeinen Text (schwarz) wird das Grundgerüst für das Template festgelegt. Dort sind zwei Felder möglich:
In diesem Template müssen nun mehrere Bereiche definiert werden:
| Copyright © 2008 by Jürg Sommer, scripts@cgicorner.ch http://www.cgicorner.ch |
Letzte Änderung: 21. Februar 2008 |