Это старая версия Справка/Разработчик/Действия за 2012-08-30 21:24:01..
Actions (действия)
Action – небольшой программный компонент, который вставляется в тело страницы.Вызов: {{имя_эшнена параметр1="значение" параметр2="значение" ...}}
Необязательные параметры указываются в [квадратных скобках].
При вызове экшена удалите неиспользуемые параметры, чтобы экшен работал правильно.
Числовые значения параметров указываются без кавычек, а строковые значения — в кавычках, max=10 и for="PageName".
Экшены, не входящие в стандартную инсталляцию, можно загрузить и установить, скопировав в серверную папку actions.
Оглавление документа none
Основные
tree - дерево страниц
Строит дерево страниц, начиная с указанной.
{{tree [for="PageName"] [depth="depth of tree"] [style=one of («br»,"ul","ol","indent") ] [owner="имя пользователя"] [nomark=1] }}| Name | default | Description |
|---|---|---|
| for | ! | От какой страницы строить дерево если "!", то для текущей страницы если "", то для всего сайта. Параметр может называться как угодно, но обязательно должен быть первым. |
| depth | full | На какую глубину отображать дерево если "full", другое не-число или 0, дерево будет выведено полностью |
| style | indent | Стиль отображения дерева – "br","ul","ol","indent" |
| nomark | 1 | Рамка вокруг дерева, если 1, то рамка скрыта. |
pageindex - алфавитный каталог страниц
Строит полный каталог всех страниц, упорядоченный по алфавиту.
{{pageindex}}changes - список изменений
Выводит список последних изменений в каком-либо кластере
{{changes [for="PageName"] [max=количество страниц] [date="YYYY-MM-DD"] [noxml=1]}}| Name | default | Description |
|---|---|---|
| for | ! | Для какого кластера выводить список если "!", то для текущей страницы если "", то для всего сайта. Параметр может называться как угодно, но обязательно должен быть первым. |
| max | ? | Максимальное количество страниц, доступных к показу. Реальное количество показанных страниц будет зависеть от персональных настроек пользователя. |
| date | дата, начиная с которой (и далее в прошлое) нужно выводить список изменений. Параметр date= также можно указать в строке запроса. | |
| noxml | 1 | скрыть/показать ссылку на RSS-поток изменений. |
mostpopular - список наиболее посещаемых страниц
Выводит список из N наиболее посещаемых страниц.
{{mostpopular [max=количество страниц]}}| Name | default | Description |
|---|---|---|
| max | ? | Максимальное количество страниц, доступных к показу. |
usersettings - страница регистрации
Выводит страницу регистрации для анонимов и страницу с настройками для зарегистрированных пользователей.
{{usersettings}}login - форма логина
Показывает форму логина, если вы ещё не залогинились, или приветствие, если уже залогинились.
{{login}}registration - форма регистрации
Показывает форму регистрации и производит всю регистрацию, собственно.
{{registration}}changepassword - смена пароля
Отсылка на email кода, при введении которого даётся доступ к смене пароля.
{{changepassword}}Не знаю, как его проверить корректно, так как, если он исполняется в приведённом ниже виде, выводит только, что не найдено результатов для фразы “1”, что бы это ни значило.
И ещё по поводу параметра for – не знаю, о чём он, и нужен ли он там, если его нет в примере.
search - поиск
Любой поиск по страницам или заголовкам.
{{search [phrase="что искать"] [page="PageName"] [topic=1] [form=1] [nomark=1] [style=one of («br»,"ul","ol","comma") ] [filter=one of («pages», “all”)]}}| Name | default | Description |
|---|---|---|
| Примечание: параметр for может называться как угодно. | ||
| topic | 1 | можно называть title если он выставлен в 1, то поиск происходит только по именам страниц, иначе – как по именам, так и по текстам |
| form | говорит, что нужно выводить форму поиска вместе с результатами. | |
| nomark | 1 | Рамка вокруг дерева, если 1, то рамка скрыта |
| style | отвечает за внешний вид результатов. | |
| filter | отвечает за то, где произодить поиск: только в страницах или в комментариях тоже. |
include - включение страницы в тело данной
Включение какой-либо страницы целиком в тело данной.
{{include page="SomePage" [nomark=1] [notoc=1] [nowarning=1] [first_anchor="..." last_anchor="..."]}}| Name | default | Description |
|---|---|---|
| Примечание: параметр page может называться как угодно. | ||
| nomark | если 1, инклюд не выделяется цветом если 2, инклюд не выделяется цветом для тех пользователей, кому не разрешено его исправлять;— тем же, кому разрешено — показывается оформление и контрольки. | |
| notoc | если 1, то заголовки из включаемой страницы не попадают в оглавление. | |
| nowarning | если 1, не выводится уведомления при вызове Include для страницы, на которую нет доступа. | |
| first_anchor и last_anchor | позволяют указать, какую часть текста включаемого документа стоит показывать. Для этого во включаемом документе надо окружить желаемую область якорями: ~{{a name="plan_start"}} Текст ~{{a name="plan_end"}}, а потом указать имена этих якорей в параметрах first_anchor и last_anchor акшна include. |
Замечания:
При инклюдах иногда глючит вставка страниц. Такое ощущение, что она берётся из кэша, хотя кэш по дефолту выключен. Выражается в следующем: инклюдится страница, её редактируешь, возвращаешься на страницу с инклюдом, а там старая информация. Экспериментальным путем лечится, когда вносишь какие-либо изменения в страницу, которая содержит сам инклюд.
В странице, где есть инклюд, вставляется имя инклюдящейся страницы и ссылка «правка», (тема – мамбо, dobee). Через некоторое время при заходе на страницу эти надписи становятся невидимы, но когда наводишь мышкой – появляются.
В странице, где есть инклюд, вставляется имя инклюдящейся страницы и ссылка «правка», (тема – мамбо, dobee). Через некоторое время при заходе на страницу эти надписи становятся невидимы, но когда наводишь мышкой – появляются.
Не работает
hits - количество обращений к странице
Отображает количество обращений к странице
{{hits [for="PageName"]}}upload - загрузка файлов
Загрузка файлов.
{{upload [global=1] [maxsize=200] [hide_description=1]}}files - отображение файлов на страницу
Отображение файлов на страницу
{{files [page="PageName"] [global=1] [owner="BenutzerName"] [picture=1] [max=номер]}}| Name | default | Description |
|---|---|---|
| global | если 1, показывает файлы, которые можно использовать в глобальном масштабе, 0.... |
lastusers - список последних зарегистрированных пользователей
Выводит список из последних 100 зарегистрированных пользователей вместе с количеством принадлежащих им страниц.
{{lastusers [stat="0"] [max="количество пользователей"]}}| Name | default | Description |
|---|---|---|
| stat | позволяет отключить показ количества принадлежащих пользователям страниц. если он 0, то max по умолчанию равен 1000, иначе 100. |
randomphrase - включение случайной строки в тело данной.
Включение случайной строки с какой-либо страницы в тело данной.
{{randomphrase page="SomePage" [nomark=1] [useemptystring=1]}}| Name | default | Description |
|---|---|---|
| useemptystring | разбивает страницу не по строкам, а по блокам, разделенным пустой строкой | |
| Примечание: параметр page может называться как угодно. |
toc - оглавление на основе заголовков
Формирует оглавление на основе заголовков.
{{toc [for|page="PageName"] [title="title of page"] [numerate=1] [from="h2"] [to="h6"] [nomark=1]}}| Name | default | Description |
|---|---|---|
| title | влияет на заголовок самого оглавления. | |
| numerate | позволяет пронумеровать все заголовки. | |
| from | h2 | по умолчанию заголовки первого уровня не включаются в оглавление. |
| Примечание: все параметры опциональные. |
paragraphs - нумерация для абзацев
Проставляет нумерацию для абзацев.
{{paragraphs [style="before|after|left|right"] [name="absolute|document-relative"]}}| Name | default | Description |
|---|---|---|
| style | влияет на то, где будут выводиться номера абзацев. |
redirect - перенаправление на другую страницу
Безусловно перенаправляет пользователя на другую страницу
{{redirect to="/KusoMendokusee"}}anchor - якорь
Создаёт якорь.
{{anchor href="ToC1" [text="Оглавление"] [title="Заголовок"]}}Примечание: параметр href может называться как угодно. Однако для акшна include параметр должен обязательно называться name.
usergroups - список групп
Выводит список групп и входящих в них пользователей.
{{usergroups [cols=5] [nomark=1]}}flash - flash-анимация
Позволяет вставлять flash-анимацию.
{{flash url="someurl.swf" [width=300] [height=400]}}YouTube
Позволяет встраивать видео с YouTube.
СкачатьПример использования:
{{youtube url="http://www.youtube.com/watch?v=9CKi5–3eAC4" [width="640"] [height="505"]}}
Vimeo
Позволяет встраивать видео с Vimeo.
СкачатьПример использования:
{{vimeo url="http://vimeo.com/9899039" [width="640"] [height="360"]}}
Для того, чтобы вставить Flash-ролик на страницу, вам необходимо набрать в визуальном или обычном редакторе следующую конструкцию:
{{flash url="<здесь необходимо указать URL ролика>" width="<ширина ролика>" height="<высота ролика>"}}
interwikilist
Список всех InterWiki-узлов, которые определены в данной инсталляции.
Вызов: {{interwikilist}}
Вызов: {{interwikilist}}
Ссылки
NB. Первый параметр for может называться как угодно. Первый параметр всегда считается параметром, определяющим, для какой страницы выводить список.backlinks - список страниц, ссылающихся на данную
{{backlinks [for="PageName"] [nomark=1]}}
- for — для какой страницы выводить список. По умолчанию равен “!", то есть текущей странице.
wanted - список несуществующих пока страниц, на которые есть ссылки для какого-либо кластера
{{wanted [for="PageName"]}}
- for — для какого кластера выводить список. По умолчанию равен “!", то есть текущей странице.
orphaned - список потерянных страниц (т.е. страниц, на которые нет ни одной ссылки) для какого-либо кластера
{{orphaned [for="PageName"]}}
- for — для какого кластера выводить список. По умолчанию равен “!", то есть текущей странице.
Комментарии
recentcomments - список последних комментариев в этой Wiki
{{recentcomments [for="PageName"] [max=количество страниц]}}
- for — для какого кластера выводить список. По умолчанию равен «/», т.е. корню сайта.
- max — количество страниц.
recentlycommented - список последних откомментированных страниц в этой Wiki
{{recentlycommented [for="PageName"] [max=количество страниц]}}
- for — для какого кластера выводить список. По умолчанию равен «/», т.е. корню сайта.
- max — количество страниц.
Персональные действия
mychanges - список изменённых вами страниц
Выводит список измененных вами страниц с возможностью сортировки.
{{mychanges [max=количество страниц]}}mypages - список принадлежащих вам страниц
Выводит список принадлежащих вам страниц с возможностью сортировки.
{{mypages [bychange=1] [bydate=1]}}watchers - список наблюдающих страницу
Выводит список наблюдающих страницу. Работает только для владельца страницы.
{{watchers [for="~SomePage"] [nomark=1]}}| Name | default | Description |
|---|---|---|
| for | ! | Параметр for может называться как угодно. Соответственно, первый параметр всегда считается параметром, определяющим, для какой страницы выводить список. По умолчанию равен "!", то есть текущей странице. |
mywatchespages - cписок страниц под вашим наблюдением
Список всех страниц под вашим «наблюдением».
{{mywatchespages}}mychangeswatches - cписок изменённых «наблюдаемых» страниц
Список изменённых «наблюдаемых» страниц.
{{mychangeswatches [max="количество страниц"]}}