Загрузка Файлов

также доступны в Deutsch, English, Français



1. Введение

Вы можете загружать файлы на вашу ваку (не забудьте поставить права записи каталогам file/global/ и file/perpage/). По умолчанию это могут делать лишь члены группы Admins (см. Права доступа), но это поведение можно изменить в файле конфигурации. Незарегистрированные пользователи загружать файлы не могут ни при каких обстоятельствах.

2. Описание Actions

2.1. upload

  • Форма для загрузки файла на данную страницу или в глобальное пространство
  • Вызов: {{upload [global=1] [maxsize=200] [hide_description=1]}}
  • Параметры:
    • global — флаг того, что загрузка будет безусловно в глобальное пространство
    • maxsize — принудительно ограничивает макс. размер (должно быть меньше, чем в конфиге)
    • hide_description — не показывать текстовое поле "описание", остаётся только поле для файла

2.2. files

  • Форма для загрузки файла на данную страницу или в глобальное пространство
  • Вызов: {{files [page="PageName" or global=1] [order="time|FILENAME|size|size_desc|ext"] [owner="UserName"] [media=1] [max=Number] [nomark=1]}}
  • Параметры:
    • первый параметр — имя страницы, для которой выводить список файлов. Если global=1, то выводится список глобального пространства
    • order — как упорядочивать, соответственно, по времени, имени, размеру, размеру-в-обратном-порядке, расширению
    • owner — показать файлы, закачанные только этим пользователем
    • picture — для картинок вместо ссылок показывать сами картинки — что-то типа галереи
    • media — показывает все изображения, аудио- и видеофайлы в своих тегах вместо имен файлов — что-то типа галереи

3. Синтаксис ссылки на файл

3.1. URL syntax

  • http://example.com/file/global/archive.zip — глобальное пространство
  • http://example.com/ToDo/Upload/file?get=archive.zip — файл, привязанный к конкретной странице
    • при этом filesфиксировано и без реврайт-мода выглядит как:
    • http://example.com/?page=ToDo/Upload/file&get=archive.zip

3.2. Wacko syntax

  • file:archive.zip – ищет в глобальном и в текущем хранилище
  • file:/archive.zip – только в глобальном
  • file:!/archive.zip
  • file:/Subpage/archive.zip

3.2.1. Media Parameters

Параметры добавляются в синтаксис файла путем добавления вопросительного знака ? и дополнительных параметров с помощью амперсанда &.
e.g. file:/image.png?200x400&direct&caption


  • Поведение при клике
    • direct – to file
    • nolink – shows only the image
    • linkonly – shows only link
    • meta – to filemeta handler (default)
  • alignment
    • right – справа
    • left – слева
    • center – посередине
  • Изменение размеров
    • 400x300 – width x height
    • 0x700 – height
    • 600 – width
  • others
    • caption – shows caption
    • clear – clears float

Пример:
file:/groups/wackowiki/mammut_800.jpg?500&caption&left

The Woolly Mammoth (Elephas primigenius)
We try to respect the hunter that dominated the first 99.9% of the history of our species. If you had to kill a mammoth or do without supper, there was no time to draw up an organization chart, assign tasks, or delegate authority. Basically, the person who saw the mammoth from farthest away was the Official Sighter, the one who ran fastest was the Head Runner, whoever threw the most accurate spear was the Grand Marksman, and the person all others respected most and listened to was the Chief. That’s all there was to it. Distributing little charts to produce an appearance of order would have been a waste of time. It still is.

4. Настройки инсталляции

4.1. Настройки constants.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 — где размещаются публичные файлы
  • UPLOAD_PER_PAGE_DIR — где размещаются непубличные файлы, привязанные к конкретным страницам

4.2. Настройки config.php


  • upload = false, true, "admins" — кто может загружать. Анонимы не могут загружать никогда
  • upload_images_only — если установлено, то не даёт загружать что-то кроме картинок. Картинки определяет с помощью GD 
  • upload_max_size — максимально допустимый размер файла, в Кб
  • upload_quota_per_user — сколько quota может загрузить один пользователь (если не установлено, то сколько угодно)