Die Informationsseite zum Script inkl. Downloadmöglichkeit und Online-Demo finden Sie hier!
|
|
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 Ängerung der Installations-Verzeichnisse ist zwingend eine Anpassung im Adminbereich notwendig.
jsmarket.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.
Pfade und Dateinamen zu Bildern im Benutzer-Bereich (z.B. Kamera-Symbol bei Inserat mit Grafik) werden direkt in den entsprechenden Templates definiert (Kamera-Gif: *.list-Datei). Sofern das image-Verzeichnis ausserhalb des cgi-bin Verzeichnisses liegt, sollte dort der Pfad angepasst werden.
| Pfad zu sendmail | Definiert den Pfad zu sendmail, notwendig für den Versand der Statistik per E-Mail |
| Zeitverschiebung | Legt die Zeitverschiebung in Stunden fest, z.B. wenn der Server in einer anderen Zeitzone steht und man trotzdem die lokale Zeit loggen möchte. |
| Daten-Datei (temporär) | Datei für temporäre Daten (letzte SIDs) |
| Error-Datei | Logfile für fehlerhafte Login-Versuche |
| Copyright | Copyright-Information (sichtbar in dem Administrationsbereich) |
| CSS für Administrationsbereich | CSS-Datei für die Administrationsoberfläche |
| allg. Bilderverzeichnis | Pfad zu den Bildern, nachfolgende GIFs für den Administrationsbereich sind abhängig von diesem Pfad, ebenfalls steht dieses Verzeichnis bei allen Templates mit <!--imgDir--> zur Verfügung. (Browser-Pfad) |
| Diverse Images | Ablageort und Dateiname der einzelnen Bilder der Admin-Oberfläche. Browser-Pfad, in Abhängigkeit mit dem allg. Bilderverzeichnis. |
| Bei neuem Eintrag Mail an | Hier kann eine E-Mail Adresse eingetragen werden, an die bei jedem neuen Inserat oder einer Änderung eines bestehenden Inserates ein Mail gesendet wird. |
| Template: Admin-Info Mail | Template für das Mail an den Administrator |
| Validierung E-Mail Adressen notwendig | Legt fest, ob bei neuen Inseraten zuerst noch die E-Mail Adresse des Inserenten bestätigt werden muss. |
| Flood-Sperre (Inserate von selber IP) | Die Flood-Sperre legt fest, dass innerhalb eines definierten Zeitraumes von der gleichen IP nur ein Inserat erfasst werden kann (Schutz vor Mehrfach-Postings / sinnloses Abfüllen von Inseraten) |
| Nicht val. Inserate nach X Tagen löschen | Definiert, nach wie vielen Tagen Inserate gelöscht werden sollen, wenn Sie noch nicht validiert sind (durch Benutzer und/oder Administrator, je nach Validierungsoptionen). Wird das Feld leer gelassen, werden nicht validierte Inserate wie validierte Inserate behandelt und nach der bei der Erfassung definierten Anzeigedauer gelöscht. |
| BB-Code in Inseraten erlauben | Legt fest, ob in Inseraten BB-Code erlaubt ist, um bestimmte Textbereiche fett ([b]..[/b]), kursiv ([i]...[/i]) bzw. unterstrichen ([u]...[/u]) darzustellen. |
| Secure-Code (Missbrauchsschutz) | Legt fest, ob der Secure-Code Missbrauchsschutz für Kontakt- und Weiterempfehlungsformular aktiviert ist. Ist dies der Fall, wird in einer Grafik eine fünfstellige Zahl angezeigt, welche in ein Eingabefeld abgetippt werden muss. Dies verhindert automatische Mailversände via Formulare durch Spammer. |
| Secure-Code Hintergrund | UNIX-Pfad zum Hintergrundbild des Secure-Codes. Nur relevant, wenn Secure-Code auch aktiviert ist. |
| Secure-Code Hintergrund-Schrift | Hex-Code der Schriftfarbe für die "Störziffern" im Hintergrund des Secure-Codes. |
| Secure-Code Vordergrund-Schrift | Hex-Code der Schriftfarbe des Secure-Codes. |
| Kategorien-Datei | Datei, in der die Konfiguration der einzelnen Kategorien abgespeichert wird. |
| Marktplatz-Bilder (Upload) | Browser und UNIX-Verzeichnis, in dem die Bilder zu den Inseraten abgespeichert werden, welche via Browser hochgeladen werden. Wichtig: die tägliche Wartungsfunktion löscht in diesem Verzeichnis automatisch Dateien, welche nicht zu Inseraten gehören und mit "tmp_" oder "[Ziffern]_" beginnen! Dieses Verzeichnis sollte ausschliesslich für jsMarket verwendet werden. |
| zu grosse Marktplatz-Bilder | Legt fest, ob zu grosse Bilder im Marktplatz mit einer Fehlermeldung abgelehnt werden sollen, oder ob die Grösse automatisch angepasst werden soll (benötigt GD-Modul, nur bei JPGs, max. Grösse in Pixel muss in Kategorie definiert sein) |
| maximale Bildgrösse in Bytes | Definiert die maximale Bildgrösse in Bytes. Ist das Feld leer oder enthält den Wert 0, sind Bilder in unbeschränkter Grösse erlaubt (bzw. es wird nur noch die allfällig konfigurierte maximale Bildgrösse in Pixel pro Kategorie berücksichtigt). |
| Template: Validation Mail | Mailvorlage für das E-Mail Validierungsmail (Link, den der Inserent anklicken muss) |
| Template: Contact Mail | Mailvorlage für den E-Mail Kontakt via HTML-Formular |
| Template: Passwort Reset Mail | Mailvorlage für die Rücksetzung des Passwortes |
| Template: Weiterempfehlen Mail | Mailvorlage für Weiterempfehlen eines Inserates via HTML-Formular |
| Fehlertext | Diverse Fehlertexte |
| Meldungstexte | Diverse Informationstexte |
| Suche... | Texte für Suchergebnisse |
| Name der Kategorie | Titel des Markplatzes |
| Inserate Daten Datei | Text-Datenbank, in welche die einzelnen Inserate gespeichert werden. |
| Einträge pro Seite | Anzahl Einträge, die der Übersichtsseite angezeigt werden. |
| Default Anzeigedauer | Anzahl Tage, die ein Inserat aktiv wird, wenn der Benutzer keine Änderung vornimmt. |
| Maximale Anzeigedauer | Die maximale Dauer in Tagen, die ein Inserat geschaltet werden kann. |
| Validierung notwendig | Legt fest, ob Einträge zuerst noch durch den Benutzer und/oder Administrator validiert werden müssen. |
| Mail: Admin-Info Mailadresse | Ziel-Adresse für das Admin-Info-Mail. leer=globale Einstellungen werden übernommen. |
| sortieren | legt fest, ob die Inserate anstatt nach Eintragungsdatum nach einem oder mehreren beliebigen Feldern sortiert werden soll. Dabei gibt es mehrere Varianten:
|
| Sortiert nach | Legt durch ; getrennt die Sortierreihenfolge fest. Der Parameter hat nur dann eine Funktion, wenn bei "sortieren" der Parameter "einmal pro Tag" oder "bei jedem Aufruf" gewählt wurde. |
| Anzeigen-Counter | Definiert, ob ein Anzeigen-Counter für diese Kategorie aktiviert werden soll, der zählt, wie oft eine Anzeige schon in der Detailansicht angezeigt wurde. Die Zahl lässt sich im Detail-Template mit <!--field:counter--> einblenden. |
| Felddefinitionen / Einschränkungen | |
| Pflichtfelder | Felder, welche zwingend einen Wert beinhalten müssen. Die Felder title, valid, password und email sind immer Pflichtfelder und müssen nicht aufgeführt werden. |
| Textbegrenzungen | Maximale Textlängen der einzelnen Felder (Feldname=Maximallänge;Feldname2=Maximallänge2;etc.) |
| E-Mail-Felder | Felder, welche immer eine E-Mail Adresse beinhalten müssen. email ist immer ein E-Mail-Feld. |
| numerische Felder | Felder, welche nur Zahlen (Kommazahlen erlaubt) beinhalten dürfen. |
| numerische Einschränkungen | Einschränkungen von numerischen Feldwerten, z.B. Alter muss grösser gleich 18 sein. |
| Text Einschränkungen | Einschränkungen von Textfeldern anhand Positiv- (muss XYZ enthalten) oder Negativlisten (darf ABC nicht enthalten). Perl Regular Expressions sind möglich. |
| Maximale Bildgrösse | Maximale Breite und Höhe in Pixel für ein Bild im Inserat, z.B. 400x300 für maximale Breite von 400 Pixel und max. Höhe von 300 Pixel. 0=beliebig |
| Thumbnail-Grösse | Grösse des Thumbnails (nur JPG), z.B. 150x100 für 150 Breite und 100 Pixel Höhe (das Bild wird proportional verkleinert, bis Höhe und Breite <= Angabe sind). |
| Alternative Thumbnails | Verwendet, falls kein Thumbnail existiert (z.B. bei GIF- oder PNG-Grafiken) das grosse Bild als Thumbnail und verkleinert es via HTTP-Resize (die Dateigrösse bleibt davon unverändert) |
| Templates | |
| Eingabe-Formular | HTML-Template für das Eingabeformular (gleiches Template kann für mehrere Märkte verwendet werden). |
| Detailansicht | HTML-Template für die Detailansicht eines Inserates (gleiches Template kann für mehrere Märkte verwendet werden). |
| Übersicht/Suchergebnis | HTML-Template für die Übersicht der Inserate. In diesem Formular werden auch die Suchergebnisse angezeigt (gleiches Template kann für mehrere Märkte verwendet werden). |
| Kontaktformular | HTML-Template für das Kontakt-Formular (gleiches Template kann für mehrere Märkte verwendet werden). |
| Weiterempfehlen-Formular | HTML-Template für das Weiterempfehlen-Formular (gleiches Template kann für mehrere Märkte verwendet werden). |
| Such-Formular | HTML-Template für das Such-Formular (gleiches Template kann für mehrere Märkte verwendet werden). |
| Passwort-Abfrage | Template für die Passwortabfrage zum Editieren eines Inserates oder Formular für die Zusendung des Passwort-Reset-Mails (gleiches Template kann für mehrere Märkte verwendet werden). |
| Passwort-Rücksetzen | Template um das Passwort mit Hilfe des E-Mail Codes zurückzusetzen (gleiches Template kann für mehrere Märkte verwendet werden). |
| Mail: Kontakt | Mail-Template für das Kontakt-Mail. leer=globale Einstellungen werden übernommen. |
| Mail: Weiterempfehlung | Mail-Template für das Weiterempfehlen-Mail. leer=globale Einstellungen werden übernommen. |
| Mail: Validierung | Mail-Template für das Validierungs-Mail. leer=globale Einstellungen werden übernommen. |
| Mail: Admin-Info | Mail-Template für das Admin-Info-Mail. leer=globale Einstellungen werden übernommen. |
| Mail: Passwort-Reset | Mail-Template für das Mail mit dem Code, um das Passwort zurück zu setzen. leer=globale Einstellungen werden übernommen. |
| <!--SYSTEMMESSAGE--> | System-Nachricht mit den Meldungstexten aus der Administrationsoberfläche |
| <!--cat--> | ID der gewählten Kategorie |
| <!--catname--> | Name der gewählten Kategorie |
| <!--CGIURL--> | URL zum CGI-Script |
| <!--numAds--> | Anzahl (validierte) Inserate in der aktuellen Kategorie |
| <!--prevLink:zurück--> | Fügt einen Link mit dem Text "zurück" ein, wenn vorherige Inserate vorhanden sind (zurück kann durch einen anderen Text oder ein Bild ersetzt werden). |
| <!--nextLink:weiter--> | Fügt einen Link mit dem Text "weiter" ein, wenn zusätzliche Inserate vorhanden sind (weiter kann durch einen anderen Text oder ein Bild ersetzt werden). |
| <!--includeFile:myfile.dat--> | Fügt die Datei myfile.dat 1:1 in das HTML-Template ein. |
| <!--ifSearch:Text--> | Gibt "Text" aus, wenn eine Suche ausgeführt wurde. |
| <!--srchString--> | Gibt den Suchstring aus, nachdem gesucht wurde (z.B. 'price'<1000, 'title' enthält 'test'). |
| <!--startList--> | Startet den Inserate-Bereich |
| <!--endList--> | Schliesst den Inserate-Bereich ab |
| <!--cat--> | ID der gewählten Kategorie |
| <!--catname--> | Name der gewählten Kategorie |
| <!--field:image--> <!--field:image0--> bis <!--field:image9--> | zeigt das Bild an, sofern vorhanden. Optionale Parameter sind möglich, z.B. <!--field:image: width="300"--> (Bild wird mit einer Breite von 300 Pixel dargestellt). Wichtig ist das Leerzeichen nach dem zweiten Doppelpunkt! |
| <!--field:timage--> <!--field:timage0--> bis <!--field:timage9--> | zeigt das Thumbnail an, sofern vorhanden (nur JPGs). Optionale Parameter sind möglich, z.B. <!--field:timage: width="300"--> (Bild wird mit einer Breite von 300 Pixel dargestellt). Wichtig ist das Leerzeichen nach dem zweiten Doppelpunkt! |
| <!--field:rimage--> <!--field:rimage0--> bis <!--field:rimage9--> | zeigt den Dateiname des Bildes ohne Pfadangabe |
| <!--ifImage:Bild vorhanden--> | zeigt den Text "Bild vorhanden" an, wenn ein Inserat zu diesem Bild vorhanden ist (Text kann abgeändert oder durch ein Bild ersetzt werden). |
| <!--field:name--> | zeigt den Inhalt des Feldes "name" an. name kann durch beliebige Feldnamen ersetzt werden. Wird nach dem Feldnamen nochmals ein Doppelpunkt angegeben und dann eine Zahl, wird der Text auf diese Anzahl Zeichen beschränkt (z.B. in Inserateübersicht sinnvoll): <!--field:feldname:100--> beschränkt Text auf 100 Zeichen. |
| <!--detailurl--> | URL zur Detailansicht des Inserats |
| <!--After[2]:text--> | Gibt "text" nur nach jedem 2. Datensatz aus. Anzahl und "text" sind frei wählbar. |
| <!--SYSTEMMESSAGE--> | System-Nachricht mit den Meldungstexten aus der Administrationsoberfläche |
| <!--cat--> | ID der gewählten Kategorie |
| <!--catname--> | Name der gewählten Kategorie |
| <!--id--> | ID des aktuellen Inserats |
| <!--CGIURL--> | URL zum CGI-Script |
| <!--field:image--> <!--field:image0--> bis <!--field:image9--> | zeigt das Bild an, sofern vorhanden. Optionale Parameter sind möglich, z.B. <!--field:image: width="300"--> (Bild wird mit einer Breite von 300 Pixel dargestellt). Wichtig ist das Leerzeichen nach dem zweiten Doppelpunkt! |
| <!--field:timage--> <!--field:timage0--> bis <!--field:timage9--> | zeigt das Thumbail an, sofern vorhanden (nur JPGs). Optionale Parameter sind möglich, z.B. <!--field:timage: width="300"--> (Bild wird mit einer Breite von 300 Pixel dargestellt). Wichtig ist das Leerzeichen nach dem zweiten Doppelpunkt! |
| <!--field:rimage--> <!--field:rimage0--> bis <!--field:rimage9--> | zeigt den Dateiname des Bildes ohne Pfadangabe |
| <!--field:feldname--> | zeigt den Inhalt des Feldes "feldname" an. name kann durch beliebige Feldnamen ersetzt werden. Wird nach dem Feldnamen nochmals ein Doppelpunkt angegeben und dann eine Zahl, wird der Text auf diese Anzahl Zeichen beschränkt (z.B. in Inserateübersicht sinnvoll): <!--field:feldname:100--> beschränkt Text auf 100 Zeichen. |
| <!--contact--> | URL zum Kontaktformular |
| <!--recommend--> | URL zum Weiterempfehlen-Formular |
| <!--editad--> | URL zum editieren des Eintrages. |
| <!--mainurl--> | URL zur Übersicht |
| <!--includeFile:myfile.dat--> | Fügt die Datei myfile.dat 1:1 in das HTML-Template ein. |
| <!--field:counter--> | Zeigt an, wie oft diese Anzeige schon dargestellt wurde. Counter muss im Adminbereich unter "Kategorie" pro Kategorie aktiviert werden. |
| <!--SYSTEMMESSAGE--> | System-Nachricht mit den Meldungstexten aus der Administrationsoberfläche |
| <!--CGIURL--> | URL zum CGI-Script |
| <!--cat--> | ID der gewählten Kategorie |
| <!--detailurl--> | URL zur Detailansicht des Inserats |
| <!--catname--> | Name der gewählten Kategorie |
| <!--field:feldname--> | zeigt den Inhalt des Feldes "feldname" an. name kann durch beliebige Feldnamen ersetzt werden. Wird nach dem Feldnamen nochmals ein Doppelpunkt angegeben und dann eine Zahl, wird der Text auf diese Anzahl Zeichen beschränkt (z.B. in Inserateübersicht sinnvoll): <!--field:feldname:100--> beschränkt Text auf 100 Zeichen. |
| <!--form:feldname--> | Fügt den Wert des Formularwertes "feldname" ein. |
| <!--date--> | Datum im Mailformat (für Headerzeile im Mail) |
| <!--messageid--> | Message-ID (für Headerzeile im Mail) |
| <!--includeFile:myfile.dat--> | Fügt die Datei myfile.dat 1:1 in das HTML-Template ein. |
| <!--scid--> | Secure-Code ID, welche bei aktiviertem Secure-Code als verstecktes Feld eingefügt werden muss. |
| <!--SYSTEMMESSAGE--> | System-Nachricht mit den Meldungstexten aus der Administrationsoberfläche |
| <!--CGIURL--> | URL zum CGI-Script |
| <!--cat--> | ID der gewählten Kategorie |
| <!--catname--> | Name der gewählten Kategorie |
| <!--imgpath--> | Browser-Pfad zum Bilderverzeichnis |
| SRV_image (Feldname) | Verwendet angegebenes Bild aus dem Bilderverzeichnis |
| <!--field:feldname--> | zeigt den Inhalt des Feldes "feldname" an. name kann durch beliebige Feldnamen ersetzt werden. Wird nach dem Feldnamen nochmals ein Doppelpunkt angegeben und dann eine Zahl, wird der Text auf diese Anzahl Zeichen beschränkt (z.B. in Inserateübersicht sinnvoll): <!--field:feldname:100--> beschränkt Text auf 100 Zeichen. |
| <!--includeFile:myfile.dat--> | Fügt die Datei myfile.dat 1:1 in das HTML-Template ein. |
| <!--form:feldname--> | Fügt den Wert des Formularwertes "feldname" ein. |
| <!--fehler:feldname--> | Gibt den Felderbezogenen Fehlertext aus (sofern Fehler vorhanden) |
| <!--CGIURL--> | URL zum CGI-Script |
| <!--cat--> | ID der gewählten Kategorie |
| <!--catname--> | Name der gewählten Kategorie |
| <!--includeFile:myfile.dat--> | Fügt die Datei myfile.dat 1:1 in das HTML-Template ein. |
| <!--CGIURL--> | URL zum CGI-Script |
| <!--cat--> | ID der gewählten Kategorie |
| <!--catname--> | Name der gewählten Kategorie |
| <!--field:feldname--> | zeigt den Inhalt des Feldes "feldname" an. name kann durch beliebige Feldnamen ersetzt werden. Wird nach dem Feldnamen nochmals ein Doppelpunkt angegeben und dann eine Zahl, wird der Text auf diese Anzahl Zeichen beschränkt (z.B. in Inserateübersicht sinnvoll): <!--field:feldname:100--> beschränkt Text auf 100 Zeichen. |
| <!--form:feldname--> | Fügt den Wert des Formular-Parameters "feldname" ein. |
| <!--includeFile:myfile.dat--> | Fügt die Datei myfile.dat 1:1 in das HTML-Template ein. |
Zeilenumbrüche in Header-Feldern von Mails ermöglichen Spammern die Manipulation der Header-Informationen und somit die Anpassung von Empfängeradressen, Betreff bis hin zum eigentlichen Mailinhalt. Dadurch können Scripte zum Spam-Versand missbraucht werden.
jsMarket bietet die Möglichkeit, Zeilenumbrüche bei bestimmten Feldern automatisch zu entfernen und somit einen effizienten Schutz gegen diese Missbrauchsmöglichkeit. Dies lässt sich in den jeweiligen Templates mit der Verwendung von "fieldh" statt "field" resp. "formh" statt "form" erreichen.
Aus diesem Grund sollten bei allen Mail-Templates im Header-Bereich (vor der ersten Leerzeile) für Feld-Platzhalter die sicheren Tags "fieldh" und "formh" verwendet werden!
Unsicheres Weiterempfehlungsformular (recommend.mail)
From: "<!--form:sendname-->" <<!--form:sendmail-->> To: "<!--form:rcptname-->" <<!--form:rcptmail-->> Date: <!--date--> Message-Id: <!--messageid--> Subject: <!--form:subject-->Sichere Variante:
From: "<!--formh:sendname-->" <<!--formh:sendmail-->> To: "<!--formh:rcptname-->" <<!--formh:rcptmail-->> Date: <!--date--> Message-Id: <!--messageid--> Subject: <!--formh:subject-->Die "formh" und "fieldh" Felder können in allen Templates (auch bei Formularen) verwendet werden und sind gleich anzuwenden wie "form" und "field". Einziger Unterschied besteht in der Enfernung der Zeilenumbrüche bei den "h"-Varianten.
Der Secure-Code ist ein fünfstelliger Code in einer Grafik, welcher bei einem neuen Mailversand (Kontakt oder Weiterempfehlen) in ein Textfeld eingetragen werden muss. Der Zahlencode in der Grafik kann von automatisierten Spam-Scripts nicht ausgelesen werden und bietet so einen effizienten Schutz gegen einen automatisierten Mailversand. Gegen manuelle Werbeeintragungen (also durch einen natürlichen Mensch, der den Code lesen kann) hilft der Secure-Code hingegen nicht.
Der Secure-Code kann nicht pro Kategorie sondern nur pro jsMarket-Installation aktiviert oder deaktiviert werden, d.h. es müssen stets alle Kategorien angepasst werden. Ein Secure-Code in nur einem Teilbereich des Marktplatzes macht aber auch keinen Sinn, da Spammer sind ansonsten einfach auf die ungeschützten Kategorien konzentrieren würden.
Damit der Secure-Code benutzt werden kann sind einige Voraussetzungen notwendig:
Damit das Eingabefeld für den Secure-Code nur bei aktivierter Funktion angezeigt wird, müssen die entsprechenden Zeilen den Tag <!--scyes--> beinhalten. Dies bewirkt, dass die Zeile bei deaktiviertem Secure-Code komplett unterdrückt wird. Eine Secure-Code Zeile im Template, welche nur dann angezeigt wird, wenn diese auch aktiviert ist, sieht also so aus:
| Copyright © 2008 by Jürg Sommer, scripts@cgicorner.ch http://www.cgicorner.ch |
Letzte Änderung: 21. Februar 2008 |