Auch verfügbar in English, Español, Française, Русский, 简体中文

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|name_desc|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
  • 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

Lokal hochgeladene Dateien werden mit der Leseberechtigung der Seite abgeglichen.

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

3.3. Einbetten von Mediendateien

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

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

zurück zur Übersicht