также доступны в 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"] [options=0|1] [owner="UserName"] [media=1] [max=Number] [nomark=1]}}
• Параметры:
  • первый параметр -- имя страницы, для которой выводить список файлов. Если global=1, то выводится список глобального пространства
  • order -- как упорядочивать, соответственно, по времени, имени, размеру, размеру-в-обратном-порядке, расширению
  • options — показать параметры сортировки и фильтрации
  • 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.webp?500&caption

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

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

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 может загрузить один пользователь (если не установлено, то сколько угодно)