также доступны в ((/Doc/Deutsch/Aktionen/DateienHochladen Deutsch)), ((/Doc/English/Actions/UploadFiles English)), ((/Doc/Español/Acciones/SubirArchivos Español)), ((/Doc/Français/Fonctions/Telechargements Français)), ((/Doc/简体中文/Actions组件/文件上传 简体中文))
{{toc numerate=1}}
=== Введение ===
Вы можете загружать файлы на вашу ваку (не забудьте поставить права записи каталогам ##file/global/## и ##file/perpage/##). По умолчанию это могут делать лишь члены группы Admins (см. ((../ПраваДоступа Права доступа))), но это поведение можно изменить в ((../ФайлКонфигурации файле конфигурации)). Незарегистрированные пользователи загружать файлы не могут ни при каких обстоятельствах.
=== Описание Actions ===
====upload====
* Форма для загрузки файла на данную страницу или в глобальное пространство
* Вызов: ##""{{upload [global=1] [maxsize=200] [hide_description=1]}}""##
* Параметры:
* ##global## -- флаг того, что загрузка будет безусловно в глобальное пространство
* ##maxsize## -- принудительно ограничивает макс. размер (должно быть меньше, чем в конфиге)
* ##hide_description## -- не показывать текстовое поле "описание", остаётся только поле для файла
**Примечание**: Пожалуйста, имейте в виду, что файлы могут быть отклонены по другим критериям, например, из-за нехватки места на диске, из-за того, что размер файла превышает максимально допустимый, или из-за того, что ваш хостинг не позволяет использовать определенные файлы.
====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## -- показывает все изображения, аудио- и видеофайлы в своих тегах вместо имен файлов -- что-то типа галереи
=== Синтаксис ссылки на файл ===
====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##
==== Wacko syntax ====
* ##""file:archive.zip""## - проверяет файлы, доступные только читателям данной страницы
* ##""file:/archive.zip""## - проверяет только файлы, доступные всем посетителям
* ##""file:!/archive.zip""##
* ##""file:/Subpage/archive.zip""## - чтобы отобразить файл, доступный только читателям данной страницы, на другой странице, указывается абсолютный путь этого файла
Абсолютный путь необходим только в том случае, если вы хотите включить локально подключенный файл на другой странице, что является скорее исключительным случаем, обычно пользователь включает файл на той же странице. В этом случае предпочтительным всегда должен быть относительный синтаксис, он не только короче, но и работает после того, как страница, к которой прикреплен файл, была переименована.
=====Медиа параметры=====
Параметры добавляются в синтаксис файла путем добавления вопросительного знака ##?## и дополнительных параметров с помощью амперсанда ##&##.
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##
file:/Groups/WackoWiki/mammut_800.jpg?500&caption
====Встраивание мультимедийных файлов====
Медиафайлы отображаются в своем медиатеге ##<image>##, ##<audio>## или ##<video>##, если не объявлено иное.
file:/lotus_flower.jpg?caption&400
file:/41265046264_720p.mp4?caption
file:/kimiko_ishizaka___bach___well_tempered_clavier_book_1___01_prelude_no._1_in_c_major_bwv_846.ogg?caption
=== Настройки инсталляции ===
==== Настройки constants.php ====
**constants.php**
%%(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## -- где размещаются непубличные файлы, привязанные к конкретным страницам
==== Настройки Администраторский раздел ====
* ##upload## = false, true, "admins" -- кто может загружать. Анонимы не могут загружать никогда
* ##upload_images_only## -- если установлено, то не даёт загружать что-то кроме картинок. Картинки определяет с помощью GD
* ##upload_max_size## -- максимально допустимый размер файла, в Кб
* ##upload_quota_per_user## -- сколько **quota** может загрузить один пользователь (если не установлено, то сколько угодно)
file:/ap_upload_settings_ru.png