Also available in Русский, Español, Française, Deutsch

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

Action

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

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):

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|FILENAME|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, size, size-in-reverse-order, and file extension
  • owner — show files owned by a specific user
  • picture — pictures will be shown instead of the references — similar to a gallery (depreciated, see media)
  • 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 – for in the current local file first then for the global file
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 files in included pages

Media Parameters

Parameters are added to the file syntax by appending a question mark ? and adding additional parameters by an ampersand &.
e.g. file:/image.png?200x400&direct&caption

• 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

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

File storage on server

Files for all users (global)
file/global/

Files of specific pages
file/perpage/

Files after backup (admin panel)
file/backup/

Customize upload settings

Edit constants: config.php

constants.php

<?php
...
define('UPLOAD_GLOBAL_DIR',                'file/global');
define('UPLOAD_PER_PAGE_DIR',            'file/perpage');
define('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

Edit secondary config