Это старая версия Справка/Разработчик/Действия за 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!От какой страницы строить дерево
если "!", то для текущей страницы
если "", то для всего сайта.
Параметр может называться как угодно, но обязательно должен быть первым.
depthfullНа какую глубину отображать дерево
если "full", другое не-число или 0, дерево будет выведено полностью
styleindentСтиль отображения дерева – "br","ul","ol","indent"
nomark1Рамка вокруг дерева,
если 1, то рамка скрыта.

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

Строит полный каталог всех страниц, упорядоченный по алфавиту.
{{pageindex}}

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

Выводит список последних изменений в каком-либо кластере
{{changes [for="PageName"] [max=количество страниц] [date="YYYY-MM-DD"] [noxml=1]}}
Name default Description
for!Для какого кластера выводить список
если "!", то для текущей страницы
если "", то для всего сайта.
Параметр может называться как угодно, но обязательно должен быть первым.
max?Максимальное количество страниц, доступных к показу. Реальное количество показанных страниц будет зависеть от персональных настроек пользователя.
dateдата, начиная с которой (и далее в прошлое) нужно выводить список изменений. Параметр date= также можно указать в строке запроса.
noxml1скрыть/показать ссылку на 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 может называться как угодно.
topic1можно называть title
если он выставлен в 1, то поиск происходит только по именам страниц,
иначе – как по именам, так и по текстам
formговорит, что нужно выводить форму поиска вместе с результатами.
nomark1Рамка вокруг дерева,
если 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). Через некоторое время при заходе на страницу эти надписи становятся невидимы, но когда наводишь мышкой – появляются.

Не работает

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позволяет пронумеровать все заголовки.
fromh2по умолчанию заголовки первого уровня не включаются в оглавление.
Примечание: все параметры опциональные.

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}}

Ссылки

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="количество страниц"]}}