Upload Files

1. Action

1.1. upload

• Form for file upload to a page or into global space
• 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. Media Parameters

• linking
  • direct - to file
  • nolink - shows only the image
  • linkonly - shows only link
  • meta - to filemeta handler (default)
• alignment
  • right
  • left
  • center
• resizing
  • 400x300 - width x height
  • 0x700 - height
  • 600 - width
• others
  • caption - shows caption
  • clear - clears float

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]