Логотип

Документация по макросам и шаблонам UMI.CMS

filemanager shared_file()

Название

%filemanager shared_file()% — Выводит подробную информацию о доступном для скачивания файле.

Параметры: filemanager shared_file([template = 'default', element_path = 0])

template

Имя шаблона, по которому выводится информация. В XSLT-шаблонизаторе игнорируется, можно указать любое значение.

element_path

Путь или id страницы файла.

Описание

Макрос выводит информацию о файле, указанного в параметре element_path. Если параметр не указан, система берет id текущей страницы.

Дополнительные сведения

Для операций с файлами и файловой системой можно также воспользоваться протоколом UFS (см. «Файловая система: протокол UFS»).

Пример вызова

udata://filemanager/shared_file/notemplate/41

XML-ответ UData

<udata module="filemanager" method="shared_file" generation-time="0.002739">
  <id>41</id>
  <alt_name>php_manual</alt_name>
  <link>/downloads/php_manual/</link>
</udata>

Элементы и атрибуты

<id>

Идентификатор страницы описания файла.

<alt_name>

Альтернативное название страницы (псевдостатический адрес).

<link>

Ссылка на страницу с файлом.

Вывод файлов осуществляется по шаблону, указанному в параметре template. Вы можете не указывать этот параметр, тогда для вывода будет использован шаблон по умолчанию — default.tpl.

Используемые шаблоны

Макрос оперирует шаблонами, находящимися в каталоге /tpls/filemanager/.

Используемые блоки шаблона

shared_file

Блок для вывода информации о файле.

%file_name%

Имя файла.

%file_size%

Размер файла (в килобайтах).

%download_link%

Url — адрес по которому можно скачать файл.

%upload_file%

Выводит форму для загрузки файла, если у пользователя есть права на запись для скачиваемого файла. Для вывода формы используется блок шаблона upload_file.

broken_file

Данный блок выводится в том случае, если файл не существует.

%upload_file%

Выводит форму для загрузки файла, если у пользователя есть права на запись для скачиваемого файла. Для вывода формы используется блок шаблона upload_file.

upload_file

Блок для вывода формы для закачки файла. Для того, чтобы файл закачивался, необходимо следующее:

  • У пользователя должны быть права на запись для страницы «Скачиваемый файл».

  • У элемента формы типа «Файл» должно быть имя name="shared_files[upload]".

Примеры использования

Добавьте скачиваемый файл с именем myfile в модуле «Файловая система»

Создайте файл sample.tpl в директории /tpls/filemanager/ и напишите в нем следующий код:

<?php

$FORMS['shared_file'] = <<<END
 Имя файла: %file_name% <br />
 Размер файла: %file_size% Kb<br /><br />
 Если закачивание файла не начнется через 10 сек, 
 кликните <a href="%download_link%">по этой ссылке</a>
 <script languge="text/javascript">
  window.setTimeout('document.location.href="%download_link%";', 10000);
 </script>
END;

$FORMS['upload_file'] = <<<END
 <form method="post" enctype="multipart/form-data" action="">
  <input type="file" name="shared_files[upload]" /> <input type="submit" value="Закачать" />
 </form>
END;

$FORMS['broken_file'] = <<<END
 Файл не существует.
 %upload_file%
END;

?>

В редактировании любой страницы вставьте макрос %filemanager shared_file('sample' ,'/myfile')% .