Vielen Dank für Ihr Interesse an unserem Script. Wir empfehlen Ihnen, sich Zeit für die Lektüre dieser Anleitung zu nehmen.
Das Script ist für den sofortigen Einsatz konfiguriert und eingerichtet. Nachdem Sie das Script auf den Server kopiert haben, können Sie es sofort verwenden. Wenn Sie Änderungen vornehmen möchten, sollten Sie diese schrittweise durchführen und nach jeder Änderung die Auswirkung auf das Script testen. Sie behalten dadurch den Überblick, welche Änderung einen eventuell auftretenden Fehler verursacht hat.
Die HTML-Templates wurden nach den Spezifikationen für XHTML 1.0 erstellt. Deshalb enthalten alle einfachen Tags (<br> oder <input>) einen abschließenden Slash (<br /> oder <input type=“text“ name=“feld“ />).
Das Script kann eingesetzt werden, um Dateien, die Sie zum Download anbieten möchten, an die Besucher auszuliefern. Sofern Sie das Script auf Ihrem Server installiert haben, erstellen Sie einfach einen Link zum Script auf einer beliebigen Seite Ihrer Website. Der Link enthält den Pfad zur index.php des Scripts sowie den Dateinamen der Download-Datei als Parameter. Beispiel:
<a href="/download_center/index.php?datei_name.txt">Download</a>
Das Download Center Lite bietet Ihnen zwei Hauptanwendungsmöglichkeiten. Zum Einen können Sie es dazu nutzen, den Pfad zu Ihrem Download-Verzeichnis zu verschleiern. Und zum Anderen können Sie sicher stellen, dass der Benutzer den "Speichern unter" Dialog angezeigt bekommt und dadurch verhindert wird, dass zum Beispiel PDF-, HTML-, Text- oder Microsoft Office Dokumente sofort geöffnet werden.
Sie können mit dem Script alle denkbaren Dateien zum Download anbieten. Die im Verzeichnis "downloads" enthaltenen Dateien sind als Beispiele für die gängigsten Dateiformate zu betrachten. Mangels Beispieldateien sind keine Musik- und Videodateien (Mp3, Midi, Mpeg etc.) verfügbar. Das Script kann aber trotzdem solche Dateien handhaben.
Sie haben außerdem die Möglichkeit, alle Downloads mitzuloggen und mitzuzählen. Beim Einschalten der Logging-Funktion werden alle Downloads nacheinander in eine Datei geschrieben. Sie erhalten dabei Informationen über die IP-Adresse, den Hostname, Dateiname, Datum, Uhrzeit, Verweisseite und User-Agent.
Sie können auch die Downloads zählen. Dazu wird der Dateiname, die Zahl der Downloads für diese Datei, Datum und Uhrzeit des ersten und letzten Downloads geschrieben.
Die Datei "index.php" stellt die Konfigurationsdatei für das Download Center Lite dar. Sie haben dadurch die Möglichkeit, die Datei zu duplizieren und mit anderen Konfigurationen aufzurufen und zu betreiben, trotzdem aber den selben Script-Kern zu nutzen.
Folgende Variablen können editiert werden:
| $referring_server | Diese Variable enthält alle Server, von denen
aus zu den Dateien gelinkt werden darf. Wenn
sie den Namen Ihres Servers eintragen verhindern
Sie alle Downloads, die von einem nicht
autorisierten Server ausgehen. Tragen Sie in diese
Liste die Domains und IP-Adressen ein, die zum
Verlinken Ihrer Dateien autorisiert sind.
|
|
| Wenn Sie die Variable leer lassen, findet
keine Überprüfung der Verweisseite durchgeführt
und jeder kann auf Ihre Dateien linken.
|
||
| $allow_empty_referer | Einige Programme auf Seiten des Benutzers können
die Anzeige des Referers (Verweisseite) verhindern,
wie zum Beispiel Firewall-Software oder Web-Browser.
Sie können den Zugang mit leerem Referer erlauben,
wenn Sie die Variable auf "yes" setzen oder verhindern,
wenn Sie die Variable auf "no" setzen.
|
|
| $ip_banlist | In dieser Variable können Sie IP-Adressen von Benutzern
eintragen, die Sie von der Nutzung des Scripts
ausschließen möchten. Wenn Sie diese Funktion nicht
nutzen möchten, lassen Sie die Variable einfach frei.
|
|
| $language | Hier können Sie die Sprache festlegen. Eingetragen werden
muss hier das Kürzel, dass auch im Namen der Sprachdatei
im Verzeichnis "languages" verwendet wurde ("de" bei
languages.de.inc.php und "en" bei languages.en.inc.php).
|
|
| $show_error_messages | Bei Auslieferung des Scripts ist diese Variable standardmäßig
auf "yes" gesetzt. Das hat zur Folge, dass Sie bei der
Konfiguration des Scripts Fehlermeldungen und Hinweise
zur Einrichtung des Download Centers erhalten. Sobald
aber das System funktioniert, können Sie die Ausgabe
der Meldungen abschalten. So verwehren Sie allzu
neugierigen Besuchern den Einblick in das System.
|
|
| $log_downloads | Wie bereits in der Einleitung beschrieben, können Sie die
Downloads mit-loggen. Tragen Sie dazu als Inhalt dieser
Variable "yes" ein. Stellen Sie auch sicher, dass das
Verzeichnis "log" und die Datei "log.txt" Schreibrechte
besitzen (chmod 777).
|
|
| $count_downloads | Wenn Sie die Downloads zählen lassen möchten, stellen
Sie den Inhalt dieser Variable auf "yes". Stellen Sie
auch sicher, dass das Verzeichnis "log" und die Datei
"count.txt" Schreibrechte besitzen (chmod 777).
|
|
| $path['downloads'] | In dieser Variable tragen Sie den Pfad zu Ihrem
Download-Verzeichnis ein. Wenn Sie den Pfad nicht
ändern und den Wert bei "./downloads/" belassen,
wird das mitgelieferte Verzeichnis "downloads"
verwendet. Durch die darin enthaltene Datei .htaccess
Datei ist der Zugriff auf das Verzeichnis von außen
gesperrt. Eine noch sicherere Lösung ist die
Platzierung des Download-Ordners außerhalb des WWW-Roots.
|
|
| $path['templates'] | Diese Variable enthält den Pfad zum Verzeichnis mit
den HTML-Templates.
|
|
| $path['logfiles'] | Diese Variable enthält den Pfad zum Verzeichnis, in dem
sich die Log-Dateien befinden.
|
|
| $file['template'] | Wenn ein Fehler aufgetreten ist, wird der Inhalt dieser
Datei angezeigt. Sie können den Inhalt der Datei nach
Ihren Wünschen ändern und auf diese Weise den Besuchern
eine angepasste Fehlermeldung anzeigen.
|
|
| $file['log'] | In dieser Variable ist der Name der Log-Datei gespeichert.
|
|
| $file['count'] | Diese Variable enthält den Namen der Datei, in der die
Downloads gezählt werden.
|
|
| $add_text | Sie können weitere Werte, Text, Variablen oder andere
Inhalte an dieser Stelle festlegen. Diese Inhalte können
Sie dann mit Hilfe von entsprechenden Markierungen in
geschweiften Klammern in die Templates übertragen.
|
|
| Wenn Sie eigene Werte in der Variable $add_text hinzufügen
folgen Sie bitte dem Muster, dass durch die beiden
Beispieleinträge deutlich gemacht wurde.
|
$add_text = array(
'txt_additional' => 'Additional',
'txt_more' => 'More'
);
Der erste Teil eines Eintrags (z.B.: txt_additional) stellt den Namen der Platzhalter im Template dar. Wenn Sie also den Wert von txt_additional im Template anzeigen möchten, tragen Sie dort den Namen umschlossen von geschweiften Klammern ein - {txt_additional}. Der Name darf keine Leer- oder Sonderzeichen enthalten. Erlaubt ist nur der Unterstrich ( _ ).
Veränderungen am HTML-Template müssen Sie nur vornehmen, wenn Sie bei einem Fehler (zum Beispiel falscher Dateiname, Aufruf des Scripts ohne Parameter) den Benutzer Informationen anzeigen möchten. Das könnte zum Beispiel ein Link zu Ihrer Homepage sein.
Mit Hilfe von HTML und CSS können Sie die Templates, die sich im Verzeichnis "templates" befinden, komplett Ihren Wünschen anpassen.
Sollten Sie für die Anpassung WYSIWYG-Editoren wie Macromedia Dreamweaver, MS Frontpage oder NetObjects Fusion verwenden, achten Sie bitte darauf, dass die Software keine eigenmächtigen Veränderungen vornimmt. Die Funktionsweise des Scripts könnte dadurch beeinträchtigt werden.
In den Templates befinden sich Markierungen/Platzhalter in geschweiften Klammern, wie zum Beispiel {txt_next_page}. Die werden beim Aufruf des Scripts durch die entsprechenden Wörter ersetzt. Diese Wörter finden Sie in der Datei "languages/language.de.inc.php". Natürlich können Sie diese Wörter auch ändern oder an eine andere Position innerhalb des Templates verschieben. Es spricht auch nichts dagegen, wenn Sie die Markierungen durch richtige Wörter ersetzen. Ebenso können Sie die Sprachdatei nach dem vorgegebenen Muster erweitern.
Neben den Platzhaltern für die Wörter existieren die so genannten Loops. Ähnlich
wie HTML-Tags gehört immer ein Paar zusammen und darf auch nicht getrennt
werden (
Erstellen Sie auf dem Server folgende Verzeichnisse (bei den meisten FTP-Programmen ist es auch möglich, alle Dateien und Verzeichnisse zu markieren und zusammen auf den Server hoch zu laden):
/download_center_lite/ /download_center_lite/downloads/ /download_center_lite/inc/ /download_center_lite/languages/ /download_center_lite/log/ /download_center_lite/templates/
Kopieren Sie alle Dateien in ihre entsprechenden Verzeichnisse auf den Server. Alle Bilddateien (.gif, .jpg, .png) müssen im Binär-Modus (Binary) auf den Server übertragen werden. Alle restlichen Dateien müssen im ASCII-Modus (Text-Modus) hochgeladen werden.
Antworten auf Ihre Fragen und Lösungen für Probleme mit dem Script finden Sie in unserem Support-Forum.
Das Script können Sie kostenlos nutzen. Wenn Sie das Script ohne Hinweis und Link auf STADTAUS.com betreiben möchten, können Sie die Vollversion online erwerben.
Kontakt: http://www.stadtaus.com/
Weitere Scripts auf STADTAUS.com:
Besuchen Sie unser Projekt MetaCollection. Die Seite ist ein Verzeichnis deutscher und internationaler Script-Archive.