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

также доступны в Deutsch, English, Español, 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="ext|ext_desc|name_desc|size|size_desc|time|time_desc"] [owner="UserName"] [media=1] [max=Number] [nomark=1]}}
  • Параметры:
    • первый параметр -- имя страницы, для которой выводить список файлов. Если global=1, то выводится список глобального пространства
    • order -- как упорядочивать, соответственно, по времени, имени, размеру, размеру-в-обратном-порядке, расширению
    • owner -- показать файлы, закачанные только этим пользователем
    • media -- показывает все изображения, аудио- и видеофайлы в своих тегах вместо имен файлов -- что-то типа галереи

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

3.1. URL syntax

  • https://example.com/file/global/archive.zip -- глобальное пространство
  • https://example.com/ToDo/Upload/file?get=archive.zip -- файл, привязанный к конкретной странице
    • при этом files -- фиксировано и без реврайт-мода выглядит как:
    • https://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. Медиа параметры

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


  • Поведение при клике
    • direct - ссылки на файл
    • nolink - показывает только изображение
    • linkonly - показывает только ссылку
    • meta - ссылки на filemeta handler (default)
  • Выравнивание
    • right - справа
    • left - слева
    • center - посередине
  • Изменение размеров
    • 400x300 - ширина x высота
    • 0x700 - высота
    • 600 - ширина
  • другие
    • caption - подпись к рисунку шоу
    • clear - clears float

Пример:
file:/Groups/WackoWiki/mammut_800.jpg?500&caption

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.

3.3. Встраивание мультимедийных файлов

Медиафайлы отображаются в своем медиатеге <image>, <audio> или <video>, если не объявлено иное.


Lotus Flower
Shinobazu Pond at Ueno Park at Ueno, Taito-ku in Tokyo
(Source:: Yoshikazu TAKADA /Some rights reserved)

Sandhill Cranes
(Source:: NPS / Dale Bohlke /Public domain)

Johann Sebastian Bach - Well-Tempered Clavier, Book 1 - 01 Prelude No. 1 in C major, BWV 846
(Source:: Composer: Johann Sebastian Bach; Performer: Kimiko Ishizaka /Public domain)

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

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

4.2. Настройки Администраторский раздел


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

Просмотрите разделы Настроек и убедитесь, что установленные по умолчанию значения для вас приемлемы; измените то, что вам не подходит.