Dateien Hochladen

Auch verfügbar in Русский, Español, 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ührungszeichen angegeben, max=10 und page="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 hochzuladende 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 hochzuladende 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"] [media=1] [max=Anzahl] [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 selbst anstatt der Dateinamen — ähnlich einer Bildergalerie (veraltet, siehe Parameter media)
    • media — zeigt alle Bilder, Audio- und Video-Dateien in ihren Medien-Tags anstatt der Dateinamen — ähnlich einer Bildergalerie
    • 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 nach lokal hochgeladener Datei der aktuellen Seite, welche nur für Leser dieser Seite verfügbar ist 
  2. file:/datei.zip – sucht nur nach global hochgeladener Datei
  3. file:!/datei.zip – relativer Pfad zu lokal hochgeladener Datei, eine Ebene tiefer
  4. file:/ToDo/Upload/datei.zip – absoluter Pfad zu lokal hochgeladener Datei, erforderlich, damit lokale Dateien in eine andere Seite eingebunden werden können

Der absolute Pfad ist nur dann erforderlich, wenn man eine lokal angehängte Datei in eine andere Seite einbinden möchte, was eher der Ausnahmefall ist, in der Regel wird der Benutzer die Datei in dieselbe Seite einbinden. In diesem Fall sollte die relative Syntax immer bevorzugt werden, sie ist nicht nur kürzer, sondern funktioniert auch, nachdem die Seite, an die die Datei angehängt ist, umbenannt wurde.

3.2.1. Medien-Parameter

Parameter werden der Dateisyntax hinzugefügt, indem ein Fragezeichen ? angehängt wird und zusätzliche Parameter durch hinzufügen eines kaufmännischen Und &.
e.g. file:/image.png?200x400&direct&caption


  • Verlinkung
    • direct – zur Datei
    • nolink – zeigt nur das Bild
    • linkonly – zeigt nur den Link zur Datei
    • meta – zum filemeta-Handler (default)
  • Ausrichtung
    • right – rechts
    • left – links
    • center – zentriert
  • Größenanpassung
    • 400x300 – Breite x Höhe
    • 0x700 – Höhe
    • 600 – Breite
  • Weitere
    • caption – zeigt Bildunterschrift
    • clear – setzt Ausrichtung zurück

Beispiel:
file:/Groups/WackoWiki/mammut_800.jpg?500&caption

The Woolly Mammoth (Elephas primigenius)
We try to respect the hunter that dominated the first 99.9% of the history of our species. If you had to kill a mammoth or do without supper, there was no time to draw up an organization chart, assign tasks, or delegate authority. Basically, the person who saw the mammoth from farthest away was the Official Sighter, the one who ran fastest was the Head Runner, whoever threw the most accurate spear was the Grand Marksman, and the person all others respected most and listened to was the Chief. That’s all there was to it. Distributing little charts to produce an appearance of order would have been a waste of time. It still is.

3.3. Einbetten von Mediendateien

Mediendateien werden in ihren Medien-Tag wie <image>, <audio> oder <video> gerendert, wenn nicht anders deklariert.


Lotus Flower
Shinobazu Pond at Ueno Park at Ueno, Taito-ku in Tokyo
(Source: Yoshikazu TAKADA /Some rights reserved)

Sandhill Cranes
(Source: NPS / Dale Bohlke /Public domain)

Johann Sebastian Bach - Well-Tempered Clavier, Book 1 - 01 Prelude No. 1 in C major, BWV 846
(Source: Composer: Johann Sebastian Bach; Performer: Kimiko Ishizaka /Public domain)

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
...
const 
UPLOAD_GLOBAL_DIR                'file/global';
const 
UPLOAD_PER_PAGE_DIR            'file/perpage';
const 
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. Sekundäre Einstellungen bearbeiten


Konfigurationsparameter Wert Beschreibung
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|..

Einstellungen für das Hochladen von Anhängen


zurück zur Übersicht