View source for 文件上传

其他语言 ((/Doc/Deutsch/Aktionen/DateienHochladen Deutsch)), ((/Doc/English/Actions/UploadFiles English)), ((/Doc/Español/Acciones/SubirArchivos Español)), ((/Doc/Français/Fonctions/Telechargements Française)), ((/Doc/Русский/Действия/Uploads Русский))

%%(info type="note" title="中文翻译")
English -> 简体中文

++请帮助翻译这个页面。++
%%

{{toc numerate=1}} 

Not necessarily required data and parameters are in [square brackets].
!!(green)Use action parameters without square brackets [ ].!!

===Action===

====upload==

  * 将文件加载到此页面或全局空间的表单 
  * Invoke: ##""{{upload [global=1] [maxsize=200] [hide_description=1]}}""##
  * Parameters:
    * ##global## — this option allows uploaded files to be globally available for all users
    * ##maxsize## — forcedly limits maximum size (must be less than in config)
    * ##hide_description## —  not to show text field "description", there remains only field for the file

**Note** : Please keep in mind that files might be rejected based on other criteria, for example **lack of disk space**, because the **file is larger than the  maximum allowed file size** or because your web-host does not allow particular files.

If you’d like to allow larger files, you’ll need to edit the PHP configuration file (php.ini) and add or set the following lines in php.ini (the example allows files up to 32 Mb):
%%(ini)
upload_max_filesize = 32M
post_max_size = 32M
max_execution_time = 300
%%

====files==

  * shows uploaded files for a specific page or global space
  * Call: ##""{{files [page="PageName" or global=1] [order="time|name_desc|size|size_desc|ext"] [owner="UserName"] [media=1] [max=Number] [nomark=1]}}""##
  * Parameters:
    * ##page## — define the name of the page, from which the list of files is to be loaded. If global=1, list of global space will be shown
    * ##order## — sort file list by time, name, name_desc, size, size-in-reverse-order, and file extension
    * ##owner## — show files owned by a specific user
    * ##media## — parses image, audio and video links into their media tags — similar to a gallery
    * ##nomark## — if set to 1, no border around the query result will be shown

===Syntax of reference to the file==
Local uploaded files, attached to a page, were check against the pages read permission.  

====URL syntax==

  * ##~http://example.com/file/global/archive.zip## — file in the global name space
  * ##~http://example.com/Dev/ToDo/Upload/file?get=archive.zip## — file that was attached to a specific page 
    * without rewrite-mode it looks like:
    * ##~http://example.com/?page=Dev/ToDo/Upload/file&get=archive.zip##

====Wacko syntax==

does search
  1. ##~file:archive.zip## - checks for local file, that is only available to readers of this page
  1. ##~file:/archive.zip## - only the global file 
  1. ##~file:!/archive.zip## - for local file with relative path
  1. ##~file:/Subpage/archive.zip## - for local file with absolute path, necessary for local files to be included in another page

The absolute path is only needed if you want to include a local attached file into another page, which is rather an exception, in the majority of cases the user will embed the file in the same page. In this case the relative syntax should always be the preferred option, it is not only shorter, but also works after the page the file is attached to has been renamed.

=====媒体参数=====
通过附加问号##?## 并通过与号##&## 添加附加参数,将参数添加到文件语法中。 
例如: ##~file:/image.png?200x400&direct&caption##

  * 链接
    * ##direct## - 到文件
    * ##nolink## - 仅显示图片
    * ##linkonly## - 仅显示链接
    * ##meta## - 到 filemeta 处理程序 (默认) 
  * 对齐方式
    * ##right## - 右对齐
    * ##left## - 左对齐
    * ##center## - 居中
  * 尺寸
    * ##400x300## - 宽 × 高
    * ##0x700## - 高
    * ##600## - 宽
  * 其他
    * ##caption## - 显示标题
    * ##clear## - 清除浮动

Example:
##~file:/Groups/WackoWiki/mammut_800.jpg?500&caption##
file:/Groups/WackoWiki/mammut_800.jpg?500&caption

====Embedding media files====
Media files are rendered in their media tag such as ##<image>##, ##<audio>## or ##<video>## unless otherwise declared.

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

===File storage on server==
Files for all users (global)
**file/global/**
  graphics.png
  letter.odt

Files of specific pages
**file/perpage/**
  @[page_id]@picture.jpg
  @[page_id]@handbook.pdf
  @[page_id]@calculation.ods

Files after backup (admin panel)
**file/backup/**


===Customize upload settings==
====Edit constants: ((/Doc/English/Configuration config.php))==
**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## — where are placed the public files
  * ##UPLOAD_PER_PAGE_DIR## — where are placed files only for users allowed to view current page, attached to the concrete pages

====((/Doc/English/Configuration Edit secondary config))==
#|
*|config setting |value | description |*
|| ##default_upload_acl## |Admins | who can load. Anonymous authors cannot load ever ||
|| ##upload## |true | who can load. Anonymous authors cannot load ever  ||
|| ##upload_images_only## |true | if is established, then it does not give to load something besides pictures. Pictures are determined with the aid of GD   ||
|| ##upload_max_size## |100 | the maximum permissible size of file, in Bytes ||
|| ##upload_quota## |0 | is how much Byte can be uploaded at all (if it is not established, then as much as desired) ||
|| ##upload_quota_per_user## |500000 | is how much Byte can be uploaded by one user (if it is not established, then as much as desired) ||
|| ##upload_banned_exts## | ""php|cgi|js|php|php3|php4|php5|.."" |  ||
|#

file:/ap_upload_settings_zh.png