Dateien Hochladen

Auch verfügbar in Русский, Française, English



Nicht zwingend erforderliche Angaben und Parameter sind in [eckigen Klammern] eingeschlossen.
Bei Verwendung der Aktionen bitte bei den Parametern die eckigen [ ] Klammern entfernen, damit es klappt.
Numerische Werte werden ohne und Zeichenketten mit Anführungzeichen angegeben, max=10 und for="SeitenName".

1. Upload Aktion


  • Bereich zum Hochladen einer Datei zu einer Seite oder für alle Benutzer (global)
  • Aufruf: {{upload [global=1] [maxsize=200] [hide_description=1]}}
  • Parameter:
    • global — bei dieser Option werden alle Dateien ausnahmslos für alle Benutzer (global) hochgeladen, also nicht lokal zu einer einzelnen Seite
    • maxsize — erzwingt eine kleinere Größe als die max. Dateigröße (muss kleiner sein als die max. Dateigröße, definiert in der Konfiguration)
    • hide_description — verhindert das das Feld "Beschreibung" angezeigt wird, es wird nur das Feld für die Datei angezeigt

Hinweis: Die maximal mögliche Größe für hochzuladene Dateien ist durch die upload_max_filesize in der PHP Konfiguration des Servers definiert


<?php
get_cfg_var
('upload_max_filesize')
get_cfg_var('post_max_size')
get_cfg_var('max_execution_time')
?>


Außerdem ist die Größe der für hochzuladene Dateien implizit beschränkt: Einmal über die Laufzeit eines PHP-Skripts, zum anderen durch den Umfang der hochladbaren Datei.

2. Files Aktion


  • Bereich zum Anzeigen der hochgeladenen Dateien zu einer Seite oder für alle Benutzer (global)
  • Aufruf: {{files [page="SeitenName" or global=1] [order="time|FILENAME|size|size_desc|ext"] [owner="UserName"] [picture=1] [nomark=1]}}
  • Parameter:
    • der erste Parameter ist — der Name der Seite, für welche die Dateiliste erstellt wird. Bei global=1, werden die Dateien angezeigt, welche für alle Benutzer hochgeladen wurden (nicht an eine Seite gebunden wurden)
    • order — zur Sortierung nach: Zeit, Dateiname, Dateigröße, Dateigröße absteigend, Dateierweiterung
    • owner — Option um die Dateien nur von diesem Nutzer anzuzeigen
    • picture — zeigt die Bilder serlbst anstatt der Dateinamen — ähnlich einer Bildergallerie
    • nomark — mit dem Wert 1 wird der Rahmen um das Ergebnis unterdrückt.

3. Syntax zur Verlinkung einer Datei

3.1. URL Syntax


  • http://example.com/file/global/datei.zip — global (für alle Nutzer) hochgeladene Datei
  • http://example.com/ToDo/Upload/file?get=datei.zip — Datei welche an eine bestimmte Seite angehängt wurde
    • Dateien — eingestellt ohne den Rewrite Modus und sieht so aus:
    • http://example.com/?page=ToDo/Upload/file&get=datei.zip

3.2. Wacko Syntax


  1. file:datei.zip – sucht zur aktuellen Seite und in den global hochgelandenen Dateien
  2. file:/datei.zip – sucht nur nach global hochgelandener Datei
  3. file:!/datei.zip – relativer Pfad zu lokal hochgelandener Datei, eine Ebene tiefer
  4. file:/ToDo/Upload/datei.zip – absoluter Pfad zu lokal hochgelandener Datei, erforderlich für Dateien in eingefügten Seiten

Problem:
Wird das Bild: Test_Bild_Ansage.png hoch geladen, muss es mit file:test_bild_ansage.png aufgerufen werden, sonst wird das Bild nicht dargestellt, sondern nur der beschreibende Text.

4. Ablage der Dateien auf dem Server


Dateien für alle Nutzer (global)
file/global/

  • grafik.png
  • schreiben.odt

Dateien zu einer Seite
file/perpage/

  • @[page_id]@bild.jpg
  • @[page_id]@handbuch.pdf
  • @[page_id]@kalkulation.ods

5. Anpassen der Installation

5.1. Bearbeitung der Konfiguration

constants.php


<?php
...
define('UPLOAD_GLOBAL_DIR',                'file/global');
define('UPLOAD_PER_PAGE_DIR',            'file/perpage');
define('UPLOAD_BACKUP_DIR',                'file/backup');
...
?>


  • UPLOAD_GLOBAL_DIR — der Pfad, in dem die öffentlichen Dateien gespeichert werden.
  • UPLOAD_PER_PAGE_DIR — der Pfad, in dem die Dateien liegen, die einer bestimmten Seite zugeordnet sind

5.2. Edit secondary config


config setting value description
default_upload_acl Admins bestimmt, wer hochladen darf. Nicht registrierte/angemeldete Nutzer können nie Dateien hochladen!
upload true steht diese Variable auf "true", können nur Bilder hochgeladen werden. Bilder werden mit der Hilfe von GD ermittelt.
upload_images_only true
upload_max_size 100 die maximale Größe für eine Datei in Byte
upload_quota 0
upload_quota_per_user 500000 Quota welche ein einzelner Nutzer hochladen darf. Ist hier nichts eingetragen, gibt es keine Begrenzung.
upload_banned_exts php|cgi|js|php|php3|php4|php5|..


zurück zur Übersicht