Это старая версия Справка/Разработчик/Действия за 2012-08-24 16:30:53..

Actions (действия)

Action – небольшой программный компонент, который вставляется в тело страницы.
Вызов: {{имя_эшнена параметр1="значение" параметр2="значение" ...}}
Необязательные параметры указываются в [квадратных скобках].
При вызове экшена удалите неиспользуемые параметры, чтобы экшен работал правильно.
Числовые значения параметров указываются без кавычек, а строковые значения — в кавычках, max=10 и for="PageName".
Экшены, не входящие в стандартную инсталляцию, можно загрузить и установить, скопировав в серверную папку actions.

Оглавление документа none

Основные

tree - дерево страниц

pageindex - алфавитный каталог страниц

changes - список изменений

usersettings - страница регистрации

registration - форма регистрации

changepassword - смена пароля

search - поиск

include - включение страницы в тело данной

hits - количество обращений к странице

upload - загрузка файлов

files - отображение файлов на страницу

lastusers - список последних зарегистрированных пользователей

randomphrase - включение случайной строки в тело данной.

toc - оглавление на основе заголовков

paragraphs - нумерация для абзацев

redirect - перенаправление на другую страницу

anchor - якорь

usergroups - список групп

flash - flash-анимация

backlinks - список страниц, ссылающихся на данную

wanted - список несуществующих пока страниц, на которые есть ссылки для какого-либо кластера

orphaned - список потерянных страниц (т.е. страниц, на которые нет ни одной ссылки) для какого-либо кластера

Комментарии

recentcomments - список последних комментариев в этой Wiki

recentlycommented - список последних откомментированных страниц в этой Wiki

Персональные действия

mychanges - список изменённых вами страниц

mypages - список принадлежащих вам страниц

watchers - список наблюдающих страницу

mywatchespages - cписок страниц под вашим наблюдением

mychangeswatches - cписок изменённых «наблюдаемых» страниц

Основные

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	?	Максимальное количество страниц, доступных к показу.

3.1. usersettings

Выводит страницу регистрации для анонимов и страницу с настройками для зарегистрированных пользователей.
Вызов: {{usersettings}}

3.2. login

Показывает форму логина, если вы ещё не залогинились, или приветствие, если уже залогинились.
Вызов: {{login}}

3.3. registration

Показывает форму регистрации и производит всю регистрацию, собственно
Вызов: {{registration}}

3.4. changepassword

Отсылка на email кода, при введении которого даётся доступ к смене пароля.
Смена пароля.
Вызов: {{changepassword}}

4.1. search

Любой поиск по страницам или заголовкам.
Вызов: {{search [phrase="что искать"] [page="PageName"] [topic=1] [form=1] [nomark=1] [style=one of («br»,"ul","ol","comma") ] [filter=one of («pages», “all”)]}}
Параметр for может называться как угодно;
topic можно называть title — если он выставлен в 1, то поиск происходит только по именам страниц, иначе как по именам, так и по текстам;

form — говорит, что нужно выводить форму поиска вместе с результатами.
filter отвечает за то, где произодить поиск: только в страницах или в комментариях тоже. nomark, выставленный в единицу, позволяет спрятать рамочку вокруг результатов поиска.
style отвечает за внешний вид результатов.

4.2. include

Включение какой-либо страницы целиком в тело данной.
Вызов: {{include page="SomePage" [nomark=1] [notoc=1] [nowarning=1] [first_anchor="..." last_anchor="..."] }}
Если стоит nomark=1, то инклюд не выделяется цветом. Если стоит nomark=2, то инклюд не выделяется цветом для тех пользователей, кому не разрешено его исправлять; тем же, кому разрешено — показывается оформление и контрольки. Если стоит notoc=1, то заголовки из включаемой страницы не попадают в оглавление. При выставлении в 1 параметра nowarning не выводится уведомления при вызове Include для страницы, на которую нет доступа.
Примечание: параметр page может называться как угодно.
Дополнительные параметры first_anchor и last_anchor позволяют указать, какую часть текста включаемого документа стоит показывать. Для этого во включаемом документе надо окружить желаемую область якорями: {{a name="plan_start"}} Текст {{a name="plan_end"}}, а потом указать имена этих якорей в параметрах first_anchor и last_anchor акшна include.

Замечание:

при инклюдах иногда глючит вставка страниц. такое ощущение, что она берётся из кэша, хотя кэш по-дефолту выключен. выражается в следующем, инклюдится страница, её редактируешь, возвращаешься на страницу с инклюдом, а там старая информация. экспериментальным путем лечится, когда вносишь какие либо изменения в страницу, которая содержит сам инклюд.
в странице, где есть инклюд, вставляется имя инклюдящейся страницы и ссылка «правка», (тема – мамбо, dobee). через некоторое время при заходе на страницу эти надписи становятся невидимы, но когда наводишь мышкой – появляются.

4.3. hits

Отображает количество обращений к странице
Вызов: {{hits [for="PageName"]}}

4.4. upload

Загрузка файлов
Вызов: {{upload [global=1] [maxsize=200] [hide_description=1]}}
подробное описание...

4.5. files

Отображение файлов на страницу
Вызов: {{files [page="PageName"] [global=1] [owner="BenutzerName"] [picture=1] [max=номер]}}
global=1 показывает файлы, которые можно использоваться в глобальном масштабе, 0....
подробное описание...

4.7. users

Выводит список из последних 100 зарегистрированных пользователей вместе с количеством принадлежащих им страниц.
Вызов: {{users [stat="0"] [max="количество пользователей"]}}
Параметр stat позволяет отключить показ количества принадлежащих пользователям страниц. Если он 0, то max по умолчанию равен 1000, иначе 100.

4.8. randomphrase

Включение случайной строки с какой-либо страницы в тело данной.
Вызов: {{randomphrase page="SomePage" [nomark=1] [useemptystring=1]}}
useemptystring означает разбивать страницу не по строкам, а по блокам, разделенным пустой строкой
Примечание: параметр page может называться как угодно.

4.9. toc

Формирует оглавление на основе заголовков.
Вызов: {{toc [for|page="PageName"] [title="title of page"] [numerate=1] [from="h2"] [to="h6"] [nomark=1]}}
Параметр title влияет на заголовок самого оглавления. Параметр numerate позволяет пронумеровать все заголовки. Параметр from имеет умолчание “h2”, то есть заголовки первого уровня не включаются в оглавление.
Примечание: все параметры опциональные.

4.10. paragraphs

Проставляет нумерацию для абзацев.
Вызов: {{paragraphs [style="before|after|left|right"] [name="absolute|document-relative"]}}
Стиль влияет на то, где будут выводиться номера абзацев.

4.11. redirect

Безусловно перенаправляет пользователя на другую страницу
Вызов: {{redirect to="/KusoMendokusee"}}, {{redirect to="!/ПодробнееПроДействия"}}

4.12. anchor

Создаёт якорь.
Вызов: {{anchor href="ToC1" [text="Оглавление"] [title="Заголовок"]}}
Примечание: параметр href может называться как угодно. Однако для акшна include параметр должен обязательно называться name.

4.14. usergroups

Выводит список групп и входящих в них пользователей.
Вызов: {{usergroups [cols=5] [nomark=1]}}

4.15. 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="<высота ролика>"}}

4.6. interwikilist

Список всех InterWiki-узлов, которые определены в данной инсталляции.
Вызов: {{interwikilist}}

Ссылки

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

backlinks - список страниц, ссылающихся на данную

{{backlinks [for="PageName"] [nomark=1]}}

for — для какой страницы выводить список. По умолчанию равен “!", то есть текущей странице.

wanted - список несуществующих пока страниц, на которые есть ссылки для какого-либо кластера

{{wanted [for="PageName"]}}

for — для какого кластера выводить список. По умолчанию равен “!", то есть текущей странице.

orphaned - список потерянных страниц (т.е. страниц, на которые нет ни одной ссылки) для какого-либо кластера

{{orphaned [for="PageName"]}}

for — для какого кластера выводить список. По умолчанию равен “!", то есть текущей странице.

Персональные действия

2.1. mychanges

Выводит список измененных вами страниц с возможностью сортировки.
Вызов: {{mychanges [max=количество страниц]}}

2.2. mypages

Выводит список принадлежащих вам страниц с возможностью сортировки.
Вызов: {{mypages [bychange=1] [bydate=1]}}

4.13. watchers

Выводит список наблюдающих страницу. Работает только для владельца страницы.
Вызов: {{watchers [for="SomePage"] [nomark=1]}}
Параметр for может называться как угодно. Соответственно, первый параметр всегда считается параметром, определяющим, для какой страницы выводить список. По умолчанию равен “!", то есть текущей странице.

2.3. mywatchespages

Список всех страниц под вашим «наблюдением».
Вызов: {{mywatchespages}}

2.4. mychangeswatches

Список изменённых «наблюдаемых» страниц
Вызов: {{mychangeswatches [max="количество страниц"]}}