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

также доступны в ((/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