文件上传

1. Action

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

upload_max_filesize = 32M
post_max_size = 32M
max_execution_time = 300	

1.2. files

• shows uploaded files for a specific page or global space
• Call: {{files [page="PageName" or global=1 or all=1 or linked=1] [order="ext|ext_desc|name_desc|size|size_desc|time|time_desc"] [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

2. Syntax of reference to the file

2.1. URL syntax

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

2.2. Wacko syntax

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

2.2.1. 媒体参数

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

2.3. Embedding media files

3. File storage on server

4. Customize upload settings

4.1. Edit constants: config.php^[link6]

<?php
...
const UPLOAD_GLOBAL_DIR                = 'file/global';
const UPLOAD_LOCAL_DIR            = 'file/perpage';
const UPLOAD_BACKUP_DIR                = 'file/backup';
...
	

• UPLOAD_GLOBAL_DIR — where are placed the public files
• UPLOAD_LOCAL_DIR — where are placed files only for users allowed to view current page, attached to the concrete pages

4.2. Edit secondary config^[link6]