También disponible en Deutsch, English, Française, Русский, 简体中文

No necesariamente los datos y parámetros requeridos están entre [corchetes].
Utilizar parámetros de acción sin corchetes [ ].

1. Acciones

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

Nota: Tenga en cuenta que los archivos pueden ser rechazados en base a otros criterios, por ejemplo, la falta de espacio en disco, porque el archivo es más grande que el tamaño máximo permitido o porque su web-host no permite archivos en particular.

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	

1.2. files

• muestra los archivos cargados para una página específica o un espacio global
• Call: {{files [page="PageName" or global=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

Local uploaded files, per page, were check against the pages read permission.

2.1. Sintaxis de URL

• https://example.com/file/global/archive.zip — the global space
• https://example.com/Dev/ToDo/Upload/file?get=archive.zip — the file, attached to the concrete page
  • without rewrite-mode it looks like:
  • https://example.com/?page=Dev/ToDo/Upload/file&get=archive.zip

2.2. Sintaxis de Wacko

does search

1. file:archive.zip - for in the current local 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 local files to be included in another page

La ruta absoluta sólo es necesaria si se quiere incluir un archivo adjunto localmente en otra página, lo cual es más bien el caso excepcional, normalmente el usuario incluirá el archivo en la misma página. En este caso se debe preferir siempre la sintaxis relativa, no sólo es más corta sino que también funciona después de que la página a la que se adjunta el archivo haya sido renombrada.

2.2.1. Media Parameters

Los parámetros se añaden a la sintaxis del archivo añadiendo un signo de interrogación ? y añadiendo parámetros adicionales con un 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
• otros
  • caption - shows caption
  • clear - clears float

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

2.3. Incorporación de archivos multimedia

Los archivos multimedia se muestran en su etiqueta multimedia como <image>, <audio> o <video> a menos que se declare lo contrario.

3. File storage on server

Archivos para todos los usuarios (global)
file/global/

Archivos de páginas específicas
file/perpage/

Archivos después de la copia de seguridad (admin panel)
file/backup/

4. Personalizar la configuración de carga

4.1. Editar constantes: config.php

constants.php

<?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. Editar configuración secundaria