View source for Dateien Hochladen

Auch verfügbar in ((/Doc/Русский/Действия/Uploads Русский)), ((/Doc/Español/Acciones/SubirArchivos Español)), ((/Doc/Français/Fonctions/Telechargements Française)), ((/Doc/English/Actions/UploadFiles English))

{{toc numerate=1}} 
Nicht zwingend erforderliche Angaben und Parameter sind in [eckigen Klammern] eingeschlossen.
!!(green)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"##.

===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 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)
<?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.

===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.


===Syntax zur Verlinkung einer Datei==
====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 ((../RewriteModus Rewrite Modus)) und sieht so aus:
    * ##~http://example.com/?page=ToDo/Upload/file&get=datei.zip##

====Wacko Syntax==

  1. ##~file:datei.zip## - sucht  nach lokal hochgeladener Datei der aktuellen Seite, welche nur für Leser dieser Seite verfügbar ist
  1. ##~file:/datei.zip## - sucht nur nach global hochgeladener Datei
  1. ##~file:!/datei.zip## - relativer Pfad zu lokal hochgeladener Datei, eine Ebene tiefer
  1. ##~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.

=====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##
file:/Groups/WackoWiki/mammut_800.jpg?500&caption

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

file:/lotus_flower.jpg?caption&400

file:/41265046264_720p.mp4?caption

file:/kimiko_ishizaka___bach___well_tempered_clavier_book_1___01_prelude_no._1_in_c_major_bwv_846.ogg?caption

===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

===Anpassen der Installation==
====Bearbeitung der ((../Konfiguration Konfiguration))==
**constants.php**
%%(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

====((/Doc/Deutsch/Konfiguration 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 ((../Glossar/G/GD 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|.."" |  ||
|#

file:/ap_upload_settings_de.png


((/Doc/Deutsch zurück zur Übersicht))