PmWikiRu /
Пожалуйста, экспериментируйте в песочнице!Условная разметка
авторам, администраторам (продвинутый)
Использование директивы (:if:)
Директива (:if:) позволяет включать или выключать обработку части страницы.
Общая форма этой директивы такая:
(:if условие параметр:) текст (:ifend:)
где "условие" - это проверяемое условие (описано ниже), а "параметр" - это параметр или аргумент условия. Если условие "истинно"(TRUE), то текст будет включен, а если "ложно"(FALSE) - исключен из обработки страницы.
Встроеные условия включают:
|
| (:if name ИМЯСТРАНИЦЫ:)
| -
| текущая страница называется "ИМЯСТРАНИЦЫ"
|
(:if group ИМЯГРУППЫ:)
| -
| текущая группа называется "ИМЯГРУППЫ"
|
(:if auth УРОВЕНЬ:)
| -
| пользователь имеет авторизационный "УРОВЕНЬ", где УРОВЕНЬ может быть: read, edit, upload, attr или admin
|
(:if authid:)
| -
| пользователь авторизован
|
(:if true:)
| -
| всегда включает обработку текста
|
(:if false:)
| -
| всегда выключает текст (тоже что и коментарий)
|
(:if attachments:)
| -
| у текущей страницы есть присоеденённые файлы
|
(:if date ДАТА:)
| -
| настоящая дата совпадает с ДАТА
|
(:if date ДАТА..:)
| -
| настоящая дата совпадает с ДАТА или позднее (неограничено)
|
(:if date ДАТА1..ДАТА2:)
| -
| нынешняя дата в диапазоне между ДАТА1 и ДАТА2 (включительно)
|
|
все даты в формате гггг-мм-чч или ггггммчч
|
(:if enabled VAR:)
| -
| PHP переменная VAR истинна (==true)
|
(:if equal СТРОКА1 СТРОКА2:)
| -
| СТРОКА1 совпадает с СТРОКА2
|
(:if match РЕГВЫР:)
| -
| имя текущей страницы подходит под регулярное выражение РЕГВЫР
|
(:if exists ИмяСтраницы:)
| -
| страница ИмяСтраницы существует
|
Также работают обратные формы условий:
|
| (:if !attachments:)
| -
| у страницы нет добавленых файлов
|
|
|
(:if ! name ИмяСтраницы:)
|
| текущая страница не называется "ИмяСтраницы"
|
(:if name -ИмяСтраницы :)
|
|
(:if name !ИмяСтраницы :)
|
Любая директива (:if:) автоматически прерывает предыдущую, так что можно легко сделать выбор варианта(без вложености):
|
| (:if auth read:)* Вам дозволено читать
|
(:if auth edit:)* Вам дозволено редактировать
|
(:if auth upload:)* Вам дозволено закачивать файлы
|
(:ifend:)
|
Использование символов обобщения ('*' и '?')
Знак звезда (*) - это обощение обозначающее любую последовательность символов, в том числе и пусто, которая может быть расположена на его месте.
А знак вопроса (?) - это обобщение обозначающее любой символ на его месте.
Символы обобщения (* и ?) используются в условной разметке:
|
| (:if name PmCal.2005* :)
| -
| текущая страница принадлежит группе PmCal и её имя начинается с 2005
|
(:if group PmWiki* :)
| -
| имя группы страницы начинается с PmWiki
|
(:if name Profiles.*,-Profiles.Profiles :)
| -
| страница в группе Profiles, но не Profiles.Profiles
|
Смешаные условия
Условия (определённые ранее) можно комбинировать в более сложные выражения. Для этого используется одна из трёх эквивалентных форм:
|
| (:if expr ВЫРАЖЕНИЕ :)
|
(:if [ ВЫРАЖЕНИЕ ] :)
|
(:if ( ВЫРАЖЕНИЕ ) :)
|
Условия комбинируются в выражения с помощью двоичных операторов и скобок. В следующей таблице, буквами А и Б обозначаются условия или подвыражения взятые в скобки:
| Выражение | Оператор | Результат "истинно" |
|---|
А and Б | And | Если А и Б истинны |
А or Б | Or | Если А или Б истинно |
А xor Б | Xor | Если А и Б истинны, или А и Б ложны |
! A | Not | Если А ложно |
А && Б | And | Если А и Б истинны |
А || Б | Or | Если А или Б истинно |
Обратите внимание, что:
- пробелы вокруг операторов и скобок обязательны;
- При синтаксических ошибках или непарных скобках поведение условий непредсказуемо.
Отсюда запись:
|
| (:if expr auth admin || auth attr || auth edit :)
|
[[Logout -> {$Name}?action=logout]]
|
(:if:)
|
предлагает logout ссылку только когда авторизация с правами больше, чем 'read'(просмотр).
администраторам (продвинутый)
Добавление новых условий
Смотри Cookbook:ConditionalMarkupSamples 
.
<< InterMap ссылки | Документация | Списки страниц >>
Перевод страницы PmWiki.ConditionalMarkup -
Оригинал перевода PmWikiRu.ConditionalMarkup -
Ссылаются
PmWikiRu.ConditionalMarkup: редакция от 21.03.2006 16:30
PmWiki.ConditionalMarkup: редакция от 10.09.2011 20:08
