Загрузка Файлов
также доступны в Deutsch[link1], English[link2], Español[link3], Français[link4], 简体中文[link5]1. Введение
Вы можете загружать файлы на вашу ваку (не забудьте поставить права записи каталогамfile/global/
и file/perpage/
). По умолчанию это могут делать лишь члены группы Admins (см. Права доступа[link6]), но это поведение можно изменить в файле конфигурации[link7]. Незарегистрированные пользователи загружать файлы не могут ни при каких обстоятельствах.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
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 может загрузить один пользователь (если не установлено, то сколько угодно)
- [link1] https://wackowiki.org/doc/Doc/Deutsch/Aktionen/DateienHochladen
- [link2] https://wackowiki.org/doc/Doc/English/Actions/UploadFiles
- [link3] https://wackowiki.org/doc/Doc/Español/Acciones/SubirArchivos
- [link4] https://wackowiki.org/doc/Doc/Français/Fonctions/Telechargements
- [link5] https://wackowiki.org/doc/Doc/简体中文/Actions组件/文件上传
- [link6] https://wackowiki.org/doc/Doc/Русский/ПраваДоступа
- [link7] https://wackowiki.org/doc/Doc/Русский/ФайлКонфигурации