⇤ ← Версия 1 от 2008-06-27 04:43:26
118
Комментарий:
|
118
converted to 1.6 markup
|
Удаления помечены так. | Добавления помечены так. |
Строка 1: | Строка 1: |
[[Include(/CreateMaterialPassport, "CreateMaterialPassport", 3)]] | <<Include(/CreateMaterialPassport, "CreateMaterialPassport", 3)>> |
Строка 3: | Строка 3: |
[[Include(/MaterialFiles, "MaterialFiles", 3)]] | <<Include(/MaterialFiles, "MaterialFiles", 3)>> |
CreateMaterialPassport
Создание паспорта материала с указанными именем, названием, авторством, лицензией и форматом.
Параметры
Параметры аналогичны используемым в макросе CreateMaterialPassport.
Параметр |
Тип |
Значение по умолчанию |
Описание |
Name |
Имя страницы |
отсутствует |
Имя новой страницы паспорта материала |
Title |
строка |
отсутствует |
Название материала |
OriginalTitle |
строка |
отсутствует |
Оригинальное название материала |
Base |
Имя страницы |
Базовая страница для паспорта |
|
Author |
строка |
отсутствует |
Автор материала |
License |
строка |
отсутствует |
Лицензия материала |
LicenseBase |
Имя страницы |
Страница с информацией о лицензиях |
|
Format |
строка |
отсутствует |
Формат материала |
FormatBase |
Имя страницы |
Страница с информацией о форматах |
|
URL |
строка |
отсутствует |
Ссылка на источник |
Template |
Имя страницы |
Шаблон для создания паспорта материала |
Поведение
При выполнении макроса создаётся страница с именем Base/Name с использованием шаблона Template, после чего выполняется попытка заполнить шаблон переданными в качестве параметров значениями Title, OriginalTitle, Author, License, Format, URL
- В случае, если страница уже существует, будет выдано предупреждение и осуществлён переход на реферрер
- В случае, если задано пустое имя, будет выдано предупреждение и осуществлён переход на реферрер
Использование
Обычно используется не напрямую, а макросом CreateMaterialPassport.
?action=CreateMaterialPassport&Name=MaterialName
Создаёт страницу с указанным именем и незаполненным шаблоном по умолчанию (MaterialPassportTemplate).
- Создаёт страницу с указанными названием, заголовком, названием материала, автором, лицензией, форматом и источником.
MaterialFiles
Управление файлами материала. Обычно используется совместно с макросом MaterialFiles.
Формат вызова и поведение
Поведение action зависит в первую очередь от параметров subaction, который указывает действие, которое необходимо произвести, и path, который указывает путь к объекту (в формате ИмяМатериала/путь/к/файлу), над котором необходимо произвести действие. В зависимости от действия, могут требоваться дополнительные параметры, для задания которых генерируется соответствующая форма. Далее рассмотрены возможные параметры subaction, их семантика и используемые дополнительные параметры.
subaction=view --- просмотр файла
Дополнительные параметры: отсутствуют
Поведение: возвращает файл как он есть
subaction=move --- перемещение файла
Дополнительные параметры:
- to=destination --- целевая директория
Поведение: В случае отсутствия параметра to выводится дерево каталогов материала, в котором находится объект. В случае, если параметр to указан, то происходит перемещение объекта в указанную директорию
subaction=delete --- удаление файла
Дополнительные параметры: отсутствуют
Поведение: удаление указанного файла или директории
subaction=upload --- закачивание файла
Дополнительные параметры:
- file --- содержимое файла
Поведение: Если параметр file не передан, то будет отбражена форма выбора файла для загрузки. Если параметр file передан, то производится загрузка файла в директорию path
subaction=pack --- архивирование файла или директории
Дополнительные параметры: отсутствуют
Поведение: Архивирование указанного файла или директории командой tar cjf. В случае, если действие производится над материалом, то архивируются все файлы материала
subaction=unpack --- распаковка архивов tar.bz2
Дополнительные параметры: отсутствуют
Поведение: Выполняет команду tar xjf над указанным файлом
subaction=mkdir --- создание поддиректории
Дополнительные параметры:
- name=dirname --- имя создаваемой поддиректории
Поведение: в случае, если параметр name не передан, отображается форма указания имени поддиректории. Если параметр name указан, то создаётся поддиректория с именем name в директории path
В случае, еслид действие выполнить не возможно по каким-либо причинам, выводится соответствующая диагностика. Возможные виды причин:
- Путь не существует
- Путь не является директорией
- Произошла ошибка во время выполнения операции
- Нет прав для выполнения операции
Права доступа
Для управления файлами используются права доступа read и write страницы паспорта материала. Право доступа read даёт возможность выполнять subaction=view. Право доступа write даёт возможность выполнять действия move, delete, upload, pack, unpack, mkdir. В случае, если права на запрашиваемое действие отсутствуют, выводится предупреждение и присходит переход на реферрер.