Параметры

Перечень и описание параметров для управления каталогом файлов:

allow.ext

Разрешённые расширения файлов.

В качестве значения параметра указывается список разрешённых расширений. Элементы списка разделяются запятой. Если этот параметр задан, то в этот каталог можно загружать только файлы с заданными расширениями.

Если этот параметр не задан, то в этот каталог можно загружать любые файлы.

Если какое-то расширение указано в этом параметре и в параметре deny.ext, то это расширение файла будет запрещено.

allow.name

Разрешить вместо загрузки файлов на сайт использовать указание имени файла, загруженного в каталог пользователя, который определяется параметром local.

Имеет смысл только если задан параметр local и не задан параметр allow.url.

allow.upload

Разрешить пользователям загружать файлы на сервер через web-форму.

allow.url

Разрешить вместо загрузки файлов на сайт использовать указание URL Файлов.

Имеет смысл только если не задан параметр allow.name.

baseurl

URL для доступа к каталогу, в котором расположены файлы этого каталога, включая начальный http:// и конечный слеш.

Если этот параметр задан, то этот URL будет добавляться в начале имени файла для формирования URL на скачивание файла. Если этот параметр не задан, то URL файла определяется службой управления загрузкой файлов на сайт автоматически.

При наследовании этого параметра дочерними каталогами к значению этого параметра автоматически в конце прибавляется имя наследующего каталога и дополнительный заключительный слеш.

Использование этого параметра приводит к отключению счётчика скачиваний файла.

deny.ext

Запрещённые расширения файлов.

В качестве значения параметра указывается список разрешённых расширений. Элементы списка разделяются запятой. Если этот параметр задан, то в этот каталог нельзя загружать только файлы с заданными расширениями.

Если этот параметр не задан, то в этот каталог можно загружать любые файлы.

Если какое-то расширение указано в этом параметре и в параметре allow.ext, то это расширение файла будет запрещено.

file.physical

При просмотре каталога файлов - показывать список файлов, находящихся в физическом каталоге, соответствующем текущему виртуальному каталогу. При сохранении файлов - файлы будут сохраняться внутри этого физического каталога с именем, соответствующем имени файла.

Этот параметр также разрешает загрузку файлов в текущий физический каталог, который задаётся параметром local.

Для таких файлов не сохраняется расширенная информация о файле, включающая в себя дату и время создания и последней модификации файла, ip-адрес, с которого файл был загружен на сайт, порядок сортировки, флаг подтверждённости, описание и комментарий к файлу. Однако для управления файлами можно параллельно с физическими создавать виртуальные файлы при помощи параметра file.virtual.

Если не задан параметр protect.upload и не задан параметр file.virtual, то любой зарегистрированный пользователь сможет управлять чьими угодно файлами.

Этот параметр игнорируется, если не задан параметр local или allow.upload.

file.sort.dt_edit

Сортировать файлы в этом каталоге по дате последней модификации (самые новые - в начале).

file.view

Задаёт способ представления списка файлов в этом каталоге. В качестве значения указывается имя представления. Допустимые имена:

list - представление в виде списка (по умолчанию)

table - представление в виде таблицы

file.virtual

Создавать ли виртуальные копии файлов при загрузке физических файлов.

Создаваемые копии виртуальных файлов не обновляются автоматически, если Вы изменяете физический файл не при помощи службы управления файлами, а, к примеру, через ФТП или при помощи любой другой сторонней программы.

После создания виртуальной копии физического файла, устанавливается привязка виртуального файла и физического, и все операции переименования, перемещения, удаления, выполняемые над виртуальной копией файла, выполняются также и над физической копией файла.

Создание виртуальной копии может быть полезно, если Вы хотите воспользоваться операциями переименования, перемещения, замещения файлов на новый без необходимости предварительного удаления старой копии. Виртуальная копия также позволяет следить за тем, кто, с какого ip-адреса загружал файл, позволяет задавать для файла заголовок и комментарий и учитывать количество скачиваний файла.

Имеет смысл только если задан параметр file.physical.

header.disposition

Посылать тег Content-Disposition при обращении к файлу. Часто это приводит к тому, что файл не будет открываться внутри окна браузера, а будет скачиваться. Посылать этот заголовок нужно, если Вы хотите явно указать имя файла.

Этот параметр имеет смысл только если не задан параметр baseurl.

header.type

Определять значение тега Content-Type по расширению файла. Если параметр не определён, то в качестве значения всегда будет передаваться application/octet-stream. Если параметр определён, то это значение зависит от расширения файла. Определяйте этот параметр, если Вы хотите открывать содержимое файла в окне браузера, и не определяйте его, если Вы хотите, чтобы файл сохранялся на диске.

Этот параметр имеет смысл только если не задан параметр baseurl.

hide

Не показывать этот каталог в списке каталогов и на карте сайта.

hide.index

Не показывать этот каталог в списке каталогов.

hide.map

Не показывать этот каталог на карте сайта.

local

Разрешить в качестве ссылки на файлы использовать ссылки на локальные каталоги. В качестве значения параметра указывается полный физический путь к корню текущего каталога, включая заключительный слеш.

При наследовании этого параметра дочерними каталогами к значению этого параметра автоматически в конце прибавляется имя наследующего каталога и дополнительный заключительный слеш.

nobot

Этот каталог не должен индексироваться поисковыми машинами. Если текущее обращение идентифицировано как обращение робота, то для доступа к каталогу просить ввести логин и пароль.

noplace

Этот каталог не должен показываться в строке «где я нахожусь».

protect.download

Если этот параметр не определён, то скачивать файлы с этого каталога смогут любые пользователи. Если этот параметр определён, то для скачки файлов требуется привилегия file.file.download.

protect.login

Скачивание файлов из этого каталога доступно только зарегистрированным пользователям. Требовать ввода логина и пароля перед загрузкой файла.

protect.upload

Защитить каталог от загрузки в него файл любыми пользователями.

Если этот параметр не задан, то любой зарегистрированный пользователь может загружать файлы в этот каталог. Если пользователь не обладает привилегией file.file.edit, то он сможет добавлять новые файлы и управлять файлами, которые были созданы им самим. К чужим файлам доступа у такого пользователя не будет.

Если этот параметр задан, то редактировать файлы в этом каталоге могут только пользователи, обладающие привилегией file.file.edit.

protect.url

Ссылки на файлы защищены путём добавления в URL специальной информации, которая зависит от секретного кода, от сессии, от идентификатора текущего пользователя, от идентификатора файла. Зависимость этой информации от сессии означает, кроме всего прочего, что она будет также зависеть от подсети, с которой пользователь обращается к сайту и от браузера, потому что одна сессия может существовать только в пределах одной подсети и в пределах одного браузера. Размер подсети задаётся в настройках пользователя.

Этот параметр игнорируется, если задан параметр baseurl.

protect.view

Этот каталог является защищённым. Только пользователи, обладающие привилегией file.dir.view.*, могут просмотреть этот каталог.

В качестве значения этого параметра может указываться часть привилегии, которая добавляется к базовой привилегии file.dir.view для формирования полного имени динамической привилегии.

Если значение параметра не задано, то для формирования динамической привилегии прибавляется путь к текущему каталогу.

size.dir

Максимальный суммарный размер всех файлов в этом каталоге, без учёта подкаталогов.

size.tree

Максимальный суммарный размер всех файлов в этом каталоге, включая подкаталоги.

Для дочерних каталогов имеет смысл только уменьшение объёма. Любое увеличение объёма будет проигнорировано.

show.admin

Всегда показывать панель администрирования в этом каталоге. На этой панели содержится информация о том, кто и когда редактировал каталог, кто имеет какие права на этот каталог, суммарный размер файлов. Если параметр не определён, то панель администрирования показывается только администраторам.

Смотрите также

Управление параметрами
http://popoff.donetsk.ua/text/work/libs/a/param/

Последняя модификация: 12.01.07 14:31

Не проходите мимо! Оставьте Ваш комментарий в форуме! >>>