Dokumentation Download Center Lite

Vielen Dank für Ihr Interesse an unserem Script. Wir empfehlen Ihnen, sich Zeit für die Lektüre dieser Anleitung zu nehmen.

Nach oben

Einleitung

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“ />).

Nach oben

Funktionsweise

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.

Nach oben

Konfiguration des Scripts

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 ( _ ).

Nach oben

Anpassung des HTML-Templates

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 (...). Sie haben aber die Möglichkeit, die Position des gesamten Blocks zu verändern.

Nach oben

Dateien auf den Webserver kopieren - Upload

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.

Nach oben

Support und Hilfe

Antworten auf Ihre Fragen und Lösungen für Probleme mit dem Script finden Sie in unserem Support-Forum.

Nach oben

Informationen zur Script-Lizenz

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.

http://www.metacollection.com/

Nach oben